# offp001/routils architecture

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

- Interactive diagram: https://gitdiagram.com/offp001/routils
- Repository: https://github.com/offp001/routils

## Overview

RoUtils is a Windows desktop utility for inspecting Roblox client caches, managing FFlags, modifying assets/configuration, and viewing or joining game servers. The principal workflow is user input through a feature-specific interface to an operation such as preview/export, applying settings, or generating a join link. The README documents capabilities and several workflows, but the main application source was not excerpted; internal implementation links are therefore omitted. The example plugin excerpt shows how plugins add tabs and use app settings and UI helpers.

Main entry points: [`src/routils.pyw`](https://github.com/offp001/routils/blob/main/src/routils.pyw) (FFlag interface), [`src/DefaultValues.json`](https://github.com/offp001/routils/blob/main/src/DefaultValues.json) (Flag lists), [`hashsaves`](https://github.com/offp001/routils/tree/main/hashsaves) (Animation conversion), [`src/Example Plugin.py`](https://github.com/offp001/routils/blob/main/src/Example%20Plugin.py) (Example plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cache["Cache Editor"]
  node_cache_ui["Cache interface<br/>[routils.pyw]"]
  node_cache_scan["Cache scanning<br/>[routils.pyw]"]
  node_cache_preview["Asset previews<br/>[routils.pyw]"]
  node_cache_export["Dump and export<br/>[routils.pyw]"]
  node_cache_store[("Roblox cache")]
end

subgraph group_flags["FFlag Manager"]
  node_flag_ui["FFlag interface<br/>[routils.pyw]"]
  node_flag_apply["Flag application<br/>[routils.pyw]"]
  node_flag_json["Saved JSONs<br/>[routils.pyw]"]
  node_flag_presets["Preset loading<br/>[routils.pyw]"]
  node_flag_lists["Flag lists<br/>[DefaultValues.json]"]
  node_ai_chat["AI chat<br/>[routils.pyw]"]
end

subgraph group_mods["Modifications"]
  node_asset_mods["Asset changers<br/>[routils.pyw]"]
  node_mesh_convert["Mesh converters<br/>[routils.pyw]"]
  node_animation_convert["Animation conversion"]
  node_cconfigs["CConfigs<br/>[routils.pyw]"]
end

subgraph group_servers["Servers and History"]
  node_subplace["Subplace joiner<br/>[routils.pyw]"]
  node_server_view["Server viewer<br/>[routils.pyw]"]
  node_history["Game and server history<br/>[routils.pyw]"]
end

subgraph group_client["Client and Plugins"]
  node_client_info["Client controls<br/>[routils.pyw]"]
  node_plugin_host["Plugin interface<br/>[routils.pyw]"]
  node_example_plugin["Example plugin<br/>[Example Plugin.py]"]
end

node_user(("RoUtils user"))
node_preset_source["Preset repository"]
node_gemini["Gemini AI"]
node_roblox["Roblox client and services"]

node_user -->|"opens"| node_cache_ui
node_cache_ui -->|"scans"| node_cache_scan
node_cache_scan -->|"reads"| node_cache_store
node_cache_ui -->|"inspects"| node_cache_preview
node_cache_ui -->|"exports"| node_cache_export
node_user -->|"configures"| node_flag_ui
node_flag_ui -->|"edits and saves"| node_flag_json
node_flag_ui -->|"applies"| node_flag_apply
node_flag_ui -->|"loads"| node_flag_presets
node_flag_presets -->|"fetches presets"| node_preset_source
node_flag_ui -->|"opens"| node_flag_lists
node_flag_ui -->|"asks"| node_ai_chat
node_ai_chat -.->|"queries"| node_gemini
node_user -->|"changes assets"| node_asset_mods
node_user -->|"converts meshes"| node_mesh_convert
node_user -->|"converts animations"| node_animation_convert
node_user -->|"saves configs"| node_cconfigs
node_user -->|"enters place IDs"| node_subplace
node_subplace -->|"generates deep link"| node_roblox
node_user -->|"inspects server"| node_server_view
node_user -->|"revisits games"| node_history
node_user -->|"views and controls"| node_client_info
node_user -->|"imports plugins"| node_plugin_host
node_plugin_host -->|"loads plugin"| node_example_plugin

click node_cache_ui "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_cache_scan "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_cache_preview "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_cache_export "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_flag_ui "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_flag_apply "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_flag_json "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_flag_presets "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_flag_lists "https://github.com/offp001/routils/blob/main/src/DefaultValues.json"
click node_ai_chat "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_asset_mods "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_mesh_convert "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_animation_convert "https://github.com/offp001/routils/tree/main/hashsaves"
click node_cconfigs "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_subplace "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_server_view "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_history "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_client_info "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_plugin_host "https://github.com/offp001/routils/blob/main/src/routils.pyw"
click node_example_plugin "https://github.com/offp001/routils/blob/main/src/Example%20Plugin.py"

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_cache_ui,node_cache_scan,node_cache_preview,node_cache_export,node_cache_store,node_user,node_roblox toneBlue
class node_flag_ui,node_flag_apply,node_flag_json,node_flag_presets,node_flag_lists,node_ai_chat toneAmber
class node_asset_mods,node_mesh_convert,node_animation_convert,node_cconfigs toneMint
class node_subplace,node_server_view,node_history toneRose
class node_client_info,node_plugin_host,node_example_plugin,node_preset_source,node_gemini toneIndigo
```

## Components

### Cache Editor

- [Cache interface](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Cache scanning](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Asset previews](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Dump and export](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- **Roblox cache**

### FFlag Manager

- [FFlag interface](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Flag application](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Saved JSONs](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Preset loading](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Flag lists](https://github.com/offp001/routils/blob/main/src/DefaultValues.json): `src/DefaultValues.json`
- [AI chat](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`

### Modifications

- [Asset changers](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Mesh converters](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Animation conversion](https://github.com/offp001/routils/tree/main/hashsaves): `hashsaves`
- [CConfigs](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`

### Servers and History

- [Subplace joiner](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Server viewer](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Game and server history](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`

### Client and Plugins

- [Client controls](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Plugin interface](https://github.com/offp001/routils/blob/main/src/routils.pyw): `src/routils.pyw`
- [Example plugin](https://github.com/offp001/routils/blob/main/src/Example%20Plugin.py): `src/Example Plugin.py`

### Other components

- **RoUtils user**
- **Preset repository**
- **Gemini AI**
- **Roblox client and services**

## Connections

- RoUtils user → Cache interface: opens (evidence: `README.md`)
- Cache interface → Cache scanning: scans (evidence: `README.md`)
- Cache scanning → Roblox cache: reads (evidence: `README.md`)
- Cache interface → Asset previews: inspects (evidence: `README.md`)
- Cache interface → Dump and export: exports (evidence: `README.md`)
- RoUtils user → FFlag interface: configures (evidence: `README.md`)
- FFlag interface → Saved JSONs: edits and saves (evidence: `README.md`)
- FFlag interface → Flag application: applies (evidence: `README.md`)
- FFlag interface → Preset loading: loads (evidence: `README.md`)
- Preset loading → Preset repository: fetches presets (evidence: `README.md`)
- FFlag interface → Flag lists: opens (evidence: `README.md`)
- FFlag interface → AI chat: asks (evidence: `README.md`)
- AI chat → Gemini AI: queries (evidence: `README.md`)
- RoUtils user → Asset changers: changes assets (evidence: `README.md`)
- RoUtils user → Mesh converters: converts meshes (evidence: `README.md`)
- RoUtils user → Animation conversion: converts animations (evidence: `README.md`)
- RoUtils user → CConfigs: saves configs (evidence: `README.md`)
- RoUtils user → Subplace joiner: enters place IDs (evidence: `README.md`)
- Subplace joiner → Roblox client and services: generates deep link (evidence: `README.md`)
- RoUtils user → Server viewer: inspects server (evidence: `README.md`)
- RoUtils user → Game and server history: revisits games (evidence: `README.md`)
- RoUtils user → Client controls: views and controls (evidence: `README.md`)
- RoUtils user → Plugin interface: imports plugins (evidence: `README.md`)
- Plugin interface → Example plugin: loads plugin (evidence: `src/Example Plugin.py`)
