Overview
TokenShop is a comprehensive token economy plugin designed for Minecraft servers, enabling administrators to create dynamic in-game shops where players can purchase a wide variety of items using earned tokens. The plugin provides a seamless shopping experience through an intuitive graphical user interface (GUI), allowing players to browse and buy items without the need for complex commands. With support for categorized shops, players can easily navigate sections such as Blocks, Tools, Armor, and Special items, making the economy feel organized and engaging. TokenShop integrates smoothly with server economies, offering features like token earning through gameplay activities, customizable pricing, and real-time inventory management to prevent overspending or stock depletion.
Beyond player-facing features, TokenShop empowers administrators with powerful in-game editing tools, enabling them to modify shop categories, add or remove items, adjust prices, and update descriptions directly within the game world. This eliminates the need for manual configuration file edits and allows for quick iterations during server events or updates. The plugin also supports optional MySQL database integration for persistent data storage across server restarts, ensuring that player tokens, shop inventories, and transaction histories are securely maintained. Fully configurable through YAML files, TokenShop allows customization of messages, GUI layouts, item displays, and permission nodes, making it adaptable to any server's unique needs while maintaining a granular permission system to control access levels.
Features
- Token Management: Players earn and spend tokens.
- Categorized Shops: Organize items into categories like Blocks, Tools, Armor, and Special.
- GUI Interface: Easy-to-use graphical interface for shopping.
- In-Game Editing: Admins can edit shops directly in-game.
- Drag and drop editor.: drag any item into the GUI and it will save
- Database Support: Optional MySQL integration for data persistence.
- Configurable: Fully customizable messages, items, and GUI elements.
- Permissions: Granular permission system.
- PlaceholderAPI Support: Use placeholders in chat, signs, and other plugins.
Product Options
Compatibility
Screenshots
Documentation
Installation
Configuration Examples
Changelog
TokenShop 3.0
25% on the Main thread
75% is on the async/off-thread
So better performance for your server
before it was 100% on Main Thread!
Added Features
Dynamic pricing with demand, economy, and market multipliers.
Stock Market Board GUI with hottest item, biggest riser, biggest discount, and cheapest item.
Rotating Black Market with timed listings and discount pricing.
Economy Event Engine with weighted random events, price multipliers, category multipliers, and black market rotation effects.
Admin Price Simulator for economy balancing projections.
Bulk purchase GUI: x1, x8, x16, x32, x64, and custom quantity.
Smart category recommendations based on player purchase history.
Multi-currency balances: bronze/silver/gold/event/premium style configurable currencies.
Vault money exchange: tokens to money, money to tokens, and currency-to-currency exchange.
Per-player language selection and persisted locale preference.
PlaceholderAPI placeholders for balances, leaderboards, and market stats.
Web dashboard with embedded/bridge modes, overview, logs, audit, catalog editing, category/item editing, and event editing.
Dashboard admin controls for reloads, event rotation, account/session management, audit logs, and activity history.
More admin diagnostics: /tokenadmin about, /ts debug, /ts debug mysql, /tokenadmin mysqlstatus history.
Fixed
Multi-Server was not working correctly, this should be fixed if not go on discord and open a bug report and I will take a look at it again.
Fixed reload behavior so shops, messages, language files, black market data, and event data refresh together.
Fixed shared-state save ordering for player data/shared YAML so saves do not collide under load.
Fixed async purchase handling so token charges happen off the main thread and failed reward delivery can refund the player.
Fixed bulk/custom shop purchases with quantity clamping, inventory-space checks, and safer total-cost math.
Fixed MySQL instability handling with fallback behavior, recovery tracking, throttled failure logging, and /tokenadmin mysqlstatus.
