its_simpl.json - Simpl

Every server boots with /simpl/its_simpl.json already on disk, before your process starts. The path is the same whether you deployed a ZIP build or a Docker image.

Schema

{
  "server_id": "srv_a1b2c3",
  "match_id": "match_d4e5f6",
  "queue_id": "queue_g7h8i9",
  "region": "iad",
  "version_tag": "0.1.0",
  "network_ports": [
    {
      "name": "game",
      "protocol": "udp",
      "internal_port": 7777,
      "external_port": 31456,
      "host": "iad.servers.simpl.gg",
      "ip": "203.0.113.10",
      "tls_enabled": false
    }
  ],
  "lobby_ids": ["lobby_j1k2l3"],
  "players": [
    {
      "player_id": "player_m4n5o6",
      "lobby_id": "lobby_j1k2l3",
      "team": "survivors",
      "role": "survivor",
      "state": {
        "mmr": 1450
      }
    }
  ],
  "custom_data": {}
}

Fields

Field	Description
`server_id`	Unique ID of this server instance
`match_id`	Unique ID of the match this server is running
`queue_id`	The queue that produced this match, if any
`region`	Region the server is running in
`version_tag`	The build version this server is running
`network_ports`	Ports your process should bind and clients should connect to
`lobby_ids`	Lobbies included in this match
`players`	Players assigned to this match
`custom_data`	Arbitrary data attached when the server was booted

Network ports

Each entry in network_ports describes one port your server exposes. host follows the pattern {region}.servers.simpl.gg. Clients connect to host:external_port; your process binds internal_port. UDP listeners must bind to SIMPL_UDP_BIND_ADDRESS, not 0.0.0.0 or a hardcoded interface. TCP listeners must bind to SIMPL_TCP_BIND_ADDRESS.