XenoTokens
Advanced Multi-Currency Economy | Shops | Ranges | SQL Storage
XenoTokens (XTK) is an advanced multi-currency economy plugin for servers that need separate currency systems, per-currency shops, player payments, transaction history, and database-backed storage.
Use it when one economy is not enough. Each currency can have its own configuration, earning rules, shop, messages, formatting, payment settings, and player-facing identity.
Features
➼ Multiple currencies running at the same time.
➼ Per-currency configuration folders for currency rules, events, shops, and messages.
➼ Custom currency symbols, names, formats, compact suffixes, starting balances, max balances, and payment rules.
➼ Token system labels and balance ranges for richer progression displays.
➼ Per-currency GUI shops with categories, multiple pages, custom display items, reward items, sounds, and reward commands.
➼ Player payments, balance leaderboards, transaction history, rollback support, and transaction cleanup.
➼ Optional gameplay rewards through per-currency events.yml files.
➼ SQLite, MySQL, and PostgreSQL storage with configurable connection pooling.
➼ Vault-compatible economy bridge.
➼ PlaceholderAPI support with default and currency-prefixed placeholders.
➼ Global token-system GUI for browsing currencies and shops.
➼ Fully configurable messages.
➼ Folia support.
Multi-Currency System
XenoTokens is built around currency folders. Each enabled currency can define its own identity, balance rules, formatting, payment settings, transaction retention, earning rules, shop layout, and language overrides.
Currency aliases can resolve from the currency ID, configured name, and display name, making multi-currency commands and placeholders easier to use.
Shop System
Each currency can have its own GUI shop through gui.yml. Shops can use pages, categories, navigation buttons, filler items, sounds, direct item rewards, console commands, and player commands.
This makes XenoTokens useful for servers that want currencies tied to reward paths, crate rewards, custom-item commands, upgrades, or progression shops.
Event Rewards
XenoTokens can reward currencies from configurable gameplay events. Example sources include mob kills, smelting, movement windows, and timed activity rewards.
Events are configured per currency, so each economy can have its own earning path.
Commands
➼ /balance [currency] [player] - View your balance or another player's balance.
➼ /pay [currency] <player> <amount> [reason] - Send currency to another player.
➼ /shop [currency] [category] [page] - Open a currency shop.
➼ /token balance [currency] [player] - View balances through the main XTK command.
➼ /token baltop [currency] [page] - View top balances.
➼ /token log [currency] [page] [player] - View transaction history.
➼ /token gui - Open the token-system GUI.
➼ /token give [currency] <player> <amount> [reason] - Add currency to a player.
➼ /token take [currency] <player> <amount> [reason] - Remove currency from a player.
➼ /token set [currency] <player> <amount> [reason] - Set a player's balance.
➼ /token reset [currency] <player> - Reset a player to the starting balance.
➼ /token rollback [currency] <transactionId> - Roll back a transaction.
➼ /token reload - Reload the plugin.
➼ /token purge [currency] <days> - Delete old transaction records.
Aliases include /xtk, /tokens, /xenotokens, /xenotoken, /bal, /money, /transfer, /store, and /tienda.
Permissions
➼ xenotokens.command.balance
➼ xenotokens.command.balance.other
➼ xenotokens.command.pay
➼ xenotokens.command.shop
➼ xenotokens.command.baltop
➼ xenotokens.command.transactionlog
➼ xenotokens.command.transactionlog.other
➼ xenotokens.command.gui
➼ xenotokens.command.gui.manage
➼ xenotokens.command.token.give
➼ xenotokens.command.token.take
➼ xenotokens.command.token.set
➼ xenotokens.command.token.reset
➼ xenotokens.command.token.rollback
➼ xenotokens.command.token.reload
➼ xenotokens.command.token.purge
PlaceholderAPI
XenoTokens provides %xtk_*% placeholders for balances, formatted balances, top position, transaction data, currency metadata, token systems, and token ranges.
Currency-prefixed placeholders are also supported, such as %xtk_main_balance_formatted% and %xtk_main_token_range%.
Support
If you find a bug or need setup help, please use the support channels instead of the review section. Include your server version, plugin version, storage type, currency ID, and any relevant logs.