> For the complete documentation index, see [llms.txt](https://stellarskills.gitbook.io/stellarskills-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stellarskills.gitbook.io/stellarskills-docs/configuration/currencies-and-disabling.md).

# currencies and disabling

Currencies are defined in `currencies/*.yml`. A tree/node cost, class starting grant, level reward, or Journey reward must refer to an existing currency ID.

| Currency field                 | Current role                                                                         |
| ------------------------------ | ------------------------------------------------------------------------------------ |
| `id`                           | Stable currency key                                                                  |
| `title`, `description`, `icon` | Presentation                                                                         |
| `balance-cap`                  | Maximum held balance used by supported grant/purchase paths                          |
| `lifetime-cap`                 | Parsed descriptor; do not assume a global enforced lifetime reward ceiling           |
| `sources`                      | Legacy reference/earning configuration; not a complete dynamic currency event engine |

Packaged `skill_points` is the usual level-reward/purchase currency. Its description and legacy source map predate XP-first quests. Changing those descriptions does not change the progression pipeline.

`general.starting-balance` controls initial balance setup. A class `starting-rewards` grant is separate and one-time. For a strict zero-point start, review both places and the leveling rewards. Adding a currency file does not automatically make every event award that new currency.

## Switch matrix

| What to stop               | Where to change it                                                | What remains                                         |
| -------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------- |
| Class gating               | `classes.yml` `enabled` / `required-for-progression`              | Stored class history/ranks are not erased            |
| A class                    | Its `enabled` field                                               | History and balances remain                          |
| New leveling awards        | `leveling.yml` `enabled` and unwanted source `enabled` fields     | Direct admin recovery paths/history are separate     |
| One quest                  | Its `enabled: false`                                              | Saved progress is retained                           |
| Quest-only economy         | Disable automatic XP sources and other direct grants deliberately | Quests still pay configured XP                       |
| A tree's purchases/refunds | Set its lifecycle away from active                                | Stored ranks remain; test effect access policy       |
| A node benefit             | Remove/reconfigure its specific effect or supported eligibility   | Node history does not disappear automatically        |
| A Journey module           | Module `enabled: false`                                           | Other modules remain enabled                         |
| A Journey entry            | Entry `enabled: false`                                            | Its prior history remains                            |
| Public ranking families    | `include-*` / class filters / module enabled                      | Player XP still records                              |
| Ranking decoration/audio   | Specific `ui-*` / `sound-*` settings                              | Rank math is unchanged                               |
| Hero rarity                | Per-class `hero.enabled` / odds / holder policy                   | Existing stored fates need deliberate review         |
| Global Hero clip           | `global-roll-sound: none` or zero volume                          | Local reveal sound controlled separately             |
| RPG HUD/studio             | Both general HUD switches and default enabled false               | Journey tracker is separate                          |
| Cost bypass                | General opt-in false and no granted bypass permission             | Ordinary paid allocation                             |
| Reward commands            | Suite `allow-reward-commands: false`                              | Permission-provider commands are a different feature |

{% hint style="warning" %}
Do not assume every reference YAML `enabled` key is consumed. In particular, integration reference files are informational; editing them cannot prevent an external mod from calling the API. Use the actual graph/module/source definitions and integration-owned controls.
{% endhint %}

{% hint style="warning" %}
Disabling or removing a definition is not an automatic refund/migration procedure. Back up and inspect affected players before reusing IDs or deleting large tree branches.
{% endhint %}