Description
# MiguelEconomy
A lightweight and easy-to-use economy mod for Minecraft servers.
MiguelEconomy adds player balances, money commands, shops, an auction house, daily rewards, jobs, and Discord logging support.
Presentation video, French only for now:
---
## Features
### Economy System
- Persistent player balances
- Starting balance for new players
- Physical money item
- Player commands: /balance, /bal, /pay, /baltop
- Admin commands to set, add, and give money
- Daily rewards with /daily
- Jobs system with 4 jobs:
- Miner
- Hunter
- Farmer
- Trader
- Jobs menu available with /job or /jobs
---
### Shops
- Server shop system
- Custom shop categories
- Custom buy and sell prices
- Custom item quantities
- Console logs for shop transactions
- Support for configurable shop files
Build shops easily using the web builder:
https://miguel-economy-builder.vercel.app/
Shop Builder
---
### Auction House
- Player-to-player item trading
- List items for sale with a fixed price
- Buy items from other players
- Search auction listings
- Server-wide auction messages
- Chat notifications for listings, purchases, and sales
---
### Discord Webhooks
MiguelEconomy can send Discord webhook messages for economy activity such as:
- Auction listings
- Auction sales
- Auction cancellations
- Shop purchases
- Shop sales
---
## Version Support
| Version | Loader | Minecraft | Status |
|---|---|---|---|
| Fabric 1.20.1 | Fabric | 1.20.1 | Supported |
| Fabric 1.21.1 | Fabric | 1.21.1 | Supported |
| Fabric 1.21.11 | Fabric | 1.21.11 | Supported |
| Forge 1.20.1 | Forge | 1.20.1 | Supported |
| NeoForge 1.21.1 | NeoForge | 1.21.1 | Supported |
---
## Commands
| Command | Description |
|---|---|
| /balance or /bal | Check your balance |
| /pay | Send money to another player |
| /baltop | View the richest online players |
| /daily | Claim your daily reward |
| /job or /jobs | Open the jobs menu |
| /shop | Open the server shop |
| /ah | Open the auction house |
---
## Support
Need help or want to report a problem?
Discord: miguel.cuba
You can also join the Discord server.
Version Feature Comparison
✅ = available, ⚠️ = available with limitation, ❌ = not available.
| Feature | Fabric 1.20.1 | Fabric 1.21.1 | Fabric 1.21.11 | Forge 1.20.1 | NeoForge 1.21.1 |
|---|---|---|---|---|---|
| Mod version | 1.0.0 | 1.1.4 | 1.1.4 | 1.1.4 | 1.1.4 |
| Minecraft version | 1.20.1 | 1.21.1 | 1.21.11 | 1.20.1 | 1.21.1 |
| Loader | Fabric | Fabric | Fabric | Forge | NeoForge |
| Java version | 17+ | 21 | 21 | 17 | 21 |
| Economy balances | ✅ | ✅ | ✅ | ✅ | ✅ |
| Starting balance | ✅ | ✅ | ✅ | ✅ | ⚠️ Hardcoded |
| Max balance | ✅ | ✅ | ✅ | ✅ | ❌ Not enforced |
| Money item | ✅ | ✅ | ✅ | ✅ | ✅ |
| Money item stack size | 64 | 64 | 64 | 1 | 64 |
| Redeem money item | ✅ | ✅ | ✅ Silent | ✅ | ✅ Silent |
| Daily rewards | ✅ | ✅ | ✅ | ✅ | ✅ |
| Death penalty option | ✅ | ✅ | ✅ | ✅ | ✅ |
| Player payments `/pay` | ✅ | ✅ | ✅ | ✅ | ✅ |
| Self-pay blocked | ❌ | ❌ | ❌ | ✅ | ❌ |
| Balance leaderboard `/baltop` | ⚠️ Online players only | ⚠️ Online players only | ⚠️ Online players only | ⚠️ Online players only | ⚠️ Online players only |
| Admin money commands | ✅ | ✅ | ✅ | ✅ | ✅ |
| View another player balance | ❌ | ❌ | ❌ | ✅ OP only | ❌ |
| Auction House | ✅ | ✅ | ✅ | ✅ | ✅ |
| Auction search | ✅ | ✅ | ✅ | ✅ | ✅ |
| Auction pagination | ❌ | ❌ | ❌ | ❌ | ❌ |
| Auction expiration | ❌ | ❌ | ❌ | ❌ | ❌ |
| Offline seller payout | ❌ | ❌ | ❌ | ❌ | ❌ |
| Auction lock/unlock | ✅ | ✅ | ✅ | ✅ | ✅ |
| Auction lock saved | ❌ | ❌ | ❌ | ✅ | ❌ |
| Admin bypass for auction lock | ❌ | ❌ | ❌ | ✅ | ❌ |
| Shulker preview in auction | ✅ | ✅ | ✅ | ✅ | ✅ |
| Shop system | ✅ | ✅ | ✅ | ✅ | ✅ |
| Shop buy | ✅ | ✅ | ✅ | ✅ | ✅ |
| Shop sell | ✅ | ✅ | ✅ | ✅ | ✅ |
| Shop sell-all | ✅ | ✅ | ✅ | ❌ | ✅ |
| Shop item NBT/components | ❌ | ✅ | ✅ | ✅ | ✅ |
| Shop search | ❌ | ❌ | ❌ | ❌ | ❌ |
| Shop stock system | ❌ | ❌ | ❌ | ❌ | ❌ |
| Shop dynamic pricing | ❌ | ❌ | ❌ | ❌ | ❌ |
| Shop editor commands | ❌ | ❌ | ❌ | ❌ | ❌ |
| Shop lock/unlock | ✅ | ✅ | ✅ | ✅ | ✅ |
| Shop lock saved | ✅ | ⚠️ Not crash-safe | ✅ | ✅ | ✅ |
| Admin bypass for shop lock | ❌ | ❌ | ❌ | ✅ | ❌ |
| Jobs system | ✅ | ✅ | ⚠️ Trader job limited | ✅ | ✅ |
| Job types | Miner, Hunter, Farmer, Trader | Miner, Hunter, Farmer, Trader | Miner, Hunter, Farmer, Trader | Miner, Hunter, Farmer, Trader | Miner, Hunter, Farmer, Trader |
| Job levels | ✅ 1–20 | ✅ 1–20 | ✅ 1–20 | ✅ 1–20 | ✅ 1–20 |
| Job GUI | ✅ | ✅ | ✅ | ✅ | ✅ |
| Join/leave jobs | ❌ | ❌ | ❌ | ❌ | ❌ |
| Scoreboard support | ✅ | ✅ | ✅ | ✅ | ✅ |
| HUD balance display | ❌ | ❌ | ❌ | ❌ | ❌ |
| Discord webhooks | ✅ | ✅ | ✅ | ✅ | ✅ |
| Separate webhook URLs | ❌ | ❌ | ❌ | ✅ | ❌ |
| Chat prefixes | ✅ | ✅ | ❌ | ✅ | ❌ |
| Config format | JSON | JSON | JSON | TOML | TOML |
| Config reload command | ❌ | ❌ | ❌ | ❌ | ⚠️ Partial |
| Balance autosave | ❌ | ❌ | ❌ | ✅ | ❌ |
| Auction autosave | ❌ | ❌ | ✅ | ✅ | ❌ |
| Jobs autosave | ✅ | ✅ | ✅ | ✅ | ✅ |
| Database support | ❌ | ❌ | ❌ | ❌ | ❌ |
| Public economy API | ❌ | ❌ | ❌ | ❌ | ❌ |
| Permission plugin support | ❌ OP only | ❌ OP only | ❌ OP only | ❌ OP only | ❌ OP only |
| Localization | ⚠️ English only | ⚠️ English only | ⚠️ English only | ⚠️ English only | ⚠️ English only |
| Best for | Older Fabric servers | Modern Fabric servers | Latest Fabric testing | Most complete 1.20.1 version | NeoForge servers |
## Main differences
- **Forge 1.20.1** is the most complete version overall.
- **Fabric 1.21.1** is the best Fabric version for most servers.
- **Fabric 1.21.11** supports newer Minecraft but has some missing polish, especially around Trader jobs and chat prefixes.
- **NeoForge 1.21.1** works for NeoForge servers but has weaker balance config support.
- **Fabric 1.20.1** is mainly useful for older Fabric 1.20.1 servers.
## Shared features
All versions include economy balances, money items, daily rewards, death penalty option, player payments, Auction House, Shop, Jobs, scoreboard support, and Discord webhooks.