# nunera/hydronium architecture

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

- Interactive diagram: https://gitdiagram.com/nunera/hydronium
- Repository: https://github.com/nunera/hydronium

## Overview

##### Main Components Structure

a) Core System Components:

##### Detailed Component Breakdown

a) Scanning/Spying Modules (Rectangle, Blue):
- ClosureSpy
- ConstantScanner
- Explorer
- ModuleScanner
- RemoteSpy
- ScriptScanner
- UpvalueScanner

b) Objects (Hexagon, Green):
- Closure
- Constant
- LocalScript
- ModuleScript
- Remote
- Upvalue

c) UI Components (Rounded Rectangle, Purple):
- Controls
- CheckBox
- ContextMenu
- Dropdown
- List
- MessageBox
- Prompt
- TabSelector
- Module-specific UIs

##### Data Flow

- User Input → UI Components
- UI Components → Corresponding Modules
- Modules → Objects
- Objects → Methods

##### Technical Details

Annotations for:
- Roblox Engine Integration Points
- Memory/GC Interaction Points
- Remote Call Interception Points

##### Implementation Notes

Notes for:
- Proto handling
- Upvalue manipulation
- Remote call interception
- Closure tracking

- Upvalue scanning/modification
- Constant scanning/modification
- Script/Module scanning
- Remote call interception
- Closure monitoring

Remember to include a note about the cache system and its role in updates, as mentioned in the README. Also, highlight the entry point (Loadstring.lua) and its relationship to the initialization process.

