Currencies & Ranges

Understand the global registry, per-currency folders, aliases, and token representation ranges.

XenoTokens resolves currencies in two layers: the global registry in config.yml, and the folder-based files under currencies/<id>/.

Global registry

config.currencies is where you decide which currency IDs should be loaded at all.

Field	Purpose
`enabled`	Turns a currency on or off without deleting its folder
`name`	Human-friendly name used for alias resolution
`display-name`	Display-oriented name that can also resolve as an alias

The default currency is selected with config.default-currency.

Each currency ID should have a folder like this:

If currency.yml is missing, that currency is skipped.

XenoTokens resolves currencies by:

That alias flow is what lets commands and placeholders accept more than one spelling for the same currency.

currency.yml can expose a presentation system such as Coin, plus ranges based on the player's current balance.

Example idea:

This affects placeholders like %xtk_token_system% and %xtk_token_range%, plus any shop message or reward command that uses the same values.