# Currency

The Currency plugin adds a wallet-based currency system to your game. Define multiple currency types with display formatting, symbols, and max limits. Characters hold currencies in wallets that support adding, removing, transferring, and automatic overflow conversion between currencies. The plugin integrates with the Items plugin through currency item types and with the Quests plugin through quest objectives and rewards.

In the Spark Editor, the Currency plugin is organized into these categories:

| Category                                                                 | What it contains                                                                                                                                                                           |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Currencies](/documentation/user-guide/plugins/currency/currencies.md)   | Currency entries with symbols, max amounts, display formatting, and starting values; WalletEntity setup; currency triggers and requirements; quest integration; UI components; persistence |
| [Conversions](/documentation/user-guide/plugins/currency/conversions.md) | Conversion entries defining exchange rates between currencies; automatic overflow conversion; conversion chains                                                                            |


---

# 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.sparkframework.dev/documentation/user-guide/plugins/currency.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.