BlueGit

timfa questward

Files

questward
README.md

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

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)

VariablePurpose
QUESTWARD_AUTH_CLIENT_SECRETOAuth client secret from auth.timfalken.com /admin
QUESTWARD_AUTH_CLIENT_IDRegistered domain (default timfalken.com)
QUESTWARD_AUTH_REDIRECT_URICallback URL (default: {public-origin}/auth/callback)
QUESTWARD_AUTH_URLAuth base URL (default https://auth.timfalken.com)
QUESTWARD_AUTH_STUB=1Force 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.