# wirmaple73/pzsavemanager architecture

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

- Interactive diagram: https://gitdiagram.com/wirmaple73/pzsavemanager
- Repository: https://github.com/wirmaple73/pzsavemanager

## Overview

Project Zomboid Save Manager is a Windows desktop tool for discovering game worlds and creating, organizing, and restoring their backups. The main UI selects a world or save, then delegates save and restore work to the domain and archive classes; options configure backup behavior, including compression and automatic saves. The README also documents in-game hotkey saves and live previews. Source excerpts show archive and world behavior, but not all scheduling, hotkey, or preview wiring, so those relationships are left unverified where necessary.

Main entry points: [`PZSaveManager/Classes/World.cs`](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/World.cs) (World Discovery), [`PZSaveManager/Classes/Save.cs`](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/Save.cs) (Save Archives), [`PZSaveManager/Forms/MainForm.cs`](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/MainForm.cs) (Main Window), [`PZSaveManager/Classes/SaveHelper.cs`](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/SaveHelper.cs) (Save Scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_worldpage["World Selection"]
  node_savepage["Save Selection"]
  node_main["Main Window<br/>[MainForm.cs]"]
  node_options["Save Options<br/>[SaveOptionsForm.cs]"]
  node_progress["Save and Restore Progress"]
  node_restoreprogress["Restoration Progress"]
  node_logform["Log Viewer<br/>[LogForm.cs]"]
end

subgraph group_domain["Worlds and Saves"]
  node_world["World Discovery<br/>[World.cs]"]
  node_save["Save Archives<br/>[Save.cs]"]
  node_backupstore[("Backup Files")]
  node_gamesaves[("Game World Files")]
end

subgraph group_runtime["Save Runtime"]
  node_savehelper["Save Scheduling<br/>[SaveHelper.cs]"]
  node_settings[("User Settings<br/>[Settings.cs]")]
end

subgraph group_support["App Support"]
  node_logger["Logging<br/>[Logger.cs]"]
  node_sound["Save Sounds<br/>[SoundPlayer.cs]"]
  node_version["Update Check<br/>[VersionManager.cs]"]
end

node_user(("User"))
node_game["Project Zomboid"]
node_releasefeed["Version Feed"]

node_user -->|"uses"| node_main
node_main -->|"loads page"| node_worldpage
node_main -->|"loads page"| node_savepage
node_main -->|"opens options"| node_options
node_main -->|"updates timer"| node_savehelper
node_main -->|"checks updates"| node_version
node_main -->|"opens logs"| node_logform
node_worldpage -->|"selects worlds"| node_world
node_savepage -->|"loads saves"| node_world
node_savepage -->|"manages saves"| node_save
node_savepage -->|"opens save progress"| node_progress
node_savepage -->|"opens restore progress"| node_restoreprogress
node_world -->|"scans folders"| node_gamesaves
node_world -->|"loads save metadata"| node_save
node_world -->|"enumerates backups"| node_backupstore
node_save -->|"reads and restores"| node_gamesaves
node_save -->|"writes archives"| node_backupstore
node_savehelper -->|"exports saves"| node_save
node_savehelper -->|"checks worlds"| node_world
node_savehelper -->|"reads options"| node_settings
node_options -->|"configures"| node_settings
node_progress -->|"tracks archive work"| node_save
node_restoreprogress -->|"tracks restoration"| node_save
node_save -->|"logs operations"| node_logger
node_world -->|"logs discovery"| node_logger
node_logger -->|"publishes log events"| node_logform
node_savehelper -->|"plays save effects"| node_sound
node_world -->|"plays save effects"| node_sound
node_version -->|"fetches version data"| node_releasefeed
node_game -.->|"triggers hotkey saves"| node_savehelper
node_savehelper -.->|"periodically saves"| node_world
node_save -.->|"stores live previews"| node_backupstore

click node_worldpage "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Pages/WorldSelectionPage.cs"
click node_savepage "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Pages/SaveSelectionPage.cs"
click node_main "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/MainForm.cs"
click node_options "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/SaveOptionsForm.cs"
click node_progress "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/SavingProgressForm.cs"
click node_restoreprogress "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/RestorationProgressForm.cs"
click node_world "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/World.cs"
click node_save "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/Save.cs"
click node_savehelper "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/SaveHelper.cs"
click node_settings "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Settings.cs"
click node_logger "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/Logger.cs"
click node_logform "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/LogForm.cs"
click node_sound "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/SoundPlayer.cs"
click node_version "https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/VersionManager.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_worldpage,node_savepage,node_main,node_options,node_progress,node_restoreprogress,node_logform,node_user toneBlue
class node_world,node_save,node_backupstore,node_gamesaves toneAmber
class node_savehelper,node_settings toneMint
class node_logger,node_sound,node_version toneRose
class node_game,node_releasefeed toneIndigo
```

## Components

### Desktop UI

- [World Selection](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Pages/WorldSelectionPage.cs): `PZSaveManager/Pages/WorldSelectionPage.cs`
- [Save Selection](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Pages/SaveSelectionPage.cs): `PZSaveManager/Pages/SaveSelectionPage.cs`
- [Main Window](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/MainForm.cs): `PZSaveManager/Forms/MainForm.cs`
- [Save Options](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/SaveOptionsForm.cs): `PZSaveManager/Forms/SaveOptionsForm.cs`
- [Save and Restore Progress](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/SavingProgressForm.cs): `PZSaveManager/Forms/SavingProgressForm.cs`
- [Restoration Progress](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/RestorationProgressForm.cs): `PZSaveManager/Forms/RestorationProgressForm.cs`
- [Log Viewer](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Forms/LogForm.cs): `PZSaveManager/Forms/LogForm.cs`

### Worlds and Saves

- [World Discovery](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/World.cs): `PZSaveManager/Classes/World.cs`
- [Save Archives](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/Save.cs): `PZSaveManager/Classes/Save.cs`
- **Backup Files**
- **Game World Files**

### Save Runtime

- [Save Scheduling](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/SaveHelper.cs): `PZSaveManager/Classes/SaveHelper.cs`
- [User Settings](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Settings.cs): `PZSaveManager/Settings.cs`

### App Support

- [Logging](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/Logger.cs): `PZSaveManager/Classes/Logger.cs`
- [Save Sounds](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/SoundPlayer.cs): `PZSaveManager/Classes/SoundPlayer.cs`
- [Update Check](https://github.com/wirmaple73/pzsavemanager/blob/master/PZSaveManager/Classes/VersionManager.cs): `PZSaveManager/Classes/VersionManager.cs`

### Other components

- **User**
- **Project Zomboid**
- **Version Feed**

## Connections

- User → Main Window: uses (evidence: `README.md`)
- Main Window → World Selection: loads page (evidence: `PZSaveManager/Forms/MainForm.cs`)
- Main Window → Save Selection: loads page (evidence: `PZSaveManager/Forms/MainForm.cs`)
- Main Window → Save Options: opens options (evidence: `PZSaveManager/Forms/MainForm.cs`)
- Main Window → Save Scheduling: updates timer (evidence: `PZSaveManager/Forms/MainForm.cs`)
- Main Window → Update Check: checks updates (evidence: `PZSaveManager/Forms/MainForm.cs`)
- Main Window → Log Viewer: opens logs (evidence: `PZSaveManager/Forms/MainForm.cs`)
- World Selection → World Discovery: selects worlds (evidence: `PZSaveManager/Pages/WorldSelectionPage.cs`)
- Save Selection → World Discovery: loads saves (evidence: `PZSaveManager/Pages/SaveSelectionPage.cs`)
- Save Selection → Save Archives: manages saves (evidence: `PZSaveManager/Pages/SaveSelectionPage.cs`)
- Save Selection → Save and Restore Progress: opens save progress (evidence: `PZSaveManager/Pages/SaveSelectionPage.cs`)
- Save Selection → Restoration Progress: opens restore progress (evidence: `PZSaveManager/Pages/SaveSelectionPage.cs`)
- World Discovery → Game World Files: scans folders (evidence: `PZSaveManager/Classes/World.cs`)
- World Discovery → Save Archives: loads save metadata (evidence: `PZSaveManager/Classes/World.cs`)
- World Discovery → Backup Files: enumerates backups (evidence: `PZSaveManager/Classes/World.cs`)
- Save Archives → Game World Files: reads and restores (evidence: `PZSaveManager/Classes/Save.cs`)
- Save Archives → Backup Files: writes archives (evidence: `PZSaveManager/Classes/Save.cs`)
- Save Scheduling → Save Archives: exports saves (evidence: `PZSaveManager/Classes/SaveHelper.cs`)
- Save Scheduling → World Discovery: checks worlds (evidence: `PZSaveManager/Classes/SaveHelper.cs`)
- Save Scheduling → User Settings: reads options (evidence: `PZSaveManager/Classes/SaveHelper.cs`)
- Save Options → User Settings: configures (evidence: `PZSaveManager/Forms/SaveOptionsForm.cs`)
- Save and Restore Progress → Save Archives: tracks archive work (evidence: `PZSaveManager/Forms/SavingProgressForm.cs`)
- Restoration Progress → Save Archives: tracks restoration (evidence: `PZSaveManager/Forms/RestorationProgressForm.cs`)
- Save Archives → Logging: logs operations (evidence: `PZSaveManager/Classes/Save.cs`)
- World Discovery → Logging: logs discovery (evidence: `PZSaveManager/Classes/World.cs`)
- Logging → Log Viewer: publishes log events (evidence: `PZSaveManager/Forms/LogForm.cs`)
- Save Scheduling → Save Sounds: plays save effects (evidence: `PZSaveManager/Classes/SaveHelper.cs`)
- World Discovery → Save Sounds: plays save effects (evidence: `PZSaveManager/Classes/World.cs`)
- Update Check → Version Feed: fetches version data (evidence: `PZSaveManager/Classes/VersionManager.cs`)
- Project Zomboid → Save Scheduling: triggers hotkey saves (evidence: `README.md`)
- Save Scheduling → World Discovery: periodically saves (evidence: `README.md`)
- Save Archives → Backup Files: stores live previews (evidence: `README.md`)
