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
@RowanFN
The version currently out is compatible with 1.7.2, as I currently use it on a 1.7.2 server.
Hey,
My Console is not enabling this plugin, asking if its up to date which it isn't,
and i would love to use this plugin, so is there anyway of getting a version for 1.7.2
Regards
Me
Great plugin! I was wondering: 1. Could you add a multi-shot for the bow? 2. Could you allow enchanments to be added to otherwise un-enchantable items (A.K.A. adding, say, Sharpness X to a stick)? 3. Could you change attributes so that with armour that has Life Steal (for example), you can steal the opponents life force when they hit you? Or with Death it kills the attacker? 4. Adding attributes to arrows makes it to where shooting it causes it to activate when it lands (i.e. (bow + explosion) + arrow = fired arrow explodes, and bow + (arrow + explosion) = fired arrow explodes)?
If so, please add!
Hiya,
Great Plugin, using it at the moment for an RPG server. I played World of WarCraft and those of you who also do know that they have the colour system for Item rarity. what I've done with your plugin is added [GREYS] to my Citizens mobs. (so each citizen is wearing armor, but its actually a custom item with the grey item name, saying some cool lore like "Rusted Iron Boots.").
This is working really well and I thank you, however I have hit a snag with my Quest writing. I'm also using CI to make Quest related Items. such as ("Stolen Pickaxe") or something. but I need the NPC to be able to Take the item from the player. the Citizens NPC quest system allows me to run commands, I was wondering whether it would be possible to add a command to mirror /CI Create.
a /CI Remove if you like. I've never made plugins before but i am a computer scientist, and appreciate there may be a complex reason as to why this isn't possible, but! could it be done? would you be interested in adding such a feature as it has good uses.
Thankyou.
-PS!! (for you smart arses out there NO /clear then the data value for the actual item DOESN'T WORK and wouldn't work as it cant guarantee it'll take the quest item.)
Does this plugin have speed and jump boots?
Seems cool,nice job!
@datmc
I tried doing
. I couldn't get that. Should I try
, or maybe
?
What I'm trying to find out is how to get the item's data (after the colon).
@TNTftw21
If this is what you're asking, ID List: http://www.minecraftinfo.com/idlist.htm - ID Name List: http://www.minecraftinfo.com/idnamelist.htm
@pjj212
I run the latest CraftBukkit beta, with Minecraft 1.7.4, and it works fine.
Does anyone know how to get item data (i.e. how to get a cocoa bean)?
Someone please update/continue this amazing plugin!
Does it still work on 1.7.2? because Ive tried and nothing happens when I do /ci
Does this prevent crafting using the custom item?
IE: If your custom item uses DIAMOND as the ID, will it disallow the creation of diamond swords using the custom item?
Nope, it disables nothing.
@FiR3_PyyRo
I don't have Essentials, but I have a kit plugin called Kits that maintains the item's attributes. You could try that. However, Kits doesn't have a way to auto-equip armor.
Someone update this plugin!!!
I was wondering, how would I put these into kits with essentialskits if possible? I tried copying the name/lores exactly, but no luck. Essentialskits integration would be great.
Can you add it where you can have custom weapon damage? Unless this is already a feature.
I have a problem. In a no PVP zone I have set with WorldGuard players can still hit eachother with the bow and cause potion effects. Can you add more abilitys and have it so you can set the precent chance of those happening on hit aswell as setting the time effects stay on for?
Will this be updated to Minecraft 1.7.4?
This is a great plugin! Can we get the source to take a look at how it works?
Is there an ability to repair immediately the item?