# novetus/novetus_src architecture

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

- Interactive diagram: https://gitdiagram.com/novetus/novetus_src
- Repository: https://github.com/novetus/novetus_src

## Overview

##### Project type and purpose
- Novetus is a desktop-based game-client/launcher ecosystem written in C#, with embedded Lua scripting for server logic and game behavior.
- It comprises installers/bootstrapper, a rich‐UI launcher (WinForms + WPF), a core shared library, a URI‐handler, plus Lua scripts & static assets.

##### File structure and surface the main modules
- Novetus.Bootstrapper (C# exe) – handles prerequisites (VC++ redists), local paths, and launches the main launcher.
- NovetusCore (C# class library) – contains common logic: file management, network/download (ContentProvider), settings, Roblox data helpers, Discord RPC integration.
- NovetusLauncher (C# exe + WinForms/WPF) – the user-facing application with multiple UI themes (Compact, Extended, Stylish), mod manager, asset downloader, SDK tools (mesh converter, script editors), server browser, console.
- NovetusURI (C# exe/dll) – registers “novetus://” custom URI to support one-click launches or quick configurations.
- Graphics – branding & UI assets (bmp, pdn) used by installer and launcher.

##### README for tech stack & workflows
- Built with Visual Studio (.sln files), targets Windows.
- Uses .NET Framework (WinForms + some WPF .xaml).
- Integrates Lua scripts for in-game/server logic.
- Downloads assets over HTTP, uses JSON/INI files for configuration.

A. Main Components (each as a big block)
1. Bootstrapper Module
– Reads/sets up LocalPaths & NuGet redists → invokes Launcher.exe
2. Launcher Application
– UI Layer (WinForms & WPF themes)
– Controllers: ModManager, SplashLoader, TabControllers
– SDK Sub-tools (AssetDownloader, MeshConverter, etc.)
3. Core Library
– FileManagement, Downloader, INI/JSON, CryptoRandom
– RobloxHelpers, DiscordRPC, WebProxy
– Settings, GlobalPaths, NovetusFuncs
4. URI Handler
– Listens for custom URI → calls Launcher with parameters
5. Asset & Script Repository
– Shareddata (RBX models)
– defaultaddons (Lua scripts for server add-ons)
– scripts/game (versioned Lua scripts for different Roblox-era games)
6. External Services
– Content Providers (download Roblox assets)
– Discord (RPC status updates)
– HTTP update servers (Novetus updates)

B. Relationships & Data Flow
- Bootstrapper → (executes) → Launcher.exe
- Launcher UI ↔ (calls) ↔ Core Library APIs
- Core Library → (HTTP requests) → External Content Servers
- Core Library → (file I/O) → Local FS (Shareddata, config files)
- Launcher → (loads/injects) → Lua scripts from scripts/ and defaultaddons/
- Launcher → (registers/invokes) → URI Handler

C. Architectural Patterns & Principles
– Modularization: clear separation between UI (Launcher), business logic (Core), and install logic (Bootstrapper).
– Plugin-style extensibility: Lua addons (defaultaddons) and SDK tools can be added without altering core.
– Theming: multiple UI skins share a common interface (Shared LauncherFormShared.cs).
– Protocol Handler: custom URI scheme for deep links.

D. Key Technologies & Frameworks
– C#/.NET Framework, WinForms, WPF (for Stylish theme)
– Lua for in-game scripting
– JSON/INI for configs, .resx for resources
– NuGet packages (DiscordRPC?), HTTP/REST for content downloads

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Install Layer
    subgraph "Install Layer"
        direction TB
        Boot("Bootstrapper Module"):::install
    end

    %% UI Layer
    subgraph "UI Layer"
        direction TB
        Launcher("Launcher Application"):::ui
    end

    %% Core Layer
    subgraph "Core Layer"
        direction TB
        CoreLib["NovetusCore.dll"]:::core
        URIHandler("URI Handler"):::core
    end

    %% Repository Layer
    subgraph "Asset & Script Repository"
        direction TB
        Shareddata["Shareddata/"]:::assets
        DefaultAddons["defaultaddons/"]:::assets
        GameScripts["scripts/game/"]:::assets
        Graphics["Graphics/"]:::assets
    end

    %% Storage
    LocalFS[(Local File System)]:::core

    %% External Services
    subgraph "External Services"
        direction TB
        ContentServer("Content Server"):::external
        Discord("Discord RPC"):::external
        UpdateServer("HTTP Update Server"):::external
    end

    %% Connections
    Boot -->|"executes"| Launcher
    Launcher -->|"calls APIs"| CoreLib
    CoreLib -->|"HTTP GET assets"| ContentServer
    CoreLib -->|"RPC updates"| Discord
    CoreLib -->|"reads/writes config"| LocalFS
    Launcher -->|"loads scripts"| GameScripts
    Launcher -->|"loads addons"| DefaultAddons
    Launcher -->|"loads assets"| Shareddata
    Launcher -->|"loads graphics"| Graphics
    Launcher -->|"registers/invokes"| URIHandler
    URIHandler -->|"launch params"| Launcher

    %% Click Events
    click Boot "https://github.com/novetus/novetus_src/tree/master/Novetus/Novetus.Bootstrapper/"
    click CoreLib "https://github.com/novetus/novetus_src/tree/master/Novetus/NovetusCore/"
    click Launcher "https://github.com/novetus/novetus_src/tree/master/Novetus/NovetusLauncher/"
    click URIHandler "https://github.com/novetus/novetus_src/tree/master/Novetus/NovetusURI/"
    click Shareddata "https://github.com/novetus/novetus_src/tree/master/Shareddata/"
    click DefaultAddons "https://github.com/novetus/novetus_src/tree/master/defaultaddons/"
    click GameScripts "https://github.com/novetus/novetus_src/tree/master/scripts/game/"
    click Graphics "https://github.com/novetus/novetus_src/tree/master/Graphics/"

    %% Styles
    classDef install fill:#D0E8FF,stroke:#005A9C,color:#003366;
    classDef core fill:#E0FFE0,stroke:#2D662D,color:#1A3D1A;
    classDef ui fill:#FFE8B0,stroke:#CC8400,color:#663D00;
    classDef assets fill:#FFF5CC,stroke:#CCAA00,color:#664C00;
    classDef external fill:#F0F0F0,stroke:#666666,color:#333333;
```
