⚡ What is SmartCurrency?

SmartCurrency is the next generation of SmartEconomy - completely rewritten from the ground up to be faster, cleaner, and more powerful than ever before.

Whether you need a simple server economy or a rock-solid foundation for shops, jobs, and rewards systems, SmartCurrency delivers without the bloat.

If you used SmartEconomy before, you'll feel right at home, but everything under the hood is brand new.


✨ Features

• ⚙️ Full Vault Integration - Works seamlessly with any Vault-compatible plugin (ShopGUI+, Jobs Reborn, DeluxeMenus, and more).
  
• PlaceholderAPI Support - Rich set of placeholders for scoreboards, holograms, and tab lists.
  
• Daily Rewards - Configurable automatic daily bonus with cooldown timer.
  
• Player-to-Player Payments - Secure money transfers with optional tax system.
  
• Balance Leaderboard - Paginated /balancetop with async-cached updates.
  
• ️ Admin Controls - Give, take, set balances, view economy stats, remove bounties, and reload config on the fly.
  
• Flexible Storage - Choose between flat-file YAML or MySQL with HikariCP connection pooling.
  
• Smart Config Updater - New config entries are added automatically on updates without ever overwriting your custom settings.
  
• Hex Color Support - Full support for &#RRGGBB and standard & color codes in all messages.
  
• ⚡ Lightweight & Fast - In-memory caching, async saving, and optimized to run efficiently even on busy servers.
  
• Interest System - Players earn periodic interest on their balance. Configurable rate, interval, minimum balance, and max payout cap.
  
• Bank Notes - Withdraw your balance as a physical item you can trade with other players. Right-click to deposit it back!
  
• Balance on Join - Players see their balance every time they join the server. Fully toggleable.
  
• Salary System - Automatic periodic payouts based on permission tiers. Perfect for ranks and donor perks.
  
• Bounty System - Place bounties on players! When the target is killed, the killer collects the reward. Supports inclusive tax, broadcasts, offline targets, and admin removal.
  
• Transaction History - View all your recent economy activity in a paginated log. Tracks payments, bounties, daily rewards, interest, and more. Persisted across restarts.
  
• ✖️ Money Multiplier - Permission-based earning multipliers for VIPs and donors. Affects daily rewards, salary, and interest payouts.
  
• Auto-Save - Configurable auto-save interval for YAML storage. Bounties, transactions, and balances are all saved automatically to prevent data loss.
  
• Death Penalty - Players lose a configurable percentage of their balance on death. Supports min/max loss caps, PvP-only mode, and exemption permissions.
  
• Leaderboard Rewards - Top players on the leaderboard automatically receive periodic bonus rewards. Fully configurable per-position amounts.
  
• Economy Stats - Admins can view server-wide economy statistics including total money in circulation, average balance, total accounts, and the richest player.
  
• ⌨️ Smart Tab Completion - All commands feature intelligent tab completion with player name suggestions, subcommand hints, and amount presets.
  
• Bank System - A full bank GUI with /bank. Deposit and withdraw money between your wallet and bank account using a sleek inventory GUI. Configurable amounts, persisted to YAML or MySQL.
  
• Item Selling System - A built-in shop! Sell configured items using /sell <hand|all>.
  
• ️ Promo Codes - Configure custom codes that players can redeem for money!
  
• Pay Toggles - VIPs/Streamers can toggle incoming payments to prevent spam using /paytoggle.
  
• Wealth Tax - Periodically tax extremely wealthy online players to balance the economy.

Commands

Command	Aliases	Description
/balance [player]	/bal, /money	Check your balance or another player's
/pay <player> <amount>	None	Send money to another player
/balancetop [page]	/baltop	View the richest players
/daily	None	Claim your daily reward
/withdraw <amount>	None	Withdraw balance as a tradeable bank note
/bounty <set|list|check|remove> [player] [amount]	None	Bounty system commands
/bank	None	Open the bank GUI
/transactions [page]	/trans	View your transaction history
/economy <sub> [player] [amount]	/eco	Admin commands (give, take, set, bank, stats, reload)
/sell <hand|all>	None	Sell configured items for money
/paytoggle	None	Toggle incoming payments
/redeem <code>	None	Redeem a promo code

Permissions

Permission	Default	Description
smartcurrency.multiplier.<tier>	None	Grants a money multiplier tier
smartcurrency.deathpenalty.exempt	None	Exempts a player from death penalties
smartcurrency.admin	OP	Admin economy commands, bounty removal, stats

PlaceholderAPI Placeholders

Placeholder	Output Example
%smartcurrency_balance%	1234.56
%smartcurrency_balance_formatted%	1,234.56
%smartcurrency_balance_short%	1.2K
%smartcurrency_balance_int%	1234
%smartcurrency_currency%	$
%smartcurrency_currency_name%	Dollar
%smartcurrency_currency_plural%	Dollars

Storage Options

