CustomItems
What is Custom Items?
With custom items you can create items with custom names , recipe, abilities , lores, enchantments and name colors. For example, sword with high damage , instant kills or both. There are many abilities that you can attach on your item. Create a bow with teleport or with explosion on hit. You can combine everything and create very good item. Every item has its permission, permission is optional. You can use this on many things, vip, as reward etc.
Commands
Command | Permission node | Description |
---|
/ci create <item name> <player> | custom-items.create | Gives custom item to the player. |
/ci info | custom-items.info | Shows info about item in hand. |
/ci reload | custom-items.reload | Reloads config and items. |
/ci help | custom-items.help | Shows all commands. |
Create new item
Every item has 11 values: Name,ID,UseRecipe,UseCustom,UsePermission,DisplayName,Lore,Color,Abilities,Enchantments and EnchantmentsLevel.
- We must register new item to items.yml
RegisteredItems: - NewItem
- Now we add whole item with informations about it
Items: NewItem: ID: 276 // 276 is diamond sword DisplayName: "New Item" UsePermission: false //if permissions are needed to use item Abilities: // item abilities - Poison - Lighting - Death Lore: - This is lore - This is another lore Color: "§6" UseRecipe: false UseCustom: true Enchantments: - KNOCKBACK EnchantmentsLevel: KNOCKBACK: 2
- ID - Minecraft item id.
- DisplayName - Displays name of item.
- UsePermission - If permission is required to use item.
- Abilities - List of item´s abilities.
- Lore - Item´s lore. (Under item´s name)
- Color - DisplayName color. (List of colors here)
- UseRecipe - Item can be created by recipe.
- UseCustom - Every item has in lore one line of item´s name, this will remove that line if its set to false, but plugin then wont know that is custom item, so abilities wont work.
- Enchantments - List of item´s enchantments. (List of all enchantments here)
- EnchantmentsLevel - List of item´s enchantments level.
- Note: Color codes are here link.
- Restart server or use /ci reload
- Item is now completed! You can add it in game by /ci create NewItem yourname
Custom recipes
- To use custom recipe you must set UseRecipe on item to true
- Then you must write recipe into recipes.yml
Write every slot in this format : 'slot number': material id.
Example
Recipes: BowExample: '1': 0 '2': 0 '3': 0 '4': 1 '5': 1 '6': 1 '7': 0 '8': 0 '9': 0
- And this is how it looks like.
Abilities
- Lighting - Strikes lighting from the sky.
- SuperFortune - This is like enchant fortune but 3x more powerfull.
- Death - Instantly kills the target.
- SuperHit - Hit is 3x bigger.
- Break - Breaks any block instantly. (except Bedrock)
- Teleport - Teleports to clicked location. (With bow, this location is where arrow fell on ground)
- Poison - Poisons the target.
- Disorient - Disorients the target.
- Explosion - Creates explosion when you click or hit something.
- LifeSteal - Converts damage to life.
- Blind - Blinds the target.
- Fire - Sets clicked block to fire / Sets hit target to fire.
Permission
Every item can have permission, if you want it to have one, then set UsePermission on item to true. Permission will be custom-items.ItemName
For developers
To do list
- Items can have enchantments with high levels.
- Items can have ID with data.
FAQ
- Q: There is item name in lore, is it a bug?
- A: No, this one line of lore must be there because its only one way to know that is custom item.
Current version v1.6.0
Support:
- 1.5.1
- 1.5.0
- 1.4.7 R1.0
- 1.4.6 R0.3
Waiting for approval versions
- None.
In development versions
- 2.0.0
Hello, nice plugin. But "Poison" don't work on my server. Can you update the plugin?
@Burntscale76
Dont use server command /reload , for reloading your items use /ci reload, and check your console for errors.
tnks for added the Blind and Fire <3
well..I mean it seems that we can't use custom items in recipe. (there's only "'slot number': material id",no item names etc. :( )
Ok, I've downloaded all the updates but I'm unable to edit any items. If i change anything, it just says /ci help no matter what CustomItems command i try.
@chasquad
PM me with your items.yml.
Heeelp!!
Help me, i got the plugin on my server, but there is no way to create new items, i tried everything, i even tried to rename the swordexample to my new sword, but ANY WAY i try to create a new item in the end he says Item does not exist, i rlly liked the plugin and i am going to like even more if you help me , if possible, do some explanations in a better way with examples not only written and make some videos, because i just can't do anything to create new items and i rlly liked the plugin
Thanks, waiting for your answer the quickly as possible
Really like the plugin. I think there should be other abilities like Fus Ro dah or just more items. really love it!
@jessefjxm
Well, you can create your own custom recipe on every item.
Nice! Instead of just plain weapons, you should do other items like food and stuff! I really like it! I recommended to server owners!
Can custom recipes use custom items?
OOOH YEAH I'VE BEEN WANTING THIS FOR MONTHS! Thank you good sir!
Heya laddy!
Really want to use your plugin, though with it on for 5 minutes or more my entire dedicated server lagged out. Tried multiple times and only with your plugin enabled was it happening.
No errors in the Minecraft log or anything, so I guess you just have one hell of a memory leak somewhere? The only related thing I can think of is that I'm using InventorySQL to store people's inventory. Could that be an issue?
Cheers bud.
@Jam3ster
PM me with your items.yml and recipes.yml
Can you tell me whats wrong? It's not working properly. I made a few new items and this is the error at startup:
23:23:44 [SEVERE] Error occurred while enabling CustomItems v1.3.1 (Is it up to date?) java.lang.NullPointerException at org.bukkit.inventory.ItemStack.<init>(ItemStack.java:88) at org.bukkit.inventory.ShapedRecipe.setIngredient(ShapedRecipe.java:99)
at org.bukkit.inventory.ShapedRecipe.setIngredient(ShapedRecipe.java:86)
at org.jakub1221.customitems.ConfigDB.Reload(ConfigDB.java:522) at org.jakub1221.customitems.ConfigDB.Startup(ConfigDB.java:270) at org.jakub1221.customitems.CustomItems.onEnable(CustomItems.java:51) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217) at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader .java:457) at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManage r.java:381) at org.bukkit.craftbukkit.v1_4_R1.CraftServer.loadPlugin(CraftServer.jav a:282) at org.bukkit.craftbukkit.v1_4_R1.CraftServer.enablePlugins(CraftServer. java:264) at net.minecraft.server.v1_4_R1.MinecraftServer.j(MinecraftServer.java:3 21) at net.minecraft.server.v1_4_R1.MinecraftServer.e(MinecraftServer.java:3 00) at net.minecraft.server.v1_4_R1.MinecraftServer.a(MinecraftServer.java:2 59) at net.minecraft.server.v1_4_R1.DedicatedServer.init(DedicatedServer.jav a:149) at net.minecraft.server.v1_4_R1.MinecraftServer.run(MinecraftServer.java :399) at net.minecraft.server.v1_4_R1.ThreadServerApplication.run(SourceFile:8 49)
can u add blind and fireball (or fire, that place block of fire and not only demage)? :D
@Ao1993
don't use server's /reload command when instaling the plugin.
@Ao1993
Check your console for errors.
Hey guys; I'm currently only receiving "/ci help" in game whilst trying to use commands. Any ideas?
Never break ability? Mobs that get hit with the Teleport ability (Bows only) make you teleport make it so it doesn't And let other items like sticks have enchantability :) Oh and if its a bow item make it so you can craft it in the same order but inverted.
Oh and the permissions don't work with bpermissions ...