Skip to main content

ITEM SETTINGS

Items are extremely configurable and are created with the user in mind. Have any questions feel free to reach out to our discord.

Example​

material: STONE
display-name: "<red>Example Item Stack"
lore:
  - "Your"
  - "Lore"

KEY​

material: <ID>

  • Depending on your server version. This is where you paste your item ID (ex. DIAMOND_AXE). Also involves multiple compatibilities such as replacing <id> with the following: nexo:<id>, itemsadder:<id>, oraxen:<id>, base64<value> (Base64 also includes using /waves itemconvert).

Material type integrations​

Vanilla​

material: STONE

List of all materials can be found HERE

Nexo​

material: "NEXO:ID"

Oraxen​

material: "ORAXEN:ID"

MMOItems​

material: "MMOITEM:ITEM_TYPE:ID"

ItemsAdder​

material: "IA:NAMESPACE:ID"

HeadDatabase​

material: "HDB:ID"

Eco​

material: "ECO:ID"

CraftEngine​

material: "CRAFTENGINE:ID"

Base64​

material: "BASE64:Value"

In order to get Base64 value of an item, you need to use /waves itemconvert ingame while holding the item in your main hand.

Flags​

Display Name​

Example:

display-name: "<red>Example Item Stack"

Lore (Description)​

Example:

lore:
  - "Example"
  - "Lore"

Amount​

The item amount.

Example:

amount: 1

Enchants​

Example:

enchants:
  - "DURABILITY:2" # EnchantName : Level
  - "AE-Custom:2" # Support for AdvancedEnchantments plugin - Add the AE- prefix

Available enchantment names: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html

Custom Model Data (Legacy)​

Legacy option for the custom model data using number.

Example:

model-data-legacy: 1

Custom Model Data​

Option for the advanced custom model data.

Example:

model-data:
  floats: # Optional
    - 1
  strings: # Optional
    - "example"
  flags: # Optional
    - true
    - false
  colors: # Optional
    - "255;255;255" # RGB

Damage​

Option of the item durability

Example:

damage: 100 # Cannot be higher than item's max damage

Dye​

Dye option for dyeable items.

Example:

dye: "255;255;255" # RGB

Flags​

Example:

flags:
  - HIDE_ENCHANTS

Available flags: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html

Item Model​

Modern version for setting the item custom model.

Example:

item-model: "namespace:custom-model"

Max Damage​

Max durability of the item.

Example:

max-damage: 200

Max Stack Size​

Example:

max-stack-size: 99 # Min 1, Max 99

Item Rarity​

Example:

rarity: COMMON

Possible values: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemRarity.html

Spawner Entity Type​

Example:

entity-type: ZOMBIE

Tooltip Style​

Design of the tooltip.

Example:

tooltip-style: "namespace:custom-style"

Unbreakable​

Example:

unbreakable: true