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.



CommandPermission nodeDescription
/ci create <item name> <player>custom-items.createGives custom item to the player.
/ci infocustom-items.infoShows info about item in hand.
/ci reloadcustom-items.reloadReloads config and items.
/ci helpcustom-items.helpShows 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
- NewItem
  • Now we add whole item with informations about it
    ID: 276 // 276 is diamond sword
    DisplayName: "New Item"
    UsePermission: false //if permissions are needed to use item
    Abilities: // item abilities
    - Poison
    - Lighting
    - Death
    - This is lore
    - This is another lore
    Color: "§6"
    UseRecipe: false
    UseCustom: true
      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.


    '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.




  • 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.



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.



  • 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


  • 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


Source code

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Gyziie Gyziie Oct 09, 2014 at 11:32 UTC - 0 likes

    @PapiDimmi: Go

    Make sure you add the item name to the "RegisteredItems" in the top of the items.yml file.

  • Avatar of Gyziie Gyziie Oct 09, 2014 at 11:31 UTC - 0 likes

    @Triyon: Go

    I run a 1.7.10 server, and it works perfectly fine for me.

  • Avatar of Gyziie Gyziie Oct 09, 2014 at 11:30 UTC - 0 likes

    First of all - I LOVE this plugin... great job!

    I got a small question: Is it/would it be possible to make the items stack? :) - Of course without stacking with normal items!

    This would be amazing!

    Last edited Oct 09, 2014 by Gyziie
  • Avatar of Triyon Triyon Sep 30, 2014 at 07:26 UTC - 0 likes

    Update to 1.7.9 please

  • Avatar of PapiDimmi PapiDimmi Sep 06, 2014 at 08:53 UTC - 0 likes

    Whenever I create an item and try to summon it, it says "Item Does Not Exist"...


  • Avatar of PapiDimmi PapiDimmi Sep 06, 2014 at 08:22 UTC - 0 likes

    You should add a feature that you can have the Death (instant death on hit) ability on arrows instead of tools, so you could make specific arrows so that when you shoot it, it instantly kills the target, but it only works as many times as you have the special arrows.

  • Avatar of RowanFN RowanFN Aug 20, 2014 at 13:55 UTC - 0 likes

    with this also, is it possible to make custom items make other custom items?

    for instance is i make a custom 'gold medallion' (gold nugget)

    then i want a special gold shovel using a stick and the 'gold medalion'

    how would that work without getting it created also by a normal gold nugget?

  • Avatar of RowanFN RowanFN Aug 19, 2014 at 16:15 UTC - 0 likes

    Finally got it working, now have to be careful :/

    and yeah an update to make it compatible with item names instead of ID's (cause 1.8 is going to be that way) would be really great and a good step forward

  • Avatar of KyrumX KyrumX Aug 10, 2014 at 13:48 UTC - 0 likes

    Its working in 1.7.9.

    But please, do update!

    Contributor of CraftZ. Contact me if you have any problems/questions!

    Remeber: If it's stupid, but it works, it's not stupid at all!


  • Avatar of dragonl dragonl Jul 31, 2014 at 10:21 UTC - 0 likes

    Update plugin plz!!! I love CustomItems! =3


Date created
Feb 03, 2013
Last update
Feb 15, 2013
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files