Item Format

Mojang very like change material (item type), enchantment, potion and many other things's ID (or namespace key). For example, they changed sweeping enchantment ID to sweeping_edge in 1.21. So, before you update your server version, you need carefully check that whether new versions have changed something, otherwise it will break your shop or menu configs.

Legacy (If you are using 2.2.0- version)

This page is telling you new Item Format which start use at version 2.2.0. Before that version, you should use legacy version of Item Format at this page.

Don't know how to possible value of each Item Format args?

Please view Item Format Arg List page to know some of those args possible value.

Hook Item

Hook Plugin

Possible Value: EcoItems, EcoArmor, MMOItems, ItemsAdder, Oraxen, MythicMobs, eco, NeigeItems, ExecutableItems.

hook-plugin: MMOItems

Hook Item

For EcoItems, Oraxen, MythicMobs, you should write item id.

For ItemsAdder, eco, you should write namespace:item id.

Eco's namespace id plugin name, like talismans.

• Talisman: Just type talisman ID here.

• EcoArmor:

  • Armor: set_<setID>_<slotID>

  • Advanced Armor: set_<setID>_<slotID>_advanced

  • Upgrade Crystal: shard_<shardID>

• Reforges: stone_<reforgeID>

For EcoArmor, you should write armor set id;;armor slot. armor slot can be set to BOOTS, CHESTPLATE, ELYTRA, HELMET, LEGGINGS.

For MMOItems, you should write <itemTypeId>;;<itemId>.

hook-item: AXE;;TEST_AXE

Stop! If you are just trying to get items from custom item plugins, hook-plugin and hook-item option should be enough for you, if your custom item plugins are not supported, please use command instead, all things below is suit for vanilla items, if you set them here, we will replace the related to item attributes and this will lead to the item you get here is different from the item should be in custom item plugins.

Material

If you want to use saved item by plugin, just set this option value to saved item ID, like material: superior_sword.

If the value is empty or illegal, defaults to stone.

Do not use this option when you have hook-plugin option, it won't work if you insist on it!

material: APPLE

Amount

Support use PlaceholderAPI or math calculate. For example, %player_health% * 5.

amount: 5

Min Amount/Max Amount - Only support in price/products

Useful for dynamic prices.

min-amount: 1
max-amount: 15

Custom Name/Display Name

According to your configuration file, there are two formats, one is the old version color code used before version 1.9, or the Text Component used in later versions. The former uses a color code format we created, while the latter uses Mini Message format, as detailed here. Mini Message format require your server core is Paper.

name: '&fA smart sword'

Item Name (1.20.5+)

Item Name is a new item attribute added in 1.20.5, different from display name, item name can not be changed in anvil.

According to your configuration file, there are two formats, one is the old version color code used before version 1.9, or the Text Component used in later versions. The former uses a color code format we created, while the latter uses Mini Message format, as detailed here. Mini Message format require your server core is Paper.

item-name: '&bRare Sword'

Lore

You can use \n to represent line breaks.

According to your configuration file, there are two formats, one is the old version color code used before version 1.9, or the Text Component used in later versions. The former uses a color code format we created, while the latter uses Mini Message format, as detailed here. Mini Message format require your server core is Paper.

lore:
  - '&fLine 1'
  - '&fLine 2'

Max Stack (1.20.5+)

max-stack: 99

Food (1.20.5+)

Effects format: Potion Type ID, Duration, Amplifier, Ambient, Particles, Icon, Chance.

For Ambient, Particles, Icon is boolean type arg, and for Chance is a number from 0 to 1.

For convert is Item Format that the item will return to player after eaten this food (Require 1.21+, and this is optional).

food:
  eat-seconds: 0.25 # Removed in 1.21.2
  can-always-eat: true 
  nutrition: 5
  saturation: 0.5
  convert: # Removed in 1.21.2
    material: BREAD
  effects: # Removed in 1.21.2
    - 'SPEED, 100, 1, true, true, false, 0.5'

Tool (1.21+)

tool:
  mining-speed: 1
  damage-per-block: 1
  rules:
    # Blocks, Speed, Drop after mine
    - 'stone, coal_ore, 1, true'

Jukebox Playable (1.21+)

song: CAT
show-song: false

Fire Resistant (1.20.5+)

fire-resistant: true

Hide Tool Tip (1.20.5+)

hide-tool-tip: true

Unbreakable

unbreakable: true

Ratity (1.20.5+)

rarity: COMMON

Flags

flags:
  - HIDE_ENCHANTS
  - HIDE_ATTRIBUTES
  - HIDE_UNBREAKABLE
  - HIDE_DESTROYS
  - HIDE_PLACED_ON
  - HIDE_ADDITIONAL_TOOLTIP
  - HIDE_DYE
  - HIDE_ARMOR_TRIM

Enchants

Config section format is: Enchant ID: Enchant Level.

For enchantment book: You maybe need use stored-enchants instead of enchants.

For custom enchantments: Some enchantments plugins are not registered their enchantment into game, so this won't work for them.

You should use Minecraft enchantment ID instead of Spigot's after 1.20.5.

enchants:
  MENDING: 1

Glow (1.20.5+)

glow: true

Custom Model Data

custom-model-data: 15

Attributes

Please note that 1.20.5 has changed attribute format, if you generated item before 1.20.5, you have to reconfig them into new format.

Config section format is Attribute ID and then has multi sub options.

attributes:
  GENERIC_ATTACK_DAMAGE: 
    name: generic.attack_damage 
    amount: 12
    operation: ADD_NUMBER # ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1
    slot: HAND 

Damageable

Represents an item that has durability and can take damage.

Damage

damage: 5

Max Damage (1.20.5+)

Similar to max durability.

max-damage: 1500

Enchantment Storage

