> For the complete documentation index, see [llms.txt](https://docs.xshyo.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xshyo.us/premium-plugins/shopmaster/economy-symbols-configuration.md).

# Economy Symbols Configuration

### 📘 Description

This configuration allows you to define how currency symbols are displayed for different types of in-game economies. You can set a default symbol, control its position relative to the value, and assign unique symbols to each registered economy.

***

### 📁 Configuration Example

```yaml
economy:
  # Defines the default currency symbol for the main economy (Vault)
  default-symbol: "$"

  # Currency symbol position
  # true = symbol appears before the value ($100)
  # false = symbol appears after the value (100$)
  symbol-before: true

  # Custom symbols for different server economies
  symbols:
    vault: "$"      # Main server currency
    tokens: "✦"     # Special tokens for events or rewards
    gems: "💎"       # Gems for premium purchases
    crystals: "✧"   # Crystals for special upgrades
    points: "Pts"   # Points for rank or achievement systems
```

***

### ⚙️ Options

#### `default-symbol`

* **Type**: `string`
* **Description**: The default symbol used when no custom symbol is defined for an economy.
* **Example**: `"$"`

***

#### `symbol-before`

* **Type**: `boolean`
* **Description**: Determines the position of the symbol relative to the number.
  * `true`: Symbol appears **before** the value (`$100`)
  * `false`: Symbol appears **after** the value (`100$`)

***

#### `symbols`

* **Type**: `map`
* **Description**: A list of custom symbols for each economy.
* **Usage**: Each key represents an economy name, and its value is the symbol to use.

| Economy    | Description                           | Symbol | Example  |
| ---------- | ------------------------------------- | ------ | -------- |
| `vault`    | Main server currency                  | `$`    | `$100`   |
| `tokens`   | Used for rewards, events, etc.        | `✦`    | `✦500`   |
| `gems`     | Used for premium items or cosmetics   | `💎`   | `💎10`   |
| `crystals` | Used for special upgrades or crafting | `✧`    | `✧25`    |
| `points`   | Rank points or achievement systems    | `Pts`  | `100Pts` |

> 🔄 You can add more currencies if your plugin supports them. Just make sure the economy name matches its registered ID in your system.

***

### 💡 Tips

* Use intuitive and easily recognizable symbols to avoid confusion.
* Double-check the economy names match those used by other plugins (e.g., Vault, PlayerPoints, etc.).
* If a symbol does not appear in-game, verify that it’s correctly configured in both the plugin and the messages that display balances.