# numunun/bodycamcomponent architecture

> Architecture diagram of the GitHub repository numunun/bodycamcomponent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/numunun/bodycamcomponent
- Repository: https://github.com/numunun/bodycamcomponent

## Overview

This is a Forge Minecraft mod for configured team/FFA matches, with combat-match lifecycle, roles and loadouts, downed/revive gameplay, domination objectives, and client HUD/presentation. Players enter through in-game commands and actions; the server runs match and combat rules, sends state over its network channel, and clients render the corresponding UI. The README is empty, so capabilities and relationships here are based on the supplied source index and excerpts; unsampled areas are included only where the tree or indexed references support them.

Main entry points: [`src/main/java/numunun/bodycamcomponent/game/GameManager.java`](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameManager.java) (Match lifecycle), [`src/main/java/numunun/bodycamcomponent/network/BodyCamNetwork.java`](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/network/BodyCamNetwork.java) (Packet channel), [`src/main/java/numunun/bodycamcomponent/BodyCamComponent.java`](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/BodyCamComponent.java) (Mod initialization), [`src/main/java/numunun/bodycamcomponent/downed/DownedManager.java`](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/downed/DownedManager.java) (Downed and revive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_match["Match control"]
  node_commands["Match commands"]
  node_manager["Match lifecycle<br/>[GameManager.java]"]
  node_settings["Match settings<br/>[GameSettings.java]"]
  node_mode["Game modes<br/>[GameMode.java]"]
  node_region["Play regions<br/>[Region.java]"]
  node_teams["Team balancing<br/>[TeamBalancer.java]"]
  node_scores["Scores and ratings<br/>[ScoreManager.java]"]
  node_reports["Match reports<br/>[ReportManager.java]"]
  node_domination["Domination mode"]
end

subgraph group_combat["Combat systems"]
  node_roles["Roles and abilities<br/>[RoleManager.java]"]
  node_respawn["Respawn handling"]
  node_loadout["Loadout management"]
  node_downed["Downed and revive<br/>[DownedManager.java]"]
  node_ping["Player pings<br/>[PingManager.java]"]
  node_corpse["Corpse entity<br/>[CorpseEntity.java]"]
end

subgraph group_presentation["Client presentation"]
  node_client["Client HUD and effects"]
  node_clientdowned["Downed client state<br/>[DownedClient.java]"]
end

subgraph group_transport["Networking"]
  node_network["Packet channel"]
end

subgraph group_foundation["Mod foundation"]
  node_config["Mod configuration<br/>[BodyCamConfig.java]"]
  node_entityregistry["Entity registry<br/>[ModEntities.java]"]
  node_main["Mod initialization"]
  node_matchlog["Match event log<br/>[MatchLog.java]"]
end

node_player(("Players"))

node_player -.->|"issues commands"| node_commands
node_commands -.->|"controls match"| node_manager
node_manager -->|"reads settings"| node_settings
node_manager -->|"selects mode"| node_mode
node_manager -->|"validates regions"| node_region
node_manager -->|"balances teams"| node_teams
node_manager -->|"resets scores"| node_scores
node_manager -->|"resets roles"| node_roles
node_manager -->|"delegates respawn"| node_respawn
node_manager -->|"starts reports"| node_reports
node_manager -->|"uses loadouts"| node_loadout
node_manager -->|"uses downed state"| node_downed
node_manager -->|"dispatches mode"| node_domination
node_manager -->|"clears corpses"| node_corpse
node_manager -->|"records events"| node_matchlog
node_manager -->|"sends match OSD"| node_network
node_roles -->|"syncs abilities"| node_network
node_domination -->|"syncs objective HUD"| node_network
node_ping -->|"sends ping packets"| node_network
node_reports -->|"sends intro packet"| node_network
node_downed -->|"syncs downed state"| node_network
node_downed -->|"checks match mode"| node_manager
node_respawn -->|"restores loadout"| node_loadout
node_client -->|"registers client events"| node_main
node_client -->|"registers corpse renderer"| node_entityregistry
node_clientdowned -->|"reads downed state"| node_downed
node_main -->|"registers config"| node_config
node_main -->|"registers channel"| node_network
node_main -->|"registers entities"| node_entityregistry
node_entityregistry -->|"creates entity type"| node_corpse
node_network -.->|"delivers client packets"| node_client
node_player -.->|"requests pings"| node_ping

click node_commands "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/command/BodyCamCommands.java"
click node_manager "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameManager.java"
click node_settings "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameSettings.java"
click node_mode "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameMode.java"
click node_region "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/Region.java"
click node_teams "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/TeamBalancer.java"
click node_roles "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/RoleManager.java"
click node_scores "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/ScoreManager.java"
click node_reports "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/ReportManager.java"
click node_respawn "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/RespawnManager.java"
click node_loadout "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/loadout/LoadoutManager.java"
click node_downed "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/downed/DownedManager.java"
click node_domination "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/DominationManager.java"
click node_ping "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/PingManager.java"
click node_corpse "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/entity/CorpseEntity.java"
click node_config "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/config/BodyCamConfig.java"
click node_network "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/network/BodyCamNetwork.java"
click node_client "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/client/ClientModEvents.java"
click node_clientdowned "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/client/DownedClient.java"
click node_entityregistry "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/registry/ModEntities.java"
click node_main "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/BodyCamComponent.java"
click node_matchlog "https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/util/MatchLog.java"

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_commands,node_manager,node_settings,node_mode,node_region,node_teams,node_scores,node_reports,node_domination toneBlue
class node_roles,node_respawn,node_loadout,node_downed,node_ping,node_corpse toneAmber
class node_client,node_clientdowned toneMint
class node_network toneRose
class node_config,node_entityregistry,node_main,node_matchlog,node_player toneIndigo
```

## Components

### Match control

- [Match commands](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/command/BodyCamCommands.java): `src/main/java/numunun/bodycamcomponent/command/BodyCamCommands.java`
- [Match lifecycle](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameManager.java): `src/main/java/numunun/bodycamcomponent/game/GameManager.java`
- [Match settings](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameSettings.java): `src/main/java/numunun/bodycamcomponent/game/GameSettings.java`
- [Game modes](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/GameMode.java): `src/main/java/numunun/bodycamcomponent/game/GameMode.java`
- [Play regions](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/Region.java): `src/main/java/numunun/bodycamcomponent/game/Region.java`
- [Team balancing](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/TeamBalancer.java): `src/main/java/numunun/bodycamcomponent/game/TeamBalancer.java`
- [Scores and ratings](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/ScoreManager.java): `src/main/java/numunun/bodycamcomponent/game/ScoreManager.java`
- [Match reports](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/ReportManager.java): `src/main/java/numunun/bodycamcomponent/game/ReportManager.java`
- [Domination mode](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/DominationManager.java): `src/main/java/numunun/bodycamcomponent/game/DominationManager.java`

### Combat systems

- [Roles and abilities](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/RoleManager.java): `src/main/java/numunun/bodycamcomponent/game/RoleManager.java`
- [Respawn handling](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/RespawnManager.java): `src/main/java/numunun/bodycamcomponent/game/RespawnManager.java`
- [Loadout management](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/loadout/LoadoutManager.java): `src/main/java/numunun/bodycamcomponent/loadout/LoadoutManager.java`
- [Downed and revive](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/downed/DownedManager.java): `src/main/java/numunun/bodycamcomponent/downed/DownedManager.java`
- [Player pings](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/game/PingManager.java): `src/main/java/numunun/bodycamcomponent/game/PingManager.java`
- [Corpse entity](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/entity/CorpseEntity.java): `src/main/java/numunun/bodycamcomponent/entity/CorpseEntity.java`

### Client presentation

- [Client HUD and effects](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/client/ClientModEvents.java): `src/main/java/numunun/bodycamcomponent/client/ClientModEvents.java`
- [Downed client state](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/client/DownedClient.java): `src/main/java/numunun/bodycamcomponent/client/DownedClient.java`

### Networking

- [Packet channel](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/network/BodyCamNetwork.java): `src/main/java/numunun/bodycamcomponent/network/BodyCamNetwork.java`

### Mod foundation

- [Mod configuration](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/config/BodyCamConfig.java): `src/main/java/numunun/bodycamcomponent/config/BodyCamConfig.java`
- [Entity registry](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/registry/ModEntities.java): `src/main/java/numunun/bodycamcomponent/registry/ModEntities.java`
- [Mod initialization](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/BodyCamComponent.java): `src/main/java/numunun/bodycamcomponent/BodyCamComponent.java`
- [Match event log](https://github.com/numunun/bodycamcomponent/blob/main/src/main/java/numunun/bodycamcomponent/util/MatchLog.java): `src/main/java/numunun/bodycamcomponent/util/MatchLog.java`

### Other components

- **Players**

## Connections

- Players → Match commands: issues commands
- Match commands → Match lifecycle: controls match (evidence: `src/main/java/numunun/bodycamcomponent/command/BodyCamCommands.java`)
- Match lifecycle → Match settings: reads settings (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Game modes: selects mode (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Play regions: validates regions (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Team balancing: balances teams (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Scores and ratings: resets scores (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Roles and abilities: resets roles (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Respawn handling: delegates respawn (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Match reports: starts reports (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Loadout management: uses loadouts (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Downed and revive: uses downed state (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Domination mode: dispatches mode (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Corpse entity: clears corpses (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Match event log: records events (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Match lifecycle → Packet channel: sends match OSD (evidence: `src/main/java/numunun/bodycamcomponent/game/GameManager.java`)
- Roles and abilities → Packet channel: syncs abilities (evidence: `src/main/java/numunun/bodycamcomponent/game/RoleManager.java`)
- Domination mode → Packet channel: syncs objective HUD (evidence: `src/main/java/numunun/bodycamcomponent/game/DominationManager.java`)
- Player pings → Packet channel: sends ping packets (evidence: `src/main/java/numunun/bodycamcomponent/game/PingManager.java`)
- Match reports → Packet channel: sends intro packet (evidence: `src/main/java/numunun/bodycamcomponent/game/ReportManager.java`)
- Downed and revive → Packet channel: syncs downed state (evidence: `src/main/java/numunun/bodycamcomponent/downed/DownedManager.java`)
- Downed and revive → Match lifecycle: checks match mode (evidence: `src/main/java/numunun/bodycamcomponent/downed/DownedManager.java`)
- Respawn handling → Loadout management: restores loadout (evidence: `src/main/java/numunun/bodycamcomponent/game/RespawnManager.java`)
- Client HUD and effects → Mod initialization: registers client events (evidence: `src/main/java/numunun/bodycamcomponent/client/ClientModEvents.java`)
- Client HUD and effects → Entity registry: registers corpse renderer (evidence: `src/main/java/numunun/bodycamcomponent/client/ClientModEvents.java`)
- Downed client state → Downed and revive: reads downed state (evidence: `src/main/java/numunun/bodycamcomponent/client/DownedClient.java`)
- Mod initialization → Mod configuration: registers config (evidence: `src/main/java/numunun/bodycamcomponent/BodyCamComponent.java`)
- Mod initialization → Packet channel: registers channel (evidence: `src/main/java/numunun/bodycamcomponent/BodyCamComponent.java`)
- Mod initialization → Entity registry: registers entities (evidence: `src/main/java/numunun/bodycamcomponent/BodyCamComponent.java`)
- Entity registry → Corpse entity: creates entity type (evidence: `src/main/java/numunun/bodycamcomponent/registry/ModEntities.java`)
- Packet channel → Client HUD and effects: delivers client packets
- Players → Player pings: requests pings
