JavaScript SDK — Regions

Regions

A game is pinned to exactly one node — its players, rooms and leaderboards exist only there. Resolve the node once, then point every call at it; a key presented on the wrong node answers 421 with a home_api_url hint.

discoverNodes
async function discoverNodes(options = {})

GET /api/discover.php — every enabled node plus the server's geo hint. No auth needed.

Example Usage:

const { nodes } = await discoverNodes();
resolveGameNode
async function resolveGameNode(apiKey, options = {})

POST /api/discover.php with the key in X-Api-Token (never in a URL) — returns the game's pinned node.

Example Usage:

const { region, node } = await resolveGameNode(apiKey);
const home = new MultiplayerClient(apiKey, { baseUrl: node.api_url });