# geode-sdk/geode architecture

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

- Interactive diagram: https://gitdiagram.com/geode-sdk/geode
- Repository: https://github.com/geode-sdk/geode

## Overview

Geode is a Geometry Dash mod loader and modding SDK. A mod developer builds against Geode’s bindings and modification APIs; when Geometry Dash starts, the loader discovers and manages mods, installs hooks, dispatches lifecycle/game events, and exposes Cocos2d-based UI and state services. Downloads and settings support the broader mod lifecycle. The graph reflects the README and sampled headers/source; several loader subsystems are represented by exact tree paths without claiming unsampled call details.

Main entry points: [`loader/src/load.cpp`](https://github.com/geode-sdk/geode/blob/main/loader/src/load.cpp) (Loader Runtime), [`loader/src/server/DownloadManager.cpp`](https://github.com/geode-sdk/geode/blob/main/loader/src/server/DownloadManager.cpp) (Download Manager), [`loader/src/utils/VMTHookManager.cpp`](https://github.com/geode-sdk/geode/blob/main/loader/src/utils/VMTHookManager.cpp) (VMT Hook Manager), [`loader/include/Geode/loader/Mod.hpp`](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/Mod.hpp) (Mod Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Loader Runtime"]
  node_loader_runtime["Loader Runtime<br/>[load.cpp]"]
  node_mod_registry["Mod Registry<br/>[Mod.hpp]"]
  node_event_bus["Event Dispatch<br/>[Dispatch.hpp]"]
  node_script_bridge["Script Bridge<br/>[ScriptEngine.cpp]"]
end

subgraph group_api["Modding API"]
  node_bindings["Game Bindings<br/>[Bindings.hpp]"]
  node_modify_api["Modify API<br/>[Modify.hpp]"]
  node_hook_manager["VMT Hook Manager<br/>[VMTHookManager.cpp]"]
  node_id_manager["Node ID Manager<br/>[IDManager.hpp]"]
end

subgraph group_ux["UI And State"]
  node_popup_manager["Popup Manager<br/>[PopupManager.cpp]"]
  node_settings["Mod Settings"]
  node_storage_api["Local Storage API<br/>[LocalStorage.h]"]
end

subgraph group_distribution["Mod Distribution"]
  node_download_manager["Download Manager"]
end

subgraph group_platform["Game Platform"]
  node_cocos_runtime["Cocos2d Runtime<br/>[cocos2d.h]"]
  node_sqlite_storage[("SQLite Storage")]
end

node_developer(("Mod Developer"))
node_game(("Geometry Dash"))
node_mod_server(("Mod Server"))

node_developer -->|"builds with"| node_bindings
node_developer -->|"writes mods"| node_modify_api
node_game -->|"starts loader"| node_loader_runtime
node_loader_runtime -->|"loads mods"| node_mod_registry
node_loader_runtime -->|"dispatches events"| node_event_bus
node_modify_api -->|"registers hooks"| node_hook_manager
node_hook_manager -->|"claims hooks"| node_mod_registry
node_hook_manager -->|"patches methods"| node_game
node_script_bridge -->|"sends events"| node_event_bus
node_loader_runtime -->|"installs bridge"| node_script_bridge
node_id_manager -->|"emits events"| node_event_bus
node_popup_manager -->|"schedules UI"| node_cocos_runtime
node_cocos_runtime -->|"renders UI"| node_game
node_download_manager -.->|"downloads packages"| node_mod_server
node_download_manager -->|"updates mods"| node_mod_registry
node_download_manager -->|"queues events"| node_loader_runtime
node_storage_api -.->|"stores values"| node_sqlite_storage
node_settings -.->|"persists state"| node_storage_api

click node_loader_runtime "https://github.com/geode-sdk/geode/blob/main/loader/src/load.cpp"
click node_mod_registry "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/Mod.hpp"
click node_event_bus "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/Dispatch.hpp"
click node_script_bridge "https://github.com/geode-sdk/geode/blob/main/loader/src/loader/ScriptEngine.cpp"
click node_bindings "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/Bindings.hpp"
click node_modify_api "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/Modify.hpp"
click node_hook_manager "https://github.com/geode-sdk/geode/blob/main/loader/src/utils/VMTHookManager.cpp"
click node_id_manager "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/modify/IDManager.hpp"
click node_cocos_runtime "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/include/cocos2d.h"
click node_popup_manager "https://github.com/geode-sdk/geode/blob/main/loader/src/ui/PopupManager.cpp"
click node_settings "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/ModSettingsManager.hpp"
click node_storage_api "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/extensions/LocalStorage/LocalStorage.h"
click node_sqlite_storage "https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/platform/android/java/src/org/cocos2dx/lib/Cocos2dxLocalStorage.java"
click node_download_manager "https://github.com/geode-sdk/geode/blob/main/loader/src/server/DownloadManager.cpp"

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_loader_runtime,node_mod_registry,node_event_bus,node_script_bridge toneBlue
class node_bindings,node_modify_api,node_hook_manager,node_id_manager toneAmber
class node_popup_manager,node_settings,node_storage_api,node_mod_server toneMint
class node_download_manager toneRose
class node_cocos_runtime,node_sqlite_storage,node_developer,node_game toneIndigo
```

## Components

### Loader Runtime

- [Loader Runtime](https://github.com/geode-sdk/geode/blob/main/loader/src/load.cpp): `loader/src/load.cpp`
- [Mod Registry](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/Mod.hpp): `loader/include/Geode/loader/Mod.hpp`
- [Event Dispatch](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/Dispatch.hpp): `loader/include/Geode/loader/Dispatch.hpp`
- [Script Bridge](https://github.com/geode-sdk/geode/blob/main/loader/src/loader/ScriptEngine.cpp): `loader/src/loader/ScriptEngine.cpp`

### Modding API

- [Game Bindings](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/Bindings.hpp): `loader/include/Geode/Bindings.hpp`
- [Modify API](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/Modify.hpp): `loader/include/Geode/Modify.hpp`
- [VMT Hook Manager](https://github.com/geode-sdk/geode/blob/main/loader/src/utils/VMTHookManager.cpp): `loader/src/utils/VMTHookManager.cpp`
- [Node ID Manager](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/modify/IDManager.hpp): `loader/include/Geode/modify/IDManager.hpp`

### UI And State

- [Popup Manager](https://github.com/geode-sdk/geode/blob/main/loader/src/ui/PopupManager.cpp): `loader/src/ui/PopupManager.cpp`
- [Mod Settings](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/loader/ModSettingsManager.hpp): `loader/include/Geode/loader/ModSettingsManager.hpp`
- [Local Storage API](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/extensions/LocalStorage/LocalStorage.h): `loader/include/Geode/cocos/extensions/LocalStorage/LocalStorage.h`

### Mod Distribution

- [Download Manager](https://github.com/geode-sdk/geode/blob/main/loader/src/server/DownloadManager.cpp): `loader/src/server/DownloadManager.cpp`

### Game Platform

- [Cocos2d Runtime](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/include/cocos2d.h): `loader/include/Geode/cocos/include/cocos2d.h`
- [SQLite Storage](https://github.com/geode-sdk/geode/blob/main/loader/include/Geode/cocos/platform/android/java/src/org/cocos2dx/lib/Cocos2dxLocalStorage.java): `loader/include/Geode/cocos/platform/android/java/src/org/cocos2dx/lib/Cocos2dxLocalStorage.java`

### Other components

- **Mod Developer**
- **Geometry Dash**
- **Mod Server**

## Connections

- Mod Developer → Game Bindings: builds with
- Mod Developer → Modify API: writes mods
- Geometry Dash → Loader Runtime: starts loader
- Loader Runtime → Mod Registry: loads mods
- Loader Runtime → Event Dispatch: dispatches events
- Modify API → VMT Hook Manager: registers hooks
- VMT Hook Manager → Mod Registry: claims hooks
- VMT Hook Manager → Geometry Dash: patches methods
- Script Bridge → Event Dispatch: sends events
- Loader Runtime → Script Bridge: installs bridge
- Node ID Manager → Event Dispatch: emits events
- Popup Manager → Cocos2d Runtime: schedules UI
- Cocos2d Runtime → Geometry Dash: renders UI
- Download Manager → Mod Server: downloads packages
- Download Manager → Mod Registry: updates mods
- Download Manager → Loader Runtime: queues events
- Local Storage API → SQLite Storage: stores values
- Mod Settings → Local Storage API: persists state
