# monstersghost/penumbraorganizerplugin architecture

> Architecture diagram of the GitHub repository monstersghost/penumbraorganizerplugin, 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/monstersghost/penumbraorganizerplugin
- Repository: https://github.com/monstersghost/penumbraorganizerplugin

## Overview

Penumbra Organizer is an in-game Dalamud plugin for organizing installed Penumbra mods. Players scan and search their library, configure sorting or protection, review proposed changes, then apply them through Penumbra; they can also restore snapshots, manage templates, exchange workbooks, and clean up folders. The graph preserves these documented capabilities and sampled internal stages. Several subsystems are represented from the README and file tree rather than inspected implementation; those relationships are documented or left unconnected where call ownership is unknown.

Main entry points: [`PenumbraOrganizer.Plugin/Windows/MainWindow.cs`](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Windows/MainWindow.cs) (Organizer window), [`PenumbraOrganizer.Plugin/Plugin.cs`](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Plugin.cs) (Plugin runtime), [`PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs`](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs) (Operation controller), [`PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs`](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs) (NPC name refresh)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Plugin interface"]
  node_plugin["Plugin runtime<br/>[Plugin.cs]"]
  node_window["Organizer window<br/>[MainWindow.cs]"]
end

subgraph group_library["Library intelligence"]
  node_work["Library work"]
  node_scan["Library scan<br/>[ScanProcessor.cs]"]
  node_index["Changed-item index"]
  node_search["Library search"]
  node_classification["Mod classification<br/>[Classification]"]
  node_npcnames["NPC name refresh"]
  node_npcstore[("NPC name store")]
end

subgraph group_organize["Organization tools"]
  node_state["Organizer state<br/>[OrganizerState.cs]"]
  node_sort["Sort layouts<br/>[ApplyPlanner.cs]"]
  node_protection["Folder protection<br/>[ProtectionRule.cs]"]
  node_newmods["New-mod sorting"]
  node_workbook["Workbook exchange<br/>[WorkbookAdapter.cs]"]
  node_templates["Layout templates<br/>[TemplatePlanner.cs]"]
end

subgraph group_safety["Operations and recovery"]
  node_ops["Operation controller"]
  node_journal[("Operation journal")]
  node_bundles[("Operation bundles")]
end

node_player(("Player"))
node_wiki["Game wiki"]
node_penumbra["Penumbra"]

node_player -->|"uses"| node_window
node_window -->|"requests actions"| node_plugin
node_plugin -->|"creates"| node_window
node_plugin -->|"uses"| node_ops
node_plugin -->|"uses"| node_state
node_plugin -->|"uses"| node_work
node_plugin -->|"uses"| node_index
node_plugin -->|"uses"| node_npcnames
node_plugin -->|"uses"| node_newmods
node_work -->|"runs"| node_scan
node_window -->|"filters results"| node_search
node_npcnames -->|"scrapes categories"| node_wiki
node_npcnames -->|"loads and saves"| node_npcstore
node_ops -->|"resolves paths"| node_bundles
node_ops -->|"records operations"| node_journal
node_plugin -->|"communicates via IPC"| node_penumbra
node_window -->|"reviews sort changes"| node_sort
node_window -->|"configures protection"| node_protection
node_window -->|"imports and exports"| node_workbook
node_window -->|"shares layouts"| node_templates
node_window -->|"starts apply and restore"| node_ops
node_ops -->|"applies changes"| node_penumbra
node_player -->|"searches library"| node_search
node_window -->|"offers sorting"| node_newmods

