# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xshyo.us/premium-plugins/shopmaster/economy-symbols-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.