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

1. Requires NeoForge for Minecraft 1.21.1
2. Place the mod jar in your mods folder
3. 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/.

License

MIT License