A token currency for your server: in-game store with drag & drop editor, sales, MySQL sync.

How it works
Players get tokens when they join for the first time, kill mobs, vote or buy them on your web store,
and can send them to each other with /tokens pay. They spend them in your in-game store:
/tokens shop
- every file in
shops/is a page of the store: a hub with categories, ranks, kits, keys, items... - a product has a price, gives items and runs commands, with an optional confirm menu, limit per player (once, per day, week or month) and stock for the whole server
/tokens sale 20 2hlowers every price by 20% for 2 hours (also on one shop only)- with MySQL every server of your network has the same balances, history, sales and stock
Features
- Tokens balance for every player, with first-join tokens,
/tokens pay(also to offline players), a top menu and the history of every token got and spent - In-game store: as many menus as you want, linked with
[open] <menu>and[back] - Drag and drop editor (
/tokens editor): move items, add glass and buttons, link menus and sell the item in your hand with its enchantments and name. Price, limit, stock and permission from a menu, no YAML needed /tokens settings: every option in one menu, plus what normal players can use- Timed sales with an announcement and placeholders for scoreboards
- Network coin: balances changed on another server show up within about a second, with the "You received ..." message. Web stores can give tokens by name or UUID, also to offline players
- Action language:
[buy(tokens)] 100,[CONSOLE],[MESSAGE],[TITLE],[ACTIONBAR],[BOSSBAR],[SOUND],[tokens_give],[money_give],[SWITCH_SERVER],[DELAY],if / elseblocks and checks - Cheques:
/tokens withdraw <amount>turns tokens into an item, right click to redeem - Mob drops: tokens for kills with chance, random amounts, permission multipliers, spawner and world filters
- Storage: YAML, SQLite or MySQL/MariaDB
- Hex colors, gradients, rainbow, click & hover in every text (MiniMessage and
&codes) - PlaceholderAPI placeholders and an API for developers
- Safe updates: new options and messages are added to your files, your edits are never touched
Compatibility
| Server | Paper, Spigot, Purpur and other forks |
| Versions | 1.8.8 → 26.x (one jar for all) |
| Java | 8 or newer |
| Network | BungeeCord / Velocity: install it on the game servers, not on the proxy |
| Optional | PlaceholderAPI, Vault + an economy plugin, ItemsAdder, ExecutableItems |
Installation
- Put
FlareTokens-<version>.jarinplugins/ - Start the server: all files are created automatically
- Build your store in game with
/tokens editorand set the options with/tokens settings
If PlaceholderAPI is missing, it is downloaded and started by itself (turn it off with auto-install in config.yml).
Updating from FlareTokens 3.x: just replace the jar. Balances are not touched, shops and old cheques keep
working, and your old files are saved in backup-3.x/.
Commands
Main command /tokens. Also /flaretokens, /token, /ftokens, /ftoken, /ft, /coins.
| Command | Description | Permission |
|---|---|---|
/tokens [balance] [player] |
See a balance | flaretokens.command.balance |
/tokens pay <player> <amount> |
Send tokens | flaretokens.command.pay |
/tokens withdraw <amount|all> |
Tokens into a cheque | flaretokens.command.withdraw |
/tokens menu |
Balance, shop, top and history in one menu | flaretokens.command.menu |
/tokens shop [shop] [player] |
Open a shop | flaretokens.command.shop |
/tokens top |
Richest players | flaretokens.command.top |
/tokens history [player] |
Tokens got and spent | flaretokens.command.history |
/tokens give|remove|set <player> <amount> |
Edit a balance | flaretokens.command.give ... |
/tokens sale <percent> <time> [shop] |
Timed sale (sale stop to end it) |
flaretokens.command.sale |
/tokens settings |
Every option in a menu | flaretokens.command.settings |
/tokens editor [menu] |
Edit menus and shops in game | flaretokens.command.editor |
/tokens migrate <yaml|sqlite|mysql> |
Copy all balances to another storage | flaretokens.command.migrate |
/tokens reload |
Reload the files | flaretokens.command.reload |
/tokens version |
Version and update check | flaretokens.command.version |
flaretokens.admin gives every permission, flaretokens.player every player command.
Amounts accept 1k and 2.5m, <player> can also be a UUID.
Placeholders
| Placeholder | Value |
|---|---|
%flaretokens_tokens% |
balance |
%flaretokens_tokens_formatted% |
1.2k, 3.4M... |
%flaretokens_tokens_commas% |
1,234,567 |
%flaretokens_position% |
position of the player in the top |
%flaretokens_top_<n>_name% / %flaretokens_top_<n>_tokens% |
top players |
%flaretokens_sale% / %flaretokens_sale_time% |
discount of the timed sale / time left |
Files
| File | Content |
|---|---|
config.yml |
storage, network, player access and every other option |
lang/en.yml |
chat messages |
shops/*.yml |
your store: one file for every menu |
menus/*.yml |
plugin menus (main menu, top, history, confirm, admin) |
shop-texts.yml |
default price, sale and limit lines of the products |
drops.yml |
tokens for mob kills |
Every file starts with a short explanation of its options.
Anonymous statistics
This plugin sends anonymous usage statistics to TMDevelopment every 30 minutes:
plugin version, Minecraft version, server software, Java version, CPU core count,
online player count, online/offline mode and a random server id generated on your server.
The country of the server is derived from its IP address (only the country code is kept).
Each plugin can also send a few anonymous settings of its own
(FlareTokens: storage type, number of shops and whether drops are on).
No player names or UUIDs, no IP addresses (they are never stored), no chat, world or config data.
Data of a server is deleted 30 days after its last report; only anonymous totals are kept.
We use it to know which versions to support.
You can turn it off for all TMDevelopment plugins in plugins/TMDStats/config.yml (enabled: false),
or only for FlareTokens with stats: false in config.yml.
The update check only reads the latest release from GitHub: nothing is sent (update-check: false to turn it off).
Support
Bugs and ideas: GitHub issues or Discord.
License
MIT © TMDevelopment. Originally created by Maiky (FlaresDevelopment), rebuilt and continued by TMDevelopment.
Pinned Versions
- R1.8–26.3
Pages
Members
1Owner