💎 Item Currencies

#Item Currencies

An Item currency makes players pay with an item they carry, such as emeralds, a custom coin or a named token, instead of money. This is a Premium feature and needs no other plugin.

Each shop, category or item gets its own Item currency, so a shop can be priced in diamonds while one of its categories is priced in emeralds.

#Currency Item

Pick the Item type on the shop, category or item, right-click it, and drop the item players should pay with into the slot. Only one of it is stored, whatever the stack size. Right-click the slot to get a copy of the stored item.

Name, lore, enchantments and custom data are kept, so a renamed paper can be a voucher that plain paper does not count as.

The same screen changes the stored item's name and lore without dropping it in again. MiniMessage, & codes and hex colours all work.

#Paying and Being Paid

Items are whole numbers, so a decimal price is rounded up when a player pays and down when a player is paid. Paying takes matching items from anywhere in the inventory. Being paid puts the items into the inventory, and anything that does not fit is dropped at the player's feet.

Prices are written as the amount followed by the item's name, such as 12 Emerald. The item's own name is used with its colours. Set Currency Display on the same screen to write a different name instead, such as &fDiamond Sword for an item named &c&lDIAMOND SWORD. Item prices are whole numbers, so this type has no Currency Format.

#In the Shop File

currency:
  type: ITEM
  identifier: item_shop
  item:
    display-name: Emerald
    material: EMERALD
    item-data: ''
    match: EXACT