Currency and vouchers
By default the shop uses its own currency, Shards. Starting balance, name, display format, maximum balance, payments and vouchers are in the currency section.
currency:
# SHARDS is the built-in currency. VAULT and PLAYERPOINTS charge those plugins instead.
provider: SHARDS
singular: Shard
plural: Shards
# How amounts look everywhere. Placeholders: %amount% %currency%
display-format: "&d%amount% %currency%"
# What new players start with.
starting-balance: 100
# -1 for no maximum.
max-balance: -1
pay:
enabled: true
min-amount: 1
# Percent taken from each payment. 0 for none.
tax-percent: 0
# /shards withdraw turns shards into an item that can be traded.
vouchers:
enabled: true
min-amount: 10
Using Vault or PlayerPoints#
Set currency.provider to VAULT or PLAYERPOINTS and the shop charges that plugin instead. Any economy plugin that is registered with Vault works. If the chosen plugin is not available, the console warns and the plugin falls back to the built-in Shards.
- Vault balances are treated as whole numbers (fractions are rounded down).
- With Vault or PlayerPoints, earning, daily rewards, vouchers,
/shards give|take|setand payments all go through that plugin. - The leaderboard (
/shards top) andstarting-balanceandmax-balanceonly apply to the built-in Shards.
Paying other players#
/shards pay <player> <amount> sends shards, also to offline players who have joined before. currency.pay.tax-percent is taken from each payment, and the receiver gets the amount minus tax. min-amount sets the smallest payment. Turn payments off with pay.enabled: false.
Vouchers#
/shards withdraw <amount> turns shards into a voucher item (needs at least vouchers.min-amount and a free inventory slot). Right-clicking the voucher redeems it. Every voucher has a unique id that can only be redeemed once, so copies are worthless.
Admin changes#
/shards give|take|set <player|*|**> <amount> and /shards reset <player|*|**> change balances. * means everyone online and ** means everyone who ever joined. Reset sets the balance to starting-balance. Amounts accept 5k, 2.5k, 1m and 1b.
Vote plugins and crates can pay with the console command shards give %player% 100.