README.md

⛏️   Minetris   🟦

You're inside the Tetris board now

Pieces are falling. Around you. On you.

---

      🟦
   🟦 🟦       ← that's coming down
      🟦

         YOU ARE HERE  ↓

⬛ ⬛ ⬛ ⬛ ⬛ ⬛ ⬛ ⬛
🟫 ⬛ 🟫 🟫 ⬛ 🟫 🟫 ⬛   ← mine these
🟫 🟫 🟫 🟫 🟫 🟫 🟫 🟫   ← this row clears

---

---

Minetris drops you onto the floor of a Tetris board — first-person, fully 3D. Tetrominoes fall from above. They stack into walls around you. They pile up. They close in.

Your pickaxe is the only thing keeping you alive.

W A S D	Space	Mouse	Click
Move	Jump	Look	Mine

Break blocks. Collect them. Fill a complete layer — it vanishes in a cascade of light and points. Leave a layer incomplete and it just... stays. And the next piece falls on top.

And the next.

And the next.

---

Random. Chaotic. Beautiful.

And merciless.

_{Built with Three.js  ·  Tone.js  ·  Pure browser JS  ·  MIT}

---

Development

Setup

Install git hooks to automatically run checks before pushing:

bash tools/install-hooks.sh

This installs a pre-push hook that runs the smoke test and blocks pushes if it fails.

Validate JS Syntax

Run the syntax checker before deploying to catch parse errors early:

node tools/validate.js

Exits with non-zero if any file in js/ has a syntax error.

Smoke Test

Run the full smoke test to verify JS syntax, DOM elements, mode cards, and script references:

node tools/smoke-test.js

This runs automatically on git push if you've installed the hooks.