BitAspire Wiki
XenoTokensXenoTokens

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, and lang.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, or Diamond Coin.

File layout

XenoTokens uses both global files and per-currency folders:

  • plugins/XenoTokens/config.yml controls global currency registration, database settings, offline-target behavior, and autosave.
  • plugins/XenoTokens/lang.yml controls shared messages and fallback text.
  • plugins/XenoTokens/currencies/<id>/currency.yml defines names, format, payments, transactions, and representation ranges.
  • plugins/XenoTokens/currencies/<id>/events.yml defines how that currency is earned.
  • plugins/XenoTokens/currencies/<id>/gui.yml defines the shop for that currency.
  • plugins/XenoTokens/currencies/<id>/lang.yml lets you override language strings per currency.
  1. Start the server once so XenoTokens generates config.yml, lang.yml, and the default currencies/main files.
  2. Pick the default currency in config.default-currency.
  3. Review config.currencies and enable only the currency folders you actually want to load.
  4. Configure currencies/main/currency.yml before touching shop or event logic.
  5. 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.

Last updated on

On this page