Files
Commonwealth-Online-Public/protocol
andrew ad7f287899 Add optional apparel sync (equippedItems)
Introduce an optional equippedItems transform extension to snapshot tracked visible apparel slots. Plugin: capture local equipped ARMO form IDs on the game-thread, include equippedItems in transform packets, parse equippedItems on the networking thread, and apply/clear synced apparel on runtime proxies (with defensive logging for missing forms). Server: fake_client parses and prints equippedItems. Docs and protocol updated; changelog and dev-log entry added. Backwards-compatible: equippedItems is optional and empty formId denotes intentional unequip.
2026-06-29 16:02:03 +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.