REconomy
Lightweight, failover-ready economy for Paper/Spigot (1.20+)
Author: Rheyoux — Version: 1.0.0
Lightweight, failover-ready economy for Paper/Spigot (1.20+)
Author: Rheyoux — Version: 1.0.0
[HR]
Why REconomy?
- Primary storage: MySQL/MariaDB
- Automatic fallback: YAML when SQL is down
- No main-thread freezes: non-blocking SQL init + circuit breaker
- Clean messages with both %balance% (exact) and %balance_formatted% (K/M/B/T)
- Vault integration (Economy provider) & PlaceholderAPI placeholders
[HR]
Commands
Code (Text):
/balance
/balance <player>
/balancetop [page]
/pay <player> <amount>
/eco set <player> <amount>
/eco add <player> <amount>
/eco remove <player> <amount>
/eco reload
- Amount suffixes: k/m/b/t (e.g. 2.5k, 3m)
Permissions
Code (Text):
reconomy.balance # default: true
reconomy.balance.others # default: op (or use reconomy.admin)
reconomy.baltop # default: true
reconomy.pay # default: true
reconomy.admin # default: op (eco commands + reload)
Integrations
- Vault: registers as Economy provider so your favorite plugins (shops, jobs, etc.) can use REconomy.
- PlaceholderAPI: placeholders for scoreboards and menus:
Code (Text):
%reconomy_balance% -> exact balance (respects config)
%reconomy_balance_formatted% -> abbreviated balance (K/M/B/T)
Config (excerpt)
Code (YAML):
storage:
mode : MYSQL # YAML | MYSQL
mysql:
host : 127.0.0.1
port : 3306
database : test
username : root
password : ""
use-ssl : false
pool:
connection-timeout-ms : 2000
max-pool-size : 10
min-idle : 2
driver:
connect-timeout-ms : 1500
socket-timeout-ms : 1500
cache:
enabled : true
ttl-seconds : 120
max-size : 10000
failover:
retry-seconds : 15
quiet-logs : true
fallback:
enabled : true
folder : data-fallback
autosave-interval-seconds : 120
economy:
starting-balance : 0.00
format:
decimal-places : 2
grouping : true
abbreviate:
enabled : true
min : 1000
decimal-places : 1
Failover & Stability
- Non-blocking SQL initialization (no blocking sockets on server thread)
- Automatic fallback to YAML on SQL errors
- Circuit breaker: avoids retrying SQL for every join while DB is down
- Automatic recovery when SQL returns
[HR]
Compatibility
- Paper/Spigot 1.20+ (tested on Paper 1.21.4)
- Java 21+
- Optional: Vault, PlaceholderAPI
[HR]
Source & Support
The project is open source. Report issues with logs/config excerpts.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
REconomy is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 26 times (via Spigot). Download it and open it directly in the game.