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
Colors doesnt work?
Anyone got the same problemen? §1 if use that the plugins says: Item does not exist! And if i use &a it shows &4 next to the item name.
Great plugin! There is just one thing you could improve. I really hate the purple lore with the item name. Soo... could you add an option in the config, to disable the lore? Thank you.
EDIT: Oh, nevermind. I already did it.
@MrRedstoneMan
It would help if you put the item information in YML format (easier for others to read and see your problem). Right now, I'm pretty sure your problem is that you forgot to include a colon after the item name (you have Killer instead of Killer:). It should look roughly like this:
i tried once again, this time restarting with a button replacing it. even when i try to edit the NAME of bowexample and swordexample it derps
Killer ID: 77 Displayname: Button UsePermission: false Abilities: - Death Lore: - This Item Will Kill Anything It Touches Color: §a UseRecipe: false UseCustom: true
please help (great plugin by the way, could you add creating an item in-game?)
i tried it one time and it worked perfectly on 1.6.2 bukkit server of mine, but when i tried to make my own item, it completely went bazerk (like i typed in /ci help and it just posted in my chat "/ci help" that's all nothing else) this is what i added (i know i used air id but that shouldn't affect the whole thing, right?)
Killer ID: 0 Displayname: The Death Sentence UsePermission: false Abilities: - Death Lore: - This Item Will Kill Anything It Touches Color: §a UseRecipe: false UseCustom: true Killer2 ID: 0 Displayname: Redstone UsePermission: false Abilities: - Death Lore: - This Item Will Kill Anything It Touches Color: §a UseRecipe: false UseCustom: true
Maybe make it so we can have items with a specific lore and name in the recipe itself?
hoppertje2,
I have a plugin thats meant for beta 1.8.1 and it still works fine on my 1.6.2 server. Test it yourself, and see if it works. it most likely WILL, unless something in the coding has been changed.
Is this plugin still being updated and does it work for 1.6.2 because it looks truely amazing.
Can you add compatibility for things like mossy stone brick please? Just putting in the id with a colon doesn't work
Hello. Can you add support for Heroes? New items must have higher priotity for damages, and classes in config.
https://forums.spout.org/threads/heroes-be-a-hero.4601/
(Jakub? Polak?)
Thanks.
add slow please, as in slow digging so I can give my swords a slow effect :D can you name this ability heavy?
Sorry to say but teleport does not work on all items. F.E. not on snowballs, eggs, ...
Can this be fixed/added? Many thanks for this amazing mod!
Hello, Jakub! Thanks for the plugin it's really awesome(it works on my 1.6.2 server) but could you add a new ability called "DeathCancel" for armor? It would protect from any hit like infinite health. Please, Jakub! Make It!
How much longer till update? I'm really excited to use this for my server! Thumbs up!
sorry for my bad english i come from switzerland , can you make a ability it make a infinity durability and a ability make infinity arrow
Can you add the ability to use custom items in crafting?
Please update! Thank you!
Is there a way to put in items say like this IrontoDiamond: '1': 42 '2': 42 '3': 42 '4': 42 '5': 42 '6': 42 '7': 42 '8': 42 '9': 42 and have it give you like 2 diamond blocks
so for if you put 9 iron blocks in the full 3x3 area, you would only be able to receive 1 item back and not 2 or more items. is there a way to be able to receive more than 1 item.
Can you implement CIT (Custom Item Textures) in your recipes, please!
When I create my own item it doesent let me spawn it. It says /ci help. And i do ci help but it tells me /ci help agagin. Server is running in 1.5.2