EconomySystem

Complete Economy Plugin for Minecraft 1.20.4 – 1.21.10

✨ Features

• 💰 Full economy system with balances, payments, and administration
• 🌍 Multi-language support – German, English, French, Russian, Ukrainian
• 🗄️ Multi-database support – YAML, MySQL, MongoDB
• 📊 Transaction history – full logging of every transaction
• 🎯 Vault integration – compatible with all Vault-based plugins
• 📝 PlaceholderAPI support – many placeholders for Scoreboards, Chat, etc.
• 🔔 Event system – other plugins can react to transactions
• ⚡ Performance optimized – efficient storage and queries
• 🔒 Security – advanced permission system
• 📈 Top players list – shows the richest players
• 🔄 Reload system – reload the config without restarting the server

📦 Requirements

• Minecraft Server: 1.20.4 – 1.21.10 (Paper/Spigot/Purpur)

• Java: Version 21 or newer

• Optional:

  • Vault for plugin compatibility
  • PlaceholderAPI for placeholders

🚀 Installation

1. Download the latest version of EconomySystem
2. Place the .jar file into your server’s plugins folder
3. Restart the server
4. The plugin will auto-create all configuration files
5. Edit config.yml to your needs
6. Use /economyreload to reload the config

⚙️ Configuration

Basic Setup

The config.yml contains all important settings:

# Currency settings
currency:
  name: "Coin"
  name-plural: "Coins"
  symbol: "$"
  starting-balance: 100.0
  min-balance: 0.0
  max-balance: 0.0   # 0 = unlimited
  decimals: 2

# Database settings
database:
  type: YAML         # YAML, MYSQL or MONGODB

# General settings
settings:
  language: en
  top-players-per-page: 10
  log-transactions: true
  save-transaction-history: true
  max-transaction-history: 100
  vault-integration: true

MySQL Example

database:
  type: MYSQL
  mysql:
    host: localhost
    port: 3306
    database: economy
    username: root
    password: "your-password"
    table-prefix: economy_

MongoDB Example

database:
  type: MONGODB
  mongodb:
    connection-string: "mongodb://localhost:27017"
    database: economy
    collection: balances
    use-ssl: false

📝 Commands

Player Commands

Command	Aliases	Description	Permission
/balance [player]	/bal, /money	Shows your balance	economy.balance
/pay <player> <amount>	/send	Pay another player	economy.pay
/top [page]	/topbalance	Shows the richest players	economy.top
/history [player] [amount]	/hist	Shows transaction history	economy.history

Admin Commands

Command	Description	Permission
/economy set <player> <amount>	Set a player's balance	economy.admin
/economy give <player> <amount>	Give money	economy.admin
/economy take <player> <amount>	Remove money	economy.admin
/economy reset <player>	Reset to starting balance	economy.admin
/economyreload	Reload config	economy.reload

🔐 Permissions

• economy.balance – View own balance
• economy.balance.others – View others’ balance
• economy.pay – Send money
• economy.top – View top list
• economy.history – Show own history
• economy.history.others – Show other players’ history
• economy.admin – All admin commands
• economy.reload – Reload the plugin
• economy.* – All permissions

📊 PlaceholderAPI

Balance

• %economy_balance%
• %economy_balance_formatted%
• %economy_balance_formatted_symbol%

Currency

• %economy_currency_name%
• %economy_currency_name_plural%
• %economy_currency_symbol%

Top List

• %economy_top_1%
• %economy_top_1_balance%
• %economy_top_1_balance_formatted%
• Works for positions 1–1000

Other

• %economy_rank%
• %economy_has_account%

Example

You have %economy_balance_formatted% in your account!
Your rank: #%economy_rank%
Richest player: %economy_top_1% with %economy_top_1_balance_formatted%

💻 API for Developers

EconomyAPI

double balance = EconomyAPI.getBalance(player);
EconomyAPI.deposit(player, 100.0);
EconomyAPI.withdraw(player, 50.0);
EconomyAPI.transfer(player1, player2, 25.0);
String formatted = EconomyAPI.format(100.0);

Events

@EventHandler
public void onBalanceChange(BalanceChangeEvent event) {
    // React to balance changes
}

@EventHandler
public void onTransaction(TransactionEvent event) {
    // React to successful transactions
}

Vault Integration

Economy economy = Bukkit.getServicesManager()
    .getRegistration(Economy.class)
    .getProvider();

economy.depositPlayer(player, 100.0);
double bal = economy.getBalance(player);

🗄️ Database Support

YAML

• No need for setup
• Stored in data.yml

MySQL

• Requires MySQL server
• Perfect for large servers

MongoDB

• Requires MongoDB server
• Ideal for very large servers and distributed systems

🌍 Multi-Language Support

Languages available:

• 🇩🇪 German (default)
• 🇬🇧 English
• 🇫🇷 French
• 🇷🇺 Russian
• 🇺🇦 Ukrainian

Change language in config:

settings:
  language: en

Custom translations: Add a file like lang_en.yml, copy structure, translate, reload plugin.

📜 Transaction History

• Player payments
• Admin actions
• Deposits / withdrawals
• Timestamp + reason

Config:

settings:
  save-transaction-history: true
  max-transaction-history: 100

Usage:

• /history
• /history 20
• /history PlayerName

🔄 Supported Versions

✔ 1.20.4 – 1.21.10 Automatic version checking included.

🐛 Known Issues

• MySQL driver must be installed manually
• MongoDB driver must be installed manually

📞 Support

• GitHub Issues
• GitHub Wiki
• Discord Server

📄 License

Licensed under MIT License.

🙏 Credits

• Built for Paper/Spigot
• Compatible with Vault + PlaceholderAPI

📝 Changelog

Version 1.0.0

• Initial Release
• Full Economy System
• Multi-language (5 languages)
• Multi-database (YAML/MySQL/MongoDB)
• Transaction history
• Vault support
• PlaceholderAPI support
• Event system
• Version checking