REconomy
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)
[HR]
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)
[HR]
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
[HR]
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
[HR]
Source & Support
The project is open source. Report issues with logs/config excerpts.