coins.yml

The Coins System provides a customizable virtual currency used for shops, rewards, and other plugin features. All settings are defined in:

/plugins/CrisStealCore/
 ├── coins.yml

⚙️ Configuration Example

name: "Coins"
symbol: "⛁"

format:
  use-thousands-separator: true
  decimals: 2
  short-scale:
    enabled: true
    k: "K"
    m: "M"
    b: "B"

messages:
  disabled: "&cCoins system is disabled."
  balance-header: "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  balance-title: "&6&l%currency% &7Balance"
  balance-amount: "&7Your balance: &6%symbol% %amount%"
  balance-footer: "&7Use &f/heart shop &7to spend your coins!"
  balance-separator: "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

💎 Configuration Options

Key
Description

name

Display name of the currency (e.g. “Coins”).

symbol

Symbol used before amounts (e.g. “⛁”, “$”, or “💰”).

format.use-thousands-separator

Whether numbers include commas (e.g. 1,000).

format.decimals

Number of decimal places to show.

format.short-scale.enabled

Enables short scale formatting (K, M, B).

format.short-scale.k/m/b

Custom suffixes for thousands, millions, billions.

messages.*

Messages shown when checking or displaying balances.


🪙 Example Balance Display

When a player checks their balance (e.g. with /coins):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 Coins Balance
Your balance: ⛁ 12.5K
Use /heart shop to spend your coins!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 Admin Command

Command:

/criscoreadmin currency <give|take|set|view> <player> [amount]

Description

This command allows server administrators to manage players’ coin balances.

Subcommand
Description
Example

give

Adds coins to a player.

/criscoreadmin currency give Steve 500

take

Removes coins from a player.

/criscoreadmin currency take Alex 250

set

Sets a player’s coin balance to a specific amount.

/criscoreadmin currency set Player 1000

view

Views a player’s current balance.

/criscoreadmin currency view Steve

💡 All amounts support decimal values and respect the formatting defined in coins.yml.

Last updated