CustomItems

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 Tonysp Tonysp Apr 14, 2014 at 22:11 UTC - 1 like

    Working fine on all 1.7 versions.

  • Avatar of RowanFN RowanFN Apr 08, 2014 at 13:58 UTC - 0 likes

    <<reply 2109962>>

    Nope :/ wasn't working on my 1.7.2 anyway, this needs an update!

  • Avatar of andrewcramer andrewcramer Apr 02, 2014 at 18:05 UTC - 0 likes

    so uh this plugin wont work with buckit 1.7.5 ?

  • Avatar of RowanFN RowanFN Mar 29, 2014 at 18:52 UTC - 0 likes

    please can this get updated!!!!!!

  • Avatar of Chewfungus115 Chewfungus115 Mar 15, 2014 at 20:08 UTC - 1 like

    Steal this plugin someone and remake it :P

  • Avatar of HappyKiller101 HappyKiller101 Mar 07, 2014 at 20:52 UTC - 0 likes

    @TNTftw21: Go

    Remember that when putting enchantments you have to do this

    Enchantments: - KNOCKBACK (or whatever enchantment you are doing) EnchantmentsLevel: KNOCKBACK: 2 I know that's kinda what you learn right when you open the config but I thought I might mention in case this was your problem.

  • Avatar of HappyKiller101 HappyKiller101 Mar 07, 2014 at 20:49 UTC - 0 likes

    @kittsfu: Go

    I know your problem, in the config if you go down in the items.yml you will see on one of the example items right under Lore it will say "Color:" thats where you put your color you want the name to be, now if you are looking to change the color of your lore I think thats not possible with this plugin yet. And make sure you put the "§" symbol before the color code. :)

  • Avatar of kittsfu kittsfu Mar 06, 2014 at 05:06 UTC - 0 likes

    @HappyKiller101: Go

    I'm sad to say that putting "Color: "&6"" did not work.

    The weapons titles become like this; "&6Name of Bow", in lightblue color.

    I havent tried any other special character to replace the §. But from i can assume from testing with "&", the creator hasn't enabled any other characters beside the original.

    Does anyone else have the console problem with craftbukkit 1.6.4 and this plugins config with § as color code? Perhaps something on my end is amiss and i'm missing something.

    Last edited Mar 06, 2014 by kittsfu
  • Avatar of TNTftw21 TNTftw21 Mar 05, 2014 at 23:05 UTC - 0 likes

    @HappyKiller101: Go

    I figured out what the problem was. Apparently, CI doesn't want me to enchant my bow with ARROW_DAMAGE 4. However, I was wondering if anyone knew if there's a special way that you're supposed to put multiple enchants on items. Also, even though I took off the enchantment DURABILITY 10, it still throws an error. I even commented out ARROW_DAMAGE, but it won't work.

    Last edited Mar 05, 2014 by TNTftw21

    http://img.grafme.com/thumb/grafme-com-bd54df2a-1518997.png

  • Avatar of HappyKiller101 HappyKiller101 Mar 05, 2014 at 23:00 UTC - 0 likes

    @kittsfu: Go

    Try using the "&" symbol instead of "§", you can't just put the number because, the symbol makes the console realize it is a color instead of a number.

Facts

Date created
Feb 03, 2013
Category
Last update
Feb 15, 2013
Development stage
Release
Language
  • enUS
License
GNU General Public License version 3 (GPLv3)
Curse link
CustomItems
Downloads
13,595
Recent files

Authors