SimpleEconomy
A simple server-side economy and player shop system for Minecraft NeoForge 1.21.1. No client mod required - works with vanilla clients!
Features
Economy System
- Player Balances: Each player has a coin balance that persists across sessions
- Starting Balance: New players receive a configurable starting amount
- Transaction Tax: Configurable tax on shop sales (default 5%)
- Leaderboard: See the richest players on the server
Commands:
| Command | Description |
|---|---|
/bal or /balance |
Check your balance |
/bal <player> |
Check another player's balance |
/pay <player> <amount> |
Send coins to another player |
/baltop or /leaderboard |
View richest players |
/transactions or /history |
View your transaction history |
Shop System
- Player Shops: Players can create and manage their own shops
- Shop Browser GUI: Browse all shops with a chest-based interface
- Bulk Buying: Adjust quantity before purchasing
- Featured Shops: Admins can feature shops to highlight them
- Offline Sales: Sellers earn money even when offline, with a summary on login
- Sale Notifications: Real-time notifications when someone buys from your shop
Commands:
| Command | Description |
|---|---|
/shops or /marketplace |
Open the shop browser GUI |
/shop create <name> |
Create a new shop |
/shop list |
List your shops |
/shop add <quantity> <price> |
Add held item to your shop |
/shop manage |
Open shop management GUI |
/shop delete |
Delete your shop (items returned) |
Daily Rewards
- Daily Claim: Earn coins every day with
/daily - Streak System: Consecutive daily claims increase your reward
- Max Streak: Configurable max streak with bonus scaling
Commands:
| Command | Description |
|---|---|
/daily or /claim |
Claim your daily reward |
/streak |
View your current streak |
Coinflip
- PvP Gambling: Challenge another player to a 50/50 coinflip
- Clickable Buttons: Accept or deny challenges with clickable chat buttons
- Auto-timeout: Challenges expire after 60 seconds
Commands:
| Command | Description |
|---|---|
/coinflip <player> <amount> |
Challenge a player |
/coinflip accept |
Accept a challenge |
/coinflip deny |
Deny a challenge |
/coinflip cancel |
Cancel your outgoing challenge |
Mob Drops
- Mobs drop coins on death (configurable per mob type)
- Bosses have higher drop rates
- PvP kill bounty system (configurable percentage)
Weekly Interest
- Players earn interest on their balance weekly
- Configurable rate and maximum cap
Admin Commands
| Command | Description | Permission |
|---|---|---|
/eco add <player> <amount> |
Add coins to a player | OP (level 2) |
/eco remove <player> <amount> |
Remove coins from a player | OP (level 2) |
/eco set <player> <amount> |
Set a player's balance | OP (level 2) |
/shop feature <shop> |
Toggle featured status | OP (level 2) |
/shop setinfinite <shop> |
Set shop items to infinite stock | OP (level 2) |
/shop admindelete <shop> |
Delete any shop | OP (level 2) |
/shop listall |
List all shops on the server | OP (level 2) |
Installation
- Requires NeoForge for Minecraft 1.21.1
- Place the mod jar in your
modsfolder - Server-side only - no client mod needed, works with vanilla clients
Configuration
Config file is generated at config/simpleeconomy/config.json on first run.
| Option | Default | Description |
|---|---|---|
currencyName |
"coins" |
Name of the currency |
startingBalance |
100.0 |
Balance given to new players |
taxRate |
0.05 |
Tax rate on shop sales (5%) |
dailyBaseReward |
100 |
Base daily reward |
dailyRewardIncrement |
50 |
Extra reward per streak day |
maxStreak |
7 |
Maximum streak days |
weeklyInterestRate |
0.10 |
Weekly interest rate (10%) |
maxInterestAmount |
500.0 |
Maximum interest payout |
killRewardPercent |
0.0 |
PvP kill reward (% of victim's balance) |
For Modpack Makers
Quest Integration
Use the /eco add command in quest rewards to give players coins:
/eco add @p 100
Admin Shops
Create admin shops with infinite stock using /shop setinfinite <shopname>.
Building
Requirements: Java 21 (required by NeoForge 1.21.1)
./gradlew build
The built jar will be in build/libs/.
