How keyzm/openzen works
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: ZenClient.java Client bootstrap · ModuleManager.java Module registry · PatchRegistry.java Patch registry · Module.java Gameplay modules
Components 23
Launch and injection
- Java agent
src/main/java/asm/patchify/loader/PatchAgent.java - Native loader
native/loader/src/MainWindow.cpp - Process injector
native/loader/src/injector.cpp - Injected DLL
native/dll/src/main.cpp - Java bridge
native/dll/src/class_loader.cpp
Client runtime
- Client bootstrap
src/main/java/shit/zen/ZenClient.java - Event bus
src/main/java/shit/zen/event/EventBus.java - Module registry
src/main/java/shit/zen/manager/ModuleManager.java - Configuration
src/main/java/shit/zen/manager/ConfigManager.java
Gameplay features
- Gameplay modules
src/main/java/shit/zen/modules/Module.java - Scaffold feature
src/main/java/shit/zen/modules/impl/movement/Scaffold.java - Inventory automation
src/main/java/shit/zen/modules/impl/player/InventoryManager.java - Module settings
src/main/java/shit/zen/settings/Setting.java
User interface
- Chat commands
src/main/java/shit/zen/manager/CommandManager.java - HUD manager
src/main/java/shit/zen/manager/HudManager.java - HUD elements
src/main/java/shit/zen/hud/HudElement.java - Web UI handlers
src/main/java/shit/zen/network/webui/SetSettingHandler.java
Patch framework
- Patch registry
src/main/java/asm/patchify/loader/PatchRegistry.java - Game patches
src/main/java/shit/zen/patch/ClientLevelPatch.java - Bytecode transformer
src/main/java/asm/patchify/loader/PatchClassFileTransformer.java
Other components
- Minecraft user
- Minecraft JVM
- Forge game
Connections 25
- Minecraft user → Native loader: starts injector
README.md - Native loader → Process injector: dispatches injection
native/loader/src/MainWindow.cpp - Process injector → Injected DLL: loads into process
- Injected DLL → Java bridge: loads Java classes
native/dll/src/main.cpp - Java bridge → Client bootstrap: bootstraps client
- Minecraft user → Minecraft JVM: starts with agent
README.md - Java agent → Patch registry: registers transformer
- Minecraft JVM → Java agent: loads agent
README.md - Client bootstrap → Event bus: creates and registers
src/main/java/shit/zen/ZenClient.java - Client bootstrap → Module registry: initializes
src/main/java/shit/zen/ZenClient.java - Module registry → Gameplay modules: registers modules
src/main/java/shit/zen/manager/ModuleManager.java - Gameplay modules → Module settings: registers settings
src/main/java/shit/zen/modules/Module.java - Module registry → Scaffold feature: registers feature
src/main/java/shit/zen/manager/ModuleManager.java - Module registry → Inventory automation: registers feature
src/main/java/shit/zen/manager/ModuleManager.java - Client bootstrap → Configuration: initializes
src/main/java/shit/zen/ZenClient.java - Client bootstrap → Chat commands: initializes commands
src/main/java/shit/zen/ZenClient.java - Chat commands → Event bus: subscribes to chat
src/main/java/shit/zen/manager/CommandManager.java - Client bootstrap → HUD manager: initializes HUD
src/main/java/shit/zen/ZenClient.java - HUD manager → HUD elements: registers and renders
src/main/java/shit/zen/manager/HudManager.java - Client bootstrap → Patch registry: registers patches
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
src/main/java/shit/zen/network/webui/SetSettingHandler.java - Web UI handlers → Module settings: updates values
src/main/java/shit/zen/network/webui/SetSettingHandler.java