# f0wler/collodion-vs architecture

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

- Interactive diagram: https://gitdiagram.com/f0wler/collodion-vs
- Repository: https://github.com/f0wler/collodion-vs

## Overview

Collodion is a Vintage Story wet-plate photography mod. Its central workflow is operating a field camera, accumulating an exposure, and progressing photographic plates through sensitization and development; the repository also provides image effects, photo synchronization, metadata auditing, configuration, and admin tooling. The graph reflects documented calls and SOURCE INDEX references. Several product areas are represented by their exact source directories because their implementation was not sampled; their internal relationships are therefore omitted where evidence is unavailable.

Main entry points: [`Core/src/ModSystem/ModSystem.Client.cs`](https://github.com/f0wler/collodion-vs/blob/main/Core/src/ModSystem/ModSystem.Client.cs) (Mod startup), [`Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs`](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs) (Preview renderer), [`Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs`](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs) (Capture bridge), [`Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs`](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs) (Exposure renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Camera capture"]
  node_fieldcamera["Field camera<br/>[ItemFieldcamera.cs]"]
  node_capture_runtime["Capture runtime"]
  node_field_bridge["Field camera bridge"]
  node_capture_bridge["Capture bridge"]
  node_exposure_renderer["Exposure renderer"]
  node_preview_renderer["Preview renderer"]
  node_gpu_accumulator["GPU accumulator"]
  node_exposure_store[("Exposure store")]
end

subgraph group_chemistry["Plate chemistry"]
  node_plates["Plate lifecycle<br/>[PlateAttributes.cs]"]
  node_tray["Development tray"]
  node_sensitization["Plate sensitization"]
  node_chemistry_profiles[("Chemistry profiles")]
end

subgraph group_photos["Photo assets"]
  node_photo_sync["Photo synchronization"]
  node_photo_paths[("Photo asset storage")]
  node_photo_store[("Photo stores")]
  node_photo_audit["Photo audit"]
  node_seen_service["Seen tracking"]
end

subgraph group_operations["Configuration and admin"]
  node_config_lifecycle["Config lifecycle<br/>[ConfigLifecycle.cs]"]
  node_config_model["Photocore config<br/>[PhotocoreConfig.cs]"]
  node_external_config["Config integrations"]
  node_admin_tooling["Admin tooling"]
  node_mod_system["Mod startup"]
end

subgraph group_effects["Image effects"]
  node_effects_pipeline["Effects pipeline"]
  node_effects_stages["Effect stages"]
end

node_player(("Player"))

node_player -.->|"uses"| node_fieldcamera
node_capture_runtime -->|"sends state"| node_field_bridge
node_capture_bridge -->|"creates"| node_exposure_renderer
node_capture_bridge -->|"creates"| node_preview_renderer
node_preview_renderer -->|"reads state"| node_exposure_renderer
node_preview_renderer -->|"accumulates preview"| node_gpu_accumulator
node_exposure_renderer -->|"loads profiles"| node_chemistry_profiles
node_capture_runtime -->|"saves exposure"| node_exposure_store
node_field_bridge -->|"checks plate state"| node_plates
node_effects_pipeline -->|"applies halation"| node_effects_stages
node_photo_sync -->|"resolves assets"| node_photo_paths
node_photo_sync -.->|"uses stores"| node_photo_store
node_photo_audit -->|"checks seen state"| node_seen_service
node_photo_audit -->|"resolves files"| node_photo_paths
node_seen_service -->|"uses asset paths"| node_photo_paths
node_config_lifecycle -->|"loads config"| node_config_model
node_external_config -->|"integrates config"| node_config_model
node_mod_system -->|"loads config"| node_config_lifecycle
node_mod_system -->|"registers integration"| node_external_config
node_mod_system -->|"starts capture"| node_capture_bridge
node_mod_system -->|"starts tooling"| node_admin_tooling

click node_fieldcamera "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Item/ItemFieldcamera.cs"
click node_capture_runtime "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Runtime/FieldCameraClientRuntime.Capture.cs"
click node_field_bridge "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Bridge/FieldCameraModSystemBridge.Client.CaptureGate.cs"
click node_capture_bridge "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs"
click node_exposure_renderer "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs"
click node_preview_renderer "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs"
click node_gpu_accumulator "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Accumulation/GpuExposureAccumulator.cs"
click node_exposure_store "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Accumulation/ExposureAccumulationStore.cs"
click node_plates "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Plates/PlateAttributes.cs"
click node_tray "https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/Tray"
click node_sensitization "https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/Plates/Sensitization"
click node_chemistry_profiles "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Chemistry/ChemistryProfileRegistry.cs"
click node_effects_pipeline "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/ImageEffects/EffectsPipeline.Pipeline.cs"
click node_effects_stages "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/ImageEffects/Stages/EffectsPipeline.Halation.cs"
click node_photo_sync "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoSync/Runtime/PhotoAssetSync.Client.cs"
click node_photo_paths "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoSync/PhotoAssetStoragePaths.cs"
click node_photo_store "https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/PhotoSync/Store"
click node_photo_audit "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoMetadata/PhotoDiskAuditService.cs"
click node_seen_service "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoMetadata/ServerPhotoSeenService.cs"
click node_config_lifecycle "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/ConfigLifecycle.cs"
click node_config_model "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/PhotocoreConfig.cs"
click node_external_config "https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/ExternalConfigIntegration.cs"
click node_admin_tooling "https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/AdminTooling"
click node_mod_system "https://github.com/f0wler/collodion-vs/blob/main/Core/src/ModSystem/ModSystem.Client.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_fieldcamera,node_capture_runtime,node_field_bridge,node_capture_bridge,node_exposure_renderer,node_preview_renderer,node_gpu_accumulator,node_exposure_store toneBlue
class node_plates,node_tray,node_sensitization,node_chemistry_profiles toneAmber
class node_photo_sync,node_photo_paths,node_photo_store,node_photo_audit,node_seen_service toneMint
class node_config_lifecycle,node_config_model,node_external_config,node_admin_tooling,node_mod_system toneRose
class node_effects_pipeline,node_effects_stages,node_player toneIndigo
```

## Components

### Camera capture

- [Field camera](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Item/ItemFieldcamera.cs): `Core/src/Features/FieldCamera/Item/ItemFieldcamera.cs`
- [Capture runtime](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Runtime/FieldCameraClientRuntime.Capture.cs): `Core/src/Features/FieldCamera/Runtime/FieldCameraClientRuntime.Capture.cs`
- [Field camera bridge](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/FieldCamera/Bridge/FieldCameraModSystemBridge.Client.CaptureGate.cs): `Core/src/Features/FieldCamera/Bridge/FieldCameraModSystemBridge.Client.CaptureGate.cs`
- [Capture bridge](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs): `Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs`
- [Exposure renderer](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs): `Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs`
- [Preview renderer](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs): `Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs`
- [GPU accumulator](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Accumulation/GpuExposureAccumulator.cs): `Core/src/Features/Exposure/Accumulation/GpuExposureAccumulator.cs`
- [Exposure store](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Accumulation/ExposureAccumulationStore.cs): `Core/src/Features/Exposure/Accumulation/ExposureAccumulationStore.cs`

### Plate chemistry

- [Plate lifecycle](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Plates/PlateAttributes.cs): `Core/src/Features/Plates/PlateAttributes.cs`
- [Development tray](https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/Tray): `Core/src/Features/Tray`
- [Plate sensitization](https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/Plates/Sensitization): `Core/src/Features/Plates/Sensitization`
- [Chemistry profiles](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Exposure/Chemistry/ChemistryProfileRegistry.cs): `Core/src/Features/Exposure/Chemistry/ChemistryProfileRegistry.cs`

### Photo assets

- [Photo synchronization](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoSync/Runtime/PhotoAssetSync.Client.cs): `Core/src/Features/PhotoSync/Runtime/PhotoAssetSync.Client.cs`
- [Photo asset storage](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoSync/PhotoAssetStoragePaths.cs): `Core/src/Features/PhotoSync/PhotoAssetStoragePaths.cs`
- [Photo stores](https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/PhotoSync/Store): `Core/src/Features/PhotoSync/Store`
- [Photo audit](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoMetadata/PhotoDiskAuditService.cs): `Core/src/Features/PhotoMetadata/PhotoDiskAuditService.cs`
- [Seen tracking](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/PhotoMetadata/ServerPhotoSeenService.cs): `Core/src/Features/PhotoMetadata/ServerPhotoSeenService.cs`

### Configuration and admin

- [Config lifecycle](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/ConfigLifecycle.cs): `Core/src/Features/Configuration/ConfigLifecycle.cs`
- [Photocore config](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/PhotocoreConfig.cs): `Core/src/Features/Configuration/PhotocoreConfig.cs`
- [Config integrations](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/Configuration/ExternalConfigIntegration.cs): `Core/src/Features/Configuration/ExternalConfigIntegration.cs`
- [Admin tooling](https://github.com/f0wler/collodion-vs/tree/main/Core/src/Features/AdminTooling): `Core/src/Features/AdminTooling`
- [Mod startup](https://github.com/f0wler/collodion-vs/blob/main/Core/src/ModSystem/ModSystem.Client.cs): `Core/src/ModSystem/ModSystem.Client.cs`

### Image effects

- [Effects pipeline](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/ImageEffects/EffectsPipeline.Pipeline.cs): `Core/src/Features/ImageEffects/EffectsPipeline.Pipeline.cs`
- [Effect stages](https://github.com/f0wler/collodion-vs/blob/main/Core/src/Features/ImageEffects/Stages/EffectsPipeline.Halation.cs): `Core/src/Features/ImageEffects/Stages/EffectsPipeline.Halation.cs`

### Other components

- **Player**

## Connections

- Player → Field camera: uses
- Capture runtime → Field camera bridge: sends state (evidence: `Core/src/Features/FieldCamera/Runtime/FieldCameraClientRuntime.Capture.cs`)
- Capture bridge → Exposure renderer: creates (evidence: `Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs`)
- Capture bridge → Preview renderer: creates (evidence: `Core/src/Features/CameraCapture/Bridge/CameraCaptureModSystemBridge.Client.cs`)
- Preview renderer → Exposure renderer: reads state (evidence: `Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs`)
- Preview renderer → GPU accumulator: accumulates preview (evidence: `Core/src/Features/CameraCapture/Capture/Pipeline/VirtualCameraPreviewRenderer.cs`)
- Exposure renderer → Chemistry profiles: loads profiles (evidence: `Core/src/Features/CameraCapture/Capture/Pipeline/VirtualExposureRenderer.cs`)
- Capture runtime → Exposure store: saves exposure (evidence: `Core/src/Features/FieldCamera/Runtime/FieldCameraClientRuntime.Capture.cs`)
- Field camera bridge → Plate lifecycle: checks plate state (evidence: `Core/src/Features/FieldCamera/Bridge/FieldCameraModSystemBridge.Client.CaptureGate.cs`)
- Effects pipeline → Effect stages: applies halation (evidence: `Core/src/Features/ImageEffects/EffectsPipeline.Pipeline.cs`)
- Photo synchronization → Photo asset storage: resolves assets (evidence: `Core/src/Features/PhotoSync/Runtime/PhotoAssetSync.Client.cs`)
- Photo synchronization → Photo stores: uses stores
- Photo audit → Seen tracking: checks seen state (evidence: `Core/src/Features/PhotoMetadata/PhotoDiskAuditService.cs`)
- Photo audit → Photo asset storage: resolves files (evidence: `Core/src/Features/PhotoMetadata/PhotoDiskAuditService.cs`)
- Seen tracking → Photo asset storage: uses asset paths (evidence: `Core/src/Features/PhotoMetadata/ServerPhotoSeenService.cs`)
- Config lifecycle → Photocore config: loads config (evidence: `Core/src/Features/Configuration/ConfigLifecycle.cs`)
- Config integrations → Photocore config: integrates config (evidence: `Core/src/Features/Configuration/ExternalConfigIntegration.cs`)
- Mod startup → Config lifecycle: loads config (evidence: `Core/src/ModSystem/ModSystem.Client.cs`)
- Mod startup → Config integrations: registers integration (evidence: `Core/src/ModSystem/ModSystem.Client.cs`)
- Mod startup → Capture bridge: starts capture (evidence: `Core/src/ModSystem/ModSystem.Client.cs`)
- Mod startup → Admin tooling: starts tooling (evidence: `Core/src/ModSystem/ModSystem.Client.cs`)
