Miner's Market
ModLGPL-3.0-only

Miner's Market

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!

76
Downloads
1
Followers
2 months ago
Updated
📦
20
Versions

📖About 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


📜 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


Developed for Minecraft Java Edition 1.20.1–1.21.9

Race to riches! ⛏️