Format & Display

Each currency can have its own unique display name, formatting, and prefix.

Core Settings

All text settings below fully support MiniMessage for beautiful gradients, colors, sprites, etc. You can edit them directly in your Currency File.

Option	Description
Name	The display name used in messages (via `%currency_name%`) and as the economy name when hooked with Vault.
Symbol	The visual character (e.g., `$`) used via the `%currency_symbol%` placeholder.
Format	Controls how balance values appear to player.
Format_Short	Controls how balance values appear to players in a "compact" form.

Example - shards.yml
Name: Shards
Symbol: <sprite:"items":"item/amethyst_shard">
Format: <c:soft_purple>%amount%%currency_symbol%</c>
Format_Short: <c:soft_purple>%amount%%currency_symbol%</c>

Tip #1

Properly configuring these settings ensures a seamless experience when third-party plugins display your currency data.

Tip #2

You can use any Currency and non-player PlaceholderAPI placeholders in Format and Format_Short fields.

Custom Prefixes

The Prefix feature allows each currency to have its own unique tag in chat messages.

1. Enable the Feature

First, enable prefixes in your config.yml:

Currency:
  Prefix:
    Enabled: true
    Format: '<gray>[<white>%currency_prefix%</white>]</gray> '

The Format setting above defines the global format for all currency tags.

2. Set the Currency Prefix

Next, edit the Prefix value inside your specific Currency File. This value replaces the %currency_prefix% placeholder in the global format above.

Total Control: If you want each currency to look completely different, set the global Format to only contain %currency_prefix%. Then, you can define the entire style (colors, brackets, etc.) inside each individual currency file.