Questward
Authoritative Node.js tile MMO with a FrameworkV3 web client. Architecture lives in questward_server_technical_design_v0.6.md. Implementation status lives in docs/FEATURES.md.
Layout
shared/— protocol constants and tile definitions used by server and clientserver/src/— Node.js simulation, persistence, editor API, gatewayclient/src/— game client on top of FrameworkV3client/assets/— world sprites. Grounds and blocks live in a folder per type; each PNG is a visual state (first alphabetical is the default). Pivot is 8px from the bottom.client/frameworkv3/— FrameworkV3 git submodule
Run locally
git submodule update --init --recursive
npm install
npm run build:client
npm test
npm start
Open http://localhost:8080 to play and http://localhost:8080/editor for the world editor.
Sign in via auth.timfalken.com (OAuth). Without QUESTWARD_AUTH_CLIENT_SECRET, local dev uses stub admins (admin-1, …). A fresh world is infinite closed grass: open chunk 0,0 in the world editor, save, then Apply now before a character can walk.
Auth env (production)
| Variable | Purpose |
|---|---|
QUESTWARD_AUTH_CLIENT_SECRET | OAuth client secret from auth.timfalken.com /admin |
QUESTWARD_AUTH_CLIENT_ID | Registered domain (default timfalken.com) |
QUESTWARD_AUTH_REDIRECT_URI | Callback URL (default: {public-origin}/auth/callback) |
QUESTWARD_AUTH_URL | Auth base URL (default https://auth.timfalken.com) |
QUESTWARD_AUTH_STUB=1 | Force stub auth |
Register timfalken.com in auth admin with callback path /auth/callback and allowed port 1234 if using :1234.
Production env file (systemd)
On the game host, put secrets outside git:
sudo mkdir -p /etc/questward
sudo nano /etc/questward/env # QUESTWARD_AUTH_CLIENT_SECRET=...
sudo chmod 600 /etc/questward/env
The systemd unit loads /etc/questward/env automatically (EnvironmentFile=-/... — missing file is OK). Reinstall or daemon-reload after edits.
cd ~/questward
sudo QUESTWARD_USER=timfa QUESTWARD_REPO="$HOME/questward" ./deploy/install-service.sh
The player-driven Central Exchange marketplace is live (hidden order book, escrow, midpoint matching, pigeon settlement). Place a Central Exchange counter in the editor next to a bank.