HaiEconomy

required is Vault

required is Vault-Folia (only for Folia Server)

required is PacketEvents

English

Short description

HaiEconomy provides a complete economy system with Vault support, payments, a balance top list and full Folia compatibility. Players can pay each other, disable incoming payments, and view their balance – while shop, ranking and arena plugins automatically use HaiEconomy as their economy provider.

Features

💰 Complete economy system with Vault provider – all shop, ranking and arena plugins use HaiEconomy automatically.

💸 Simple payments: /pay <player> <amount> with sound and notification for sender and receiver.

🔕 Payment toggle: players can disable incoming payments with /paytoggle at any time.

🏆 Balance top list /baltop with pagination (/baltop 2).

🔢 Formatted amounts: players can type 10k, 2.5k, 1,5m, 100m, 2b or 1t instead of long numbers.

🎨 Unlimited colors: every message supports MiniMessage (<gradient:…>), classic & codes (&a, &l, &r) and hex colors (&#ff0000).

💱 Fully configurable currency: symbol, position (before/after), singular/plural, number pattern and locale (de_DE, en_US, …).

📝 All messages editable in messages.yml – no code changes needed.

🔗 PlaceholderAPI support for scoreboards, tab list and chat.

🧵 Full Folia support: only Folia/Paper schedulers are used, all balance changes are thread-safe and saving runs asynchronously.

⚡ Lightweight: no external database required, accounts are stored in balances.yml.

Requirements

Minecraft version: 1.21.x – 26.2

Server loader: Paper, Purpur, Folia (Spigot/Bukkit are not supported)

API version: 1.21 (compatible with all minor releases)

Dependencies: Vault (required), PlaceholderAPI (optional)

Commands

/balance (aliases /bal, /money) → shows your own balance /balance → shows the balance of another player (also offline) /pay → sends money, e.g. /pay Sabin 10k /paytoggle → enables or disables incoming payments /baltop (alias /balancetop) → shows the richest players /baltop → shows a specific page of the top list /eco give|take|set|reset [amount] → money administration /haieconomy reload → reloads config and messages without restart /haieconomy version → shows the plugin version

Example permissions

haieconomy.balance → allows /balance (default: everyone) haieconomy.balance.others → allows /balance (default: OP) haieconomy.pay → allows /pay (default: everyone) haieconomy.pay.bypass → can pay players who disabled payments (default: OP) haieconomy.paytoggle → allows /paytoggle (default: everyone) haieconomy.baltop → allows /baltop (default: everyone) haieconomy.admin → allows all /eco commands (default: OP) haieconomy.reload → allows /haieconomy reload (default: OP)

Example placeholders

%haieconomy_balance% → formatted balance %haieconomy_balance_raw% → balance as raw number %haieconomy_rank% → position in the top list %haieconomy_baltop_name_1% → name of the player on place 1 %haieconomy_baltop_value_1% → balance of place 1

Area of application

Ideal for survival, citybuild and minigame servers that want a clean, fast economy without juggling three different plugins – and for networks running Folia that need a thread-safe solution.

Report bugs or ideas on Discord: Discord

---

Deutsch

Kurzbeschreibung

HaiEconomy bietet ein vollständiges Wirtschaftssystem mit Vault-Unterstützung, Zahlungen, einer Reichweiten-Rangliste und vollem Folia-Support. Spieler können sich gegenseitig Geld senden, Zahlungen deaktivieren und ihren Kontostand ansehen – während Shop-, Ranking- und Arena-Plugins HaiEconomy automatisch als Economy-Provider nutzen.

Features

💰 Komplettes Wirtschaftssystem mit Vault-Provider – alle Shop-, Ranking- und Arena-Plugins nutzen HaiEconomy automatisch.

💸 Einfache Zahlungen: /pay <Spieler> <Betrag> mit Sound und Benachrichtigung für Sender und Empfänger.

🔕 Zahlungs-Toggle: Spieler können eingehende Zahlungen jederzeit mit /paytoggle deaktivieren.

🏆 Reichweiten-Liste /baltop mit Seiten (/baltop 2).

🔢 Formatierte Beträge: Statt langer Zahlen können Spieler 10k, 2.5k, 1,5m, 100m, 2b oder 1t eingeben.

🎨 Farben ohne Limit: alle Nachrichten unterstützen MiniMessage (<gradient:…>), klassische &-Codes (&a, &l, &r) und Hex-Farben (&#ff0000).

💱 Währung frei konfigurierbar: Symbol, Position (vor/nach Betrag), Singular/Plural, Zahlenformat und Locale (de_DE, en_US, …).

📝 Alle Nachrichten in messages.yml editierbar – ohne Code-Änderungen.

🔗 PlaceholderAPI-Unterstützung für Scoreboard, Tabliste und Chat.

🧵 Voller Folia-Support: es werden ausschließlich Folia-/Paper-Scheduler genutzt, alle Kontostände werden thread-sicher aktualisiert und das Speichern läuft asynchron.

⚡ Leichtgewichtig: keine externe Datenbank nötig, Konten liegen in balances.yml.

Anforderungen

Minecraft-Version: 1.21.x – 26.2

Server-Loader: Paper, Purpur, Folia (Spigot/Bukkit werden nicht unterstützt)

API-Version: 1.21 (kompatibel mit allen Minor-Releases)

Abhängigkeiten: Vault (erforderlich), PlaceholderAPI (optional)

Befehle

/balance (Aliase /bal, /money) → zeigt deinen eigenen Kontostand /balance → zeigt den Kontostand eines anderen Spielers (auch offline) /pay → sendet Geld, z. B. /pay Sabin 10k /paytoggle → nimmt Zahlungen an bzw. deaktiviert sie /baltop (Alias /balancetop) → zeigt die reichsten Spieler /baltop → zeigt eine bestimmte Seite der Rangliste /eco give|take|set|reset [Betrag] → Geldverwaltung /haieconomy reload → lädt Config und Nachrichten ohne Neustart neu /haieconomy version → zeigt die Plugin-Version

Beispiel-Permissions

haieconomy.balance → erlaubt /balance (Standard: alle) haieconomy.balance.others → erlaubt /balance (Standard: OP) haieconomy.pay → erlaubt /pay (Standard: alle) haieconomy.pay.bypass → kann auch Spielern mit deaktivierten Zahlungen senden (Standard: OP) haieconomy.paytoggle → erlaubt /paytoggle (Standard: alle) haieconomy.baltop → erlaubt /baltop (Standard: alle) haieconomy.admin → erlaubt alle /eco-Befehle (Standard: OP) haieconomy.reload → erlaubt /haieconomy reload (Standard: OP)

Beispiel-Platzhalter

%haieconomy_balance% → formatierter Kontostand %haieconomy_balance_raw% → Kontostand als rohe Zahl %haieconomy_rank% → Platz in der Reichweiten-Liste %haieconomy_baltop_name_1% → Name des Spielers auf Platz 1 %haieconomy_baltop_value_1% → Kontostand von Platz 1

Einsatzgebiet

Ideal für Survival-, Citybuild- und Minigame-Server, die ein sauberes, schnelles Wirtschaftssystem wollen – ohne drei verschiedene Plugins zu pflegen. Ebenso geeignet für Netzwerke mit Folia, die eine thread-sichere Lösung benötigen.

Bugs oder Ideen auf dem Discord melden: Discord