How to play Dungeon Blitz?

Everything runs on your own machine — the server, the game files and your saves. No account on anyone else's server, and no internet connection needed once it is set up.

Requirements

1. Node.js (LTS) — the game server runs on it.
2. FlashBrowser — Dungeon Blitz is a Flash game and modern browsers dropped Flash in 2020. Any standalone Flash player pointed at http://localhost:8000 also works.
3. GitHub Desktop — or git if you prefer the command line.

Getting the game

Clone the repository on GitHub Desktop, or:

git clone https://github.com/theminesastudios/dungeon-blitz-r.git
cd dungeon-blitz-r

Starting it

Run the launcher for your system:

System	File
macOS	dev-mac.command — double-click, or ./dev-mac.command in Terminal
Windows	dev-windows.bat — double-click

The launcher pulls the latest code (stashing your local saves first), installs dependencies, starts the server, and opens the game once it is listening.

Leave the terminal window open while you play. Closing it stops the server.

If you would rather drive it yourself:

npm install
npm run dev

Then open the game in FlashBrowser using:

http://localhost:8000

Making a character

Register any email and password on the login screen. It is your own server, so the account is created on the spot.

• Accounts live in src/server/data/Accounts.json
• Characters live in src/server/data/saves/, which git ignores — updating the project never overwrites your progress

Skipping to the content

If you want to try the endgame without playing through it, there is a seeder that creates a test account with six characters — one fully-completed and one brand new for each of the three classes:

cd src/server && npm run seed:test-account

That gives you test@theminesa.studio with the password testtest (override with TEST_ACCOUNT_PASSWORD), and these characters:

Character	State
MaxMage, MaxPaladin, MaxRogue	Level 50, all 293 missions claimed, all 39 class abilities at rank 10, maxed talents and buildings, every mount, pet, charm, dye and material
NewMage, NewPaladin, NewRogue	Level 1, nothing unlocked

Re-running the seeder is safe — it reuses the account and rewrites the six characters. It refuses to run against a multiplayer server, since it writes a known password.

If it does not start

Symptom	Cause
ERROR: Node.js is not installed or not on PATH	Install Node.js LTS and re-run the launcher.
The browser opens but the page is blank	Flash is not enabled in that browser. Use FlashBrowser or a standalone Flash player.
Port 8000 already in use	Another copy of the server is still running. Close its terminal window.
The launcher stashed your changes and you want them back	git stash list then git stash pop — the launcher labels its stashes with a timestamp.