TokenShop

Discord Support: Support
This require VaultUnlocked or Vault and PlaceholderAPI to be installed.
Purpur is supported!

Total Download reached
10 Thank you for downloading this plugin!
20
30
40

In Version 3.0 your TokenShop folder needs to be deleted so the new files can get installed.


If you get this message, ignore it. It is doing nothing and not hurting your server.
[HorriblePlayerLoginEventHack] You have plugins listening to the PlayerLoginEvent, this will cause re-configuration APIs to be unavailable:
This is from Paper they remove PlayerLogin Event.

TokenShop 3.0

TokenShop is a token economy and GUI shop plugin built for modern Spigot, Paper, and Purpur servers. It gives players a clean menu-based shop where they can spend tokens, browse categories, buy in bulk, check balances, use multiple currencies, and exchange tokens with Vault money when you want that style of economy.
For owners and staff, TokenShop is meant to be practical day to day. You can edit shop layouts in game, manage player balances, reload shop data, watch market movement, rotate black market offers, and use the admin price simulator before making economy changes that affect the whole server.

Version 3.0 also adds more serious backend tools for larger servers. You can run with YAML or MySQL storage, use shared MySQL state across servers, enable an embedded or bridge dashboard, track audit/activity history, and expose PlaceholderAPI values for scoreboards, menus, websites, or chat formatting.

Features
- Category-based token shop GUI with clean navigation
- Multi-page shop categories
- In-game live shop editor
- Drag-and-drop layout editing
- Save validation, undo/redo, and edit locks for safer admin editing
- Configurable shop items from `shops.yml`
- Custom display items saved separately from base shop config
- Command rewards after purchase
- Command-only shop items for crates, ranks, kits, money, permissions, and other server rewards
- Configurable purchase click mode
- Bulk buying menu with x1, x8, x16, x32, x64, and custom quantity
- Smart category recommendations based on recent player purchases
- Multi-currency token system
- Configurable currency names, symbols, and active states
- Admin currency management commands
- Vault/VaultUnlocked money exchange
- Token-to-money, money-to-token, and token-to-token exchange support
- Dynamic pricing based on demand, economy pressure, and market movement
- Stock Market Board with hottest item, biggest riser, biggest discount, and cheapest item
- Rotating Black Market with timed discounted listings
- Economy Event Engine with weighted random events
- Event multipliers for global prices, category prices, and black market rotation speed
- Admin Price Simulator for testing economy balance before changing prices
- Per-player language selection
- Persistent locale preference
- PlaceholderAPI expansion for balances, leaderboards, and market stats
- Spigot update checker with admin notification permission
- bStats support
- YAML or MySQL player data storage
- Shared MySQL state for shop displays, prices, events, and black market data
- Async I/O with configurable worker threads
- MySQL status, recovery, and failure history diagnostics
- Optional embedded web dashboard
- Optional bridge dashboard mode for external hosting
- Dashboard login, sessions, password tools, audit logs, and activity history

Player Commands
- `/tokenshop` - Open the main shop
- `/tokenshop market` - Open the Stock Market Board
- `/tokenshop blackmarket` - Open the Black Market
- `/tokens` - Check your default balance
- `/tokens <player>` - Check another player's default balance
- `/tokens <currency>` - Check one of your currency balances
- `/tokens currencies` - List enabled currencies and your balances
- `/tokens top5` - Show the top 5 balances
- `/tokens top10` - Show the top 10 balances
- `/tokens rate` - Show default exchange rates
- `/tokens rate <fromCurrency> <toCurrency>` - Show a token-to-token exchange rate
- `/tokens exchange toMoney <amount>` - Convert default tokens into Vault money
- `/tokens exchange toMoney <currency> <amount>` - Convert a specific currency into Vault money
- `/tokens exchange toTokens <amount>` - Buy default tokens with Vault money
- `/tokens exchange toTokens <currency> <amount>` - Buy a specific currency with Vault money
- `/tokens exchange <fromCurrency> <toCurrency> <amount>` - Convert one token currency into another
- `/tokens language <locale>` - Set your language
- `/tokens language auto` - Reset language detection back to automatic

