# veltrix-s/onyxmenu architecture

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

- Interactive diagram: https://gitdiagram.com/veltrix-s/onyxmenu
- Repository: https://github.com/veltrix-s/onyxmenu

## Overview

Nocturne is a client-side Among Us mod menu. The player opens its in-game interface, selects lobby, gameplay, visual, chat, or utility options, and uses those controls to affect the game; replay and music are additional menu capabilities. The plugin initializes configuration, installs Harmony patches, and registers runtime components. Groups and paths reflect the source tree and index; several feature relationships are supported only by the README, so unsampled implementation details are not expanded into speculative call chains.

Main entry points: [`src/Menu/NocturneMenu.cs`](https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneMenu.cs) (In-game menu), [`src/Core/NocturnePlugin.cs`](https://github.com/veltrix-s/onyxmenu/blob/main/src/Core/NocturnePlugin.cs) (Plugin runtime), [`src/Music/NocturneMusicPlayer.cs`](https://github.com/veltrix-s/onyxmenu/blob/main/src/Music/NocturneMusicPlayer.cs) (Music player), [`src/Chat/ChatPatches.cs`](https://github.com/veltrix-s/onyxmenu/blob/main/src/Chat/ChatPatches.cs) (Chat utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Runtime and interface"]
  node_plugin["Plugin runtime<br/>[NocturnePlugin.cs]"]
  node_menu["In-game menu<br/>[NocturneMenu.cs]"]
  node_config[("Persistent settings<br/>[NocturneConfig.cs]")]
  node_hud["HUD and notices<br/>[NocturneHud.cs]"]
end

subgraph group_lobby["Lobby and hosting"]
  node_lobbytools["Lobby tools"]
  node_autohost["Auto-host<br/>[AutoHostPatches.cs]"]
  node_hostsettings["Host settings"]
  node_clones["Lobby clones"]
end

subgraph group_game["Gameplay and visuals"]
  node_gameplay["Gameplay options"]
  node_patches["Game patches<br/>[GameplayPatches.cs]"]
  node_visuals["Visual overlays<br/>[VisualPatches.cs]"]
  node_radar["Player radar<br/>[NocturneRadar.cs]"]
end

subgraph group_social["Chat and security"]
  node_chat["Chat utilities<br/>[ChatPatches.cs]"]
  node_whisper["Whisper<br/>[NocturneWhisper.cs]"]
  node_security["Access and guards<br/>[NocturneAccess.cs]"]
end

subgraph group_media["Replay and media"]
  node_replay["Match replay<br/>[NocturneReplay.cs]"]
  node_music["Music player"]
  node_mediawin["Windows media controls<br/>[WinMedia.cs]"]
end

node_player(("Player"))

node_player -->|"runs mod"| node_plugin
node_player -->|"opens menu"| node_menu
node_plugin -->|"binds settings"| node_config
node_plugin -->|"registers component"| node_menu
node_plugin -->|"registers component"| node_hud
node_plugin -->|"registers component"| node_music
node_plugin -->|"registers component"| node_radar
node_menu -->|"reads settings"| node_config
node_menu -->|"offers lobby controls"| node_lobbytools
node_menu -->|"offers hosting options"| node_autohost
node_menu -->|"offers host settings"| node_hostsettings
node_menu -->|"offers clone controls"| node_clones
node_menu -->|"offers gameplay options"| node_gameplay
node_menu -.->|"configures game options"| node_patches
node_menu -->|"offers visual options"| node_visuals
node_menu -->|"offers radar"| node_radar
node_menu -->|"offers chat utilities"| node_chat
node_menu -.->|"offers whisper"| node_whisper
node_menu -->|"opens replay"| node_replay
node_player -->|"opens player"| node_music
node_music -->|"uses media controls"| node_mediawin
node_chat -->|"invokes whisper"| node_whisper
node_menu -.->|"exposes access settings"| node_security

click node_plugin "https://github.com/veltrix-s/onyxmenu/blob/main/src/Core/NocturnePlugin.cs"
click node_menu "https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneMenu.cs"
click node_config "https://github.com/veltrix-s/onyxmenu/blob/main/src/Core/NocturneConfig.cs"
click node_hud "https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneHud.cs"
click node_lobbytools "https://github.com/veltrix-s/onyxmenu/blob/main/src/Lobby/NocturneLobbyTools.cs"
click node_autohost "https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/AutoHostPatches.cs"
click node_hostsettings "https://github.com/veltrix-s/onyxmenu/blob/main/src/Host/NocturneLobbySettings.cs"
click node_clones "https://github.com/veltrix-s/onyxmenu/blob/main/src/Lobby/NocturneLobbyClones.cs"
click node_gameplay "https://github.com/veltrix-s/onyxmenu/blob/main/src/Cheats/NocturneRoleBuffs.cs"
click node_patches "https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/GameplayPatches.cs"
click node_visuals "https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/VisualPatches.cs"
click node_radar "https://github.com/veltrix-s/onyxmenu/blob/main/src/Radar/NocturneRadar.cs"
click node_chat "https://github.com/veltrix-s/onyxmenu/blob/main/src/Chat/ChatPatches.cs"
click node_whisper "https://github.com/veltrix-s/onyxmenu/blob/main/src/Chat/NocturneWhisper.cs"
click node_security "https://github.com/veltrix-s/onyxmenu/blob/main/src/Security/NocturneAccess.cs"
click node_replay "https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneReplay.cs"
click node_music "https://github.com/veltrix-s/onyxmenu/blob/main/src/Music/NocturneMusicPlayer.cs"
click node_mediawin "https://github.com/veltrix-s/onyxmenu/blob/main/src/Music/WinMedia.cs"

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_plugin,node_menu,node_config,node_hud toneBlue
class node_lobbytools,node_autohost,node_hostsettings,node_clones toneAmber
class node_gameplay,node_patches,node_visuals,node_radar toneMint
class node_chat,node_whisper,node_security toneRose
class node_replay,node_music,node_mediawin,node_player toneIndigo
```

## Components

### Runtime and interface

- [Plugin runtime](https://github.com/veltrix-s/onyxmenu/blob/main/src/Core/NocturnePlugin.cs): `src/Core/NocturnePlugin.cs`
- [In-game menu](https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneMenu.cs): `src/Menu/NocturneMenu.cs`
- [Persistent settings](https://github.com/veltrix-s/onyxmenu/blob/main/src/Core/NocturneConfig.cs): `src/Core/NocturneConfig.cs`
- [HUD and notices](https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneHud.cs): `src/Menu/NocturneHud.cs`

### Lobby and hosting

- [Lobby tools](https://github.com/veltrix-s/onyxmenu/blob/main/src/Lobby/NocturneLobbyTools.cs): `src/Lobby/NocturneLobbyTools.cs`
- [Auto-host](https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/AutoHostPatches.cs): `src/Patches/AutoHostPatches.cs`
- [Host settings](https://github.com/veltrix-s/onyxmenu/blob/main/src/Host/NocturneLobbySettings.cs): `src/Host/NocturneLobbySettings.cs`
- [Lobby clones](https://github.com/veltrix-s/onyxmenu/blob/main/src/Lobby/NocturneLobbyClones.cs): `src/Lobby/NocturneLobbyClones.cs`

### Gameplay and visuals

- [Gameplay options](https://github.com/veltrix-s/onyxmenu/blob/main/src/Cheats/NocturneRoleBuffs.cs): `src/Cheats/NocturneRoleBuffs.cs`
- [Game patches](https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/GameplayPatches.cs): `src/Patches/GameplayPatches.cs`
- [Visual overlays](https://github.com/veltrix-s/onyxmenu/blob/main/src/Patches/VisualPatches.cs): `src/Patches/VisualPatches.cs`
- [Player radar](https://github.com/veltrix-s/onyxmenu/blob/main/src/Radar/NocturneRadar.cs): `src/Radar/NocturneRadar.cs`

### Chat and security

- [Chat utilities](https://github.com/veltrix-s/onyxmenu/blob/main/src/Chat/ChatPatches.cs): `src/Chat/ChatPatches.cs`
- [Whisper](https://github.com/veltrix-s/onyxmenu/blob/main/src/Chat/NocturneWhisper.cs): `src/Chat/NocturneWhisper.cs`
- [Access and guards](https://github.com/veltrix-s/onyxmenu/blob/main/src/Security/NocturneAccess.cs): `src/Security/NocturneAccess.cs`

### Replay and media

- [Match replay](https://github.com/veltrix-s/onyxmenu/blob/main/src/Menu/NocturneReplay.cs): `src/Menu/NocturneReplay.cs`
- [Music player](https://github.com/veltrix-s/onyxmenu/blob/main/src/Music/NocturneMusicPlayer.cs): `src/Music/NocturneMusicPlayer.cs`
- [Windows media controls](https://github.com/veltrix-s/onyxmenu/blob/main/src/Music/WinMedia.cs): `src/Music/WinMedia.cs`

### Other components

- **Player**

## Connections

- Player → Plugin runtime: runs mod (evidence: `README.md`)
- Player → In-game menu: opens menu (evidence: `README.md`)
- Plugin runtime → Persistent settings: binds settings (evidence: `src/Core/NocturnePlugin.cs`)
- Plugin runtime → In-game menu: registers component (evidence: `src/Core/NocturnePlugin.cs`)
- Plugin runtime → HUD and notices: registers component (evidence: `src/Core/NocturnePlugin.cs`)
- Plugin runtime → Music player: registers component (evidence: `src/Core/NocturnePlugin.cs`)
- Plugin runtime → Player radar: registers component (evidence: `src/Core/NocturnePlugin.cs`)
- In-game menu → Persistent settings: reads settings (evidence: `src/Menu/NocturneMenu.cs`)
- In-game menu → Lobby tools: offers lobby controls (evidence: `README.md`)
- In-game menu → Auto-host: offers hosting options (evidence: `README.md`)
- In-game menu → Host settings: offers host settings (evidence: `README.md`)
- In-game menu → Lobby clones: offers clone controls (evidence: `src/Menu/NocturneMenu.cs`)
- In-game menu → Gameplay options: offers gameplay options (evidence: `README.md`)
- In-game menu → Game patches: configures game options
- In-game menu → Visual overlays: offers visual options (evidence: `README.md`)
- In-game menu → Player radar: offers radar (evidence: `README.md`)
- In-game menu → Chat utilities: offers chat utilities (evidence: `README.md`)
- In-game menu → Whisper: offers whisper (evidence: `src/Menu/NocturneMenu.cs`)
- In-game menu → Match replay: opens replay (evidence: `README.md`)
- Player → Music player: opens player (evidence: `README.md`)
- Music player → Windows media controls: uses media controls (evidence: `src/Music/NocturneMusicPlayer.cs`)
- Chat utilities → Whisper: invokes whisper (evidence: `src/Chat/ChatPatches.cs`)
- In-game menu → Access and guards: exposes access settings (evidence: `src/Menu/NocturneMenu.cs`)
