💎 Gem Masters

Descend into crystal caverns, gather precious gems, and build your treasure empire! Gem Masters is a top‑down mining adventure with deep tycoon mechanics. Explore 5 unique depths, upgrade your gear, and race to find the legendary Diamond of Legends – or amass 10,000 gold through smart expeditions.

🎮 How It Works

• ⛏️ Enter the Mine – Choose your depth (1–5) and descend. Each level has a unique theme (Sandstone Caverns, Crystal Grotto, Amethyst Depths, Ruby Chambers, Diamond Core) with different gem colors and values.
• 🕹️ Move & Collect – Use WASD / Arrow Keys to walk over sparkling gems. Each gem adds to your expedition haul.
• ⚡ Energy Matters – Moving costs energy. When energy hits 0, you’re forced back to the surface. Upgrade your energy capacity to stay longer.
• 🔝 Return via Elevator – Stand on the glowing green elevator tile and press E to exit the mine. All collected gems are sold automatically – with a bonus multiplier from your pickaxe level.
• 🛒 Upgrade Your Setup – Spend gold on permanent upgrades: Better Pickaxe → increase gem sale value Energy Booster → more max energy Speed Boots → faster movement Lucky Charm → more gems spawn
• 💰 Win Conditions – 1️⃣ Find the Diamond of Legends (depth 5) – worth 5,000 gold! 2️⃣ Or accumulate 10,000 gold total.

✨ Features

✔ 5 distinct depths with unique visuals, gem colors, and wall/floor designs ✔ Persistent upgrades – keep improving across expeditions ✔ Energy & risk management – push deeper or return early ✔ Auto‑save & manual saves (3 slots) – never lose progress ✔ Full keyboard + mouse UI – also buttons for everything ✔ Sound effects (collect, buy, error, elevator, win) – toggle mute anytime ✔ Immersive 2D top‑down view with smooth movement and collision detection ✔ Dynamic gem spawning – every expedition feels fresh

🕹️ Controls (quick reference)

Key / Button	Action
WASD / Arrows	Move in mine
E	Use elevator (exit mine)
B	Open shop (on surface)
H	Help screen
M	Mute / unmute
F5	Quick save (slot 1)
⬆️ / ⬇️ side buttons	Change depth (outside mine)
⛏️ Mine side button	Enter the mine quickly

All menu buttons are also available on screen.

🏆 The Goal

• Primary Win: Reach depth 5 and collect the Diamond of Legends – a massive white gem worth 5,000 gold.
• Alternate Win: Amass 10,000 gold through many successful expeditions.
• Defeat? There’s no hard game over – you can always try again. But failure means returning empty‑handed or with spent energy.

🌐 Platform

• Browser only – works on Chrome, Firefox, Edge, Safari (desktop strongly recommended for best experience).
• Responsive layout – buttons and canvas scale, but full map is best on larger screens.

“Mining has never been this addictive. Upgrading my pickaxe feels so satisfying!” – Early Tester

Ready to become a Gem Master? The caves are waiting… 💎