Admin Commands
- `/tokenadmin` - Open the admin menu
- `/tokenadmin menu` - Open the admin menu
- `/tokenadmin about` - Show plugin, server, database, and hook information
- `/tokenadmin give <player> <amount>` - Add default tokens
- `/tokenadmin take <player> <amount>` - Remove default tokens
- `/tokenadmin set <player> <amount>` - Set a default token balance
- `/tokenadmin currency <give|take|set> <player> <currency> <amount>` - Manage a specific currency balance
- `/tokenadmin open <player>` - Open the shop for a player
- `/tokenadmin editor <category>` - Open the live editor for a category
- `/tokenadmin reload` - Reload configuration, language, shop, event, and market data
- `/tokenadmin mysqlstatus` - Show live MySQL/fallback/recovery status
- `/tokenadmin mysqlstatus history` - Show recent MySQL events
- `/ts debug` - Run a general diagnostic report
- `/ts debug mysql` - Run a MySQL diagnostic report
- `/tokenadmin dashboard status` - Show dashboard runtime status
- `/tokenadmin dashboard setlogin <user> <pass> [role]` - Set a runtime dashboard login
- `/tokenadmin dashboard resetpassword [user] [role]` - Generate a new dashboard password

Aliases
- `/token`
- `/tokenbalance`
- `/tokensadmin`
- `/ts`
- `/tshop`
- `/shoptokens`

Permissions
- `tokenshop.use` - Access `/tokenshop`
- `tokenshop.tokens` - Access `/tokens`
- `tokenshop.tokens.others` - View other player balances
- `tokenshop.admin` - Access admin commands and admin GUI tools
- `tokenshop.notifyupdate` - Receive update notifications

PlaceholderAPI Placeholders

Balance
- `%tokenshop_balance%`
- `%tokenshop_balance_formatted%`

Leaderboard
- `%tokenshop_tokentop5%`
- `%tokenshop_tokentop10%`
- `%tokenshop_top_<position>%`
- `%tokenshop_top_<position>_name%`
- `%tokenshop_top_<position>_balance%`
- `%tokenshop_top_<position>_balance_formatted%`

Market
- `%tokenshop_market_hottest%`
- `%tokenshop_market_hottest_item%`
- `%tokenshop_market_hottest_name%`
- `%tokenshop_market_hottest_cost%`
- `%tokenshop_market_biggest_riser%`
- `%tokenshop_market_riser%`
- `%tokenshop_market_biggest_riser_name%`
- `%tokenshop_market_biggest_riser_cost%`
- `%tokenshop_market_biggest_discount%`
- `%tokenshop_market_discount%`
- `%tokenshop_market_biggest_discount_name%`
- `%tokenshop_market_biggest_discount_cost%`
- `%tokenshop_market_cheapest%`
- `%tokenshop_market_cheapest_item%`
- `%tokenshop_market_cheapest_name%`
- `%tokenshop_market_cheapest_cost%`

Dependencies and Hooks
- Soft depends: `VaultUnlocked`, `Vault`, `PlaceholderAPI`

Storage
- Storage mode is configurable in `config.yml`: `YAML` or `MYSQL`
- YAML mode uses local plugin files such as `playerdata.yml`, `shop-display-items.yml`, `shops.yml`, `messages.yml`, and `lang.yml`
- MySQL mode stores player balances and shared state for multi-server setups
- Async I/O keeps heavier save work away from the main server thread


Kind Notes
- Built for modern 1.21+ server software
- After editing `shops.yml` manually, run `/tokenadmin reload`
- Stock Market, Black Market, Admin Price Simulator, Economy Event Engine, dashboard, currencies, and exchange features can be enabled or disabled in `config.yml`
- Economy events are configurable with weights, multipliers, category overrides, and black market rotation effects
- Keep the embedded dashboard bound to `127.0.0.1` unless you intentionally put it behind a proxy
- Replace default dashboard passwords and secrets before exposing dashboard access