# savageduck26/ducks-gauntlet-mods architecture

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

- Interactive diagram: https://gitdiagram.com/savageduck26/ducks-gauntlet-mods
- Repository: https://github.com/savageduck26/ducks-gauntlet-mods

## Overview

The repository combines a Gauntlet Slayer Edition modpack with an optional desktop manager. The main workflow is a player using the manager to check for the latest pack, select mods, install or update them, and optionally save or restore installed-folder snapshots. The modpack itself is divided into clientside, local, serverside, and Trials categories, with AddUtility documented as required. Manager source excerpts support its main module relationships; unsampled mod implementations are represented by their directories, so their internal call flows are not inferred.

Main entry points: [`DucksModManager/src/ui.rs`](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/ui.rs) (Manager UI), [`Ducks-Modpack/AddUtility(REQUIRED_FOR_MODS)`](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/AddUtility(REQUIRED_FOR_MODS)) (AddUtility), [`DucksModManager/src/pack.rs`](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/pack.rs) (Pack updates), [`DucksModManager/src/main.rs`](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/main.rs) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_manager["Mod manager"]
  node_gui["Manager UI<br/>[ui.rs]"]
  node_entry["App entry<br/>[main.rs]"]
  node_packfetch["Pack updates<br/>[pack.rs]"]
  node_modinstall["Mod install<br/>[install.rs]"]
  node_snapshots["Savestates<br/>[saver.rs]"]
  node_appupdate["Manager updates<br/>[selfupdate.rs]"]
end

subgraph group_pack["Gauntlet modpack"]
  node_utility["AddUtility"]
  node_docs["Mod documentation"]
end

subgraph group_client["Clientside mods"]
  node_clientmods["Clientside mods"]
end

subgraph group_local["Local mods"]
  node_localmods["Local mods"]
end

subgraph group_server["Serverside mods"]
  node_servermods["Serverside mods"]
end

subgraph group_trials["Trials mods"]
  node_trialmods["Trials mods"]
end

node_player(("Player"))
node_github["GitHub"]
node_modloader["Bitesquid loader"]

node_player -->|"uses"| node_gui
node_entry -->|"starts"| node_gui
node_gui -->|"checks and fetches"| node_packfetch
node_gui -->|"installs and updates"| node_modinstall
node_gui -->|"manages snapshots"| node_snapshots
node_gui -->|"checks manager update"| node_appupdate
node_packfetch -->|"requests pack"| node_github
node_github -->|"returns archive"| node_packfetch
node_modloader -.->|"loads mods"| node_utility
node_utility -->|"required compatibility"| node_clientmods
node_utility -->|"required compatibility"| node_localmods
node_utility -->|"required compatibility"| node_servermods
node_utility -->|"required compatibility"| node_trialmods
node_player -->|"consults"| node_docs

click node_gui "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/ui.rs"
click node_entry "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/main.rs"
click node_packfetch "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/pack.rs"
click node_modinstall "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/install.rs"
click node_snapshots "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/saver.rs"
click node_appupdate "https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/selfupdate.rs"
click node_utility "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/AddUtility(REQUIRED_FOR_MODS)"
click node_docs "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Docs"
click node_clientmods "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Clientside%20Mods"
click node_localmods "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Local%20Mods"
click node_servermods "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Serverside%20Mods"
click node_trialmods "https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Trials%20Mods"

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_gui,node_entry,node_packfetch,node_modinstall,node_snapshots,node_appupdate toneBlue
class node_utility,node_docs toneAmber
class node_clientmods toneMint
class node_localmods toneRose
class node_servermods,node_player,node_github,node_modloader toneIndigo
class node_trialmods toneTeal
```

## Components

### Mod manager

- [Manager UI](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/ui.rs): `DucksModManager/src/ui.rs`
- [App entry](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/main.rs): `DucksModManager/src/main.rs`
- [Pack updates](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/pack.rs): `DucksModManager/src/pack.rs`
- [Mod install](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/install.rs): `DucksModManager/src/install.rs`
- [Savestates](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/saver.rs): `DucksModManager/src/saver.rs`
- [Manager updates](https://github.com/savageduck26/ducks-gauntlet-mods/blob/main/DucksModManager/src/selfupdate.rs): `DucksModManager/src/selfupdate.rs`

### Gauntlet modpack

- [AddUtility](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/AddUtility(REQUIRED_FOR_MODS)): `Ducks-Modpack/AddUtility(REQUIRED_FOR_MODS)`
- [Mod documentation](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Docs): `Ducks-Modpack/Docs`

### Clientside mods

- [Clientside mods](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Clientside%20Mods): `Ducks-Modpack/Clientside Mods`

### Local mods

- [Local mods](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Local%20Mods): `Ducks-Modpack/Local Mods`

### Serverside mods

- [Serverside mods](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Serverside%20Mods): `Ducks-Modpack/Serverside Mods`

### Trials mods

- [Trials mods](https://github.com/savageduck26/ducks-gauntlet-mods/tree/main/Ducks-Modpack/Trials%20Mods): `Ducks-Modpack/Trials Mods`

### Other components

- **Player**
- **GitHub**
- **Bitesquid loader**

## Connections

- Player → Manager UI: uses (evidence: `README.md`)
- App entry → Manager UI: starts (evidence: `DucksModManager/src/main.rs`)
- Manager UI → Pack updates: checks and fetches (evidence: `DucksModManager/src/ui.rs`)
- Manager UI → Mod install: installs and updates (evidence: `DucksModManager/src/ui.rs`)
- Manager UI → Savestates: manages snapshots (evidence: `DucksModManager/src/saver.rs`)
- Manager UI → Manager updates: checks manager update (evidence: `DucksModManager/src/main.rs`)
- Pack updates → GitHub: requests pack (evidence: `DucksModManager/src/pack.rs`)
- GitHub → Pack updates: returns archive
- Bitesquid loader → AddUtility: loads mods
- AddUtility → Clientside mods: required compatibility (evidence: `README.md`)
- AddUtility → Local mods: required compatibility (evidence: `README.md`)
- AddUtility → Serverside mods: required compatibility (evidence: `README.md`)
- AddUtility → Trials mods: required compatibility (evidence: `README.md`)
- Player → Mod documentation: consults (evidence: `README.md`)
