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
@CrapperCreeper1234
yeah me too it worked in a private srver then I got it on my public and it did this :/
hey i made a sword and it doesnt work when i type /ci i get /ci help when i do /ci help i get /ci help AGAIN! plz help me
Hi dude.
First i want to say your plugin is awesome.But i have really interesting error.
What happened it that upon entering a crafting table, the custom weapon would be able to just be taken out without no crafting recipe.
Here my files: items.yml:
recipes:
Thankss
Hello, I use your plugin to make a Realms of the Mad Gods Server. Umm Can i suggest that you add these abilities?:
FireCharge - Releases a fire or fire charge in direction you are shooting at. (right click to fire it) Thats about it. :P
Is it possible to set UpdateItems: true and keep a durability of an item? e.g. I change the enchants, do /ci reload, the item is changed but the durability persist
And then if the player is offline or if the item is in a chest, /ci reload does nothing. Please make it that item is changed even though an item is in chest/player is offline.
It is really annoying that you can't create item without an ability.
Please fix it.
if i may make a suggestion. Make custom recipes require custom items...example, you need to put 9 fires in a crafting table to make something called an eternal flame that does nothing. Then you need to put 9 eternal flames in to make a godly flame.
@jakesta14
I too think something as simple as an ability called None and that has no callback.
yyy bugs CraftingTablePlus xD
@MajikalBlood
you need to make sure ALL items have a ability (silly huh?) or you get what i call brain dead plugin
Okay...So...I had this plugin working but then I started getting "/ci help"
Is there pics or anything? I was wondering If Say I change a block with it change sprite?
this plugin will be perfect if ... ... custom items have their own ID (already planned) ... custom items id names are not in the lore ... durability will be dropped if abilities are used ... permission support for crafting the item ... commands can be binded as an ability ... all item support (cause some abilities seem to effect only swords or bows)
@xeNiumw0w
You can use /eci
Can the abilities be NULL?Now it'll cause NullPoint exception :(
BTW,an idea : available to add limits to how many times an abilities of an item can be used, just like item damage(but can't be repaired)
Why is it that some of these abilities dont work on mobs?
Poison and other potion effect weapons have no use other than their abilities. They should do damage as well as abilities
please add so new items can have their own item icons ingame, like in "moarstuff"
get the source from http://dev.bukkit.org/server-mods/moarstuff
I've used other plugins for creating custom recipes. This plugin is very simple. What do I think about that? I LOVE IT!
One question though, or request; is it possible to create an item with a players name as lore, like
where %playername% is the name of the player who created the item
@AJ3456
use "/eci" for the essentials' command (or you can disable the "/ci" command in essentials, forcing the command to this plugin
Can you change the command? it conflicts with essentials.