---

---

Economy adds a full money system to your server: balances, payments, bounties, a sell GUI, spawner shops, player packages, a rotation market, quests, crates, a trade GUI, auction house and mob spawners — all running only on the server. Vanilla clients can join and use every feature without installing anything.

---

✨ Features

💵 Money & Balances

• /balance — check your current balance
• /baltop — leaderboard of the richest players (paginated GUI)
• /pay <player> <amount> — send money to another player (with a confirmation popup for large amounts)
• Maximum balance cap of $5T (5 trillion)
• Balances persist across restarts and logouts
• Configurable starting balance for new players

🛒 Shop & Sell GUI

• /shop — full category-based shop with prices per item
• /sell — opens a 54-slot chest GUI
• Drop items into the top 45 slots and click the lime glass pane to sell everything, or press ESC to sell and close
• Every vanilla item has a sell price — ores, mob drops, food, logs, and more
• Buy prices scale up the more you purchase (dynamic pricing), sell prices drift down as more is sold
• Optional per-item stock system with automatic restocking
• VIP & MVP sell multipliers (1.5x and 2x)

🌟 Market

• /market — rotating featured items every few hours at a discount
• Discounts from 10% up to 40% on the daily rotation
• Refreshes automatically — always something to check

🏦 Bank

• /bank — view your balance and interest info
• Automatic daily interest paid on your balance
• Interest accrues while you're offline too — log back in and collect it

🎁 Daily Rewards

• /daily — claim your daily reward
• 7-day streak system with increasing rewards each day
• Miss a day and the streak resets — but the rewards are worth it

🎯 Bounty System

• /bounty set <player> <amount> — place a bounty on another player
• /bounty check <player> — see if someone has a bounty
• /bounty top — see the top 10 bounties on the server
• /bounty (no arguments) — see your own bounty and top 3
• Kill a wanted player to collect their bounty
• Server-wide broadcast when a bounty is placed or collected

🎟️ Lottery

• /lottery — buy a ticket and join the draw
• /lottery info — current pot, ticket count, and your tickets
• /lottery winners — last 10 draw winners
• Configurable draw interval, ticket price, minimum pot, and number of winners
• Winners are announced to the whole server

📦 Package System

• /package send <player> — opens a 5-page send GUI (270 slots)
• /package receive — shows all incoming packages as player heads
• Click a head to claim — items go straight to your inventory, overflow drops on the ground
• Sender and receiver both get notified
• Packages persist across restarts and logouts

🔨 Spawners

• Buy mob spawners and fishing spawners from the shop
• Place them, and they accumulate loot over time
• Mob spawners stack up to 1,000
• Fishing spawners stack up to 3, with stacking boosting rare drop rates
• Storage GUI with pagination, SELL ALL, and back navigation
• Collect stored XP to mend your armor and tools (mending repair like vanilla)
• Toggle auto-sell per spawner — money goes to the spawner owner automatically
• Explosion protection (optional) so a creeper can't destroy your 1M-mob spawner
• Speed upgrade system with configurable max multiplier

🌟 Fishing Spawners

• Fish Spawner — cod, salmon, pufferfish, tropical fish
• Treasure Spawner — enchanted books, bows, rods, nautilus shells, saddles
• Garbage Spawner — lily pads, bones, string, ink sacs, and other junk
• Combined Spawner — mixes all three, with rare drops boosted by stacking

🏛️ Auction House

• /ah — browse listings from other players
• /ah sell <price> — list the item you're holding
• Configurable tax on sales
• Per-player listing cap so one player can't flood the market
• Click your own listing to take it back
• Listings persist across restarts

🤝 Trade GUI

• /trade <player> — open a two-sided trade window
• Both players drop items into their own side
• Both must confirm before the swap happens
• Everything is returned safely if either side closes the GUI

🏆 Quests

• /quest — GUI showing all available quests and your progress
• Mine, kill, or collect — any objective the server sets up
• Claim rewards in-game with a single click
• Fully configurable via quests.yml — add as many as you like
• Progress resets daily

