SimpleEconomy

A production-ready economy plugin for PocketMine-MP, powered by SimpleSQL.

Built for server owners who want a working economy in minutes and developers who want an API that doesn't fight them.

Why another economy plugin?

I know BedrockEconomy exists, and it's a great plugin - recommended on Poggit, actively maintained. So why SimpleEconomy?

Short answer: Different philosophy, different strengths.

SimpleEconomy BedrockEconomy

Storage Hybrid SQL + YAML via SimpleSQL Pure SQL (libasynql)

API complexity 4 methods. That's it. Full async ClosureAPI / fluent builders

Setup Drop-in, works instantly Requires understanding async patterns

Offline player data Built-in (temporary sessions) Requires manual SQL queries

ScoreHud integration Built-in Separate plugin required

Multi-language 14 languages built-in 4 languages

Transaction events Cancellable events for third-party control Custom event system

Target audience Small-to-medium servers, non-dev admins Advanced setups, dev-oriented

Why not PR into BedrockEconomy? BedrockEconomy is architecturally pure-SQL. SimpleEconomy's hybrid SQL-YAML approach (via SimpleSQL) is a fundamentally different storage philosophy - this isn't a feature addition, it's a different way of thinking about player data. Both approaches have merit, but they can't coexist in one codebase without compromise.

TL;DR: BedrockEconomy is powerful and flexible. SimpleEconomy is simple and instant. Choose what fits your server.

Features

6 commands - /money, /pay, /setmoney, /addmoney, /reducemoney, /topmoney

Name prefix matching - type /money nh and it finds NhanAZ

Offline player support - check and modify balances of players who aren't online

Leaderboard - paginated /topmoney with async cache rebuild

14 languages - English, Vietnamese, Korean, Russian, Spanish, Ukrainian, Chinese, Indonesian, Turkish, French, Portuguese, German, Japanese, Italian

ScoreHud integration - built-in scoreboard tags, no extra plugin needed

Transaction events - other plugins can listen to, or even cancel, economy transactions

Currency formatting - $1,000,000 (default) or$1.5M (compact)

SQLite & MySQL - switch with one line in config

Installation

From Poggit (recommended)

Download the latest .phar from Poggit CI.

Drop it in your server's plugins/ folder. Done.

From source

• Clone this repository

• The plugin requires the SimpleSQL and libasynql virions to be injected (handled automatically by Poggit CI)

Commands

Command Description Permission Default

/money [player] Check your balance, or someone else's simpleeconomy.command.money Everyone

/pay Send money to another player simpleeconomy.command.pay Everyone

/topmoney [page] View the richest players simpleeconomy.command.topmoney Everyone

/setmoney Set a player's balance simpleeconomy.command.setmoney OP

/addmoney Add money to a player simpleeconomy.command.addmoney OP

/reducemoney Remove money from a player simpleeconomy.command.reducemoney OP

Tip: All commands support name prefix matching. If Steve is online, /pay st 100 works.

Tip: Admin commands (/setmoney, /addmoney, /reducemoney) work on offline players too.

Configuration

After first run, edit plugin_data/SimpleEconomy/config.yml:

Language (14 supported)

language: "eng"

Starting balance for new players

default-balance: 1000

Currency display

currency: symbol: "" formatter: "default" # or "compact" for 1.5K style

Leaderboard

topmoney-per-page: 10 leaderboard-size: 100

Database (sqlite or mysql)

database: type: sqlite

Supported Languages

Code Language

eng English

vie Tiếng Việt

kor 한국어

rus Русский

spa Español

ukr Українська

zho 简体中文

ind Bahasa Indonesia

tur Türkçe

fra Français

por Português

deu Deutsch

jpn 日本語

ita Italiano

All language files are saved to plugin_data/SimpleEconomy/lang/ - you can edit them freely.

ScoreHud Integration

If ScoreHud is installed, SimpleEconomy automatically provides these scoreboard tags:

Tag Example Description

{simpleeconomy.balance} $1,000 Formatted balance

{simpleeconomy.rank} 3 Leaderboard position

{simpleeconomy.raw} 1000 Raw balance number

No extra plugins or configuration needed. Just add the tags to your ScoreHud config.

For Developers

Want a full working example? Check out SimpleEconomyExample - a complete plugin demonstrating how to use the SimpleEconomy API with real commands and event listeners.

Quick Start - Using the API

use NhanAZ\SimpleEconomy\Main as SimpleEconomy;

// Get the plugin instance $eco = SimpleEconomy::getInstance();

// Check balance (online players) $balance =$eco->getMoney("Steve"); // ?int - null if offline

