# 1person280/cute-of-duty architecture

> Architecture diagram of the GitHub repository 1person280/cute-of-duty, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1person280/cute-of-duty
- Repository: https://github.com/1person280/cute-of-duty

## Overview

Cute Of Duty is a server-authoritative tactical extraction shooter. The player-facing loop runs from menu/loadout into a match, where the client sends intent, the server simulates combat and world state, and snapshots feed the client’s HUD and 3D presentation; extraction returns the player to the menu. The graph combines documented architecture and sampled call structure. Some major gameplay and networking subsystems are represented from README descriptions and the source index; their internal calls are not inferred where source was not sampled.

Main entry points: [`HostCode/net/network.rs`](https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/network.rs) (Client networking), [`HostCode/launcher/mod.rs`](https://github.com/1person280/cute-of-duty/blob/main/HostCode/launcher/mod.rs) (Client assembly), [`ServerCode/net/session.rs`](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/net/session.rs) (Session and transport), [`ServerCode/engine/mod.rs`](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/engine/mod.rs) (Authoritative tick)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_contract["Shared contracts"]
  node_contract_codec["Wire codec<br/>[codec.rs]"]
  node_contract_packets["Packet format<br/>[packet.rs]"]
  node_contract_protocol["Message protocol<br/>[protocol.rs]"]
  node_contract_elements["Element rules<br/>[element.rs]"]
  node_contract_operators["Operator catalog<br/>[operator.rs]"]
  node_server_map["Map definitions<br/>[mod.rs]"]
end

subgraph group_client["Client presentation"]
  node_client_entry["Client entry<br/>[main.rs]"]
  node_client_assembly["Client assembly<br/>[mod.rs]"]
  node_client_flow["Client flow<br/>[state.rs]"]
  node_client_menu["Menu and loadout<br/>[mod.rs]"]
  node_client_net["Client networking<br/>[network.rs]"]
  node_client_snapshot["Snapshot rendering<br/>[snapshot.rs]"]
  node_client_remote["Remote resources<br/>[remote.rs]"]
  node_client_hud["Combat HUD<br/>[vitals.rs]"]
  node_client_maps["Map HUD<br/>[minimap.rs]"]
  node_client_items["Inventory UI<br/>[wheel.rs]"]
  node_client_world["3D world and camera<br/>[scene.rs]"]
  node_client_camera["Camera rig<br/>[camera.rs]"]
end

subgraph group_server["Authoritative server"]
  node_server_entry["Server entry<br/>[main.rs]"]
  node_server_net["Session and transport<br/>[session.rs]"]
  node_server_engine["Authoritative tick<br/>[mod.rs]"]
  node_server_combat["Combat simulation<br/>[mod.rs]"]
  node_server_domain["World and gameplay<br/>[mod.rs]"]
  node_server_config["Game configuration<br/>[mod.rs]"]
  node_server_inventory["Inventory service<br/>[service.rs]"]
end

subgraph group_platform["Server services"]
  node_server_storage[("Persistence<br/>[mod.rs]")]
  node_server_web["Web services<br/>[router.rs]"]
end

node_player(("Player"))
node_external_service(("External clients"))

node_player -->|"starts"| node_client_entry
node_client_entry -->|"runs"| node_client_assembly
node_client_assembly -->|"assembles"| node_client_flow
node_client_assembly -->|"assembles"| node_client_net
node_client_assembly -->|"assembles"| node_client_menu
node_client_assembly -->|"assembles"| node_client_hud
node_client_assembly -->|"assembles"| node_client_world
node_client_menu -->|"sends intent"| node_client_net
node_client_net -->|"sends input"| node_server_net
node_server_net -->|"sends snapshots"| node_client_net
node_client_net -->|"uses messages"| node_contract_protocol
node_server_net -->|"uses messages"| node_contract_protocol
node_contract_codec -->|"encodes"| node_contract_packets
node_contract_packets -->|"carries messages"| node_contract_protocol
node_client_net -->|"delivers snapshots"| node_client_snapshot
node_client_snapshot -->|"feeds display"| node_client_hud
node_client_snapshot -->|"feeds scene"| node_client_world
node_client_net -->|"receives resources"| node_client_remote
node_client_world -->|"uses camera rig"| node_client_camera
node_client_hud -->|"includes map views"| node_client_maps
node_client_hud -->|"includes inventory UI"| node_client_items
node_client_items -.->|"sends item intent"| node_client_net
node_server_entry -.->|"starts service"| node_server_net
node_server_net -->|"dispatches input"| node_server_engine
node_server_engine -->|"advances combat"| node_server_combat
node_server_combat -->|"updates world"| node_server_domain
node_server_engine -->|"publishes snapshots"| node_server_net
node_server_config -.->|"configures rules"| node_server_engine
node_server_map -->|"defines layout"| node_client_world
node_server_inventory -.->|"maintains inventory"| node_server_domain
node_server_engine -.->|"persists state"| node_server_storage
node_external_service -.->|"uses web API"| node_server_web
node_contract_elements -.->|"shares element data"| node_server_combat
node_contract_operators -->|"supplies roster"| node_server_combat

click node_client_entry "https://github.com/1person280/cute-of-duty/blob/main/HostCode/main.rs"
click node_client_assembly "https://github.com/1person280/cute-of-duty/blob/main/HostCode/launcher/mod.rs"
click node_client_flow "https://github.com/1person280/cute-of-duty/blob/main/HostCode/flow/state.rs"
click node_client_menu "https://github.com/1person280/cute-of-duty/blob/main/HostCode/menu/mod.rs"
click node_client_net "https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/network.rs"
click node_client_snapshot "https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/snapshot.rs"
click node_client_remote "https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/remote.rs"
click node_client_hud "https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/vitals.rs"
click node_client_maps "https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/minimap.rs"
click node_client_items "https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/item/wheel.rs"
click node_client_world "https://github.com/1person280/cute-of-duty/blob/main/HostCode/world/scene.rs"
click node_client_camera "https://github.com/1person280/cute-of-duty/blob/main/HostCode/world/camera.rs"
click node_contract_codec "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/codec.rs"
click node_contract_packets "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/packet.rs"
click node_contract_protocol "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/protocol.rs"
click node_contract_elements "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/element.rs"
click node_contract_operators "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/operator.rs"
click node_server_entry "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/main.rs"
click node_server_net "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/net/session.rs"
click node_server_engine "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/engine/mod.rs"
click node_server_combat "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/combat/mod.rs"
click node_server_domain "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/entity/mod.rs"
click node_server_config "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/config/mod.rs"
click node_server_map "https://github.com/1person280/cute-of-duty/blob/main/ContractCode/map/mod.rs"
click node_server_inventory "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/inventory/service.rs"
click node_server_storage "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/storage/mod.rs"
click node_server_web "https://github.com/1person280/cute-of-duty/blob/main/ServerCode/net/web/router.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_contract_codec,node_contract_packets,node_contract_protocol,node_contract_elements,node_contract_operators,node_server_map,node_external_service toneBlue
class node_client_entry,node_client_assembly,node_client_flow,node_client_menu,node_client_net,node_client_snapshot,node_client_remote,node_client_hud,node_client_maps,node_client_items,node_client_world,node_client_camera toneAmber
class node_server_entry,node_server_net,node_server_engine,node_server_combat,node_server_domain,node_server_config,node_server_inventory toneMint
class node_server_storage,node_server_web toneRose
class node_player toneIndigo
```

## Components

### Shared contracts

- [Wire codec](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/codec.rs): `ContractCode/net/codec.rs`
- [Packet format](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/packet.rs): `ContractCode/net/packet.rs`
- [Message protocol](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/net/protocol.rs): `ContractCode/net/protocol.rs`
- [Element rules](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/element.rs): `ContractCode/element.rs`
- [Operator catalog](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/operator.rs): `ContractCode/operator.rs`
- [Map definitions](https://github.com/1person280/cute-of-duty/blob/main/ContractCode/map/mod.rs): `ContractCode/map/mod.rs`

### Client presentation

- [Client entry](https://github.com/1person280/cute-of-duty/blob/main/HostCode/main.rs): `HostCode/main.rs`
- [Client assembly](https://github.com/1person280/cute-of-duty/blob/main/HostCode/launcher/mod.rs): `HostCode/launcher/mod.rs`
- [Client flow](https://github.com/1person280/cute-of-duty/blob/main/HostCode/flow/state.rs): `HostCode/flow/state.rs`
- [Menu and loadout](https://github.com/1person280/cute-of-duty/blob/main/HostCode/menu/mod.rs): `HostCode/menu/mod.rs`
- [Client networking](https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/network.rs): `HostCode/net/network.rs`
- [Snapshot rendering](https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/snapshot.rs): `HostCode/net/snapshot.rs`
- [Remote resources](https://github.com/1person280/cute-of-duty/blob/main/HostCode/net/remote.rs): `HostCode/net/remote.rs`
- [Combat HUD](https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/vitals.rs): `HostCode/hud/vitals.rs`
- [Map HUD](https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/minimap.rs): `HostCode/hud/minimap.rs`
- [Inventory UI](https://github.com/1person280/cute-of-duty/blob/main/HostCode/hud/item/wheel.rs): `HostCode/hud/item/wheel.rs`
- [3D world and camera](https://github.com/1person280/cute-of-duty/blob/main/HostCode/world/scene.rs): `HostCode/world/scene.rs`
- [Camera rig](https://github.com/1person280/cute-of-duty/blob/main/HostCode/world/camera.rs): `HostCode/world/camera.rs`

### Authoritative server

- [Server entry](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/main.rs): `ServerCode/main.rs`
- [Session and transport](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/net/session.rs): `ServerCode/net/session.rs`
- [Authoritative tick](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/engine/mod.rs): `ServerCode/engine/mod.rs`
- [Combat simulation](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/combat/mod.rs): `ServerCode/combat/mod.rs`
- [World and gameplay](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/entity/mod.rs): `ServerCode/entity/mod.rs`
- [Game configuration](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/config/mod.rs): `ServerCode/config/mod.rs`
- [Inventory service](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/inventory/service.rs): `ServerCode/inventory/service.rs`

### Server services

- [Persistence](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/storage/mod.rs): `ServerCode/storage/mod.rs`
- [Web services](https://github.com/1person280/cute-of-duty/blob/main/ServerCode/net/web/router.rs): `ServerCode/net/web/router.rs`

### Other components

- **Player**
- **External clients**

## Connections

- Player → Client entry: starts
- Client entry → Client assembly: runs (evidence: `HostCode/main.rs`)
- Client assembly → Client flow: assembles (evidence: `HostCode/launcher/mod.rs`)
- Client assembly → Client networking: assembles (evidence: `HostCode/launcher/mod.rs`)
- Client assembly → Menu and loadout: assembles (evidence: `HostCode/launcher/mod.rs`)
- Client assembly → Combat HUD: assembles (evidence: `HostCode/launcher/mod.rs`)
- Client assembly → 3D world and camera: assembles (evidence: `HostCode/launcher/mod.rs`)
- Menu and loadout → Client networking: sends intent (evidence: `HostCode/menu/mod.rs`)
- Client networking → Session and transport: sends input
- Session and transport → Client networking: sends snapshots
- Client networking → Message protocol: uses messages
- Session and transport → Message protocol: uses messages
- Wire codec → Packet format: encodes (evidence: `ContractCode/net/mod.rs`)
- Packet format → Message protocol: carries messages (evidence: `ContractCode/net/mod.rs`)
- Client networking → Snapshot rendering: delivers snapshots
- Snapshot rendering → Combat HUD: feeds display
- Snapshot rendering → 3D world and camera: feeds scene
- Client networking → Remote resources: receives resources (evidence: `HostCode/net/mod.rs`)
- 3D world and camera → Camera rig: uses camera rig (evidence: `HostCode/world/mod.rs`)
- Combat HUD → Map HUD: includes map views (evidence: `HostCode/hud/mod.rs`)
- Combat HUD → Inventory UI: includes inventory UI
- Inventory UI → Client networking: sends item intent
- Server entry → Session and transport: starts service
- Session and transport → Authoritative tick: dispatches input (evidence: `ServerCode/engine/mod.rs`)
- Authoritative tick → Combat simulation: advances combat (evidence: `ServerCode/engine/mod.rs`)
- Combat simulation → World and gameplay: updates world (evidence: `ServerCode/combat/mod.rs`)
- Authoritative tick → Session and transport: publishes snapshots
- Game configuration → Authoritative tick: configures rules
- Map definitions → 3D world and camera: defines layout (evidence: `ContractCode/map/mod.rs`)
- Inventory service → World and gameplay: maintains inventory
- Authoritative tick → Persistence: persists state
- External clients → Web services: uses web API
- Element rules → Combat simulation: shares element data
- Operator catalog → Combat simulation: supplies roster (evidence: `ServerCode/combat/mod.rs`)
