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
@GeekyOne
Some items.yml problems, pm me with your items.yml and recipes.yml
@GeneralGore944
Every time when you use /ci reload it will replace all custom items in player´s inventory to new updated items, set to false if you dont want to.
@USM666
Ofc you can do custom items but you dont have imagination. You can do cake with this abilities, give it name or whatever.
You need to rename this plugin to custom SWORDS not custom ITEMS. Because it sure as hell won't work with anything else but arrows and swords. Pretty misleading and boring.
It keeps erroring in the console when I boot it up. I am on version 1.5 and CB version 1.4.7-R1.0. Any help? I really want to mess around with the plugin but I can't get around it
then when I say /version
Help?
In the config, What does "update items" do?
@PandaC0mmander
Check console for errors, there must be yml errors.
@Jakub1221
Alright, replaced my recipe with that, but still the same issue. The item appears on the crafting table slot, so the player can just take it. Any advice?
um.. custom weapons held. broken monster head blocks. 2~4ea drops..
how fix?
Really looking forward to this, 'Items can have ID with data.'
@dvir01
Wow, alot of new abilities thanks.
can you add this abilities pls:
<3
@PandaC0mmander
Its not bug, my server said that in yml there was problem in recipes.yml that caused this problem, here is fixed recipes.yml .
I would have a request for the next update. Would it be possible to make it so you can use custom items in recipes? Example: Use BowExample in the crafting recipe for SwordExample Thanks :D
Hello, We are currently using your plugin and came across a game breaking bug. It ruined our intentions of making these weapons near impossible to obtain.
What happened it that upon entering a crafting table, the custom weapon would be able to just be taken out without no crafting recipe. We tried two main options, one including attempting to turn off custom recipes. The other making a recipe that is impossible to make by normal players, nether worked.
**The code for the item config currently goes as follows,**
RegisteredItems:
- AgthorBladeoftheHighLord
- BellinBowoftheDevine
- HelinaSpadeoftheSeeker
- Anarithaxeofskiesmaster
Items:
AgthorBladeoftheHighLord:
ID: 276
DisplayName: Agthor Blade of the HighLord
UsePermission: true
Abilities:
- LifeSteal
Lore:
- Legendary
Color: §6
UseRecipe: true
UseCustom: true
Enchantments:
- KNOCKBACK
- DAMAGE_ALL
- DURABILITY
- FIRE_ASPECT
- DAMAGE_UNDEAD
- DAMAGE_ARTHROPODS
- LOOT_BONUS_MOBS
EnchantmentsLevel:
KNOCKBACK: 2
DAMAGE_ALL: 5
DURABILITY: 3
FIRE_ASPECT: 2
DAMAGE_UNDEAD: 5
DAMAGE_ARTHROPODS: 5
LOOT_BONUS_MOBS: 3
BellinBowoftheDevine:
ID: 261
DisplayName: Bellin Bow of the Devine
UsePermission: true
Abilities:
- Poison
Lore:
- Legendary
Color: §6
UseRecipe: true
UseCustom: true
Enchantments:
- ARROW_INFINITE
- ARROW_FIRE
- ARROW_KNOCKBACK
- ARROW_DAMAGE
EnchantmentsLevel:
ARROW_INFINITE: 1
ARROW_FIRE: 1
ARROW_KNOCKBACK: 2
ARROW_DAMAGE: 5
HelinaSpadeoftheSeeker:
ID: 277
DisplayName: Helina Spade of the Seeker
UsePermission: true
Abilities:
- Blind
Lore:
- Legendary
Color: §6
UseRecipe: true
UseCustom: true
Enchantments:
- DIG_SPEED
- SILK_TOUCH
- DURABILITY
- LOOT_BONUS_BLOCKS
EnchantmentsLevel:
DIG_SPEED: 5
SILK_TOUCH: 1
DURABILITY: 3
LOOT_BONUS_BLOCKS: 3
Anarithaxeofskiesmaster:
ID: 279
DisplayName: Anarith Axe of Skies Master
UsePermission: true
Abilities:
- SuperHit
Lore:
- Legendary
Color: §6
UseRecipe: true
UseCustom: true
Enchantments:
- DAMAGE_ALL
- DAMAGE_UNDEAD
- DAMAGE_ARTHROPODS
- DIG_SPEED
- SILK_TOUCH
- DURABILITY
- LOOT_BONUS_BLOCKS
EnchantmentsLevel:
DAMAGE_ALL: 5
DAMAGE_UNDEAD: 5
DAMAGE_ARTHROPODS: 5
DIG_SPEED: 5
SILK_TOUCH: 1
DURABILITY: 3
LOOT_BONUS_BLOCKS: 3
**And our recipe config goes as follows,**
Recipes:
AgthorBladeoftheHighLord:
'1': 7
'2': 7
'3': 7
'4': 0
'5': 0
'6': 0
'7': 0
'8': 0
'9': 0
BellinBowoftheDevine:
'1': 0
'2': 7
'3': 0
'4': 0
'5': 0
'6': 0
'7': 0
'8': 0
'9': 0
HelinaSpadeoftheSeeker:
'1': 0
'2': 0
'3': 7
'4': 0
'5': 0
'6': 0
'7': 0
'8': 0
'9': 0
Anarithaxeofskiesmaster:
'1': 0
'2': 0
'3': 0
'4': 7
'5': 0
'6': 0
'7': 0
'8': 0
'9': 0
**I dont believe this is a issue on our part, but a plugin issue. Please correct me if I am wrong.**
Thanks
-Dan
It would be great if the custom items could not damage protected areas. I tried a explosive bow on a no build and destroy protected area and It ended up blown up.
I tried Jakub but the item im trying to spawn is still not spawning. Mind if i send you my configs so you can tell me what i screwed up?
@flameslicer
When you are spawning this item you must write your item name , name as you register that item.
I have tried EVERYTHING to get my items working! Whenever i try to craft/ spawn in a item i have created in the yml files it says the item doesn't exist! I'd love it if you'd be able to help me.
@Mifumi
Poison work, but only on players (because you cannot posion mob) and for this pvp must be enabled.