# level-thumbnails/level-thumbs-mod architecture

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

- Interactive diagram: https://gitdiagram.com/level-thumbnails/level-thumbs-mod
- Repository: https://github.com/level-thumbnails/level-thumbs-mod

## Overview

LevelThumbnails is a Geometry Dash mod for viewing and submitting level thumbnails. The main path is gameplay screenshot capture, preview and note editing, then authenticated upload; other hooks display thumbnails in level views and profile/comment interfaces. ThumbnailManager fetches and caches images, while AuthManager handles account linking, roles, and submissions. The README provides no capability detail, so this map relies on the sampled source and source index; unsampled modules are represented only where their paths and responsibilities are supported.

Main entry points: [`src/hooks/PauseLayer.cpp`](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/PauseLayer.cpp) (Pause hooks), [`src/layers/ThumbnailPopup.cpp`](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/ThumbnailPopup.cpp) (Thumbnail popup), [`src/managers/ThumbnailManager.cpp`](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/ThumbnailManager.cpp) (Thumbnail service), [`src/managers/AuthManager.cpp`](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/AuthManager.cpp) (Account and upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Gameplay capture"]
  node_pause["Pause hooks<br/>[PauseLayer.cpp]"]
  node_popup["Thumbnail popup<br/>[ThumbnailPopup.cpp]"]
end

subgraph group_views["Thumbnail views"]
  node_levelcell["Level list display<br/>[LevelCell.cpp]"]
  node_levelinfo["Level detail display<br/>[LevelInfoLayer.cpp]"]
  node_comments["Comment badges<br/>[CommentCell.cpp]"]
  node_profile["Profile badges<br/>[ProfilePage.cpp]"]
  node_linksetting["Account linking<br/>[LinkAccount.cpp]"]
  node_modactions["Thumbnail actions<br/>[ModActions.cpp]"]
end

subgraph group_services["Account and thumbnail services"]
  node_settings["Mod settings"]
  node_thumbnail["Thumbnail service"]
  node_cache[("Image caches")]
  node_auth["Account and upload<br/>[AuthManager.cpp]"]
end

subgraph group_shared["Shared UI and utilities"]
  node_render["Screenshot rendering<br/>[RenderTexture.cpp]"]
  node_notes["Submission notes"]
  node_confirm["Confirmation dialogs"]
  node_loading["Loading overlay<br/>[LoadingOverlay.cpp]"]
  node_compat["Compatibility helpers<br/>[EclipseCompat.hpp]"]
  node_modnode["Node compatibility<br/>[ModNodeCompat.hpp]"]
  node_hider["Node visibility<br/>[NodeHider.hpp]"]
  node_encoder["URL encoding<br/>[UrlEncode.hpp]"]
end

node_player(("Player"))
node_api{{"Thumbnail API"}}

node_player -->|"opens capture"| node_pause
node_pause -->|"renders screenshot"| node_render
node_pause -->|"builds note"| node_notes
node_pause -->|"opens preview"| node_popup
node_pause -->|"checks compatibility"| node_auth
node_popup -->|"fetches thumbnail"| node_thumbnail
node_popup -->|"uploads submission"| node_auth
node_popup -->|"requests confirmation"| node_confirm
node_popup -->|"shows progress"| node_loading
node_popup -->|"encodes note"| node_encoder
node_popup -->|"requests thumbnail info"| node_api
node_levelcell -->|"fetches thumbnail"| node_thumbnail
node_levelinfo -->|"fetches thumbnail"| node_thumbnail
node_comments -->|"checks badge role"| node_auth
node_profile -->|"checks badge role"| node_auth
node_linksetting -->|"links account"| node_auth
node_linksetting -->|"confirms action"| node_confirm
node_modactions -->|"manages thumbnails"| node_thumbnail
node_thumbnail -->|"reads and writes"| node_cache
node_thumbnail -->|"downloads image"| node_api
node_auth -->|"authenticates and uploads"| node_api
node_pause -->|"checks pending count"| node_api
node_pause -->|"checks integration"| node_compat
node_pause -->|"uses compatibility"| node_modnode
node_pause -->|"uses visibility helper"| node_hider

click node_pause "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/PauseLayer.cpp"
click node_render "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/RenderTexture.cpp"
click node_notes "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/SubmissionNotes.hpp"
click node_popup "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/ThumbnailPopup.cpp"
click node_confirm "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/ConfirmAlertLayer.hpp"
click node_loading "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/LoadingOverlay.cpp"
click node_levelcell "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/LevelCell.cpp"
click node_levelinfo "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/LevelInfoLayer.cpp"
click node_comments "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/CommentCell.cpp"
click node_profile "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/ProfilePage.cpp"
click node_settings "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/SettingsManager.cpp"
click node_thumbnail "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/ThumbnailManager.cpp"
click node_cache "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/ThumbnailManager.cpp"
click node_auth "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/AuthManager.cpp"
click node_linksetting "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/setting/LinkAccount.cpp"
click node_modactions "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/setting/ModActions.cpp"
click node_compat "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/EclipseCompat.hpp"
click node_modnode "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/ModNodeCompat.hpp"
click node_hider "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/NodeHider.hpp"
click node_encoder "https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/UrlEncode.hpp"

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_pause,node_popup toneBlue
class node_levelcell,node_levelinfo,node_comments,node_profile,node_linksetting,node_modactions toneAmber
class node_settings,node_thumbnail,node_cache,node_auth,node_api toneMint
class node_render,node_notes,node_confirm,node_loading,node_compat,node_modnode,node_hider,node_encoder toneRose
class node_player toneIndigo
```

## Components

### Gameplay capture

- [Pause hooks](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/PauseLayer.cpp): `src/hooks/PauseLayer.cpp`
- [Thumbnail popup](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/ThumbnailPopup.cpp): `src/layers/ThumbnailPopup.cpp`

### Thumbnail views

- [Level list display](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/LevelCell.cpp): `src/hooks/LevelCell.cpp`
- [Level detail display](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/LevelInfoLayer.cpp): `src/hooks/LevelInfoLayer.cpp`
- [Comment badges](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/CommentCell.cpp): `src/hooks/CommentCell.cpp`
- [Profile badges](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/hooks/ProfilePage.cpp): `src/hooks/ProfilePage.cpp`
- [Account linking](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/setting/LinkAccount.cpp): `src/setting/LinkAccount.cpp`
- [Thumbnail actions](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/setting/ModActions.cpp): `src/setting/ModActions.cpp`

### Account and thumbnail services

- [Mod settings](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/SettingsManager.cpp): `src/managers/SettingsManager.cpp`
- [Thumbnail service](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/ThumbnailManager.cpp): `src/managers/ThumbnailManager.cpp`
- [Image caches](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/ThumbnailManager.cpp): `src/managers/ThumbnailManager.cpp`
- [Account and upload](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/managers/AuthManager.cpp): `src/managers/AuthManager.cpp`

### Shared UI and utilities

- [Screenshot rendering](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/RenderTexture.cpp): `src/utils/RenderTexture.cpp`
- [Submission notes](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/SubmissionNotes.hpp): `src/utils/SubmissionNotes.hpp`
- [Confirmation dialogs](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/ConfirmAlertLayer.hpp): `src/layers/ConfirmAlertLayer.hpp`
- [Loading overlay](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/layers/LoadingOverlay.cpp): `src/layers/LoadingOverlay.cpp`
- [Compatibility helpers](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/EclipseCompat.hpp): `src/utils/EclipseCompat.hpp`
- [Node compatibility](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/ModNodeCompat.hpp): `src/utils/ModNodeCompat.hpp`
- [Node visibility](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/NodeHider.hpp): `src/utils/NodeHider.hpp`
- [URL encoding](https://github.com/level-thumbnails/level-thumbs-mod/blob/main/src/utils/UrlEncode.hpp): `src/utils/UrlEncode.hpp`

### Other components

- **Player**
- **Thumbnail API**

## Connections

- Player → Pause hooks: opens capture (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Screenshot rendering: renders screenshot (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Submission notes: builds note (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Thumbnail popup: opens preview (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Account and upload: checks compatibility (evidence: `src/hooks/PauseLayer.cpp`)
- Thumbnail popup → Thumbnail service: fetches thumbnail (evidence: `src/layers/ThumbnailPopup.cpp`)
- Thumbnail popup → Account and upload: uploads submission (evidence: `src/layers/ThumbnailPopup.cpp`)
- Thumbnail popup → Confirmation dialogs: requests confirmation (evidence: `src/layers/ThumbnailPopup.cpp`)
- Thumbnail popup → Loading overlay: shows progress (evidence: `src/layers/ThumbnailPopup.cpp`)
- Thumbnail popup → URL encoding: encodes note (evidence: `src/layers/ThumbnailPopup.cpp`)
- Thumbnail popup → Thumbnail API: requests thumbnail info (evidence: `src/layers/ThumbnailPopup.cpp`)
- Level list display → Thumbnail service: fetches thumbnail (evidence: `src/hooks/LevelCell.cpp`)
- Level detail display → Thumbnail service: fetches thumbnail (evidence: `src/hooks/LevelInfoLayer.cpp`)
- Comment badges → Account and upload: checks badge role (evidence: `src/hooks/CommentCell.cpp`)
- Profile badges → Account and upload: checks badge role (evidence: `src/hooks/ProfilePage.cpp`)
- Account linking → Account and upload: links account (evidence: `src/setting/LinkAccount.cpp`)
- Account linking → Confirmation dialogs: confirms action (evidence: `src/setting/LinkAccount.cpp`)
- Thumbnail actions → Thumbnail service: manages thumbnails (evidence: `src/setting/ModActions.cpp`)
- Thumbnail service → Image caches: reads and writes (evidence: `src/managers/ThumbnailManager.cpp`)
- Thumbnail service → Thumbnail API: downloads image (evidence: `src/managers/ThumbnailManager.cpp`)
- Account and upload → Thumbnail API: authenticates and uploads (evidence: `src/managers/AuthManager.cpp`)
- Pause hooks → Thumbnail API: checks pending count (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Compatibility helpers: checks integration (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Node compatibility: uses compatibility (evidence: `src/hooks/PauseLayer.cpp`)
- Pause hooks → Node visibility: uses visibility helper (evidence: `src/hooks/PauseLayer.cpp`)
