# ethan-kisiel/cobalt architecture

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

- Interactive diagram: https://gitdiagram.com/ethan-kisiel/cobalt
- Repository: https://github.com/ethan-kisiel/cobalt

## Overview

Cobalt is a Godot-based multiplayer game/framework. Its startup flow initializes input and signals root readiness; the game-state manager then coordinates world loading and game-mode UI. In play, controllers pass input to player characters, which own movement, interaction, inventory, and voice components. Separate branches support network sessions and synchronized level travel, item spawning, developer tools, and settings. Edges reflect explicit calls or source-index references; some substantial subsystems are represented from the tree because their implementation was not sampled.

Main entry points: [`Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`](https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameObjects/PlayerCharacter/PlayerCharacter.cs) (Player Character), [`Core/Autoload/GameStateManager/GameStateManager.cs`](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/GameStateManager/GameStateManager.cs) (Game State), [`Game/GameScene/GameScene.cs`](https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameScene/GameScene.cs) (Game Scene), [`Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs`](https://github.com/ethan-kisiel/cobalt/blob/main/Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs) (Session Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Game Lifecycle"]
  node_root["Root Startup<br/>[Root.cs]"]
  node_state["Game State"]
  node_mode["Game Mode<br/>[GameMode.cs]"]
  node_world["World Base<br/>[WorldBase.cs]"]
  node_scene["Game Scene<br/>[GameScene.cs]"]
end

subgraph group_player["Player Gameplay"]
  node_controller["Player Controller"]
  node_character["Player Character<br/>[PlayerCharacter.cs]"]
  node_movement["Movement"]
  node_interaction["Interaction"]
  node_inventory["Player Inventory"]
  node_voice["Voice Talker<br/>[VoipTalker.cs]"]
end

subgraph group_network["Multiplayer"]
  node_multiplayer["Session Controller"]
  node_peer["Network Peer"]
  node_levels["Networked Levels"]
end

subgraph group_items["Items"]
  node_itemspawn["World Item Spawner"]
  node_registry["Item Registry<br/>[ItemRegistry.cs]"]
  node_dropped["Dropped Item<br/>[DroppedItem.cs]"]
end

subgraph group_interface["UI and Tools"]
  node_ui["UI Manager<br/>[UiManager.cs]"]
  node_console["Developer Console<br/>[DevConsole.cs]"]
  node_commands["Command Manager<br/>[CommandManager.cs]"]
  node_settings["Graphics Settings"]
  node_settingsconfig["Settings Transformer"]
end

node_user(("Player"))

node_root -->|"signals ready"| node_state
node_root -.->|"initializes game"| node_mode
node_state -->|"loads world"| node_world
node_state -->|"loads game UI"| node_ui
node_state -->|"selects mode"| node_mode
node_scene -->|"creates player"| node_character
node_user -->|"provides input"| node_controller
node_controller -->|"forwards input"| node_character
node_character -->|"uses movement"| node_movement
node_character -->|"uses interaction"| node_interaction
node_character -->|"uses inventory"| node_inventory
node_character -->|"enables voice"| node_voice
node_scene -->|"creates controller"| node_multiplayer
node_multiplayer -.->|"configures peer"| node_peer
node_scene -->|"creates manager"| node_levels
node_multiplayer -->|"registers commands"| node_commands
node_levels -->|"registers travel"| node_commands
node_itemspawn -->|"reads definitions"| node_registry
node_itemspawn -->|"spawns items"| node_dropped
node_character -->|"toggles UI"| node_ui
node_console -.->|"fires commands"| node_commands
node_settings -->|"configures settings"| node_settingsconfig

click node_root "https://github.com/ethan-kisiel/cobalt/blob/main/Root.cs"
click node_state "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/GameStateManager/GameStateManager.cs"
click node_mode "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Resources/GameMode/GameMode.cs"
click node_world "https://github.com/ethan-kisiel/cobalt/blob/main/Core/GameObjects/WorldBase/WorldBase.cs"
click node_scene "https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameScene/GameScene.cs"
click node_controller "https://github.com/ethan-kisiel/cobalt/blob/main/Core/GameObjects/PlayerControllerBase/PlayerControllerBase.cs"
click node_character "https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameObjects/PlayerCharacter/PlayerCharacter.cs"
click node_movement "https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/PlayerMovementComponent/PlayerMovementComponent.cs"
click node_interaction "https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/InteractComponent/InteractComponent.cs"
click node_inventory "https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/PlayerInventoryComponent/PlayerInventoryComponent.cs"
click node_voice "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Voip/VoipTalker/VoipTalker.cs"
click node_multiplayer "https://github.com/ethan-kisiel/cobalt/blob/main/Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs"
click node_peer "https://github.com/ethan-kisiel/cobalt/blob/main/Core/SteamMultiplayer/SteamMultiplayerPeer.cs"
click node_levels "https://github.com/ethan-kisiel/cobalt/blob/main/Game/MultiplayerObjects/NetworkedLevelManager/NetworkedLevelManager.cs"
click node_itemspawn "https://github.com/ethan-kisiel/cobalt/blob/main/Game/Autoload/WorldItemSpawner/WorldItemSpawner.cs"
click node_registry "https://github.com/ethan-kisiel/cobalt/blob/main/Game/Resources/ItemRegistry/ItemRegistry.cs"
click node_dropped "https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameObjects/DroppedItem/DroppedItem.cs"
click node_ui "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/UiManager/UiManager.cs"
click node_console "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Ui/DevConsole/DevConsole.cs"
click node_commands "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/CommandManager/CommandManager.cs"
click node_settings "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Ui/GraphicsSettingsMenu/GraphicsSettingsMenu.cs"
click node_settingsconfig "https://github.com/ethan-kisiel/cobalt/blob/main/Core/Utils/ProjectSettingsTransformer/ProjectSettingsTransformer.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_root,node_state,node_mode,node_world,node_scene toneBlue
class node_controller,node_character,node_movement,node_interaction,node_inventory,node_voice toneAmber
class node_multiplayer,node_peer,node_levels toneMint
class node_itemspawn,node_registry,node_dropped toneRose
class node_ui,node_console,node_commands,node_settings,node_settingsconfig,node_user toneIndigo
```

## Components

### Game Lifecycle

- [Root Startup](https://github.com/ethan-kisiel/cobalt/blob/main/Root.cs): `Root.cs`
- [Game State](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/GameStateManager/GameStateManager.cs): `Core/Autoload/GameStateManager/GameStateManager.cs`
- [Game Mode](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Resources/GameMode/GameMode.cs): `Core/Resources/GameMode/GameMode.cs`
- [World Base](https://github.com/ethan-kisiel/cobalt/blob/main/Core/GameObjects/WorldBase/WorldBase.cs): `Core/GameObjects/WorldBase/WorldBase.cs`
- [Game Scene](https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameScene/GameScene.cs): `Game/GameScene/GameScene.cs`

### Player Gameplay

- [Player Controller](https://github.com/ethan-kisiel/cobalt/blob/main/Core/GameObjects/PlayerControllerBase/PlayerControllerBase.cs): `Core/GameObjects/PlayerControllerBase/PlayerControllerBase.cs`
- [Player Character](https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameObjects/PlayerCharacter/PlayerCharacter.cs): `Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`
- [Movement](https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/PlayerMovementComponent/PlayerMovementComponent.cs): `Game/Components/PlayerMovementComponent/PlayerMovementComponent.cs`
- [Interaction](https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/InteractComponent/InteractComponent.cs): `Game/Components/InteractComponent/InteractComponent.cs`
- [Player Inventory](https://github.com/ethan-kisiel/cobalt/blob/main/Game/Components/PlayerInventoryComponent/PlayerInventoryComponent.cs): `Game/Components/PlayerInventoryComponent/PlayerInventoryComponent.cs`
- [Voice Talker](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Voip/VoipTalker/VoipTalker.cs): `Core/Voip/VoipTalker/VoipTalker.cs`

### Multiplayer

- [Session Controller](https://github.com/ethan-kisiel/cobalt/blob/main/Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs): `Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs`
- [Network Peer](https://github.com/ethan-kisiel/cobalt/blob/main/Core/SteamMultiplayer/SteamMultiplayerPeer.cs): `Core/SteamMultiplayer/SteamMultiplayerPeer.cs`
- [Networked Levels](https://github.com/ethan-kisiel/cobalt/blob/main/Game/MultiplayerObjects/NetworkedLevelManager/NetworkedLevelManager.cs): `Game/MultiplayerObjects/NetworkedLevelManager/NetworkedLevelManager.cs`

### Items

- [World Item Spawner](https://github.com/ethan-kisiel/cobalt/blob/main/Game/Autoload/WorldItemSpawner/WorldItemSpawner.cs): `Game/Autoload/WorldItemSpawner/WorldItemSpawner.cs`
- [Item Registry](https://github.com/ethan-kisiel/cobalt/blob/main/Game/Resources/ItemRegistry/ItemRegistry.cs): `Game/Resources/ItemRegistry/ItemRegistry.cs`
- [Dropped Item](https://github.com/ethan-kisiel/cobalt/blob/main/Game/GameObjects/DroppedItem/DroppedItem.cs): `Game/GameObjects/DroppedItem/DroppedItem.cs`

### UI and Tools

- [UI Manager](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/UiManager/UiManager.cs): `Core/Autoload/UiManager/UiManager.cs`
- [Developer Console](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Ui/DevConsole/DevConsole.cs): `Core/Ui/DevConsole/DevConsole.cs`
- [Command Manager](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Autoload/CommandManager/CommandManager.cs): `Core/Autoload/CommandManager/CommandManager.cs`
- [Graphics Settings](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Ui/GraphicsSettingsMenu/GraphicsSettingsMenu.cs): `Core/Ui/GraphicsSettingsMenu/GraphicsSettingsMenu.cs`
- [Settings Transformer](https://github.com/ethan-kisiel/cobalt/blob/main/Core/Utils/ProjectSettingsTransformer/ProjectSettingsTransformer.cs): `Core/Utils/ProjectSettingsTransformer/ProjectSettingsTransformer.cs`

### Other components

- **Player**

## Connections

- Root Startup → Game State: signals ready (evidence: `Core/Autoload/GameStateManager/GameStateManager.cs`)
- Root Startup → Game Mode: initializes game
- Game State → World Base: loads world (evidence: `Core/Autoload/GameStateManager/GameStateManager.cs`)
- Game State → UI Manager: loads game UI (evidence: `Core/Autoload/GameStateManager/GameStateManager.cs`)
- Game State → Game Mode: selects mode (evidence: `Core/Autoload/GameStateManager/GameStateManager.cs`)
- Game Scene → Player Character: creates player (evidence: `Game/GameScene/GameScene.cs`)
- Player → Player Controller: provides input (evidence: `Core/GameObjects/PlayerControllerBase/PlayerControllerBase.cs`)
- Player Controller → Player Character: forwards input (evidence: `Core/GameObjects/PlayerControllerBase/PlayerControllerBase.cs`)
- Player Character → Movement: uses movement (evidence: `Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`)
- Player Character → Interaction: uses interaction (evidence: `Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`)
- Player Character → Player Inventory: uses inventory (evidence: `Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`)
- Player Character → Voice Talker: enables voice (evidence: `Game/GameObjects/PlayerCharacter/PlayerCharacter.cs`)
- Game Scene → Session Controller: creates controller (evidence: `Game/GameScene/GameScene.cs`)
- Session Controller → Network Peer: configures peer
- Game Scene → Networked Levels: creates manager (evidence: `Game/GameScene/GameScene.cs`)
- Session Controller → Command Manager: registers commands (evidence: `Game/MultiplayerObjects/SteamMultiplayerController/SteamMultiplayerController.cs`)
- Networked Levels → Command Manager: registers travel (evidence: `Game/MultiplayerObjects/NetworkedLevelManager/NetworkedLevelManager.cs`)
- World Item Spawner → Item Registry: reads definitions (evidence: `Game/Autoload/WorldItemSpawner/WorldItemSpawner.cs`)
- World Item Spawner → Dropped Item: spawns items (evidence: `Game/Autoload/WorldItemSpawner/WorldItemSpawner.cs`)
- Player Character → UI Manager: toggles UI
- Developer Console → Command Manager: fires commands
- Graphics Settings → Settings Transformer: configures settings (evidence: `Core/Ui/GraphicsSettingsMenu/GraphicsSettingsMenu.cs`)
