# n3rdmade/pelican-modpackmanager architecture

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

- Interactive diagram: https://gitdiagram.com/n3rdmade/pelican-modpackmanager
- Repository: https://github.com/n3rdmade/pelican-modpackmanager

## Overview

Pelican Modpack Manager adds modpack and individual-mod browsing to the server panel. Users filter provider catalogs, inspect project/version details, then confirm an install; a queued job drives loader/server preparation and pack installation while recording progress. Separate update checking compares installed versions and can notify owners. The README documents backup, cleanup, preservation, world handling, and artwork capabilities, but the sampled installer excerpt does not show all their call paths; those are represented within its installation subsystem rather than as guessed stages.

Main entry points: [`src/Filament/Server/Pages/ModpackBrowserPage.php`](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModpackBrowserPage.php) (Modpack browser), [`src/Services/UpdateCheckService.php`](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/UpdateCheckService.php) (Update checker), [`src/Filament/Server/Pages/ModBrowserPage.php`](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModBrowserPage.php) (Mod browser), [`src/Services/CurseForgeService.php`](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/CurseForgeService.php) (CurseForge adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Panel experience"]
  node_modpack_browser["Modpack browser"]
  node_mod_browser["Mod browser<br/>[ModBrowserPage.php]"]
  node_modpack_view["Modpack interface"]
  node_mod_view["Mod interface"]
end

subgraph group_catalogs["Provider catalogs"]
  node_curseforge["CurseForge adapter"]
  node_modrinth["Modrinth adapter"]
  node_ftb["FTB adapter<br/>[FtbService.php]"]
  node_atlauncher["ATLauncher adapter"]
end

subgraph group_installation["Installation lifecycle"]
  node_install_job["Queued install job"]
  node_install_service["Pack installer"]
  node_install_record["Install progress record<br/>[ModpackInstall.php]"]
  node_install_store[("Install database")]
end

subgraph group_updates["Update tracking"]
  node_update_command["Update check command"]
  node_update_service["Update checker"]
end

node_server_user(("Server user"))
node_curseforge_api{{"CurseForge API"}}
node_modrinth_api{{"Modrinth API"}}
node_ftb_api{{"FTB API"}}
node_atlauncher_api{{"ATLauncher API"}}
node_pelican{{"Pelican server panel"}}

node_server_user -->|"browses packs"| node_modpack_browser
node_server_user -->|"browses mods"| node_mod_browser
node_modpack_browser -->|"renders"| node_modpack_view
node_mod_browser -->|"renders"| node_mod_view
node_modpack_browser -->|"queries"| node_curseforge
node_modpack_browser -->|"queries"| node_modrinth
node_modpack_browser -->|"queries"| node_ftb
node_modpack_browser -->|"queries"| node_atlauncher
node_mod_browser -->|"queries"| node_curseforge
node_mod_browser -->|"queries"| node_modrinth
node_curseforge -->|"requests catalog"| node_curseforge_api
node_modrinth -->|"requests catalog"| node_modrinth_api
node_ftb -->|"requests catalog"| node_ftb_api
node_atlauncher -->|"requests catalog"| node_atlauncher_api
node_modpack_browser -->|"dispatches install"| node_install_job
node_install_job -->|"loads and updates"| node_install_record
node_install_job -->|"runs install"| node_install_service
node_install_service -->|"records progress"| node_install_record
node_install_record -->|"persists records"| node_install_store
node_update_command -->|"checks versions"| node_update_service
node_update_service -->|"reads and updates"| node_install_record
node_update_service -->|"checks provider"| node_curseforge
node_update_service -->|"checks provider"| node_modrinth
node_update_service -->|"checks provider"| node_ftb
node_update_service -->|"checks provider"| node_atlauncher
node_install_service -.->|"configures server"| node_pelican

click node_modpack_browser "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModpackBrowserPage.php"
click node_mod_browser "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModBrowserPage.php"
click node_modpack_view "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/resources/views/filament/server/pages/modpack-browser-page.blade.php"
click node_mod_view "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/resources/views/filament/server/pages/mod-browser-page.blade.php"
click node_curseforge "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/CurseForgeService.php"
click node_modrinth "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ModrinthService.php"
click node_ftb "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/FtbService.php"
click node_atlauncher "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ATLauncherService.php"
click node_install_job "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Jobs/InstallModpackJob.php"
click node_install_service "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ModpackInstallService.php"
click node_install_record "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Models/ModpackInstall.php"
click node_install_store "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/database/migrations/2024_01_01_000000_create_modpack_installs_table.php"
click node_update_command "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Console/Commands/CheckModpackUpdatesCommand.php"
click node_update_service "https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/UpdateCheckService.php"

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_modpack_browser,node_mod_browser,node_modpack_view,node_mod_view,node_server_user toneBlue
class node_curseforge,node_modrinth,node_ftb,node_atlauncher toneAmber
class node_install_job,node_install_service,node_install_record,node_install_store,node_curseforge_api,node_modrinth_api,node_ftb_api,node_atlauncher_api,node_pelican toneMint
class node_update_command,node_update_service toneRose
```

## Components

### Panel experience

- [Modpack browser](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModpackBrowserPage.php): `src/Filament/Server/Pages/ModpackBrowserPage.php`
- [Mod browser](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Filament/Server/Pages/ModBrowserPage.php): `src/Filament/Server/Pages/ModBrowserPage.php`
- [Modpack interface](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/resources/views/filament/server/pages/modpack-browser-page.blade.php): `resources/views/filament/server/pages/modpack-browser-page.blade.php`
- [Mod interface](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/resources/views/filament/server/pages/mod-browser-page.blade.php): `resources/views/filament/server/pages/mod-browser-page.blade.php`

### Provider catalogs

- [CurseForge adapter](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/CurseForgeService.php): `src/Services/CurseForgeService.php`
- [Modrinth adapter](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ModrinthService.php): `src/Services/ModrinthService.php`
- [FTB adapter](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/FtbService.php): `src/Services/FtbService.php`
- [ATLauncher adapter](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ATLauncherService.php): `src/Services/ATLauncherService.php`

### Installation lifecycle

- [Queued install job](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Jobs/InstallModpackJob.php): `src/Jobs/InstallModpackJob.php`
- [Pack installer](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/ModpackInstallService.php): `src/Services/ModpackInstallService.php`
- [Install progress record](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Models/ModpackInstall.php): `src/Models/ModpackInstall.php`
- [Install database](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/database/migrations/2024_01_01_000000_create_modpack_installs_table.php): `database/migrations/2024_01_01_000000_create_modpack_installs_table.php`

### Update tracking

- [Update check command](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Console/Commands/CheckModpackUpdatesCommand.php): `src/Console/Commands/CheckModpackUpdatesCommand.php`
- [Update checker](https://github.com/n3rdmade/pelican-modpackmanager/blob/main/src/Services/UpdateCheckService.php): `src/Services/UpdateCheckService.php`

### Other components

- **Server user**
- **CurseForge API**
- **Modrinth API**
- **FTB API**
- **ATLauncher API**
- **Pelican server panel**

## Connections

- Server user → Modpack browser: browses packs (evidence: `README.md`)
- Server user → Mod browser: browses mods (evidence: `README.md`)
- Modpack browser → Modpack interface: renders (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Mod browser → Mod interface: renders (evidence: `src/Filament/Server/Pages/ModBrowserPage.php`)
- Modpack browser → CurseForge adapter: queries (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Modpack browser → Modrinth adapter: queries (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Modpack browser → FTB adapter: queries (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Modpack browser → ATLauncher adapter: queries (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Mod browser → CurseForge adapter: queries (evidence: `src/Filament/Server/Pages/ModBrowserPage.php`)
- Mod browser → Modrinth adapter: queries (evidence: `src/Filament/Server/Pages/ModBrowserPage.php`)
- CurseForge adapter → CurseForge API: requests catalog (evidence: `src/Services/CurseForgeService.php`)
- Modrinth adapter → Modrinth API: requests catalog (evidence: `src/Services/ModrinthService.php`)
- FTB adapter → FTB API: requests catalog (evidence: `src/Services/FtbService.php`)
- ATLauncher adapter → ATLauncher API: requests catalog (evidence: `src/Services/ATLauncherService.php`)
- Modpack browser → Queued install job: dispatches install (evidence: `src/Filament/Server/Pages/ModpackBrowserPage.php`)
- Queued install job → Install progress record: loads and updates (evidence: `src/Jobs/InstallModpackJob.php`)
- Queued install job → Pack installer: runs install (evidence: `src/Jobs/InstallModpackJob.php`)
- Pack installer → Install progress record: records progress (evidence: `src/Services/ModpackInstallService.php`)
- Install progress record → Install database: persists records (evidence: `src/Models/ModpackInstall.php`)
- Update check command → Update checker: checks versions (evidence: `src/Console/Commands/CheckModpackUpdatesCommand.php`)
- Update checker → Install progress record: reads and updates (evidence: `src/Services/UpdateCheckService.php`)
- Update checker → CurseForge adapter: checks provider (evidence: `src/Services/UpdateCheckService.php`)
- Update checker → Modrinth adapter: checks provider (evidence: `src/Services/UpdateCheckService.php`)
- Update checker → FTB adapter: checks provider (evidence: `src/Services/UpdateCheckService.php`)
- Update checker → ATLauncher adapter: checks provider (evidence: `src/Services/UpdateCheckService.php`)
- Pack installer → Pelican server panel: configures server (evidence: `README.md`)