🎁 Crates

• /crate — opens the crate GUI
• Weighted reward pools — the rarer the reward, the lower its chance
• Keys can be granted automatically for playtime, or given by admins with /crate give <player> <crate> <amount>
• Keys persist across restarts
• Fully configurable via crates.yml — create unlimited crates with any reward pool

🧭 Teleporting & Homes

• /tpa <player> — request to teleport to someone (clickable Accept / Deny buttons)
• /tpahere <player> — ask someone to teleport to you
• /tpaccept, /tpdeny, /tpacancel — manage pending requests
• /sethome <name>, /home <name>, /delhome <name> — unlimited named homes
• /warp <name>, /setwarp <name>, /delwarp <name> — server-wide warp points

---

🔧 Installation

1. Drop the Economy jar into your server's plugins/ folder
2. Restart the server
3. Configure plugins/Economy/shopitems.yml for your sell prices

No client installation needed. Players join with vanilla clients and everything works.

---

📋 Commands

Command	Description
/balance (aliases: /bal, /money)	Check your balance
/baltop	Leaderboard of richest players
/pay <player> <amount>	Send money to a player
/sell	Open the sell GUI
/shop	Open the shop
/market	View the rotating featured items
/bank	View bank information and interest
/daily	Claim your daily streak reward
/worth [item]	Browse or search for item sell prices
/bounty set <player> <amount>	Place a bounty
/bounty check <player>	Check a player's bounty
/bounty top	See the top bounties on the server
/lottery	Buy a lottery ticket
/lottery info	See the current pot and your tickets
/lottery winners	See the last 10 winners
/package send <player>	Send a package
/package receive	Open your inbox
/spawners	Open the spawner shop
/ah	Open the auction house
/ah sell <price>	List the item you're holding
/trade <player>	Open a two-sided trade window
/quest	Open the quest GUI
/crate	Open the crate GUI
/crate give <player> <crate> <amount>	Give keys to a player (admin)
/cs set <price> / /cs remove	Create or remove a chest shop (admin)
/tpa <player> / /tpahere <player>	Request a teleport
/tpaccept / /tpdeny / /tpacancel	Manage teleport requests
/home / /sethome / /delhome	Manage named homes
/warp / /setwarp / /delwarp	Manage warps
/rules	Show your server's rules
/eco	Admin economy commands
/tax <on|off>	Toggle taxes (admin)
/customshop	Custom shop whitelist management (admin)

---

⚙️ Configuration

All data is stored in your server's plugins/Economy/ folder:

• config.yml — all tunable options (tax, interest, lottery, spawners, auction cap, dynamic pricing, stock, crates, quests, and more)
• shopitems.yml — sell prices and shop categories for every item
• quests.yml — quest definitions (add unlimited quests)
• crates.yml — crate definitions and reward pools
• players/ — per-player balance, home, streak and playtime files
• bounties.yml — active bounties
• packages.yml — player packages
• ah.yml — auction house listings
• chestshops.yml — player chest shops
• crate-keys.yml — saved crate keys per player
• market.yml, prices.yml, stock.yml — market rotation, dynamic pricing and stock data
• rules.txt — shown by /rules
• pay-history.log — full log of every /pay trade

---

🔌 Integrations

• Vault — register as an economy provider so other plugins can use your currency
• PlaceholderAPI — dozens of placeholders including %economy_balance%, %economy_baltop_1_name%, %economy_daily_streak%, %economy_lottery_pot%, and more

---

📌 Requirements

• Paper 1.21.3 or newer (also runs on Purpur)
• Java 21 or newer
• Optional: Vault and/or PlaceholderAPI

---

🔧 Admin Tools

• /eco add|set|remove|reset|reload|giveall|history — full admin control over balances
• /eco history <player> — see a player's last N /pay trades
• /crate give — hand out crate keys
• /cs set|remove — create chest shops in-game
• /customshop on|off|add|remove|list — whitelist management for the shop
• /tax on|off — toggle pay tax
• All admin commands have full tab completion

---

---

Made by HuskyForge 🐺