💰 Currencies

#Currencies

Every price in the plugin is paid in a currency. A shop always has one, and a category or an item can set its own on Premium. Whatever does not set one uses the one above it: an item falls back to its category, and a category to its shop.

A type whose plugin is not installed, or that needs Premium on Lite, is skipped when you swap through the types in the editor.

#In the Shop File

The currency is a block with its type on the shop, the category or the item. A category or item without a block uses the one above it.

currency:
  type: EXCELLENTECONOMY
  identifier: gems

The type is one of VAULT, PLAYERPOINTS, VOTINGPLUGIN, EXCELLENTECONOMY, EXPERIENCE, PLACEHOLDER or ITEM. ExcellentEconomy, Placeholder and Item also take an identifier naming which currency of that type to use, and Placeholder and Item currencies are written out in full in the same block, shown on their own pages.

#When a Plugin Is Missing

A shop priced in a currency the server cannot pay in does not open, and tells the player which plugin is missing. An item priced in such a currency is hidden from its shop until the plugin is installed, and /sell skips it.

#Whole Numbers and Decimals

Vault, Placeholder and decimal ExcellentEconomy currencies accept decimal prices. PlayerPoints, VotingPlugin, Experience, Item and whole-number ExcellentEconomy currencies are whole numbers only: a decimal price is rounded up when the player pays and rounded down when the player is paid, so 2.5 costs 3 and pays 2. The rounded amount is the one named in the transaction message, stored in the history and moved back by undo.

#Currencies Screen

Editor > Settings > Currencies lists every currency the server knows, with the plugin behind it and whether that plugin is installed. Placeholder currencies can be created, edited and deleted from here. The other types are built in and only listed.

#Navigation