# keyzm/openzen architecture

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

- Interactive diagram: https://gitdiagram.com/keyzm/openzen
- Repository: https://github.com/keyzm/openzen

## Overview

Open Zen is a reconstructed Minecraft 1.20.1/Forge 47.4.20 client, delivered as a Java agent or through a native injector. Its main runtime path initializes the client, registers ASM patches and managers, then uses game events to drive configurable gameplay modules and HUD rendering; commands and configuration provide user control. The README documents both delivery routes and ASM patching. Several subsystem details are represented from the tree and index rather than inspected implementations, so uncertain wiring is omitted.

Main entry points: [`src/main/java/shit/zen/ZenClient.java`](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/ZenClient.java) (Client bootstrap), [`src/main/java/shit/zen/manager/ModuleManager.java`](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/ModuleManager.java) (Module registry), [`src/main/java/asm/patchify/loader/PatchRegistry.java`](https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchRegistry.java) (Patch registry), [`src/main/java/shit/zen/modules/Module.java`](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/Module.java) (Gameplay modules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Launch and injection"]
  node_agent["Java agent<br/>[PatchAgent.java]"]
  node_native_loader["Native loader<br/>[MainWindow.cpp]"]
  node_injector["Process injector<br/>[injector.cpp]"]
  node_dll["Injected DLL<br/>[main.cpp]"]
  node_dll_loader["Java bridge<br/>[class_loader.cpp]"]
end

subgraph group_runtime["Client runtime"]
  node_client["Client bootstrap<br/>[ZenClient.java]"]
  node_events["Event bus<br/>[EventBus.java]"]
  node_module_manager["Module registry<br/>[ModuleManager.java]"]
  node_config["Configuration<br/>[ConfigManager.java]"]
end

subgraph group_features["Gameplay features"]
  node_modules["Gameplay modules<br/>[Module.java]"]
  node_scaffold["Scaffold feature<br/>[Scaffold.java]"]
  node_inventory["Inventory automation"]
  node_settings["Module settings<br/>[Setting.java]"]
end

subgraph group_interface["User interface"]
  node_commands["Chat commands"]
  node_hud_manager["HUD manager<br/>[HudManager.java]"]
  node_hud["HUD elements<br/>[HudElement.java]"]
  node_webui["Web UI handlers"]
end

subgraph group_patching["Patch framework"]
  node_patch_registry["Patch registry<br/>[PatchRegistry.java]"]
  node_patches["Game patches"]
  node_transformer["Bytecode transformer"]
end

node_user(("Minecraft user"))
node_minecraft["Minecraft JVM"]
node_game["Forge game"]

node_user -->|"starts injector"| node_native_loader
node_native_loader -->|"dispatches injection"| node_injector
node_injector -.->|"loads into process"| node_dll
node_dll -->|"loads Java classes"| node_dll_loader
node_dll_loader -.->|"bootstraps client"| node_client
node_user -->|"starts with agent"| node_minecraft
node_agent -.->|"registers transformer"| node_patch_registry
node_minecraft -->|"loads agent"| node_agent
node_client -->|"creates and registers"| node_events
node_client -->|"initializes"| node_module_manager
node_module_manager -->|"registers modules"| node_modules
node_modules -->|"registers settings"| node_settings
node_module_manager -->|"registers feature"| node_scaffold
node_module_manager -->|"registers feature"| node_inventory
node_client -->|"initializes"| node_config
node_client -->|"initializes commands"| node_commands
node_commands -->|"subscribes to chat"| node_events
node_client -->|"initializes HUD"| node_hud_manager
node_hud_manager -->|"registers and renders"| node_hud
node_client -->|"registers patches"| node_patch_registry
node_patch_registry -.->|"registers patch classes"| node_patches
node_patch_registry -.->|"dispatches transforms"| node_transformer
node_transformer -.->|"transforms game classes"| node_game
node_webui -->|"reads and updates"| node_modules
node_webui -->|"updates values"| node_settings

click node_agent "https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchAgent.java"
click node_native_loader "https://github.com/keyzm/openzen/blob/master/native/loader/src/MainWindow.cpp"
click node_injector "https://github.com/keyzm/openzen/blob/master/native/loader/src/injector.cpp"
click node_dll "https://github.com/keyzm/openzen/blob/master/native/dll/src/main.cpp"
click node_dll_loader "https://github.com/keyzm/openzen/blob/master/native/dll/src/class_loader.cpp"
click node_client "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/ZenClient.java"
click node_events "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/event/EventBus.java"
click node_module_manager "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/ModuleManager.java"
click node_modules "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/Module.java"
click node_scaffold "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/impl/movement/Scaffold.java"
click node_inventory "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/impl/player/InventoryManager.java"
click node_settings "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/settings/Setting.java"
click node_config "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/ConfigManager.java"
click node_commands "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/CommandManager.java"
click node_hud_manager "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/HudManager.java"
click node_hud "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/hud/HudElement.java"
click node_webui "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/network/webui/SetSettingHandler.java"
click node_patch_registry "https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchRegistry.java"
click node_patches "https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/patch/ClientLevelPatch.java"
click node_transformer "https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchClassFileTransformer.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_agent,node_native_loader,node_injector,node_dll,node_dll_loader,node_user toneBlue
class node_client,node_events,node_module_manager,node_config toneAmber
class node_modules,node_scaffold,node_inventory,node_settings toneMint
class node_commands,node_hud_manager,node_hud,node_webui toneRose
class node_patch_registry,node_patches,node_transformer,node_minecraft,node_game toneIndigo
```

## Components

### Launch and injection

- [Java agent](https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchAgent.java): `src/main/java/asm/patchify/loader/PatchAgent.java`
- [Native loader](https://github.com/keyzm/openzen/blob/master/native/loader/src/MainWindow.cpp): `native/loader/src/MainWindow.cpp`
- [Process injector](https://github.com/keyzm/openzen/blob/master/native/loader/src/injector.cpp): `native/loader/src/injector.cpp`
- [Injected DLL](https://github.com/keyzm/openzen/blob/master/native/dll/src/main.cpp): `native/dll/src/main.cpp`
- [Java bridge](https://github.com/keyzm/openzen/blob/master/native/dll/src/class_loader.cpp): `native/dll/src/class_loader.cpp`

### Client runtime

- [Client bootstrap](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/ZenClient.java): `src/main/java/shit/zen/ZenClient.java`
- [Event bus](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/event/EventBus.java): `src/main/java/shit/zen/event/EventBus.java`
- [Module registry](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/ModuleManager.java): `src/main/java/shit/zen/manager/ModuleManager.java`
- [Configuration](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/ConfigManager.java): `src/main/java/shit/zen/manager/ConfigManager.java`

### Gameplay features

- [Gameplay modules](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/Module.java): `src/main/java/shit/zen/modules/Module.java`
- [Scaffold feature](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/impl/movement/Scaffold.java): `src/main/java/shit/zen/modules/impl/movement/Scaffold.java`
- [Inventory automation](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/modules/impl/player/InventoryManager.java): `src/main/java/shit/zen/modules/impl/player/InventoryManager.java`
- [Module settings](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/settings/Setting.java): `src/main/java/shit/zen/settings/Setting.java`

### User interface

- [Chat commands](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/CommandManager.java): `src/main/java/shit/zen/manager/CommandManager.java`
- [HUD manager](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/manager/HudManager.java): `src/main/java/shit/zen/manager/HudManager.java`
- [HUD elements](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/hud/HudElement.java): `src/main/java/shit/zen/hud/HudElement.java`
- [Web UI handlers](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/network/webui/SetSettingHandler.java): `src/main/java/shit/zen/network/webui/SetSettingHandler.java`

### Patch framework

- [Patch registry](https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchRegistry.java): `src/main/java/asm/patchify/loader/PatchRegistry.java`
- [Game patches](https://github.com/keyzm/openzen/blob/master/src/main/java/shit/zen/patch/ClientLevelPatch.java): `src/main/java/shit/zen/patch/ClientLevelPatch.java`
- [Bytecode transformer](https://github.com/keyzm/openzen/blob/master/src/main/java/asm/patchify/loader/PatchClassFileTransformer.java): `src/main/java/asm/patchify/loader/PatchClassFileTransformer.java`

### Other components

- **Minecraft user**
- **Minecraft JVM**
- **Forge game**

## Connections

- Minecraft user → Native loader: starts injector (evidence: `README.md`)
- Native loader → Process injector: dispatches injection (evidence: `native/loader/src/MainWindow.cpp`)
- Process injector → Injected DLL: loads into process
- Injected DLL → Java bridge: loads Java classes (evidence: `native/dll/src/main.cpp`)
- Java bridge → Client bootstrap: bootstraps client
- Minecraft user → Minecraft JVM: starts with agent (evidence: `README.md`)
- Java agent → Patch registry: registers transformer
- Minecraft JVM → Java agent: loads agent (evidence: `README.md`)
- Client bootstrap → Event bus: creates and registers (evidence: `src/main/java/shit/zen/ZenClient.java`)
- Client bootstrap → Module registry: initializes (evidence: `src/main/java/shit/zen/ZenClient.java`)
- Module registry → Gameplay modules: registers modules (evidence: `src/main/java/shit/zen/manager/ModuleManager.java`)
- Gameplay modules → Module settings: registers settings (evidence: `src/main/java/shit/zen/modules/Module.java`)
- Module registry → Scaffold feature: registers feature (evidence: `src/main/java/shit/zen/manager/ModuleManager.java`)
- Module registry → Inventory automation: registers feature (evidence: `src/main/java/shit/zen/manager/ModuleManager.java`)
- Client bootstrap → Configuration: initializes (evidence: `src/main/java/shit/zen/ZenClient.java`)
- Client bootstrap → Chat commands: initializes commands (evidence: `src/main/java/shit/zen/ZenClient.java`)
- Chat commands → Event bus: subscribes to chat (evidence: `src/main/java/shit/zen/manager/CommandManager.java`)
- Client bootstrap → HUD manager: initializes HUD (evidence: `src/main/java/shit/zen/ZenClient.java`)
- HUD manager → HUD elements: registers and renders (evidence: `src/main/java/shit/zen/manager/HudManager.java`)
- Client bootstrap → Patch registry: registers patches (evidence: `src/main/java/shit/zen/ZenClient.java`)
- Patch registry → Game patches: registers patch classes
- Patch registry → Bytecode transformer: dispatches transforms
- Bytecode transformer → Forge game: transforms game classes
- Web UI handlers → Gameplay modules: reads and updates (evidence: `src/main/java/shit/zen/network/webui/SetSettingHandler.java`)
- Web UI handlers → Module settings: updates values (evidence: `src/main/java/shit/zen/network/webui/SetSettingHandler.java`)
