ORBITAL Dev Protocol (v0)

Transport: WebSocket (wss) · Encoding: JSON · Endpoint: wss://dev.orbital.exesys.de/api/

Konzeptübersicht

State

players: Map<playerId, {id,x,y,vx,vy}> liegt serverseitig im RAM
Server ist authoritative: Client sendet nur Wünsche (Commands)

Tick

Fixe Tickrate: 10 Hz (100 ms)
Pro Tick: Physik/Integration → Snapshot → Broadcast

Input

WS Messages vom Client: join, move
Validation serverseitig (JSON, Types, Clamps)

Output

WS Messages vom Server: joined, state
state ist ein vollständiger Snapshot (keine Deltas)

Live-Test

Status: DISCONNECTED Player: -

Letzter Snapshot (me)

x

-

y

-

Log

Message-Format

Client → Server

JOIN

{
  "type": "join"
}

MOVE

{
  "type": "move",
  "vx": 100,
  "vy": 0
}

Constraints (server enforced): vx,vy finite numbers, clamp aktuell [-200..200]

Server → Client

JOINED

{
  "type": "joined",
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

STATE

{
  "type": "state",
  "players": [
    { "id": "uuid-1", "x": 12.3, "y": -4.0 },
    { "id": "uuid-2", "x": -1.0, "y": 9.5 }
  ]
}