# im-shadee/cobalt64 architecture

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

- Interactive diagram: https://gitdiagram.com/im-shadee/cobalt64
- Repository: https://github.com/im-shadee/cobalt64

## Overview

Cobalt64 is a work-in-progress, N64-oriented game engine. The visible runtime shape is startup into scene selection/loading, with scene data represented by objects and components; game code can use engine inputs, transforms, math, and debugging facilities. Scene parsing currently reads object and transform arrays, while the scene schema also declares camera, light, model, batching, and actor data. The README offers no further capability detail, and several runtime connections are not established by the excerpts, so the graph avoids guessing at those flows.

Main entry points: [`src/engine/scenes/scenes.h`](https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.h) (Scene Components), [`src/engine/core/startup.c`](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/startup.c) (Engine Startup), [`src/engine/scenes/scenes.c`](https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.c) (Scene Loading), [`src/game/temp.c`](https://github.com/im-shadee/cobalt64/blob/main/src/game/temp.c) (Game Code)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_game["Game Code<br/>[temp.c]"]
  node_entry["Program Entry<br/>[main.c]"]
  node_startup["Engine Startup<br/>[startup.c]"]
end

subgraph group_world["Scene and Objects"]
  node_scenes["Scene Loading<br/>[scenes.c]"]
  node_objects["Object State<br/>[object.c]"]
  node_scene_schema["Scene Components<br/>[scenes.h]"]
end

subgraph group_components["Engine Components"]
  node_transforms["Transforms<br/>[transform.c]"]
  node_cameras["Cameras<br/>[camera.c]"]
  node_lights["Lighting<br/>[lights.h]"]
  node_models["Model Instances<br/>[model_instance.h]"]
  node_actors["Actor Behaviors<br/>[actor_behavior.h]"]
  node_actor_instances["Actor Instances<br/>[actor_instance.h]"]
  node_triggers["Trigger Behaviors<br/>[trigger_behavior.h]"]
  node_trigger_instances["Trigger Instances<br/>[trigger_instance.h]"]
end

subgraph group_services["Engine Services"]
  node_memory["Memory Arenas<br/>[memory.c]"]
  node_inputs["Controller Input<br/>[inputs.h]"]
  node_debug["Debug Tools<br/>[debug.c]"]
  node_math["Math Utilities<br/>[cobalt_math.c]"]
  node_vectors["Vector Operations<br/>[vectors.h]"]
  node_colors["Color Types<br/>[color.h]"]
  node_layers["Render Layers<br/>[layers.h]"]
end

node_entry -->|"starts"| node_startup
node_startup -->|"uses scene API"| node_scenes
node_startup -->|"uses object API"| node_objects
node_startup -->|"uses transform API"| node_transforms
node_startup -->|"uses debug API"| node_debug
node_startup -->|"uses math API"| node_math
node_scenes -->|"allocates scene data"| node_memory
node_scenes -->|"reads object data"| node_objects
node_scenes -->|"reads transform data"| node_transforms
node_scenes -->|"resets main camera"| node_cameras
node_scenes -->|"uses scene types"| node_scene_schema
node_scene_schema -->|"declares actor data"| node_actors
node_scene_schema -->|"declares instances"| node_actor_instances
node_scene_schema -->|"declares trigger data"| node_triggers
node_scene_schema -->|"declares instances"| node_trigger_instances
node_game -->|"references input API"| node_inputs
node_game -->|"references transform API"| node_transforms
node_game -->|"references debug API"| node_debug
node_game -->|"references trig API"| node_math
node_transforms -->|"uses vectors"| node_vectors
node_math -->|"uses vectors"| node_vectors
node_debug -->|"reads controller input"| node_inputs
node_objects -->|"uses render layers"| node_layers
node_cameras -->|"uses colors"| node_colors
node_scene_schema -->|"declares cameras"| node_cameras
node_scene_schema -->|"declares lights"| node_lights
node_scene_schema -->|"declares model data"| node_models

click node_game "https://github.com/im-shadee/cobalt64/blob/main/src/game/temp.c"
click node_entry "https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/main.c"
click node_startup "https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/startup.c"
click node_scenes "https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.c"
click node_objects "https://github.com/im-shadee/cobalt64/blob/main/src/engine/objects/object.c"
click node_scene_schema "https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.h"
click node_transforms "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/transform/transform.c"
click node_cameras "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/camera/camera.c"
click node_lights "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/light/lights.h"
click node_models "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/model/model_instance.h"
click node_actors "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/shared/actor_behavior.h"
click node_actor_instances "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/instance/actor_instance.h"
click node_triggers "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/shared/trigger_behavior.h"
click node_trigger_instances "https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/instance/trigger_instance.h"
click node_memory "https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/memory.c"
click node_inputs "https://github.com/im-shadee/cobalt64/blob/main/src/engine/inputs/inputs.h"
click node_debug "https://github.com/im-shadee/cobalt64/blob/main/src/engine/debug/debug.c"
click node_math "https://github.com/im-shadee/cobalt64/blob/main/src/engine/math/cobalt_math.c"
click node_vectors "https://github.com/im-shadee/cobalt64/blob/main/src/engine/math/linalg/vectors.h"
click node_colors "https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/types/color.h"
click node_layers "https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/types/layers.h"

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_game,node_entry,node_startup toneBlue
class node_scenes,node_objects,node_scene_schema toneAmber
class node_transforms,node_cameras,node_lights,node_models,node_actors,node_actor_instances,node_triggers,node_trigger_instances toneMint
class node_memory,node_inputs,node_debug,node_math,node_vectors,node_colors,node_layers toneRose
```

## Components

### Runtime

- [Game Code](https://github.com/im-shadee/cobalt64/blob/main/src/game/temp.c): `src/game/temp.c`
- [Program Entry](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/main.c): `src/engine/core/main.c`
- [Engine Startup](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/startup.c): `src/engine/core/startup.c`

### Scene and Objects

- [Scene Loading](https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.c): `src/engine/scenes/scenes.c`
- [Object State](https://github.com/im-shadee/cobalt64/blob/main/src/engine/objects/object.c): `src/engine/objects/object.c`
- [Scene Components](https://github.com/im-shadee/cobalt64/blob/main/src/engine/scenes/scenes.h): `src/engine/scenes/scenes.h`

### Engine Components

- [Transforms](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/transform/transform.c): `src/engine/components/transform/transform.c`
- [Cameras](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/camera/camera.c): `src/engine/components/camera/camera.c`
- [Lighting](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/light/lights.h): `src/engine/components/light/lights.h`
- [Model Instances](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/model/model_instance.h): `src/engine/components/model/model_instance.h`
- [Actor Behaviors](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/shared/actor_behavior.h): `src/engine/components/actor/shared/actor_behavior.h`
- [Actor Instances](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/instance/actor_instance.h): `src/engine/components/actor/instance/actor_instance.h`
- [Trigger Behaviors](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/shared/trigger_behavior.h): `src/engine/components/actor/shared/trigger_behavior.h`
- [Trigger Instances](https://github.com/im-shadee/cobalt64/blob/main/src/engine/components/actor/instance/trigger_instance.h): `src/engine/components/actor/instance/trigger_instance.h`

### Engine Services

- [Memory Arenas](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/memory.c): `src/engine/core/memory.c`
- [Controller Input](https://github.com/im-shadee/cobalt64/blob/main/src/engine/inputs/inputs.h): `src/engine/inputs/inputs.h`
- [Debug Tools](https://github.com/im-shadee/cobalt64/blob/main/src/engine/debug/debug.c): `src/engine/debug/debug.c`
- [Math Utilities](https://github.com/im-shadee/cobalt64/blob/main/src/engine/math/cobalt_math.c): `src/engine/math/cobalt_math.c`
- [Vector Operations](https://github.com/im-shadee/cobalt64/blob/main/src/engine/math/linalg/vectors.h): `src/engine/math/linalg/vectors.h`
- [Color Types](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/types/color.h): `src/engine/core/types/color.h`
- [Render Layers](https://github.com/im-shadee/cobalt64/blob/main/src/engine/core/types/layers.h): `src/engine/core/types/layers.h`

## Connections

- Program Entry → Engine Startup: starts (evidence: `src/engine/core/main.c`)
- Engine Startup → Scene Loading: uses scene API (evidence: `src/engine/core/startup.c`)
- Engine Startup → Object State: uses object API (evidence: `src/engine/core/startup.c`)
- Engine Startup → Transforms: uses transform API (evidence: `src/engine/core/startup.c`)
- Engine Startup → Debug Tools: uses debug API (evidence: `src/engine/core/startup.c`)
- Engine Startup → Math Utilities: uses math API (evidence: `src/engine/core/startup.c`)
- Scene Loading → Memory Arenas: allocates scene data (evidence: `src/engine/scenes/scenes.c`)
- Scene Loading → Object State: reads object data (evidence: `src/engine/scenes/scenes.c`)
- Scene Loading → Transforms: reads transform data (evidence: `src/engine/scenes/scenes.c`)
- Scene Loading → Cameras: resets main camera (evidence: `src/engine/scenes/scenes.c`)
- Scene Loading → Scene Components: uses scene types (evidence: `src/engine/scenes/scenes.c`)
- Scene Components → Actor Behaviors: declares actor data (evidence: `src/engine/scenes/scenes.h`)
- Scene Components → Actor Instances: declares instances (evidence: `src/engine/scenes/scenes.h`)
- Scene Components → Trigger Behaviors: declares trigger data (evidence: `src/engine/scenes/scenes.h`)
- Scene Components → Trigger Instances: declares instances (evidence: `src/engine/scenes/scenes.h`)
- Game Code → Controller Input: references input API (evidence: `src/game/temp.c`)
- Game Code → Transforms: references transform API (evidence: `src/game/temp.c`)
- Game Code → Debug Tools: references debug API (evidence: `src/game/temp.c`)
- Game Code → Math Utilities: references trig API (evidence: `src/game/temp.c`)
- Transforms → Vector Operations: uses vectors (evidence: `src/engine/components/transform/transform.c`)
- Math Utilities → Vector Operations: uses vectors (evidence: `src/engine/math/cobalt_math.c`)
- Debug Tools → Controller Input: reads controller input (evidence: `src/engine/debug/debug.c`)
- Object State → Render Layers: uses render layers
- Cameras → Color Types: uses colors (evidence: `src/engine/components/camera/camera.c`)
- Scene Components → Cameras: declares cameras (evidence: `src/engine/scenes/scenes.h`)
- Scene Components → Lighting: declares lights (evidence: `src/engine/scenes/scenes.h`)
- Scene Components → Model Instances: declares model data (evidence: `src/engine/scenes/scenes.h`)