This is specific to items that can store enchantments, as opposed to being enchanted. Material.ENCHANTED_BOOK is an example of an item with enchantment storage.

Stored Enchants

Similar to Enchants.

stored-enchants:
  MENDING: 1

Banner

Patterns

Config section format is: Pattern ID: Pattern Color.

patterns:
  BASE: WHITE

Potion

Represents a potion or item that can have custom effects.

Base Effect (1.20.5+)

base-effect: 'WATER'

Base Effect (Before 1.20.5)

Format: Potion Type ID, Extended, Upgraded.

For Extended and Upgraded arg is boolean type.

base-effect: 'WATER, true, false'

Effects / Custom Effects

Effects format: Potion Type ID, Duration, Amplifier, Ambient, Particles, Icon.

For Ambient, Particles, Icon is boolean type arg.

effects:
  - 'SPEED, 100, 1, true, true, false'

Color

Color has 2 formats:

• Red, Green, Blue

• One number (like 0xff0000)

color: '5'

Armor

Represents armor that an entity can equip.

Trim (1.20+)

Config section format is 2 sub options.

trim:
  material: IRON
  pattern: TIDE

Leather Armor

Color

Color has 2 formats:

• Red, Green, Blue

• One number (like 0xff0000)

color: '0xff0000'

Axolotl Bucket (1.17+)

Color

Possible value: LUCY, WILD, GOLD, CYAN, BLUE.

color: LUCY

Tropical Fish Bucket (1.14+)

Color

Possible value: WHITE, ORANGE, MAGENTA, LIGHT_BLUE, YELLOW, LIME, PINK, GRAY, LIGHT_GRAY, CYAN, PURPLE, BLUE, BROWN, GREEN, RED, BLACK.

color: WHITE

Pattern Color

Similar to Color above.

pattern-color: WHITE

Pattern

Possible value: KOB, SUNSTREAK, SNOOPER, DASHER, BRINELY, SPOTTY, FLOPPER, STRIPEY, GLITTER, BLOCKFISH, BETTY, CLAYFISH.

pattern: KOB

Skull

Support 2 formats:

• Base64: Like example below, only support 1.19+.

• Player Name: Need online mode, support all versions.

skull: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvN2YzZmVkMTZmZDU1MTkwOWZhNWUyOWNkZDY5N2VlMzQ2ZTYzMzkwYjM4M2E0MzAwYTY2MmE4MGI2NGQ5ZWIxNyJ9fX0=

Firwork

Power

power: 1

Firework Effect

Config section format is multi sub options.

For type possible value: BALL, BALL_LARGE, STAR, BURST, CREEPER.

firework:
  1: 
    flicker: true
    trial: true
    colors:
      base:
        - 5
      fade:
        - 666666
    type: BALL

Firework Star

Firework Effect

For type possible value: BALL, BALL_LARGE, STAR, BURST, CREEPER.

firework:
  flicker: true
  trial: true
  colors:
    base:
      - 5
    fade:
      - 666666
  type: BALL

Suspicious Stew (1.14+)

Effects

Effects format: Potion Type ID, Duration, Amplifier, Ambient, Particles, Icon.

effects:
  - 'SPEED, 100, 1, true, true, false'

Bundle (1.17+)/Shulker

Contents

Config section format is slot ID and then with item format.

contents:
  1:
    material: STONE
  2:
    material: APPLE
    amount: 5

Brushable Blocks (1.20+)

Content

The loot item inside brushable blocks. Want custom brushable block? Consider buy our CustomArcheology plugin here!

content:
  material: APPLE

Spawner

Only spawner option is required if you want spawner has mobs inside. Other options are optional.

spawner: ZOMBIE
min-delay: 200
max-delay: 800
max-entities: 6
player-range: 16
spawn-range: 30

Ominous Bottle (1.20.5+)

Power

power: 3

Music Instrument (1.18+)

Music

music: PONDER_GOAT_HORN # Music

Repairable

repair-cost: 15

Enchantable (1.21.2+)

enchantable: 15

Glider (1.21.2+)

glider: true

Item Model (1.21.2+)

item-model: 'mycustom:itemmodel'

Tooltip Style (1.21.2+)

tootip-style: 'mycustom:tooltip'

Use Cooldowns (1.21.2+)

use-cooldown:
  cooldown-group: 'minecraft:custom_weapon'
  cooldown-seconds: 1.5

Equippable - Premium

equippable:
  entities: 
    - 'zombie' # Entity Type ID
    - 'skeletons' # Entity Type Tag
  dispensable: true
  swappable: true
  damage-on-hurt: true
  camera-overlay: misc/pumpkinblur
  sound: ambient.basalt_deltas.mood
  model: mycustomarmor
  slot: head

Damage Resistant

damage-resistant: is_fall # Damage Type Tag

Plugin Enchants - UltimateShop-Premium Only

Support AdvancedEnchantments only for now.

Plugin like EcoEnchants, ExcellentEnchants are vanilla enchants like plugin, you just need to put their enchantment ID to enchants option (like above).

You can use plugin-enchants option to add plugin enchants for your item.

plugin-enchants:
  PLANTER: 5 # A AdvancedEnchantments enchantment

Change Item - Require MythicChanger

Support FlipCard, SpinToWin, UltimateShop only

Change the item by MythicChanger, if you are using premium version of MythicChanger, it will allow you use custom NBT tag by adding nbt-xxx rule here. You can also use /mc viewnbt command to view the hold item NBT info.

This feature require your server must install MythicChanger plugin, please get it here:

FREE: Click to download

PREMIUM: Click to download

For how to configure the change-item section, please read MythicChanger's wiki, . Please note that some of the change rules require PREMIUM version of MythicChanger, not PREMIUM version of UltimateShop!

change-item:
  set-name: '&fGood Diamond Sword'