Server manual

This part is for server owners. A WildM server is a small Node.js program, game-server/server.js, with no npm dependencies. It serves server information and resources over HTTP, keeps players in sync over TCP, and announces itself to the WFX.re master server.

These docs

This documentation is served by the master server at <master>/docs/ (http://127.0.0.1:7777/docs/ in development, https://wfx.re/docs/ once published).

Quick start

1. Register your server on the Portal and copy its server key — Getting a server key.
2. Edit server.json: name, ports, max players, spawn, and your key in svKey — server.json.
3. Add resources in resources/; a loadscreen/ folder becomes your loading screen — Resources & loading screen.
4. Open the ports (HTTP 30120, TCP 30121 by default) — Ports, LAN & firewall.
5. Start it:

cd game-server
node server.js        # or: npm start

The console shows the HTTP and TCP addresses, the resource count, and the master's answer to the first heartbeat:

[WildM] ressources : 2 fichiers, 0.0 Mo
[WildM] http  http://192.168.1.20:30120
[WildM] jeu   tcp://192.168.1.20:30121
[WildM] master : annonce acceptée, serveur visible dans la liste WFX.re

Within seconds the server is in the WFX.re list — Heartbeat & server list.

No key, no listing — but still playable

Without a valid svKey the server runs normally and players can join it with direct connect (> host:30120); it just does not appear in the public list.

What the server does today

Feature	Status
/info, resource manifest, resource downloads	Implemented
Player sync: hello / welcome, positions in, player list out at 10 Hz	Implemented
Max players (Serveur plein error when full)	Implemented
Heartbeat with sv_key every 30 s	Implemented
Server-side scripting (resource code executed by the server)	Not implemented — resources are files delivered to clients
Authentication of players against WFX.re	Not implemented — hello carries a name; a token field is accepted by the client format but not checked by the server

See Project status for what has been tested.