How margele/openzen works
Open Zen is a reconstructed Minecraft 1.20.1 Forge client delivered as either a Java Agent JAR or a Windows hot injector. The principal workflow is launch/injection, bytecode patch registration, client initialization, then event-driven modules that alter gameplay and expose configurable UI, commands, HUD, and WebUI features. The sampled sources support the Java initialization and manager relationships; delivery options and broader capabilities are documented in the README. Native internals and several feature implementations were not sampled, so their internal links are omitted.
Main entry points: ZenClient.java Zen client · EventBus.java Event bus · ModuleManager.java Module manager · webui WebUI handlers
Components 17
Launch and injection
- Java Agent
src/main/java/asm/patchify/loader/PatchAgent.java - Hot injector
native/loader/src - Injected DLL
native/dll/src
Client runtime
- Patch registry
src/main/java/asm/patchify/loader/PatchRegistry.java - Game patches
src/main/java/shit/zen/patch - Zen client
src/main/java/shit/zen/ZenClient.java - Event bus
src/main/java/shit/zen/event/EventBus.java
Gameplay features
- Module manager
src/main/java/shit/zen/manager/ModuleManager.java - Gameplay modules
src/main/java/shit/zen/modules/impl - Module settings
src/main/java/shit/zen/settings
User interaction
- Commands
src/main/java/shit/zen/manager/CommandManager.java - HUD manager
src/main/java/shit/zen/manager/HudManager.java - Click GUIs
src/main/java/shit/zen/gui - Configuration
src/main/java/shit/zen/manager/ConfigManager.java - WebUI handlers
src/main/java/shit/zen/network/webui
Other components
- User
- Minecraft JVM
Connections 22
- User → Java Agent: launches with
- User → Hot injector: starts
- Hot injector → Injected DLL: hot injects
- Java Agent → Minecraft JVM: attaches to
- Injected DLL → Minecraft JVM: injects into
- Minecraft JVM → Patch registry: loads agent
- Zen client → Patch registry: registers patches
src/main/java/shit/zen/ZenClient.java - Patch registry → Game patches: transforms classes
- Zen client → Event bus: initializes
src/main/java/shit/zen/ZenClient.java - Zen client → Module manager: creates
src/main/java/shit/zen/ZenClient.java - Zen client → HUD manager: creates
src/main/java/shit/zen/ZenClient.java - Zen client → Commands: creates
src/main/java/shit/zen/ZenClient.java - Zen client → Configuration: creates
src/main/java/shit/zen/ZenClient.java - Module manager → Gameplay modules: registers modules
src/main/java/shit/zen/manager/ModuleManager.java - Module manager → Event bus: subscribes to
src/main/java/shit/zen/manager/ModuleManager.java - Gameplay modules → Module settings: exposes settings
src/main/java/shit/zen/modules/impl/player/InventoryManager.java - HUD manager → Event bus: handles render events
src/main/java/shit/zen/manager/HudManager.java - Commands → Event bus: handles chat events
src/main/java/shit/zen/manager/CommandManager.java - User → Click GUIs: configures client
- User → WebUI handlers: controls remotely
- WebUI handlers → Gameplay modules: changes modules
src/main/java/shit/zen/network/webui/SetSettingHandler.java - WebUI handlers → Module settings: sets values
src/main/java/shit/zen/network/webui/SetSettingHandler.java