begin live server support

README.md

@@ -39,6 +39,93 @@ Run the dev server:
 npm start
 ```
 
+### Relay Server
+
+The relay server bridges WebSocket connections from the browser to Tribes 2 game
+servers via UDP. This is necessary because browsers can't open UDP sockets
+directly.
+
+#### Local development
+
+First, obtain TribesNext account credentials:
+
+```console
+npm run login
+```
+
+This prompts for your TribesNext username and password, downloads the account
+certificate and encrypted key, and writes them to `.env.local`.
+
+Then run the relay (or use `npm run start:both` to run it alongside the Next.js
+dev server):
+
+```console
+npm run relay:dev
+```
+
+#### Deploying to Fly.io
+
+The relay is configured for [Fly.io](https://fly.io) deployment via
+`relay/Dockerfile` and `fly.toml`. It needs a persistent volume to hold game
+assets (~1.5 GB) used for the CRC integrity check.
+
+**1. Create the app and volume:**
+
+```console
+fly launch          # creates the app (adjust app name in fly.toml if needed)
+fly volumes create gamedata --region ord --size 3
+```
+
+**2. Set account credentials as secrets:**
+
+Run `npm run login` locally first if you haven't already, then copy the values
+from `.env.local`:
+
+```console
+fly secrets set \
+  T2_ACCOUNT_NAME=... \
+  T2_ACCOUNT_PASSWORD=... \
+  T2_ACCOUNT_CERTIFICATE=... \
+  T2_ACCOUNT_ENCRYPTED_KEY=...
+```
+
+**3. Deploy:**
+
+```console
+fly deploy
+```
+
+**4. Populate game assets on the volume:**
+
+SSH into the running machine and clone the repo to get `docs/base/`:
+
+```console
+fly ssh console
+```
+
+Then inside the machine:
+
+```sh
+apt-get update && apt-get install -y git
+git clone --depth 1 --filter=blob:none --sparse \
+  https://github.com/exogen/t2-mapper.git /tmp/t2-mapper
+cd /tmp/t2-mapper
+git sparse-checkout set docs/base
+mv docs/base /data/base
+rm -rf /tmp/t2-mapper
+```
+
+This only needs to be done once — the volume persists across deploys.
+
+**Environment variables** (all optional, with defaults):
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `RELAY_PORT` | `8765` | WebSocket listen port |
+| `GAME_BASE_PATH` | `docs/base` relative to relay | Path to extracted game assets |
+| `MANIFEST_PATH` | `public/manifest.json` relative to project root | Path to resource manifest |
+| `T2_MASTER_SERVER` | `master.tribesnext.com` | Master server for server list queries |
+
 ### Running scripts
 
 [tsx](https://tsx.is) is included to run TypeScript files directly.