Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for TMDevelopment

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

Report FlareTokens?

Minecraft Platforms Java License


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 2h lowers 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 / else blocks 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

  1. Put FlareTokens-<version>.jar in plugins/
  2. Start the server: all files are created automatically
  3. Build your store in game with /tokens editor and 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.

Information

Category
Admin Tools
Published
October 25, 2026
License
7Downloads
0Stars

Pinned Versions

Members

1