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
@ScrimCraft
Yes it is.
In the abilities data, is it in seconds?
Can you add an ability for fly ? :)
Or double jump!
@maxa2g
This problem is in recipes.yml, check that or pm with your recipes.yml.
@dvir01
They can have, just put that id into string, "352:2" for example.
Bug: When people open the crafting bench one of the cutom items is already there, every time they re-open it its there again.
i have a suggestion if possible you should make it so you can craft with custom items
i got this plugin working on a private server and it works fine but whenever i bring it on my public with a duplicate of the configs and item stuff then it won't let me craft it and whenever i do any /ci related command it jsut sys in the chat in white /ci help
Can you please integrate WorldGuard protection?
Jakub1221 come to my battle kit server to see your plugin in use :D pvp-craftil.no-ip.org and also did u know your plugin work whit pvpgun plugin? you can use it on guns :D
@T0BBL3R
Items cant have ID with data, for now
@JTLethal
Items cant have ID with data, for now
@GeneralGore944
world guard block all explosions, mark it on true in config.
I just got this plugin to work. I like it and all but we should have to ability to turn off the lore. I don't like using it because it takes away from the fun of making it special but seem to be vanilla.
Items with Data don't seem to work. It says it was updated for 1.6 but nothing seems to work. I'm trying to do 351:2 but nothing.
@Jakub1221
My friend who basically tells me what to do asks for your skype so he can fix this, I sincerely apologize and know you are very busy and really couldn't give two shits about our problem. But if it gets him off my back by sending this, then so be it.
Thanks
-Dan
@Jakub1221
/ci reload doesnt work, it shows up with /ci help and the same with console except it gives a string of something involving craftbukkit_R1.4.7
Hey folks,
Is it possible to create a splash Potion which set enemies or mobs on fire?
for expample:
Molotowcocktail:
ID: 373:16451 //??? <- It won't work for me :(
DisplayName: Molotowcocktail
UsePermission: false
Abilities:
- Fire
Lore:
- [...]
- [...]
Color: §6
UseRecipe: true
UseCustom: true
When i upload this item on my Server i can't reload the items.yml -> Internal Error.
One More question, @Jakub1221
Is there ANY plugin that you can recommend that will stop the Block damage that the explosions will cause? I desperately need it!
Ah alright, Thanks!