Getting Started
First steps for understanding XenoTokens, its currency folders, and its shop-ready economy model.
What is XenoTokens?
XenoTokens is the advanced token branch built around multiple currencies, per-currency configuration folders, event-based earning, and GUI shops. It keeps the balance and transaction features of a token economy, but adds separate currency identities and a stronger presentation layer.
What makes it different from CyberTokens
- More than one currency can be enabled at the same time.
- Each currency has its own
currency.yml,events.yml,gui.yml, andlang.yml. - Placeholder values can target a specific currency by prefix.
- Shops are configured per currency instead of being bolted onto one global balance.
- Currency folders can expose their own token system labels and balance ranges like
Silver Coin,Golden Coin, orDiamond Coin.
File layout
XenoTokens uses both global files and per-currency folders:
plugins/XenoTokens/config.ymlcontrols global currency registration, database settings, offline-target behavior, and autosave.plugins/XenoTokens/lang.ymlcontrols shared messages and fallback text.plugins/XenoTokens/currencies/<id>/currency.ymldefines names, format, payments, transactions, and representation ranges.plugins/XenoTokens/currencies/<id>/events.ymldefines how that currency is earned.plugins/XenoTokens/currencies/<id>/gui.ymldefines the shop for that currency.plugins/XenoTokens/currencies/<id>/lang.ymllets you override language strings per currency.
Recommended first setup flow
- Start the server once so XenoTokens generates
config.yml,lang.yml, and the defaultcurrencies/mainfiles. - Pick the default currency in
config.default-currency. - Review
config.currenciesand enable only the currency folders you actually want to load. - Configure
currencies/main/currency.ymlbefore touching shop or event logic. - Test
/money,/pay,/shop, and placeholders with at least one player account before adding more currencies.
Bundled defaults
XenoTokens ships with a main currency and a disabled custom example. The easiest workflow is to duplicate the example structure and then rename it cleanly.
Documentation Tree
Start here to understand how XenoTokens is organized and which pages matter first.
Supported Plugins
Review the integrations that matter around XenoTokens and its multi-currency shop flow.
Last updated on