TokensCL 🪙

TokensCL is an ultra-optimized, highly configurable multi-currency economy plugin designed for Minecraft servers. Break away from single-currency limitations by creating, managing, and integrating as many custom tokens as you need—complete with dedicated shops, player-to-player transfers, PlaceholderAPI integration, and advanced purchase limits.

---

✨ Features

• Multi-Currency System: Create distinct custom tokens, each with its own visual prefix, status, and configuration file.
• Command-Panel Style Shops: Configure rich GUI shops per token supporting decor items, purchase limits (allTime, daily, weekly, monthly), and custom permissions.
• Flexible & Independent Purchase Conditions: Shop items can require Tokens (price), Vault Money (money), and/or Vanilla XP (xp). Use any combination or just one—the plugin automatically verifies and deducts all defined costs before completing the purchase.
• Player Transfers (/tokens pay): Allow players to securely send tokens to each other with optional transaction taxes.
• Robust Security & Error Handling: Designed with fault-tolerant mechanics. If a token file or configuration encounters an error, it safely isolates the issue, alerts administrators, and keeps the server running seamlessly without breaking.
• PlaceholderAPI Support: Fully integrated placeholders to display balances, prefixes, and global token stats across scoreboards, holograms, and chat.
• Economy Compatibility: Native hooks for Vault, LuckPerms, and GroupManager.
• Multi-Language Support: Full English codebase with a modular lan/ folder (en.yml and es.yml) for effortless localization.

---

💻 Commands & Permissions

Player Commands

• /tokens shop — Opens the main GUI menu listing all available token shops.
• /tshop — Quick shortcut to open the main token shop menu (or /tshop <token> for a specific shop).
• /tokens shop <token> — Directly opens a specific token's shop menu.
• /tokens pay <player> <token> <amount> — Pay a specific token amount to another player.
• /tokens balance [player] [token] — Check token balances.

Admin Commands (/tokens or /tokenscl)

• /tokens create <name> — Create a new token (integer values only). Perm: tokenscl.admin.create
• /tokens list — View all created tokens. Perm: tokenscl.admin.list
• /tokens give <player> <token> <amount> — Give a specific amount of tokens to a player. Perm: tokenscl.admin.give
• /tokens take <player> <token> <amount> — Take tokens from a player. Perm: tokenscl.admin.take
• /tokens remove <token> — Delete an existing token. Perm: tokenscl.admin.remove
• /tokens reload — Reload configurations and language files. Perm: tokenscl.admin.reload

Admin Permissions

• tokenscl.admin.* — Grants full administrative access to all token management commands.

---

🔌 PlaceholderAPI Placeholders

TokensCL registers comprehensive placeholders under the %playertokens_...% identifier:

• %playertokens_<token>% — Displays the player's balance for a specific token.
• %playertokens_<token>_formatted% — Displays the balance formatted with thousands separators.
• %playertokens_<token>_prefix% — Displays the colored visual prefix of the token.
• %playertokens_<token>_enabled% — Returns whether the token is currently active (true/false).
• %playertokens_count% — Total number of registered tokens.
• %playertokens_list% — Comma-separated list of all token IDs.

---

📥 Installation

1. Download TokensCL.jar and place it in your server's plugins/ directory.
2. Ensure Vault (and an economy provider) is installed for monetary rewards and money costs. (PlaceholderAPI is optional).
3. Start the server to generate the default configuration, language files (lan/en.yml, lan/es.yml), and the default example token (tokens/example.yml).
4. Customize your tokens and shops in the plugins/TokensCL/tokens/ folder!