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
This plugin is getting better and better, i personaly tested beta versions with Jakub, helped him testing some bugs like ci info doing internal error, he's a very interrested person in java and bukkit plugin, I know this plugin is already good, and it will be better for sure.
Great work Jakub BTW: Then talk to me on skype, i've a few more abilities ideias :P
@everystat13
Will be in v1.3.0.
@FANS4ever
Command permissions will be added in next update.
Permissions for commands??? I just don't want to be op when i took the time to configure my permissions plugin ....
Hi!! Your plugin is awesome and very easy to use ! But i have a question : how am i supposed to configure recipes?
thx :)
cool
Could it be possible to adjust the length and power of effects like Nausea and Poison? Now or in future versions?
Very nice plugin!
BUT: I just made a poison sword, and it still does damage in worldguard pvp-free zones
@Mino8423
Your problem is with registered item, you registered it as HighKingSword but in items it is as SwordExample, rename SwordExample to HighKingSword.
Abilities are pretty cool, yeah. I found out cool way of giving someone an items. Just add any line of lore with Name of ur sword,and its adding an option to it ;p
I was doin my sword like Sword of Giant, and it was adding just sharpness, nwo i just added 2 lines: "Abilites:", and "Electricity", which was name of my sword. Its so cool u dont always have to add this with a command and u can edit lore as u want in realtime ;D
I have the same problem a a guy below heres my items.yml if u need http://pastebin.com/CYWhNQBv
@Jakub1221
Thanks, works great now. I guess when i downloaed it I got V1 while u were uploading the newer version. Also thanks for working on snowballs.
@Vincent1468
Create ticket and post your items.yml there, because this error is caused by it.
Im getting this error when I try to create a item.
@nickobelenus
You must be using v1.0.0, try v1.1.0 for display names etc. ,snowball will be added in next update.
THe names of the items on mine won't show the display name or lore text it just shows the code item name ie. NewItem instead of the New Item that is set as display name and also could u make it so you can add the ability to snowballs cuz I tried making a holy hand grenade and it only works when u hit something with it not throw it, thanks.
Looks very promising. I look forward for setting damage and protection. This plugin could also use more enchantments / abilities. But as for now it looks really good. Will probably use it on my server.
-Sicarius531
@LeTruent
Yes, i will add this in next updates.
could you add a support for spout items ? with a configurable ID and data value ?
Best plugin ever, was searching anything that was adding abilities to swords thats based on lore description of sword ;] Im using plugin Lores, and im adding desc with "SwordExample" and its adding it! Cool!
Btw, u could make it check by NAME of sword, but have to be coloured or so ;]