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 questward.timfalken.com (or your host) with callback path /auth/callback in the auth admin panel.
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.
Source
| 1 | # Questward |
| 2 | |
| 3 | 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`. |
| 4 | |
| 5 | ## Layout |
| 6 | |
| 7 | - `shared/` — protocol constants and tile definitions used by server and client |
| 8 | - `server/src/` — Node.js simulation, persistence, editor API, gateway |
| 9 | - `client/src/` — game client on top of FrameworkV3 |
| 10 | - `client/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. |
| 11 | - `client/frameworkv3/` — FrameworkV3 git submodule |
| 12 | |
| 13 | ## Run locally |
| 14 | |
| 15 | ```text |
| 16 | git submodule update --init --recursive |
| 17 | npm install |
| 18 | npm run build:client |
| 19 | npm test |
| 20 | npm start |
| 21 | ``` |
| 22 | |
| 23 | Open [http://localhost:8080](http://localhost:8080) to play and [http://localhost:8080/editor](http://localhost:8080/editor) for the world editor. |
| 24 | |
| 25 | Sign in via [auth.timfalken.com](https://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](http://localhost:8080/editor), save, then **Apply now** before a character can walk. |
| 26 | |
| 27 | ### Auth env (production) |
| 28 | |
| 29 | | Variable | Purpose | |
| 30 | |----------|---------| |
| 31 | | `QUESTWARD_AUTH_CLIENT_SECRET` | OAuth client secret from auth.timfalken.com `/admin` | |
| 32 | | `QUESTWARD_AUTH_CLIENT_ID` | Registered domain (default `timfalken.com`) | |
| 33 | | `QUESTWARD_AUTH_REDIRECT_URI` | Callback URL (default: `{public-origin}/auth/callback`) | |
| 34 | | `QUESTWARD_AUTH_URL` | Auth base URL (default `https://auth.timfalken.com`) | |
| 35 | | `QUESTWARD_AUTH_STUB=1` | Force stub auth | |
| 36 | |
| 37 | Register `questward.timfalken.com` (or your host) with callback path `/auth/callback` in the auth admin panel. |
| 38 | |
| 39 | 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. |