Skip to content

Page: Servers

Server fleet management with hosting API lifecycle controls.

Overview

The Servers page displays all registered game servers in the cluster. It shows live status, player counts, regions, and provides hosting API controls for server lifecycle management.

Server Grid

Each server is displayed as a card with:

Field Source Description
Display Name ServerRegistry.display_name Human-readable server name
Status ServerRegistry.status online / offline / restarting / wiping
Region ServerRegistry.region Geographic region (us-east, eu-west, etc.)
Players ServerRegistry.online_count / max_players Current / maximum player count
Game Mode ServerRegistry.game_mode pvp / pve / creative
Last Heartbeat ServerRegistry.last_heartbeat Time since last bridge heartbeat (30s interval)
Version ServerRegistry.version Game build version

Servers with stale heartbeats (>90 seconds) display a degraded status badge.

Hosting Controls

Server lifecycle actions are powered by the BisectHosting Starbase API, proxied through the API Gateway:

Action Min Role Rate Limit Description
Start Admin 1 per 60s per server Start the game server process
Stop Admin 1 per 60s per server Gracefully stop the server
Restart Admin 1 per 60s per server Stop then start
Wipe Owner 1 per 60s per server Full server wipe (destructive)

All actions require confirmation dialogs and produce toast notifications on success/failure.