bhandras/dungeon

★ 0Forks 0JavaScriptGitHub ↗Compare

README

Dungeon Blackout

A browser-based top-down dungeon survival shooter built with Three.js.

Source repository: https://github.com/bhandras/dungeon

If GitHub Pages is enabled for the repository, the game can be hosted directly from the main branch root at:

https://bhandras.github.io/dungeon/

Run locally

Because the game uses ES modules, serve the folder with a simple local web server and open index.html in your browser.

Examples:

cd dungeon
python -m http.server 8000

Then open http://localhost:8000/.

Controls

  • Move: WASD
  • Aim: mouse
  • Fire: left mouse
  • Throw grenade: right mouse or Space
  • Cycle weapons: Q
  • Switch directly: 1 to 5
  • Restart: R

Notes

  • The torch uses a long forward cone with softer spill around the player.
  • Weapons use layered projectile, glow, shockwave, and particle effects.
  • The minimap reveals only explored dungeon space and stays uncovered as you survive.
  • The dungeon is procedurally generated.
  • Pickups include health, ammo, grenades, and weapon crates.

Contributors

bhandras

Issues