SmartCurrency supports two storage backends. Switch between them with a single config change:

• YAML (Default) - Zero setup. Data is stored locally in flat files with in-memory caching for blazing fast reads, async saving, and configurable auto-save intervals.
  
• MySQL - Production-grade database storage with HikariCP connection pooling. Perfect for networks and large servers. Fully configurable pool settings (max connections, timeouts, idle limits, etc.).

Bounty System

Put a price on someone's head! Players can place bounties on other players using /bounty set <player> <amount>. When the target is killed by another player, the killer collects the reward.

• Configurable minimum and maximum bounty amounts
• Inclusive tax system (e.g. place $100, 5% tax is taken from the pool, killer gets $95)
• Bounties stack - multiple players can add to the same target's bounty
• Server-wide broadcasts when bounties are set and claimed
• Support for offline player targeting
• Bounties persist across server restarts
• /bounty list to see all active bounties
• /bounty check <player> to check a specific target
• /bounty remove <player> to admin-remove a bounty (requires smartcurrency.admin)

Death Penalty

Add consequences to dying! Players lose a configurable percentage of their balance on death.

• Configurable percentage of balance lost (e.g. 5%)
• Minimum and maximum loss caps to keep things fair
• PvP-only mode - only lose money when killed by another player
• Exempt specific players or ranks with smartcurrency.deathpenalty.exempt
• Death loss is logged in transaction history

Leaderboard Rewards

Incentivize wealth! The top players on /baltop automatically receive periodic bonus rewards.

• Configurable reward amounts per position (1st, 2nd, 3rd, etc.)
• Configurable payout interval
• Only online players receive rewards
• Rewards are logged in transaction history

Economy Stats

Get a bird's eye view of your server's economy with /eco stats:

• Total money in circulation across all accounts
• Total number of player accounts
• Average balance per player
• Richest player and their balance

Bank System

Keep your money safe! Use /bank to open a sleek inventory GUI where you can deposit and withdraw between your wallet and bank account.

• Modern chest GUI with emerald block (deposit), gold block (balance), and redstone block (withdraw)
• Multiple click actions: left click (small), right click (medium), shift+left (large), shift+right (all)
• Configurable deposit/withdraw amounts (default: $100 / $1,000 / $10,000)
• Custom amount via chat — click the sign item to type any exact amount you want
• GUI updates in real-time after each action
• Bank data persists to YAML or MySQL alongside your other data
• Included in auto-save for zero data loss

Transaction History

Every economy action is tracked! Use /transactions to browse your recent activity.

• Tracks deposits, withdrawals, payments, daily rewards, interest, salary, bounties, death penalties, and bank notes
• Paginated display with configurable entries per page
• Configurable max transactions stored per player
• Shows date, type (+ or -), amount, and description
• Persisted to disk/database across restarts

✖️ Money Multiplier

Reward your VIPs and donors with higher earnings! The multiplier system grants permission-based earning boosts.

• Permission-based tiers (e.g. smartcurrency.multiplier.vip = 1.5x)
• Players receive the highest tier they qualify for
• Affects daily rewards, salary, and interest payouts
• Players see their active multiplier on join
• Unlimited custom tiers

Interest System

Let your players earn money passively! The interest system pays a configurable percentage of a player's balance at set intervals.

• Configurable interest rate (e.g. 1.5%)
• Set payout interval (in minutes)
• Minimum balance required to earn interest
• Optional max payout cap per cycle
• Only pays online players

Bank Notes

Turn digital money into physical items! Players can use /withdraw <amount> to create a bank note item they can hold, drop, or trade with others. Right-click the note to deposit it back into your balance.

• Configurable item material and custom model data
• Min and max withdrawal amounts
• Secure validation so notes can't be faked
• Right-click to deposit back into balance

Salary System

Reward your players for being online! The salary system pays out automatically based on permission-based tiers. Perfect for rewarding ranks and donor perks.

• Permission-based tiers (e.g. smartcurrency.salary.vip)
• Players receive the highest tier they qualify for
• Configurable payout interval
• Unlimited custom tiers

Smart Config Updater

Tired of config files getting wiped on updates? SmartCurrency's Smart Config Updater solves this once and for all.

When you update the plugin jar:

1. New config entries, messages, and settings are added automatically.
2. Your custom values are never overwritten. Every change you made is preserved.
3. YAML comments are carried over from the new default.
4. A backup of your old config is created before any update.
5. New entries are logged to console so you know exactly what changed.

Just drop in the new jar and restart. That's it.


⚙️ Configuration Preview



Installation

1. Download the latest version of SmartCurrency.
2. Install Vault (required) and PlaceholderAPI (optional).
3. Drop SmartCurrency into your server's plugins folder.
4. Restart your server to generate the config.
5. Customize the config to your liking and run /eco reload.

Requirements

• Minecraft: 1.21.11+
• Java: 21+
• Vault: Required
• PlaceholderAPI: Optional (for placeholders)