Files
Commonwealth-Online-Public/protocol
andrew 5b54db64d4 Character Appearance Phase 1 Done
Bump appearance payloads to version 2 and add `morphRegions` and `facialBoneMorphs` capture, serialization, and proxy application. Also fix head-part syncing when sender and proxy counts differ by reallocating the proxy array instead of deferring the whole list, and update the Python harness and protocol docs to match.
2026-06-30 17:37:02 +12:00
..
2026-06-30 17:37:02 +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.