What is MultiEco?

MultiEco is a multi-currency economy framework for Spigot and Paper servers. Create unlimited custom currencies from simple YAML files — no code, no recompiling. Drop a file, run one command, and your currency is live with its own commands, permissions, leaderboard and placeholders.

Perfect for survival, skyblock, prison and SMP servers that need coins, gems, tokens, shards or any other second currency without stacking extra plugins.

How It Works

Drop a YAML file into plugins/MultiEco/currencys/ (e.g. shards.yml)
Run /multieco reload
The command /shards is instantly live with balance, give, take, set, pay and top subcommands

The filename becomes the command name. You can also create currencies in-game with /multieco create.

Features

Unlimited currencies — each one is a single YAML file, with singular/plural names and custom symbols (◆, $, ★)
Auto-generated commands — balance, give, take, set, pay and top for every currency, no manual registration
Dynamic permissions — every currency generates its own nodes (e.g. multieco.shards.give)
Player-to-player payments with configurable transfer tax and permission-based tax tiers (VIP pays less, staff pays none)
Leaderboards — built-in paginated /currency top for every currency
PlaceholderAPI support — case-insensitive placeholders for every currency, registered automatically
Human-readable storage — balances saved as editable YAML files, one per currency, identified by UUID
Balance cache — online balances held in memory with async disk writes on quit
BigDecimal precision — no floating-point rounding errors, ever
Decimal & integer currencies, negative balances, and min/max balance limits
Number formatting — thousands separators, decimal places and optional K/M/B/T abbreviations
Hot reload — currencies are added, updated or removed without touching player balances
Developer API — 20+ methods and 6 custom events (load, unload, deposit, withdraw, transfer, balance change)
Fully customizable messages — every string lives in messages.yml with color codes and placeholders

Commands

Every currency gets its own command based on the filename:

/shards — view your balance
/shards pay <player> <amount> — send currency to another player
/shards give / take / set <player> <amount> — admin management
/shards top [page] — leaderboard

Admin control:

/multieco — view all your balances (players) or help (console)
/multieco list and /multieco info <currency>
/multieco create <id> [display-name] — create a currency in-game
/multieco delete <currency> confirm — remove a currency and its data
/multieco reload — reload everything without a restart

Example Currency File

Currencies are configured entirely in YAML:

id: shards
display-name: "Shards"
symbol: "◆"
icon: DIAMOND
starting-balance: 0
decimals: false
payments:
  tax:
    enabled: true
    percentage: 5
    permissions:
      vip: { permission: "multieco.shards.vip", percentage: 3 }

If a player holds multiple tax-tier permissions, the lowest-tax tier is applied automatically.

Compatibility

Minecraft: 1.16 through the latest version (Spigot and Paper)
Java: 17+
Soft dependency: PlaceholderAPI (optional)
Works alongside EssentialsX, LuckPerms, ShopGUI+ and other popular plugins

Full documentation is available at multieco.codella.dev.

MultiEco

About