CustomItems

This project is abandoned.

Whether this project is out of date or its author marked it as abandoned, this project is no longer maintained.

If you wish to take this project over, please report it and state your intentions.

Logo

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.

Logo

Commands

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.

block

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

block

Custom recipes

  • To use custom recipe you must set UseRecipe on item to true
  • Then you must write recipe into recipes.yml

recipe

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.

example

block

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.

block

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

block

For developers

block

To do list

  • Items can have enchantments with high levels.
  • Items can have ID with data.

block

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.

block

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

block

Source code

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

  • Avatar of DavidBBukkit DavidBBukkit Jan 22, 2016 at 20:46 UTC - 0 likes

    So everybody knows, I just launched a forum where you can ask questions about Custom Items. I would prefer that you use it from now on to ask questions. As a reward to those who do, questions asked via the forum will be given the highest priority of all the questions I receive.

    The forum can be accessed at one of the two following URLs:
    https://www.theprogrammersworld.net/forum
    https://www.theprogrammersworld.com/forum

    ZBDHf98904c3d177ce612835754d9784a2bd

  • Avatar of DavidBBukkit DavidBBukkit Jan 10, 2016 at 17:56 UTC - 0 likes

    @frankhribal: Go

    When creating a new custom item in "items.yml", the ID entry is not intended for what you want the new item's ID to be, but rather what the ID of the item you want to base your custom item off of is.

    Consider this excerpt from the default "items.yml":

    Items:
      SwordExample:
        ID: 276
        DisplayName: Sword Example
        UsePermission: false
        Abilities:
        - Poison
        - Lightning
        - Death
    

    Since we want to base this item off of a diamond sword, we will set the ID equal to 276. Because Custom Items only allows you to base your items off of other items, separate IDs are not set for the items. This is an unfortunate limitation of server-side plugins, as it would be necessary for a client side modification to be installed in order to allow for items with new IDs to be added.

    Last edited Jan 10, 2016 by DavidBBukkit
  • Avatar of frankhribal frankhribal Dec 25, 2015 at 22:29 UTC - 0 likes

    @DavidBBukkit: Go

    I guess you would know how to answer this: Does the new item have an id that I can call later?

    So the default records have the id's 2256-2268, and there are some unused id's after. I put my custom song in assets/minecraft/sounds/custom/ and I can play it using the playsound command. Does that mean that it already has an id that I can call on?

    Thanks!

  • Avatar of DavidBBukkit DavidBBukkit Dec 23, 2015 at 18:32 UTC - 0 likes

    If anyone is interested, I have revived this plugin here: https://www.theprogrammersworld.net/CustomItems/

  • Avatar of Mipastu Mipastu Mar 28, 2015 at 19:11 UTC - 0 likes

    This plugin is Extremly broken! do not use!

    You cant create any custom items with it!

    Minecraft Servers
  • Avatar of Nakryuu Nakryuu Feb 04, 2015 at 11:51 UTC - 0 likes

    Hello, how so I can put items from customitem mobs to drop and mobarena reward? sorry bad english iam from indonesian :)

  • Avatar of baqizidi baqizidi Jan 22, 2015 at 13:44 UTC - 0 likes

    He and another called NBTEditor plug-ins conflict, configuration folder It is also the name of CustomItems, how to do,I am the 1.47 version

  • Avatar of JacketPotato JacketPotato Jan 07, 2015 at 04:46 UTC - 0 likes

    Please update to 1.8.1!

    And change the command "/ci". It is just causing conflicts with ClearEverything and Essentials.

    papicraft.mcalias.com 1.8.1 SkyBlock

  • Avatar of syberia97 syberia97 Jan 06, 2015 at 18:45 UTC - 0 likes

    update to 1.8 Spigot

  • Avatar of Misero36 Misero36 Dec 28, 2014 at 17:51 UTC - 0 likes

    Using /ci is clearing my inventory.

Facts

Date created
Feb 03, 2013
Category
Last update
Feb 15, 2013
Development stage
Abandoned
Language
  • enUS
License
GNU General Public License version 3 (GPLv3)
Downloads
20,610
Recent files

Authors