🏪 Auction House & Economy Mod

Transform your Minecraft server into a thriving economy with a complete trading and currency system! This mod adds a fully-featured auction house, NPC merchants, virtual currency, and multiple ways to earn money through gameplay. Perfect for survival multiplayer servers, roleplay communities, and economy-focused gameplay.

---

✨ Key Features

🛒 Auction House System

Access a player-driven marketplace where you can buy and sell items with other players using virtual currency.

• Command: /auctionhouse - Opens the auction house GUI (no permissions required)

• Sell items: Select items from your inventory, set your price, and list them for sale

• Buy items: Browse all available listings and purchase items instantly

• Clean interface: Easy-to-use GUI with item previews, prices, and seller names

• Real-time updates: See new listings as they appear

• Secure transactions: All trades use the virtual currency system

💰 Virtual Currency System

A complete money management system with multiple commands and earning methods. Commands:

• /money - Check your current balance

• /money give <player> <amount> - Give money to a player (OP only)

• /money set <player> <amount> - Set a player's balance (OP only)

• /money remove <player> <amount> - Remove money from a player (OP only)

Earn Money Through Gameplay:

• ⛏️ Mining: Earn money by breaking blocks (configurable per block type)

• ⚔️ Combat: Get paid for defeating mobs (configurable per mob type)

• 🎣 Fishing: Earn rewards when catching fish

• ⏰ Playtime: Automatic rewards every 10 minutes of playtime

• All rewards are fully configurable via rewards_config.json

🧑‍💼 NPC Merchant System

Place interactive merchant NPCs that buy items from players at fixed prices. Commands:

• /npc spawn - Place a blacksmith villager merchant (OP only)

• /npc remove - Remove the nearest merchant NPC (OP only)

Features:

• 100+ items priced: Over 100 items have custom prices based on rarity and value

• Right-click to trade: Simply right-click the merchant to open the selling interface

• Invincible NPCs: Merchants cannot be killed or moved

• Smart pricing system: Items are valued based on their in-game rarity:

• Common items: 10-500 coins

• Uncommon items: 500-2,000 coins

• Rare items: 2,000-10,000 coins

• Epic items: 10,000-30,000 coins

Example Prices:

• Diamond: 4,000 coins

• Diamond Sword: 15,000 coins

• Netherite Ingot: 8,000 coins

• Elytra: 25,000 coins

• Dragon Egg: 30,000 coins

• Nether Star: 20,000 coins

• Bread: 500 coins

• Iron Ingot: 1,500 coins

🏆 Leaderboard System

Display the richest players on your server with a floating hologram.

• Command: /baltop - Toggle a floating hologram showing the top 10 richest players

• Fixed position: The hologram stays at the location where you execute the command

• Real-time updates: Automatically updates when players earn or spend money

• Beautiful display: Color-coded rankings with player names and balances

• Toggle on/off: Run the command again to hide the hologram

---

⚙️ Configuration

Rewards Configuration (rewards_config.json)

Customize how players earn money:

Merchant Prices (merchant_prices_config.json)

Automatically generated with all item prices. You can edit this file to adjust prices to your liking.

---

🎮 Perfect For

• Survival Multiplayer Servers: Add an economy layer to vanilla survival

• Roleplay Servers: Create immersive trading experiences

• Economy-Focused Servers: Full trading and currency system

• Community Servers: Encourage player interaction through trading

---

📦 Installation

1. Download and install Minecraft Forge 47.4.0 for Minecraft 1.20.1

1. Place the mod in your mods folder (both server and client)

1. Start your server/game

1. Configure (optional): Edit rewards_config.json in your world folder

---

🔧 Technical Information

• Minecraft Version: 1.20.1

• Forge Version: 47.4.0+

• Type: Hybrid (Server-side + Client-side required)

• Network: Full multiplayer synchronization

• Storage: JSON-based persistent data

• Performance: Lightweight with no noticeable impact

---

🛡️ Permissions

• Players: Can use /auctionhouse, /money (view only), /baltop

• Operators: Full access to all commands including /npc and money management

---

🆘 Support & Feedback

Found a bug or have a suggestion? Please report it on the issue tracker! Enjoy building your server's economy! 💎

---

Cette description est complète, professionnelle et couvre tous les aspects du mod ! 🚀