Economy-System

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) 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