This structure will provide a clear visualization of how Hydronium integrates with Roblox games and performs its pen-testing functions while maintaining a clean and understandable architecture representation.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Main Components
    Entry["Entry Point"]:::entry
    Core["Core System"]:::core
    Cache[(Cache System)]:::cache
    RobloxGame["Roblox Game Environment"]:::external

    %% Methods Container
    subgraph Methods
        EnvMethods["Environment Methods"]:::method
        StrMethods["String Methods"]:::method
        TblMethods["Table Methods"]:::method
        UsrMethods["Userdata Methods"]:::method
    end

    %% Scanning/Spying Modules
    subgraph Modules
        ClosureSpy["Closure Spy"]:::module
        ConstScanner["Constant Scanner"]:::module
        Explorer["Explorer"]:::module
        ModScanner["Module Scanner"]:::module
        RemoteSpy["Remote Spy"]:::module
        ScriptScanner["Script Scanner"]:::module
        UpvalueScanner["Upvalue Scanner"]:::module
    end

    %% Objects
    subgraph Objects
        Closure["Closure"]:::object
        Constant["Constant"]:::object
        LocalScript["LocalScript"]:::object
        ModuleScript["ModuleScript"]:::object
        Remote["Remote"]:::object
        Upvalue["Upvalue"]:::object
    end

    %% UI Components
    subgraph UI
        MainUI["Main UI"]:::ui
        subgraph Controls
            CheckBox["CheckBox"]:::control
            ContextMenu["ContextMenu"]:::control
            Dropdown["Dropdown"]:::control
            List["List"]:::control
            MessageBox["MessageBox"]:::control
            Prompt["Prompt"]:::control
            TabSelector["TabSelector"]:::control
        end
        subgraph ModuleUIs
            ClosureSpyUI["ClosureSpy UI"]:::moduleui
            ConstScannerUI["ConstantScanner UI"]:::moduleui
            ExplorerUI["Explorer UI"]:::moduleui
            ModScannerUI["ModuleScanner UI"]:::moduleui
            RemoteSpyUI["RemoteSpy UI"]:::moduleui
            ScriptScannerUI["ScriptScanner UI"]:::moduleui
            UpvalueScannerUI["UpvalueScanner UI"]:::moduleui
        end
    end

    %% Relationships
    Entry --> Core
    Core --> Methods
    Core --> Modules
    Core --> Objects
    Core --> UI
    Core --> Cache
    
    Modules <--> RobloxGame
    Objects <--> RobloxGame
    
    %% Module to UI relationships
    ClosureSpy <--> ClosureSpyUI
    ConstScanner <--> ConstScannerUI
    Explorer <--> ExplorerUI
    ModScanner <--> ModScannerUI
    RemoteSpy <--> RemoteSpyUI
    ScriptScanner <--> ScriptScannerUI
    UpvalueScanner <--> UpvalueScannerUI

    %% Click events
    click Entry "https://github.com/nunera/Hydronium/blob/revision/Loadstring.lua"
    click Core "https://github.com/nunera/Hydronium/blob/revision/init.lua"
    click EnvMethods "https://github.com/nunera/Hydronium/blob/revision/methods/environment.lua"
    click StrMethods "https://github.com/nunera/Hydronium/blob/revision/methods/string.lua"
    click TblMethods "https://github.com/nunera/Hydronium/blob/revision/methods/table.lua"
    click UsrMethods "https://github.com/nunera/Hydronium/blob/revision/methods/userdata.lua"
    click ClosureSpy "https://github.com/nunera/Hydronium/blob/revision/modules/ClosureSpy.lua"
    click ConstScanner "https://github.com/nunera/Hydronium/blob/revision/modules/ConstantScanner.lua"
    click Explorer "https://github.com/nunera/Hydronium/blob/revision/modules/Explorer.lua"
    click ModScanner "https://github.com/nunera/Hydronium/blob/revision/modules/ModuleScanner.lua"
    click RemoteSpy "https://github.com/nunera/Hydronium/blob/revision/modules/RemoteSpy.lua"
    click ScriptScanner "https://github.com/nunera/Hydronium/blob/revision/modules/ScriptScanner.lua"
    click UpvalueScanner "https://github.com/nunera/Hydronium/blob/revision/modules/UpvalueScanner.lua"
    click Closure "https://github.com/nunera/Hydronium/blob/revision/objects/Closure.lua"
    click Constant "https://github.com/nunera/Hydronium/blob/revision/objects/Constant.lua"
    click LocalScript "https://github.com/nunera/Hydronium/blob/revision/objects/LocalScript.lua"
    click ModuleScript "https://github.com/nunera/Hydronium/blob/revision/objects/ModuleScript.lua"
    click Remote "https://github.com/nunera/Hydronium/blob/revision/objects/Remote.lua"
    click Upvalue "https://github.com/nunera/Hydronium/blob/revision/objects/Upvalue.lua"
    click MainUI "https://github.com/nunera/Hydronium/blob/revision/ui/main.lua"
    click CheckBox "https://github.com/nunera/Hydronium/blob/revision/ui/controls/CheckBox.lua"
    click ContextMenu "https://github.com/nunera/Hydronium/blob/revision/ui/controls/ContextMenu.lua"
    click Dropdown "https://github.com/nunera/Hydronium/blob/revision/ui/controls/Dropdown.lua"
    click List "https://github.com/nunera/Hydronium/blob/revision/ui/controls/List.lua"
    click MessageBox "https://github.com/nunera/Hydronium/blob/revision/ui/controls/MessageBox.lua"
    click Prompt "https://github.com/nunera/Hydronium/blob/revision/ui/controls/Prompt.lua"
    click TabSelector "https://github.com/nunera/Hydronium/blob/revision/ui/controls/TabSelector.lua"
    click ClosureSpyUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/ClosureSpy.lua"
    click ConstScannerUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/ConstantScanner.lua"
    click ExplorerUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/Explorer.lua"
    click ModScannerUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/ModuleScanner.lua"
    click RemoteSpyUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/RemoteSpy.lua"
    click ScriptScannerUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/ScriptScanner.lua"
    click UpvalueScannerUI "https://github.com/nunera/Hydronium/blob/revision/ui/modules/UpvalueScanner.lua"

    %% Styling
    classDef entry fill:#ff6b6b,stroke:#333,stroke-width:2px
    classDef core fill:#ff9f43,stroke:#333,stroke-width:2px
    classDef method fill:#1dd1a1,stroke:#333
    classDef module fill:#54a0ff,stroke:#333
    classDef object fill:#00d2d3,stroke:#333
    classDef ui fill:#5f27cd,stroke:#333,color:#fff
    classDef control fill:#8854d0,stroke:#333,color:#fff
    classDef moduleui fill:#6c5ce7,stroke:#333,color:#fff
    classDef external fill:#a8a8a8,stroke:#333
    classDef cache fill:#ffa502,stroke:#333
```
