# cognifydev/clashofgods architecture

> Architecture diagram of the GitHub repository cognifydev/clashofgods, 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/cognifydev/clashofgods
- Repository: https://github.com/cognifydev/clashofgods

## Overview

ClashOfGods is an Among Us gameplay mod with custom roles, networked role RPCs, event-driven game integration, configurable UI, cosmetics, and an extensible plugin system—especially Python plugins. The main startup workflow loads the mod, registers listeners and roles, then reacts to game events to provide gameplay behavior. The graph emphasizes documented and indexed subsystem relationships; some plugin and UI integrations are represented without verified call edges because their source was not excerpted.

Main entry points: [`COG/Main.cs`](https://github.com/cognifydev/clashofgods/blob/main/COG/Main.cs) (Mod startup), [`COG/Role/CustomRole.cs`](https://github.com/cognifydev/clashofgods/blob/main/COG/Role/CustomRole.cs) (Custom roles), [`COG/UI/Load/SplashManagerPatch.cs`](https://github.com/cognifydev/clashofgods/blob/main/COG/UI/Load/SplashManagerPatch.cs) (Load sequence), [`COG/Listener/ListenerManager.cs`](https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/ListenerManager.cs) (Listener dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Events"]
  node_main["Mod startup<br/>[Main.cs]"]
  node_splash["Load sequence"]
  node_listeners["Listener dispatch<br/>[ListenerManager.cs]"]
  node_gameevents["Game event types<br/>[Event.cs]"]
  node_configs["Configuration<br/>[ConfigBase.cs]"]
end

subgraph group_gameplay["Gameplay Systems"]
  node_roles["Custom roles<br/>[CustomRole.cs]"]
  node_rolemanager["Role registry"]
  node_roleimpl["Built-in roles<br/>[Unknown.cs]"]
  node_rolerpc["Role RPC dispatch<br/>[RoleRpcManager.cs]"]
  node_winners["Winner evaluation"]
end

subgraph group_extension["Plugins and Cosmetics"]
  node_resources["Plugin resources"]
  node_python["Python plugins"]
  node_cosmetics["Custom cosmetics"]
end

subgraph group_playerui["Player Options and UI"]
  node_clientoptions["Client options"]
  node_buttons["Custom buttons<br/>[CustomButton.cs]"]
end

node_player(("Among Us player"))

node_player -.->|"starts mod"| node_main
node_main -.->|"loads through"| node_splash
node_splash -->|"registers listeners"| node_listeners
node_splash -->|"registers roles"| node_roleimpl
node_listeners -->|"dispatches events"| node_gameevents
node_listeners -->|"dispatches role events"| node_rolemanager
node_main -->|"loads configuration"| node_configs
node_rolemanager -->|"stores roles"| node_roles
node_roles -->|"registers buttons"| node_buttons
node_roles -->|"registers RPCs"| node_rolerpc
node_rolerpc -->|"resolves role IDs"| node_rolemanager
node_roles -.->|"supplies win logic"| node_winners
node_main -->|"unloads resources"| node_resources
node_resources -.->|"loads plugins"| node_python
node_resources -.->|"loads cosmetic resources"| node_cosmetics
node_clientoptions -->|"reads language settings"| node_configs

click node_main "https://github.com/cognifydev/clashofgods/blob/main/COG/Main.cs"
click node_splash "https://github.com/cognifydev/clashofgods/blob/main/COG/UI/Load/SplashManagerPatch.cs"
click node_listeners "https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/ListenerManager.cs"
click node_gameevents "https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/Event/Event.cs"
click node_configs "https://github.com/cognifydev/clashofgods/blob/main/COG/Config/ConfigBase.cs"
click node_roles "https://github.com/cognifydev/clashofgods/blob/main/COG/Role/CustomRole.cs"
click node_rolemanager "https://github.com/cognifydev/clashofgods/blob/main/COG/Role/CustomRoleManager.cs"
click node_roleimpl "https://github.com/cognifydev/clashofgods/blob/main/COG/Role/Impl/Unknown.cs"
click node_rolerpc "https://github.com/cognifydev/clashofgods/blob/main/COG/Rpc/Role/RoleRpcManager.cs"
click node_winners "https://github.com/cognifydev/clashofgods/blob/main/COG/Game/CustomWinner/CustomWinnerManager.cs"
click node_resources "https://github.com/cognifydev/clashofgods/blob/main/COG/Plugin/ResourcesManager.cs"
click node_python "https://github.com/cognifydev/clashofgods/blob/main/COG/Plugin/Python/PythonPluginManager.cs"
click node_cosmetics "https://github.com/cognifydev/clashofgods/blob/main/COG/Cosmetic/CosmeticsManager.cs"
click node_clientoptions "https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/Impl/ClientOptionListener.cs"
click node_buttons "https://github.com/cognifydev/clashofgods/blob/main/COG/UI/Hud/CustomButton/CustomButton.cs"

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_main,node_splash,node_listeners,node_gameevents,node_configs toneBlue
class node_roles,node_rolemanager,node_roleimpl,node_rolerpc,node_winners toneAmber
class node_resources,node_python,node_cosmetics toneMint
class node_clientoptions,node_buttons toneRose
class node_player toneIndigo
```

## Components

### Startup and Events

- [Mod startup](https://github.com/cognifydev/clashofgods/blob/main/COG/Main.cs): `COG/Main.cs`
- [Load sequence](https://github.com/cognifydev/clashofgods/blob/main/COG/UI/Load/SplashManagerPatch.cs): `COG/UI/Load/SplashManagerPatch.cs`
- [Listener dispatch](https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/ListenerManager.cs): `COG/Listener/ListenerManager.cs`
- [Game event types](https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/Event/Event.cs): `COG/Listener/Event/Event.cs`
- [Configuration](https://github.com/cognifydev/clashofgods/blob/main/COG/Config/ConfigBase.cs): `COG/Config/ConfigBase.cs`

### Gameplay Systems

- [Custom roles](https://github.com/cognifydev/clashofgods/blob/main/COG/Role/CustomRole.cs): `COG/Role/CustomRole.cs`
- [Role registry](https://github.com/cognifydev/clashofgods/blob/main/COG/Role/CustomRoleManager.cs): `COG/Role/CustomRoleManager.cs`
- [Built-in roles](https://github.com/cognifydev/clashofgods/blob/main/COG/Role/Impl/Unknown.cs): `COG/Role/Impl/Unknown.cs`
- [Role RPC dispatch](https://github.com/cognifydev/clashofgods/blob/main/COG/Rpc/Role/RoleRpcManager.cs): `COG/Rpc/Role/RoleRpcManager.cs`
- [Winner evaluation](https://github.com/cognifydev/clashofgods/blob/main/COG/Game/CustomWinner/CustomWinnerManager.cs): `COG/Game/CustomWinner/CustomWinnerManager.cs`

### Plugins and Cosmetics

- [Plugin resources](https://github.com/cognifydev/clashofgods/blob/main/COG/Plugin/ResourcesManager.cs): `COG/Plugin/ResourcesManager.cs`
- [Python plugins](https://github.com/cognifydev/clashofgods/blob/main/COG/Plugin/Python/PythonPluginManager.cs): `COG/Plugin/Python/PythonPluginManager.cs`
- [Custom cosmetics](https://github.com/cognifydev/clashofgods/blob/main/COG/Cosmetic/CosmeticsManager.cs): `COG/Cosmetic/CosmeticsManager.cs`

### Player Options and UI

- [Client options](https://github.com/cognifydev/clashofgods/blob/main/COG/Listener/Impl/ClientOptionListener.cs): `COG/Listener/Impl/ClientOptionListener.cs`
- [Custom buttons](https://github.com/cognifydev/clashofgods/blob/main/COG/UI/Hud/CustomButton/CustomButton.cs): `COG/UI/Hud/CustomButton/CustomButton.cs`

### Other components

- **Among Us player**

## Connections

- Among Us player → Mod startup: starts mod
- Mod startup → Load sequence: loads through (evidence: `COG/UI/Load/SplashManagerPatch.cs`)
- Load sequence → Listener dispatch: registers listeners (evidence: `COG/UI/Load/SplashManagerPatch.cs`)
- Load sequence → Built-in roles: registers roles (evidence: `COG/UI/Load/SplashManagerPatch.cs`)
- Listener dispatch → Game event types: dispatches events (evidence: `COG/Listener/ListenerManager.cs`)
- Listener dispatch → Role registry: dispatches role events (evidence: `COG/Listener/ListenerManager.cs`)
- Mod startup → Configuration: loads configuration (evidence: `COG/Config/ConfigBase.cs`)
- Role registry → Custom roles: stores roles (evidence: `COG/Role/CustomRoleManager.cs`)
- Custom roles → Custom buttons: registers buttons (evidence: `COG/Role/CustomRole.cs`)
- Custom roles → Role RPC dispatch: registers RPCs (evidence: `COG/Role/CustomRole.cs`)
- Role RPC dispatch → Role registry: resolves role IDs (evidence: `COG/Rpc/Role/RoleRpcManager.cs`)
- Custom roles → Winner evaluation: supplies win logic (evidence: `COG/Role/CustomRole.cs`)
- Mod startup → Plugin resources: unloads resources (evidence: `COG/Main.cs`)
- Plugin resources → Python plugins: loads plugins
- Plugin resources → Custom cosmetics: loads cosmetic resources
- Client options → Configuration: reads language settings (evidence: `COG/Listener/Impl/ClientOptionListener.cs`)
