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
@faesorama
so i found out what the problem was you need to set a ability to get it to work i was trying to make enchanted gear without ability's and that didnt work fix?
@silver9999
it works just set a ability Chain gear FTW
added some weapons or armor error log http://pastie.org/7267977 items.yml http://pastie.org/7267980 recipes.yml http://pastie.org/7267992
if i remove this http://pastie.org/7268086 it works
found it its was - missing @ abilities -.-
not for me no try'd chain armor and nothing, wont enable on startup
Its not working for Armor is it ?
would be nice if i could make armor also enchanted sticks and blaze rods, fishing pole
@bloodofdoor
i think you can only use bow / swords
Battleaxe: ID: 279 DisplayName: Diamond Battleaxe UsePermission: false Abilities: - SuperFortune Lore: - This is lore Color: §2 UseRecipe: true UseCustom: true Enchantments: - SHARPNESS EnchantmentsLevel: SHARPNESS: 2 Battleaxe: '1': 264 '2': 264 '3': 264 '4': 264 '5': 280 '6': 264 '7': 0 '8': 280 '9': 0
Is there anything wrong with this? I can't seem to get it to work.
i already love this plugin it allows you to expierence this like never before i can now make a sword that blinds people so i can have like a invisible person going around blinding people on my pvp server all i ask for is a sword that cancels potion effects/negatitive effects
Why is it whenever I change a ability it says the item does not exist?
Hi, could you add Wither effect upon getting hit as an ability? Thanks :)
@Jakub1221
"It is really annoying that you can't create item without an ability.
Please fix it."
and
"Is it possible to set UpdateItems: true and keep a durability of an item? e.g. I change the enchants, do /ci reload, the item is changed but the durability persist
And then if the player is offline or if the item is in a chest, /ci reload does nothing. Please make it that item is changed even though an item is in chest/player is offline."
Each item has it's own custom id right? So other plugins don't get confused.
Hi, I made the (first?) german tutorial for this plugin: http://youtu.be/16UDR2jnreg
@sirnixalot98
If developer of that plugin want to make this compatible with it, he can, there is Source Code too so it shouldn´t be problem for that developer :)
1. Do you know any kit plugins that would work with custom items? I'd like to use this for kitpvp to make awesome kits! 2. Does this require spout or any other plugins to work?
v1.6.0 works with bukkit 1.5.0/1.5.1
Please update it sounds sooo awesome
will you update the plugin?
@dmh412
No. you can create more than that. I have 14 items loaded for ROTMG server! :P
Also.. I've realized i can't create more than 3 items. Is that a bug or is it supposed to be that way?
Hey I've been using your plugin for a while and I LOVE it. But would it be possible to configure the abilities a bit more? something like
LifeSteal-Chance: 25 Poison-Chance: 100 LifeSteal-Damage: 1 Fire-Chance: 50 Fire-Duration: 1
Something like that would be helpful because the life drain is really Overpowered and I don't want to be able to set people on fire EVERY time otherwise its just kind of like fire aspect.
Thanks :D