// Modify balance (online players) $eco->setMoney("Steve", 5000); // bool - false if offline or cancelled$eco->addMoney("Steve", 500); // bool $eco->reduceMoney("Steve", 200); // bool - false if insufficient funds

// Format money using the server's configured style $display =$eco->formatMoney(1500000); // "$1,500,000" or "$1.5M"

That's the entire sync API. 4 methods.

Async API - Offline Players

// Works for BOTH online and offline players $eco->getMoneyAsync("Steve", function(?int$balance): void { if (balance !== null) { // Steve has played before, balance is balance } else { // Steve has never joined } });

Transaction Events

SimpleEconomy fires events that your plugin can listen to:

TransactionSubmitEvent - fired before a transaction executes. Cancellable.

use NhanAZ\SimpleEconomy\event\TransactionSubmitEvent; use NhanAZ\SimpleEconomy\event\TransactionEvent;

public function onTransaction(TransactionSubmitEvent event): void { // Block payments over 10,000 if (event->type === TransactionEvent::TYPE_PAY && event->getAmount() > 10000) { $event->cancel(); } }

TransactionSuccessEvent - fired after a transaction completes. Read-only.

use NhanAZ\SimpleEconomy\event\TransactionSuccessEvent;

public function onSuccess(TransactionSuccessEvent event): void { this->getLogger()->info("{event->playerName}: {event->oldBalance} → {$event->newBalance}"); }

Event Properties

Property Type Description

$event->playerName string The player involved

$event->oldBalance int Balance before the transaction

$event->newBalance int Balance after the transaction

$event->type string

"set", "add", "reduce", or "pay"

$event->getAmount() int Absolute difference between old and new

Offline Player Data Access

For commands or features that need to work on offline players:

$eco->withPlayerSession("Steve", function(Session$session, bool $temporary) use ($eco): void { $balance = (int)$session->get("balance", 0);

// Do something with the balance...

// IMPORTANT: close temp sessions when done if (temporary) { eco->closeTempSession("Steve"); } }, function(string $error): void { // Handle error (e.g., data still loading) });

Leaderboard Data

// Get top 10 players $top =$eco->getTopBalances(limit: 10, offset: 0); // Returns: [["name" => "steve", "balance" => 50000], ...]

// Get a player's rank $rank =$eco->getPlayerRank("Steve"); // ?int - null if not in cache

// Total cached entries $count =$eco->getBalanceCacheCount();

Multi-Economy Provider Compatibility

SimpleEconomy is supported by multiple multi-economy libraries. We recommend using EcoAPI for the best experience.

Library Type Config value PR Status

EcoAPI Provider "simpleeconomy" ✅ Supported

libPiggyEconomy Provider "simpleeconomy" ✅ Supported

MoneyConnector Connector "simpleeconomy" Planned

Economizer Transistor "SimpleEconomy" Planned

libEco Auto-detect

Planned

Capital Migration source "simpleeconomy" Planned

Recommended: EcoAPI is a simple, lightweight, and unified economy API library that supports auto-detection, async operations, custom providers, and multiple economy plugins with a single clean interface. It is the recommended choice for plugin developers who want broad economy plugin compatibility.

Once these libraries support SimpleEconomy, plugins using them (shop plugins, auction plugins, etc.) will automatically work with SimpleEconomy without any code changes on their end.

Project Structure

SimpleEconomy/ ├── plugin.yml ├── LICENSE ├── resources/ │ ├── config.yml │ ├── simplesql/ │ │ ├── mysql.sql │ │ └── sqlite.sql │ └── lang/ │ ├── eng.yml # English │ ├── vie.yml # Tiếng Việt │ ├── kor.yml # 한국어 │ └── ... (14 languages) └── src/NhanAZ/SimpleEconomy/ ├── Main.php # Core plugin + API ├── LangManager.php # Multi-language system ├── CurrencyFormatter.php # $1,000 /$1K formatting ├── LeaderboardTask.php # Async cache builder ├── ScoreHudListener.php # ScoreHud integration ├── command/ │ ├── MoneyCommand.php │ ├── PayCommand.php │ ├── SetMoneyCommand.php │ ├── AddMoneyCommand.php │ ├── ReduceMoneyCommand.php │ └── TopMoneyCommand.php └── event/ ├── TransactionEvent.php # Base event ├── TransactionSubmitEvent.php # Pre-transaction (cancellable) └── TransactionSuccessEvent.php # Post-transaction

License

MIT License - do whatever you want with it.

Credits

SimpleSQL - the hybrid SQL-YAML engine that powers this plugin

libasynql - async SQL library for PocketMine-MP

ScoreHud - scoreboard addon (optional integration)