Files
Commonwealth-Online-Public/protocol
andrew 4b8f5246c4 Add appearance sync and late-join replay
Adds optional `appearance` snapshots to transform packets, applies supported appearance data to runtime proxies, and has the server replay stored transforms to newly connected clients so late joiners receive current visuals immediately.
2026-06-29 16:46:50 +12:00
..

Protocol

This folder documents the planned network protocol for Commonwealth Online.

The first protocol should be simple and focused on player transform sync.

First Packet Types

  • Welcome packet
  • Transform packet
  • World state packet (host time and weather) — see world-state.md
  • Server world state packet (dev GUI weather/time) — see server-world-state.md
  • Disconnect packet

Future Packet Types

  • Animation state packet
  • Fire weapon packet
  • Health packet
  • Chat packet
  • Cell change packet

Design Goals

The protocol should be:

  • Simple
  • Easy to debug
  • Versioned
  • Safe to extend
  • Clear enough to test outside Fallout 4

Early Testing

The protocol should be testable using fake clients before being connected to Fallout 4.