click node_plugin "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Plugin.cs"
click node_window "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Windows/MainWindow.cs"
click node_state "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/OrganizerState.cs"
click node_work "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibraryWork/LibraryWorkCoordinator.cs"
click node_scan "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibraryWork/Pure/ScanProcessor.cs"
click node_index "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibrarySearch/ChangedItemIndexBuilder.cs"
click node_search "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibrarySearch/LibrarySearchFilter.cs"
click node_classification "https://github.com/monstersghost/penumbraorganizerplugin/tree/main/PenumbraOrganizer.Plugin/Organizer/Classification"
click node_sort "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/ApplyPlanner.cs"
click node_protection "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/ProtectionRule.cs"
click node_newmods "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NewMods/NewModSortPipeline.cs"
click node_workbook "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/WorkbookAdapter.cs"
click node_templates "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Templates/TemplatePlanner.cs"
click node_npcnames "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs"
click node_npcstore "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameListStore.cs"
click node_ops "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs"
click node_journal "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationJournal.cs"
click node_bundles "https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationBundlePaths.cs"

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_plugin,node_window toneBlue
class node_work,node_scan,node_index,node_search,node_classification,node_npcnames,node_npcstore toneAmber
class node_state,node_sort,node_protection,node_newmods,node_workbook,node_templates toneMint
class node_ops,node_journal,node_bundles toneRose
class node_player,node_wiki,node_penumbra toneIndigo
```

## Components

### Plugin interface

- [Plugin runtime](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Plugin.cs): `PenumbraOrganizer.Plugin/Plugin.cs`
- [Organizer window](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Windows/MainWindow.cs): `PenumbraOrganizer.Plugin/Windows/MainWindow.cs`

### Library intelligence

- [Library work](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibraryWork/LibraryWorkCoordinator.cs): `PenumbraOrganizer.Plugin/LibraryWork/LibraryWorkCoordinator.cs`
- [Library scan](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibraryWork/Pure/ScanProcessor.cs): `PenumbraOrganizer.Plugin/LibraryWork/Pure/ScanProcessor.cs`
- [Changed-item index](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibrarySearch/ChangedItemIndexBuilder.cs): `PenumbraOrganizer.Plugin/LibrarySearch/ChangedItemIndexBuilder.cs`
- [Library search](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/LibrarySearch/LibrarySearchFilter.cs): `PenumbraOrganizer.Plugin/LibrarySearch/LibrarySearchFilter.cs`
- [Mod classification](https://github.com/monstersghost/penumbraorganizerplugin/tree/main/PenumbraOrganizer.Plugin/Organizer/Classification): `PenumbraOrganizer.Plugin/Organizer/Classification`
- [NPC name refresh](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs): `PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs`
- [NPC name store](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameListStore.cs): `PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameListStore.cs`

### Organization tools

- [Organizer state](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/OrganizerState.cs): `PenumbraOrganizer.Plugin/Organizer/OrganizerState.cs`
- [Sort layouts](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/ApplyPlanner.cs): `PenumbraOrganizer.Plugin/Organizer/ApplyPlanner.cs`
- [Folder protection](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/ProtectionRule.cs): `PenumbraOrganizer.Plugin/Organizer/ProtectionRule.cs`
- [New-mod sorting](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/NewMods/NewModSortPipeline.cs): `PenumbraOrganizer.Plugin/Organizer/NewMods/NewModSortPipeline.cs`
- [Workbook exchange](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/WorkbookAdapter.cs): `PenumbraOrganizer.Plugin/Organizer/WorkbookAdapter.cs`
- [Layout templates](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Templates/TemplatePlanner.cs): `PenumbraOrganizer.Plugin/Organizer/Templates/TemplatePlanner.cs`

### Operations and recovery

- [Operation controller](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs): `PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs`
- [Operation journal](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationJournal.cs): `PenumbraOrganizer.Plugin/Organizer/Operations/OperationJournal.cs`
- [Operation bundles](https://github.com/monstersghost/penumbraorganizerplugin/blob/main/PenumbraOrganizer.Plugin/Organizer/Operations/OperationBundlePaths.cs): `PenumbraOrganizer.Plugin/Organizer/Operations/OperationBundlePaths.cs`

### Other components

- **Player**
- **Game wiki**
- **Penumbra**

## Connections

- Player → Organizer window: uses (evidence: `README.md`)
- Organizer window → Plugin runtime: requests actions (evidence: `PenumbraOrganizer.Plugin/Windows/MainWindow.cs`)
- Plugin runtime → Organizer window: creates (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → Operation controller: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → Organizer state: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → Library work: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → Changed-item index: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → NPC name refresh: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Plugin runtime → New-mod sorting: uses (evidence: `PenumbraOrganizer.Plugin/Plugin.cs`)
- Library work → Library scan: runs (evidence: `PenumbraOrganizer.Plugin/LibraryWork/LibraryWorkCoordinator.cs`)
- Organizer window → Library search: filters results (evidence: `PenumbraOrganizer.Plugin/Windows/MainWindow.SearchTab.cs`)
- NPC name refresh → Game wiki: scrapes categories (evidence: `PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs`)
- NPC name refresh → NPC name store: loads and saves (evidence: `PenumbraOrganizer.Plugin/Organizer/NpcNames/NpcNameRefreshService.cs`)
- Operation controller → Operation bundles: resolves paths (evidence: `PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs`)
- Operation controller → Operation journal: records operations (evidence: `PenumbraOrganizer.Plugin/Organizer/Operations/OperationController.cs`)
- Plugin runtime → Penumbra: communicates via IPC (evidence: `README.md`)
- Organizer window → Sort layouts: reviews sort changes (evidence: `README.md`)
- Organizer window → Folder protection: configures protection (evidence: `README.md`)
- Organizer window → Workbook exchange: imports and exports (evidence: `README.md`)
- Organizer window → Layout templates: shares layouts (evidence: `README.md`)
- Organizer window → Operation controller: starts apply and restore (evidence: `README.md`)
- Operation controller → Penumbra: applies changes (evidence: `README.md`)
- Player → Library search: searches library (evidence: `README.md`)
- Organizer window → New-mod sorting: offers sorting (evidence: `PenumbraOrganizer.Plugin/Organizer/NewMods/NewModSortPipeline.cs`)
