Basic

Enabled
1
enabled: true
Copied!
With this setting you can disable an item completely.
If a player has the item in inventory it won't be removed.
Same thing for blocks, but when broken they won't drop anymore.
Display name
1
display_name: "Test"
Copied!
This is the name user will see on the item
Permission
1
permission: myitem
Copied!
Item Permission
Lore
1
lore:
2
- '&7When you mine a block'
3
- '&7it drops exp orbs'
4
- '&750% of times.'
Copied!
Lore lines of the item
Enchants
1
enchants:
2
  - ARROW_FIRE:1
3
  - anger_artifact:1
4
  - my_custom_plugin:custom_enchant:6
Copied!
Enchants of the item.
You can set vanilla enchants and custom enchants of other plugins (for example EcoEnchants, GoldenEnchants...).
Supports also namespaces (if you are creating custom enchants using Namespaced keys)
Attribute modifiers
1
attribute_modifiers:
2
  mainhand:
3
    attackDamage: 19
4
    attackSpeed: 1.1
5
    maxHealth: 1.1
6
    movementSpeed: -1
7
    armor: 1.1
8
    armorToughness: 1.1
9
    attackKnockback: 1.1
10
    luck: 1.1
11
  offhand:
12
    attackDamage: 19
13
    attackSpeed: 1.1
14
    maxHealth: 1.1
15
    movementSpeed: 1.1
16
    armor: 1.1
17
    armorToughness: 1.1
18
    attackKnockback: 1.1
19
    luck: 1.1
Copied!
These are the vanilla attribute modifiers, you can get more info here https://minecraft.gamepedia.com/Attribute#Attributes_available_on_all_living_entities​
Durability
1
durability:
2
  max_custom_durability: 200
3
  custom_durability: 32
4
  disappear_when_broken: false
5
  unbreakable: false
6
  usages: 5
Copied!
There are pretty self explanatory.
usages are a special propery which allows you to set a number of usages for the current item. Remember to decrement it using events (check events tutorial).
custom_durability is the durability amount which the item has on crafting (if not specified is the same as max_custom_durability)
max_custom_durability is the max durability the item can reach
Item flags
1
item_flags:
2
  - HIDE_ATTRIBUTES
3
  - HIDE_DESTROYS
4
  - HIDE_ENCHANTS
5
  - HIDE_PLACED_ON
6
  - HIDE_POTION_EFFECTS
7
  - HIDE_UNBREAKABLE
Copied!
Special item flags that can hide some vanilla info of the item.
You can find a detailed info list here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html​
blocked_enchants
Special item property that disables enchants for this item, so your users won't be able to enchant it.
Disable some enchants
Disable all enchants
1
blocked_enchants:
2
      - DAMAGE_UNDEAD
3
      - DAMAGE_ALL
4
      - DAMAGE_ARTHROPODS
5
      - KNOCKBACK
6
      - DURABILITY
7
      - SWEEPING_EDGE
Copied!
1
blocked_enchants:
2
      - ALL
Copied!
events_cooldown
Special attribute to limit spamming of events by players. It's in ticks, so 20 = 1 second.
1
  healing_crystals:
2
    display_name: display-name-healing_crystals
3
    permission: healing_crystals
4
    resource:
5
      material: IRON_SWORD
6
      generate: true
7
      textures:
8
      - item/healing_crystals.png
9
    durability:
10
      max_custom_durability: 6
11
      custom_durability: 6
12
      disappear_when_broken: true
13
    item_flags:
14
    - HIDE_ATTRIBUTES
15
    events_cooldown: 1200 ########### <-- EXAMPLE 60 seconds
16
    events:
17
      interact:
18
        right:
19
          play_particle:
20
            name: HEART
21
          decrement_durability:
22
            amount: 1
23
          potion_effect:
24
            type: REGENERATION
25
            duration: 70
26
            amplifier: 4
Copied!
events_needed_player_stats
Special attribute to make events work only if the player stat (ItemsAdder player stat, which are usually shown in HUDs) satisfies the set rule.
You can set it to >, < ad =
Example:
Magic wand
1
  magic_wand:
2
    display_name: "Magic wand"
3
    permission: magic_wand
4
    resource:
5
      material: DIAMOND_SWORD
6
      generate: true
7
      textures:
8
      - item/example_item.png
9
    durability:
10
      max_custom_durability: 512
11
    attribute_modifiers:
12
      mainhand:
13
        attackDamage: 0.1
14
    blocked_enchants:
15
    - ALL
16
    events_needed_player_stats:
17
      mana: ">0" ### <---- for example. You could also set it to <5 or =1 for example.
18
    events:
19
      interact:
20
        entity:
21
          target_potion_effect:
22
            type: GLOWING
23
            duration: 70
24
            amplifier: 15
25
          decrement_player_stat:
26
            name: mana
27
            amount: 1
Copied!
glow
You can make an item glowing when dropped on the ground.
Very useful for rare items.
In order to use the glow feature you have to install two APIs.
​GlowAPI and PacketListenerAPI​
They are needed because this feature is impossible to implement without writing an extremely long code, someone already did it and we can use their API.
Example
1
items:
2
  glowing_item:
3
    display_name: Glowing Item
4
    resource:
5
      material: DIAMOND
6
      generate: true
7
      textures:
8
      - item/glowing_item.png
9
    drop:
10
      glow:
11
        enabled: true
12
        color: DARK_RED
Copied!
show_name
You can make a drop show its name.
Very useful for rare items.
Example:
1
  glowing_item:
2
    display_name: Glowing Item
3
    resource:
4
      material: DIAMOND
5
      generate: true
6
      textures:
7
      - item/glowing_item.png
8
    drop:
9
      show_name: true
Copied!
template
Templates and variants
variant_of
Templates and variants