# 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 client - `server/src/` — Node.js simulation, persistence, editor API, gateway - `client/src/` — game client on top of FrameworkV3 - `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. - `client/frameworkv3/` — FrameworkV3 git submodule ## Run locally ```text git submodule update --init --recursive npm install npm run build:client npm test npm start ``` Open [http://localhost:8080](http://localhost:8080) to play and [http://localhost:8080/editor](http://localhost:8080/editor) for the world editor. 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. ### 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: ```bash 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. ```bash 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.