Minted Free

A GUI-first economy plugin for premium survival and roleplay servers. Status: v0.68.0

Minted ships 1.8 through 1.26 in a single jar. No separate JARs per version, no per-version shims duplicated in feature code. Everything version-sensitive routes through the compat layer, and api-version: 1.13 in plugin.yml opts out of the server's legacy-material mode so modern item names resolve everywhere. On startup Minted self-checks the whole alias table (Material probe: 20/20).

Latest release (with jar attached): https://github.com/IYanel-DEV/Minted-Free/releases

• Two balances - a bank and a wallet per player, with integrations.primary-balance deciding which one Vault, PlaceholderAPI and the public API see.
• Physical cash - paper banknotes you carry and spend (/wallet), with an optional resource pack for custom textures, or a classic digital balance (economy.physical: false). Notes are signed, so edited or forged notes are rejected on redeem.
• Banking - interest, loans with fees and late fees, withdrawal/transfer fees, and player-to-player requests (/pay and the clickable request message).
• Payment source of your choice - /minted source wallet|bank|both. both pays from the wallet and falls back to the full amount from the bank when the wallet cannot cover it. A bank-funded purchase starts a short delivery cooldown (payments.bank-cooldown-seconds, default 7), announced in chat; wallet purchases are never blocked.
• Multi-currency - an optional base currency with exchange rates for shops and auctions (/currency).
• Stats - server-wide totals, rich list and burn tracking (/mstats), and a personal ledger per player (/mhistory).

• Global shops (/eshop) with a seeded, version-safe catalog.
• Community marketplace - anyone lists stock at their own price, with buy-back, stock and earnings tracking.
• Player shops (/pshop) - personal storefronts with their own pages, prices and earnings.
• Auction house (/ah) - timed listings, bids, buyouts, expiry and collection.
• Sell - /sell [amount|all|menu]; sell-all handles every distinct stack you hold in one click.
• Bounties (/bounty) - post, track, claim, refund and expire.
• VIP shops - a VIP who owns a player shop automatically gets a /<username> command that opens it for anyone who types it. Manage VIPs with /minted vip add|remove|list, the dashboard's VIP page, or the minted.vip permission (LuckPerms and friends).

• Admin dashboard (/minted dashboard) - economy overview, VIP manager, account inspector, shop and bounty shortcuts.
• Admin commands - /eco give|take|set|reset, balance export/import, and /minted report for a live look at every integration.
• Bank tellers - self-built ProtocolLib NPCs (/minted npc). No Citizens dependency. New tellers default to a yellow Banker name and a mustachioed bank-man-in-a-suit skin, both configurable under integrations.npcs.
• 12 languages out of the box (English, Arabic, German, Spanish, French, Italian, Japanese, Korean, Polish, Portuguese, Russian, Chinese) with /language and per-player or server-wide selection.

• One jar for Minecraft 1.8 - 1.26. No per-version downloads; everything version-sensitive routes through the compat layer.
• Storage - SQLite out of the box, MySQL/MariaDB for networks. Fully async; the server thread never waits on disk or the network.
• Multi-server networks - point every server at the same MySQL database and enable multi-server: balances are written as atomic deltas (two servers can never overwrite or double-spend each other), players are re-read on join, and optional Redis pub/sub announces changes instantly.
• Public API - MintedAPI/MintedEconomy plus MintedBalanceChangeEvent for your own plugins.
• Custom items - ItemsAdder, Nexo and Oraxen items keep their own identity in shops, /sell and the marketplace (detected automatically, no dependency).
• Integrations - Vault and VaultUnlocked (the vault2 API), PlaceholderAPI, EssentialsX awareness, ProtocolLib, ViaVersion and bStats - every one optional, guarded, and degrading cleanly when absent.

1. Drop Minted-<version>.jar in plugins/ and start the server. SQLite works with zero configuration.
2. Try /minted gui - the personal hub with balance, bank, wallet, stats and requests.
3. /balance, /pay <player> <amount>, /bank, /wallet work immediately.
4. For a network: set database.type: mysql and multi-server.enabled: true on every server (optionally a shared redis:// URI), then check /minted report.

Admin subcommands of /minted: dashboard (admin overview), vip add|remove|list (VIPs and their /username shop commands), npc create|remove|here|list (bank tellers), reload, report.

Everything lives in one commented config.yml; the blocks you are most likely to touch:

database:
  type: "sqlite"          # or "mysql" for networks
  # host / port / database / username / password / pool-size

multi-server:             # shared database across servers
  enabled: false
  redis: ""               # e.g. redis://localhost:6379 (optional)
  save-seconds: 2         # how fast changes reach the database
  refresh-seconds: 15     # self-heal re-read interval

vip:
  enabled: true           # /<username> shop commands

integrations:
  vault:
    register: false       # make Minted the Vault economy provider
  vaultunlocked:
    register: false       # ...on the vault2 API
  customitems:
    enabled: true         # ItemsAdder / Nexo / Oraxen identity

Minted ships one self-test catalogue (dev.minted.selftest) with two runners, so "correct" is defined exactly once:

• At build time - .\mvnw.cmd test (or simply .\mvnw.cmd clean package, which runs it too). Covers the money rules: amount tokens, deposit/withdraw and the cap, the admin-set path, the remote-sync path, and a two-server simulation proving that concurrent balance changes compose instead of overwriting each other, that an overdraft is refused, and that a stale cache can never push a balance past the cap.
• On a running server - /minted selftest (admin) runs the same checks plus the parts only a live server can prove: a real guarded-delta round-trip against your database (cleaned up afterwards), the public economy API, the loaded shop model, every command executor, the VIP list, detected custom-item providers and the Redis announcement channel. Results are printed in chat and logged to the console.

Requires JDK 8+ (JDK 17+ recommended). The wrapper pins Maven for you.

# Linux / macOS
./mvnw clean package

# Windows
.\mvnw.cmd clean package

Output: target/Minted-<version>.jar

• Compile against 1.8.8 API. The pom.xml pins spigot-api:1.8.8 as its only dependency, so everything referenced here is guaranteed to exist at runtime from 1.8 upward. Newer-server material is reached through the compat layer, never through direct API calls.
• api-version: 1.13 in plugin.yml. Opts out of the server's legacy-material mode, so modern Material constants (OAK_PLANKS, RED_WOOL, ...) resolve on the single jar. Paper/Spigot ignore the value on 1.12 and below, so the 1.8 -> 1.26 range is unaffected. MaterialLookup keeps a per-version rename map (e.g. chain -> IRON_CHAIN) and logs a diagnostic probe at startup.
• Fully async storage is a hard requirement from the start; the backend milestone must never touch the main thread on disk or on the wire.
• No required dependencies. Every third-party hook (ProtocolLib, Vault, PlaceholderAPI, ViaVersion) is optional, guarded, and degrades to a sane default when absent.

1. No new Bukkit API call resulting from a later version than 1.8.8 in core code paths - if it is not available on 1.8, it goes behind an adapter.
2. Never couple feature code to org.bukkit.craftbukkit or net.minecraft.* directly. Use dev.minted.util.Reflection.
3. Keep every database operation off the main thread.

• Releases and downloads: https://github.com/IYanel-DEV/Minted-Free/releases
• Source and issues: https://github.com/IYanel-DEV/Minted-Free
• In game, /minted report prints the live state of every integration - the fastest way to diagnose "why isn't X hooked".
• Anonymous usage stats (bStats, id 34228) can be disabled in plugins/bStats/config.yml; no balance or player data is ever collected.