Miner's Market

⛏️ Miner's Market - Competitive Mining Challenge

A competitive mining mod for Minecraft

Compete to strike it rich — mine ores, sell to the merchant, and be the first to earn 10,000 gold! The first player to reach the goal wins!

---

✨ Features

🏪 Market at Spawn

• Auto-Generated Market: A market structure spawns automatically at the world spawn point
• NPC Merchant: A merchant NPC stands ready to buy your ores and ingots
• Starter Equipment: Each player receives a powerful Miner's Pickaxe and supplies from a chest

⛏️ Miner's Pickaxe

• Fortune III: Built-in Fortune III enchantment for maximum ore drops
• High Durability: 4096 durability — lasts through long mining sessions
• Fast Mining: Mining speed of 12.0 — faster than diamond tools

💰 Ore Trading

Sell your mined items to the merchant for gold:

Item	Price	Item	Price
Coal	1	Raw Copper	1
Copper Ingot	2	Lapis Lazuli	3
Raw Iron	5	Iron Ingot	10
Raw Gold	7	Gold Ingot	15
Redstone	5	Diamond	30
Emerald	10	Amethyst Shard	10
Netherite Ingot	100

📈 Price Events

• Dynamic Pricing: Every 10 minutes, a random price event occurs — ore prices go up or down!
• Timed Events: Each event lasts 3–5 minutes, keeping the game exciting
• HUD Indicator: Active price events are shown on your HUD with the current multiplier
• Title Announcements: Price changes are announced with on-screen titles so you never miss them
• Strategy Element: Decide whether to sell now or wait for better prices

📊 Real-Time HUD

• Earnings Display: Track your current gold with a coin icon
• Play Time: See your elapsed time in MM:SS format
• Rankings: View finished players and their times
• Floating Notifications: Sale amounts pop up when you sell items
• Market Direction Marker: Always know which way to the market
• Price Event Status: See when a price event is active and the current price multiplier

🎮 Game Flow

• Game Start Block: Press to begin a 5-second countdown, then the race starts
• Game Reset Block: Double-click within 5 seconds to reset the game
• Night Vision: All players receive permanent night vision for mining
• Victory Notifications: Announcements when players reach the goal

---

📖 How to Play

1. Create a New World: Start a new world with the mod installed
2. Find the Market: A market structure is generated at the spawn point
3. Grab Your Gear: Take a Miner's Pickaxe and bread from the chest
4. Start the Game: Press the Game Start block to begin the countdown
5. Mine Ores: Head underground and mine as many ores as you can
6. Sell to Merchant: Return to the market and right-click the merchant while holding items
7. Reach 10,000 Gold: The first player to earn 10,000 gold wins!

---

🛠️ Technical Details

Multi-Loader Support

This mod is built with Architectury and supports multiple mod loaders!

• 1.21.1–1.21.9: Fabric and NeoForge
• 1.20.1: Fabric and Forge
• Download the correct version for your mod loader
• Shared codebase ensures consistent experience across loaders

Requirements

Minecraft 1.21.9

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.134.1+1.21.9, OR NeoForge 21.9.16-beta+
• Dependencies: Architectury API 18.0.3+

Minecraft 1.21.8

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.136.0+1.21.8, OR NeoForge 21.8.52+
• Dependencies: Architectury API 17.0.8+

Minecraft 1.21.7

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.129.0+1.21.7, OR NeoForge 21.7.25-beta+
• Dependencies: Architectury API 17.0.8+

Minecraft 1.21.6

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.128.2+1.21.6, OR NeoForge 21.6.20-beta+
• Dependencies: Architectury API 17.0.6+

Minecraft 1.21.5

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.126.0+1.21.5, OR NeoForge 21.5.96+
• Dependencies: Architectury API 16.1.4+

Minecraft 1.21.4

• Mod Loader: Fabric Loader 0.18.4+ with Fabric API 0.119.3+1.21.4, OR NeoForge 21.4.156+
• Dependencies: Architectury API 15.0.3+

Minecraft 1.21.3

• Mod Loader: Fabric Loader 0.16.10+ with Fabric API 0.107.3+1.21.3, OR NeoForge 21.3.95+
• Dependencies: Architectury API 14.0.4+

Minecraft 1.21.1

• Mod Loader: Fabric Loader 0.17.3+ with Fabric API 0.116.7+1.21.1, OR NeoForge 21.1.209+
• Dependencies: Architectury API 13.0.8+

Minecraft 1.20.1

• Mod Loader: Fabric Loader 0.16.10+ with Fabric API 0.92.2+1.20.1, OR Forge 47.3.0+
• Dependencies: Architectury API 9.2.14+

Compatibility

• Works alongside other mods
• Compatible with performance mods (Sodium, Starlight, etc.)
• Designed for multiplayer but also works in singleplayer

---

🐛 Bug Reports & Suggestions

Found a bug or have a suggestion? Report it on our GitHub Issues page!

---

📷 Screenshots

Check out the Gallery above for screenshots showcasing:

• The market structure at spawn
• NPC merchant trading
• HUD overlay with earnings and rankings
• Miner's Pickaxe in action

---

🤝 Credits

• Built with Architectury

---

📜 License & Permissions

License: LGPL-3.0 - Copyright (C) 2025 Soichiro Kashima

Source Code: Available on GitHub

Freedom to Use: ✅ Free to use, modify, and redistribute under LGPL-3.0 terms

Modpack Inclusion: ✅ Allowed - You may include this mod in modpacks

Redistribution: ✅ Allowed - You may redistribute this mod (must remain LGPL-3.0)

---

🔗 Links

• GitHub Repository: https://github.com/ksoichiro/MinersMarket
• CurseForge: [Link to CurseForge page]

---

Developed for Minecraft Java Edition 1.20.1–1.21.9

Race to riches! ⛏️