🔧Built-in Placeholders

Available placeholders:

  • {enchants} - Display item's enchantments. We don't auto hide enchants of the item, you have to add HIDE_ENCHANTS flag to item by yourself!

  • {empty_slots} - Display item's empty slots.

  • {enchant_amount} - Display item's enchantment amount.

  • {slot_amount} - Display item's max slot amount.

  • {used_slot_amount}

You can further set options for the {enchants}, {empty_slots} placeholder in auto-lore.placeholder option in config.yml file.

{enchants} Placeholder

Available sub placeholders for {enchants}:

Enchantment Sort for {enchants} Placeholder

EnchantmentSlots supports auto enchantment sort in {enchants} placeholder: we will hook into EcoEnchants v10+ or ExcellentEnchants v4 and use it's API to get enchantment display sort in those plugins, for vanilla enchantments, it's depend on how long it was obtained.

To use this feautre, you need enable sort option in config.yml file.

    placeholder:
      enchants:
        sort: true

Custom Enchantment Name for {enchant_name} sub placeholder

By default, other plugins can not get enchantments name that displayed in client. You have to set them in config.yml to make EnchantmentSlots correctly display enchantment name for custom enchantments. For example of vanilla enchantments:

# Enchant Name
enchant-name:
  # Default providing vanilla enchantments here.
  # For third enchantment plugins:
  # Plugin will auto get enchantment display name that provided by EcoEnchants and ExcellentEnchants
  # If you are not using the 2 plugins, please using "Enchantment Key: Enchantment Display Name" format
  # Like:
  # an_other_enchantment: 'This is just an example here!'
  protection: 'Protection'
  fire_protection: 'Fire Protection'
  feather_falling: 'Feather Falling'
  blast_protection: 'Blast Protection'
  projectile_protection: 'Projectile Protection'
  respiration: 'Respiration'
  aqua_affinity: 'Aqua Affinity'
  thorns: 'Thorns'
  depth_strider: 'Depth Strider'
  frost_walker: 'Frost Walker'
  binding_curse: 'Binding Curse'
  sharpness: 'Sharpness'
  smite: 'Smite'
  bane_of_arthropods: 'Bane of Arthropods'
  knockback: 'Knockback'
  fire_aspect: 'Fire Aspect'
  looting: 'Looting'
  sweeping: 'Sweeping'
  # For 1.21+
  sweeping_edge: 'Sweeping Edge'
  efficiency: 'Efficiency'
  silk_touch: 'Silk Touch'
  unbreaking: 'Unbreaking'
  fortune: 'Fortune'
  power: 'Power'
  punch: 'Punch'
  flame: 'Flame'
  infinity: 'Infinity'
  luck_of_the_sea: 'Luck of the Sea'
  lure: 'Lure'
  loyalty: 'Loyalty'
  impaling: 'Impaling'
  riptide: 'Riptide'
  channeling: 'Channeling'
  multishot: 'Multishot'
  quick_charge: 'Quick Charge'
  piercing: 'Piercing'
  mending: 'Mending'
  vanishing_curse: 'Vanishing Curse'
  soul_speed: 'Soul Speed'
  wind_burst: 'Wind Burst'
  breach: 'Breach'
  density: 'Density'

But, EnchantmentSlots will hook into EcoEnchants v10+ or ExcellentEnchants v4 (v3 is supported in version before 3.2.0) and use it's API to get enchantment name, so if you are using the 2 plugins, you don't need manually set enchantment name at config.yml.

Custom Enchantment Level for {enchant_level} sub placeholder

By default, plugin will print number itself at {enchant_level} sub placeholder, if you want to override the result of this sub placeholder, you can do that in config.yml file.

For example of better number display:

# Enchant Level
enchant-level:
  1: ①
  2: ②
  3: ③
  4: ④
  5: ⑤
  6: ⑥

Custom Enchantment Used Slot Display for {enchant_used_slot} sub placeholder

By default, plugin will print number itself at {enchant_used_slot} sub placeholder, you can override it's result in config.yml file. For example:

# Enchant Used Slot
enchant-used-slot:
  placeholder:
    0: '&c☆'
    1: ''
    2: '&7☆'
    3: '&f☆'
    4: '&e☆'
    5: '&6☆'

Auto Add Space

If enabled, plugin will auto add space if the placeholder has valid result.

    placeholder:
      enchants:
        format: '&6  {enchant_name}{enchant_level}{enchant_used_slot}'
        auto-add-space: true

Last updated