# baizhi-zero/nightx-oss architecture

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

- Interactive diagram: https://gitdiagram.com/baizhi-zero/nightx-oss
- Repository: https://github.com/baizhi-zero/nightx-oss

## Overview

NightX-OSS is a Minecraft 1.8.9 client extension with gameplay modules, command and account interfaces, and visual customization. A player interacts through commands, module controls, or the account screen; modules participate in the event system, while Forge mixins intercept game and network behavior. Configuration persists client settings and accounts. The README gives project context but few feature specifics; feature breadth here is inferred from the source tree, and wiring is limited to relationships shown in sampled source.

Main entry points: [`src/main/java/net/baizhi/client/features/module/ModuleManager.kt`](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/module/ModuleManager.kt) (Module registry), [`src/main/java/net/baizhi/client/visual/client/altmanager/GuiAltManager.kt`](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/client/altmanager/GuiAltManager.kt) (Account screen), [`src/main/java/net/baizhi/client/event/EventManager.kt`](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/event/EventManager.kt) (Event dispatch), [`src/main/java/net/baizhi/client/features/command/CommandManager.kt`](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/command/CommandManager.kt) (Command handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Client Core"]
  node_launch["Client entry<br/>[Launch.kt]"]
  node_events["Event dispatch<br/>[EventManager.kt]"]
  node_networkhook["Network hooks"]
end

subgraph group_gameplay["Gameplay Features"]
  node_modulemanager["Module registry<br/>[ModuleManager.kt]"]
  node_combat["Combat modules"]
  node_movement["Movement modules"]
  node_playerfeatures["Player modules"]
  node_visualfeatures["Visual modules"]
end

subgraph group_interfaces["Player Interfaces"]
  node_commands["Command handling<br/>[CommandManager.kt]"]
  node_accountui["Account screen<br/>[GuiAltManager.kt]"]
  node_imgui["ImGui interface<br/>[ImGuiManager.kt]"]
  node_notifications["Notifications"]
end

subgraph group_state["Accounts and State"]
  node_auth["Account authentication"]
  node_filemanager["Configuration manager<br/>[FileManager.java]"]
  node_accountconfig["Account config"]
  node_presetmanager["Presets<br/>[PresetManager.kt]"]
end

node_player(("Player"))
node_minecraft["Minecraft 1.8.9"]

node_player -->|"enters commands"| node_commands
node_commands -->|"executes commands"| node_commands
node_player -->|"manages accounts"| node_accountui
node_accountui -->|"logs in"| node_auth
node_accountui -->|"saves accounts"| node_accountconfig
node_filemanager -->|"loads and saves"| node_accountconfig
node_modulemanager -->|"registers listeners"| node_events
node_networkhook -->|"dispatches packets"| node_events
node_events -->|"invokes handlers"| node_modulemanager
node_minecraft -->|"network interception"| node_networkhook
node_player -->|"toggles modules"| node_modulemanager
node_modulemanager -->|"registers modules"| node_combat
node_modulemanager -->|"registers modules"| node_movement
node_modulemanager -->|"registers modules"| node_playerfeatures
node_modulemanager -->|"registers modules"| node_visualfeatures
node_player -->|"uses interface"| node_imgui
node_player -->|"receives notices"| node_notifications
node_presetmanager -->|"uses config directory"| node_filemanager

click node_launch "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/Launch.kt"
click node_events "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/event/EventManager.kt"
click node_networkhook "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/injection/forge/mixins/network/MixinNetworkManager.java"
click node_modulemanager "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/module/ModuleManager.kt"
click node_combat "https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/combat"
click node_movement "https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/movement"
click node_playerfeatures "https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/player"
click node_visualfeatures "https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/visual"
click node_commands "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/command/CommandManager.kt"
click node_accountui "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/client/altmanager/GuiAltManager.kt"
click node_imgui "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/imgui/ImGuiManager.kt"
click node_notifications "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/notification/NotificationManager.kt"
click node_auth "https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/auth/account"
click node_filemanager "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/config/FileManager.java"
click node_accountconfig "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/config/configs/AccountsConfig.java"
click node_presetmanager "https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/api/PresetManager.kt"

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_launch,node_events,node_networkhook toneBlue
class node_modulemanager,node_combat,node_movement,node_playerfeatures,node_visualfeatures toneAmber
class node_commands,node_accountui,node_imgui,node_notifications toneMint
class node_auth,node_filemanager,node_accountconfig,node_presetmanager toneRose
class node_player,node_minecraft toneIndigo
```

## Components

### Client Core

- [Client entry](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/Launch.kt): `src/main/java/net/baizhi/client/Launch.kt`
- [Event dispatch](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/event/EventManager.kt): `src/main/java/net/baizhi/client/event/EventManager.kt`
- [Network hooks](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/injection/forge/mixins/network/MixinNetworkManager.java): `src/main/java/net/baizhi/client/injection/forge/mixins/network/MixinNetworkManager.java`

### Gameplay Features

- [Module registry](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/module/ModuleManager.kt): `src/main/java/net/baizhi/client/features/module/ModuleManager.kt`
- [Combat modules](https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/combat): `src/main/java/net/baizhi/client/features/module/impl/combat`
- [Movement modules](https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/movement): `src/main/java/net/baizhi/client/features/module/impl/movement`
- [Player modules](https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/player): `src/main/java/net/baizhi/client/features/module/impl/player`
- [Visual modules](https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/features/module/impl/visual): `src/main/java/net/baizhi/client/features/module/impl/visual`

### Player Interfaces

- [Command handling](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/command/CommandManager.kt): `src/main/java/net/baizhi/client/features/command/CommandManager.kt`
- [Account screen](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/client/altmanager/GuiAltManager.kt): `src/main/java/net/baizhi/client/visual/client/altmanager/GuiAltManager.kt`
- [ImGui interface](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/imgui/ImGuiManager.kt): `src/main/java/net/baizhi/client/visual/imgui/ImGuiManager.kt`
- [Notifications](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/visual/notification/NotificationManager.kt): `src/main/java/net/baizhi/client/visual/notification/NotificationManager.kt`

### Accounts and State

- [Account authentication](https://github.com/baizhi-zero/nightx-oss/tree/main/src/main/java/net/baizhi/client/auth/account): `src/main/java/net/baizhi/client/auth/account`
- [Configuration manager](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/config/FileManager.java): `src/main/java/net/baizhi/client/config/FileManager.java`
- [Account config](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/config/configs/AccountsConfig.java): `src/main/java/net/baizhi/client/config/configs/AccountsConfig.java`
- [Presets](https://github.com/baizhi-zero/nightx-oss/blob/main/src/main/java/net/baizhi/client/features/api/PresetManager.kt): `src/main/java/net/baizhi/client/features/api/PresetManager.kt`

### Other components

- **Player**
- **Minecraft 1.8.9**

## Connections

- Player → Command handling: enters commands
- Command handling → Command handling: executes commands
- Player → Account screen: manages accounts
- Account screen → Account authentication: logs in
- Account screen → Account config: saves accounts
- Configuration manager → Account config: loads and saves
- Module registry → Event dispatch: registers listeners
- Network hooks → Event dispatch: dispatches packets
- Event dispatch → Module registry: invokes handlers
- Minecraft 1.8.9 → Network hooks: network interception
- Player → Module registry: toggles modules
- Module registry → Combat modules: registers modules
- Module registry → Movement modules: registers modules
- Module registry → Player modules: registers modules
- Module registry → Visual modules: registers modules
- Player → ImGui interface: uses interface
- Player → Notifications: receives notices
- Presets → Configuration manager: uses config directory
