Shards

Shards are a built-in second currency, stored in the Storefront database. Any shop or item shop item can be priced in shards.

Commands

Command	Purpose	Permission
`/shards`	Show your balance.	`storefront.shards`
`/shards <player>`	Show another player's balance.	`storefront.shards.others`
`/shards pay <player> <amount>`	Send shards to an online player.	`storefront.shards.pay`
`/shards top`	Shard leaderboard.	`storefront.shards.top`
`/shards give\|take\|set <player> <amount>`	Change a balance (also from console).	`storefront.shards.admin`

Payments

Key (`pay:` under `shards:`)	Meaning
`enabled`	Off by default. Turn on to allow `/shards pay`.
`minimum`	Smallest payment.
`cooldown-seconds`	Time between two payments by the same player.
`tax-percent`	Percentage removed from each payment (0-90).
`confirm-above`	Payments of at least this amount must be confirmed by running the command again.

Other settings

starting-balance: 0 under shards:: shards every new player starts with.
log-changes: true under shards:: keep a history of every change in the database.
size: 10 and refresh-seconds: 60 under top: (inside shards:): leaderboard length and refresh rate.
compact-numbers: show 1.2K / 3.4M instead of full numbers.

Kill rewards

Players earn shards for killing other players. The killer sees the amount above the hotbar.

Key (`kill-rewards:` under `shards:`)	Meaning
`enabled`	Turn kill rewards on or off.
`amount`	Shards per kill (default 10).
`same-victim-cooldown-seconds`	No reward for killing the same player again within this time (default 300). 0 = off.
`ignore-same-ip`	No reward when killer and victim connect from the same IP address.
`sound`	Optional sound for the killer.

Shard booster

/storefront booster give <player> [amount] [multiplier] [hours] gives a booster item (x4 for 24 hours by default). The player right clicks it to multiply their shard arena payouts for the duration. Only one booster runs at a time, and it is saved in the database, so it survives restarts and works across servers on MySQL. Set affects-kill-rewards: true under shard-booster: to boost kill rewards too. Configure the item under shard-booster in config.yml.

Sharing balances

With type: mysql under storage: on every server, balances are shared. Every change is a single safe database update, so balances can never go negative or be spent twice across servers.