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
with this also, is it possible to make custom items make other custom items?
for instance is i make a custom 'gold medallion' (gold nugget)
then i want a special gold shovel using a stick and the 'gold medalion'
how would that work without getting it created also by a normal gold nugget?
Finally got it working, now have to be careful :/
and yeah an update to make it compatible with item names instead of ID's (cause 1.8 is going to be that way) would be really great and a good step forward
Its working in 1.7.9.
But please, do update!
Update plugin plz!!! I love CustomItems! =3
Warning! This plugin is very likely to break in 1.7.0-1.7.9
I tried creating an item and it says it does not exist i registered the item and put the item stats on the thing and it wont work! also I tried re-naming the bow and I renamed everything and I have the same issue, plz help! D:
Working fine on all 1.7 versions.
@andrewcramer
Nope :/ wasn't working on my 1.7.2 anyway, this needs an update!
so uh this plugin wont work with buckit 1.7.5 ?
please can this get updated!!!!!!
Steal this plugin someone and remake it :P
@TNTftw21
Remember that when putting enchantments you have to do this
Enchantments: - KNOCKBACK (or whatever enchantment you are doing) EnchantmentsLevel: KNOCKBACK: 2 I know that's kinda what you learn right when you open the config but I thought I might mention in case this was your problem.
@kittsfu
I know your problem, in the config if you go down in the items.yml you will see on one of the example items right under Lore it will say "Color:" thats where you put your color you want the name to be, now if you are looking to change the color of your lore I think thats not possible with this plugin yet. And make sure you put the "§" symbol before the color code. :)
@HappyKiller101
I'm sad to say that putting "Color: "&6"" did not work.
The weapons titles become like this; "&6Name of Bow", in lightblue color.
I havent tried any other special character to replace the §. But from i can assume from testing with "&", the creator hasn't enabled any other characters beside the original.
Does anyone else have the console problem with craftbukkit 1.6.4 and this plugins config with § as color code? Perhaps something on my end is amiss and i'm missing something.
@HappyKiller101
I figured out what the problem was. Apparently, CI doesn't want me to enchant my bow with ARROW_DAMAGE 4. However, I was wondering if anyone knew if there's a special way that you're supposed to put multiple enchants on items. Also, even though I took off the enchantment DURABILITY 10, it still throws an error. I even commented out ARROW_DAMAGE, but it won't work.
@kittsfu
Try using the "&" symbol instead of "§", you can't just put the number because, the symbol makes the console realize it is a color instead of a number.
@TNTftw21 I would say its a 1.7 issue, did you try uninstalling and reinstalling it? Or it could be possible you have too many items made? (I don't know if that would be an issue, just a thought).
I can't use this plugin on 1.6.4 with the color command: § It only results in a plugin error in the console upon trying to start the server.
So i've had to remove the § for now. And the plugin work flawless without it. Except for that the titles are messed up due the missing "§". So they become like this: 5The Bow of Teleportation .. instead of having the color represented by the figure 5.
Can you somehow fix this? Perhaps introduce a way to get a colored title without the need of the §. If i am in the wrong somehow, please do give me some tip on how to solve this.
Thanks in advance, and thank you for a great plugin.
Idea: make it possible to thrown an item (the same way you throw a snowball) and when it hits it explodes.
Custom items broke. Bukkit can't even find it, but it is still, somehow, there. I can tell because when I enter /ci create TNTftw21 ExampleSword, instead of creating it or telling me that it doesn't exist, it just says /ci help. I had tried to create an item before then, but when I did /ci reload, it didn't work. It said that none of the items existed, but it still worked. When I stopped the server, CI died. There is NO error log associated with it saying /ci help. I really don't want to discard all of my work, but that's how it's looking (thank god for backups). If anyone has advice, please share it with me.
I replaced my items.yml by taking out the parts I wanted, the n deleting everything in items.yml and pasting what I had in. This happened:
Now Bukkit can see CI, but CI can't see CI.