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
@imabustya
If you don't want abilities just set "UseCostum" to false
@xeNiumw0w
Yes, but u can also use /clean
Has the same affect
Could you make it so it also detects items via name (if it does so is configurable). This way we could have "custom enchants", such as Poison I.
/ci from CustomItems is condraticing /ci from Essentials
Could you add support for using multiple items in each numbered location of the recipe. For example:
Recipes: BowExample: '1': 0
'2': 0
'3': 0
'4': 1;2
'5': 1;2
'6': 1;2
'7': 0
'8': 0
'9': 0
So instead of 3 stone it requires 6 stone in the second row. This would be great for my custom RPG server for balancing the economy.
Also could you add support for adding zero abilities to an item? Maybe: Abilities: - None
Could we see some pictures, or a tutorial video for this plugin please? Also, do the abilities show in the lore, and is it possible to use another plugin to rename a CustomItem yet have it retain its abilities?
@lmartnez10
Try doing /ci create SwordExaple <player>
because i think u only changed the display name
And if u did also change the item name, is it in the loaded item list in the items.yml?
So I base the sword I made of the swordexample and renamed it and gave it other abilities the format is right but when I enter the command /ci create <Name> <Player> it says weapon does not exist? Help!
Is it possible to bind commands to the custom item (without showing it in the lore)?
Is this plugins allow us to override the original recipe of minecraft?
Please help me whenever i make a new item i cant craft it heres the item file:RegisteredItems: - EnderBow - LifeKiller Items: EnderBow: ID: 261 DisplayName: EnderBow UsePermission: false Abilities: - Teleport Lore: - "This legendary bow was crafted by EnderMen" Color: "§2" UseRecipe: true UseCustom: true LifeKiller: ID: 276 DisplayName: LifeKiller UsePermission: false Abilities: - LifeSteal - Lightning Lore: - "This legendary sword was created by Steve" Color: "§b" UseRecipe: true UseCustom: true
This is the recipe folder:Recipes: EnderBow: '1': 368 '2': 368 '3': 368 '4': 121 '5': 261 '6': 121 '7': 368 '8': 368 '9': 368 LifeKiller: '1': 265 '2': 265 '3': 265 '4': 265 '5': 276 '6': 265 '7': 265 '8': 265 '9': 265
Please tell me why this doesnt work!
@Jakub1221
Wow this plugin got so damm awesome :)
The only thing im missing is diffrent colores in the name and lore, so would it be possible to add the color codes to the lore and the name?
EDIT:
Maybe aslo a way to add a custom item in a recipe?
Every time I register a new item either with, or without a recepie my console gets spammed with errors, only the default ones work normally. Here's a brief:
And here's the error it posts me:
sorry, I would post this on github or something, but can't find any related to this plugin.
Will this update eventually and will more abilitys be added?Nice plugin im definetly using it for my server!
You plan on adding multi world support?, now it doesn't work on other worlds except the main world.
Would be nice to select the exempt worlds where you want to work the custom items.
@mig4ng
Hi. Thanks for responding. I guess it just opens for even more possibilities for various tools that can players can create and use. It's also a nice way to put limits on commands that players can have access to, but not too much or too often. That would let us allow them to use tp at a cost now and then, but not all the time.
Think it would make your plugin complete and comprehensive :D
@iM2Korean
Post here your recipe.yml and item.yml maybe I can help you:
http://dev.bukkit.org/paste/
@do6star
I don't think this is really the point of this plugin, but i wouldn't be that hard to create a plugin like this.
There Is A Problem For Some Reason When I Craft Something In A Crafting Table, And I Take The Item Out It Duplicates The Item When I Reopen The Crafting Table Over And Over Again.
Hi. Awesome plugin! I had an idea though, with the use of command helper and similar plugins, would it be possible to create pretty mundane items? like a Rod (blaze) named something, with 3/10 uses left that activates a command (like: /spawn)? When its out of uses, its destroyed?