# jpcodecraft/albiondataavalonia architecture

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

- Interactive diagram: https://gitdiagram.com/jpcodecraft/albiondataavalonia
- Repository: https://github.com/jpcodecraft/albiondataavalonia

## Overview

Albion Free Market Data Client is a desktop companion that passively captures Albion Online network traffic, interprets game events into trackers and market records, and uploads permitted data to Albion Online Data Project (AODP). Its core workflow runs from packet capture and event dispatch through domain tracking and local persistence or upload, with the desktop UI exposing results and settings. README-documented farming/specs capture and auto-update capabilities are retained as branches, though their detailed runtime wiring is not shown in the sampled sources.

Main entry points: [`AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Services/NetworkListenerService.cs) (Network capture), [`AlbionDataAvalonia/App.axaml.cs`](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/App.axaml.cs) (Application startup), [`AlbionDataAvalonia/ViewModels/MainViewModel.cs`](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/ViewModels/MainViewModel.cs) (Desktop UI), [`AlbionDataAvalonia/Loot/LootTrackerService.cs`](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Loot/LootTrackerService.cs) (Loot tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and ingestion"]
  node_listener["Network capture"]
  node_dispatch["Game event handlers"]
  node_uploader["AODP upload<br/>[Uploader.cs]"]
end

subgraph group_tracking["Game data tracking"]
  node_combat["Combat tracker"]
  node_gathering["Gathering and fishing"]
  node_loot["Loot tracker"]
  node_party["Party tracker"]
  node_identity["Player identity"]
  node_legendary["Legendary items"]
  node_market["Market mail and trades<br/>[MailService.cs]"]
  node_farming["Farming tracker"]
  node_specs["Specs capture"]
  node_emv["Estimated market values"]
end

subgraph group_storage["Local data and settings"]
  node_gatheringdb["Gathering sessions"]
  node_database[("SQLite database<br/>[LocalContext.cs]")]
  node_settings["Settings manager<br/>[SettingsManager.cs]"]
  node_state["Player and upload state<br/>[PlayerState.cs]"]
end

subgraph group_client["Desktop experience"]
  node_app["Application startup<br/>[App.axaml.cs]"]
  node_ui["Desktop UI<br/>[MainViewModel.cs]"]
end

subgraph group_integrations["External services"]
  node_auth["Account authentication<br/>[AuthService.cs]"]
  node_aodp{{"AODP service"}}
  node_afm{{"AFM service"}}
  node_updates["Automatic updates<br/>[ClientUpdater.cs]"]
end

node_player(("Albion player"))

node_player -->|"plays while capturing"| node_listener
node_listener -->|"dispatches events"| node_dispatch
node_listener -->|"routes combat data"| node_combat
node_listener -->|"routes harvest data"| node_gathering
node_listener -->|"routes loot data"| node_loot
node_listener -->|"routes party data"| node_party
node_listener -->|"routes identity data"| node_identity
node_listener -->|"routes item data"| node_legendary
node_listener -->|"routes market data"| node_market
node_listener -->|"updates values"| node_emv
node_loot -->|"uses party context"| node_party
node_loot -->|"uses player identity"| node_identity
node_loot -->|"looks up values"| node_emv
node_combat -->|"uses party context"| node_party
node_gathering -->|"looks up values"| node_emv
node_gathering -->|"persists sessions"| node_gatheringdb
node_gatheringdb -->|"reads and writes"| node_database
node_market -->|"stores mail"| node_database
node_auth -->|"stores credentials"| node_database
node_auth -.->|"authenticates account"| node_afm
node_app -->|"starts capture"| node_listener
node_app -->|"creates view model"| node_ui
node_app -->|"loads settings"| node_settings
node_app -->|"initializes authentication"| node_auth
node_ui -.->|"presents tracker"| node_combat
node_ui -.->|"presents tracker"| node_gathering
node_ui -.->|"presents tracker"| node_loot
node_ui -.->|"presents market data"| node_market
node_uploader -.->|"uploads records"| node_aodp
node_dispatch -.->|"forwards captured data"| node_uploader
node_farming -.->|"records privately"| node_afm
node_specs -.->|"uploads specs"| node_afm
node_app -.->|"checks versions"| node_updates
node_settings -.->|"configures sharing"| node_state

click node_listener "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Services/NetworkListenerService.cs"
click node_dispatch "https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia/Network/Events/Handlers"
click node_uploader "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Uploader.cs"
click node_combat "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Combat/CombatTrackerService.cs"
click node_gathering "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Gathering/GatheringTrackerService.cs"
click node_loot "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Loot/LootTrackerService.cs"
click node_party "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Party/PartyTrackerService.cs"
click node_identity "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Players/PlayerIdentityService.cs"
click node_legendary "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Legendary/LegendaryItemTrackerService.cs"
click node_market "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Services/MailService.cs"
click node_farming "https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia"
click node_specs "https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia/Network"
click node_emv "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Items/Services/ItemEstimatedMarketValueService.cs"
click node_gatheringdb "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Gathering/GatheringSessionPersistenceService.cs"
click node_database "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/DB/LocalContext.cs"
click node_settings "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Settings/SettingsManager.cs"
click node_state "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/State/PlayerState.cs"
click node_app "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/App.axaml.cs"
click node_ui "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/ViewModels/MainViewModel.cs"
click node_auth "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Auth/Services/AuthService.cs"
click node_updates "https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/ClientUpdater.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_listener,node_dispatch,node_uploader toneBlue
class node_combat,node_gathering,node_loot,node_party,node_identity,node_legendary,node_market,node_farming,node_specs,node_emv toneAmber
class node_gatheringdb,node_database,node_settings,node_state toneMint
class node_app,node_ui toneRose
class node_auth,node_aodp,node_afm,node_updates,node_player toneIndigo
```

## Components

### Capture and ingestion

- [Network capture](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Services/NetworkListenerService.cs): `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`
- [Game event handlers](https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia/Network/Events/Handlers): `AlbionDataAvalonia/Network/Events/Handlers`
- [AODP upload](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Uploader.cs): `AlbionDataAvalonia/Network/Uploader.cs`

### Game data tracking

- [Combat tracker](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Combat/CombatTrackerService.cs): `AlbionDataAvalonia/Combat/CombatTrackerService.cs`
- [Gathering and fishing](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Gathering/GatheringTrackerService.cs): `AlbionDataAvalonia/Gathering/GatheringTrackerService.cs`
- [Loot tracker](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Loot/LootTrackerService.cs): `AlbionDataAvalonia/Loot/LootTrackerService.cs`
- [Party tracker](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Party/PartyTrackerService.cs): `AlbionDataAvalonia/Party/PartyTrackerService.cs`
- [Player identity](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Players/PlayerIdentityService.cs): `AlbionDataAvalonia/Players/PlayerIdentityService.cs`
- [Legendary items](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Legendary/LegendaryItemTrackerService.cs): `AlbionDataAvalonia/Legendary/LegendaryItemTrackerService.cs`
- [Market mail and trades](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Network/Services/MailService.cs): `AlbionDataAvalonia/Network/Services/MailService.cs`
- [Farming tracker](https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia): `AlbionDataAvalonia`
- [Specs capture](https://github.com/jpcodecraft/albiondataavalonia/tree/master/AlbionDataAvalonia/Network): `AlbionDataAvalonia/Network`
- [Estimated market values](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Items/Services/ItemEstimatedMarketValueService.cs): `AlbionDataAvalonia/Items/Services/ItemEstimatedMarketValueService.cs`

### Local data and settings

- [Gathering sessions](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Gathering/GatheringSessionPersistenceService.cs): `AlbionDataAvalonia/Gathering/GatheringSessionPersistenceService.cs`
- [SQLite database](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/DB/LocalContext.cs): `AlbionDataAvalonia/DB/LocalContext.cs`
- [Settings manager](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Settings/SettingsManager.cs): `AlbionDataAvalonia/Settings/SettingsManager.cs`
- [Player and upload state](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/State/PlayerState.cs): `AlbionDataAvalonia/State/PlayerState.cs`

### Desktop experience

- [Application startup](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/App.axaml.cs): `AlbionDataAvalonia/App.axaml.cs`
- [Desktop UI](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/ViewModels/MainViewModel.cs): `AlbionDataAvalonia/ViewModels/MainViewModel.cs`

### External services

- [Account authentication](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/Auth/Services/AuthService.cs): `AlbionDataAvalonia/Auth/Services/AuthService.cs`
- **AODP service**
- **AFM service**
- [Automatic updates](https://github.com/jpcodecraft/albiondataavalonia/blob/master/AlbionDataAvalonia/ClientUpdater.cs): `AlbionDataAvalonia/ClientUpdater.cs`

### Other components

- **Albion player**

## Connections

- Albion player → Network capture: plays while capturing (evidence: `README.md`)
- Network capture → Game event handlers: dispatches events (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Combat tracker: routes combat data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Gathering and fishing: routes harvest data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Loot tracker: routes loot data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Party tracker: routes party data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Player identity: routes identity data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Legendary items: routes item data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Market mail and trades: routes market data (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Network capture → Estimated market values: updates values (evidence: `AlbionDataAvalonia/Network/Services/NetworkListenerService.cs`)
- Loot tracker → Party tracker: uses party context (evidence: `AlbionDataAvalonia/Loot/LootTrackerService.cs`)
- Loot tracker → Player identity: uses player identity (evidence: `AlbionDataAvalonia/Loot/LootTrackerService.cs`)
- Loot tracker → Estimated market values: looks up values (evidence: `AlbionDataAvalonia/Loot/LootTrackerService.cs`)
- Combat tracker → Party tracker: uses party context (evidence: `AlbionDataAvalonia/Combat/CombatTrackerService.cs`)
- Gathering and fishing → Estimated market values: looks up values (evidence: `AlbionDataAvalonia/Gathering/GatheringTrackerService.cs`)
- Gathering and fishing → Gathering sessions: persists sessions (evidence: `AlbionDataAvalonia/Gathering/GatheringTrackerService.cs`)
- Gathering sessions → SQLite database: reads and writes (evidence: `AlbionDataAvalonia/Gathering/GatheringSessionPersistenceService.cs`)
- Market mail and trades → SQLite database: stores mail (evidence: `AlbionDataAvalonia/Network/Services/MailService.cs`)
- Account authentication → SQLite database: stores credentials (evidence: `AlbionDataAvalonia/Auth/Services/AuthService.cs`)
- Account authentication → AFM service: authenticates account
- Application startup → Network capture: starts capture (evidence: `AlbionDataAvalonia/App.axaml.cs`)
- Application startup → Desktop UI: creates view model (evidence: `AlbionDataAvalonia/App.axaml.cs`)
- Application startup → Settings manager: loads settings (evidence: `AlbionDataAvalonia/App.axaml.cs`)
- Application startup → Account authentication: initializes authentication (evidence: `AlbionDataAvalonia/App.axaml.cs`)
- Desktop UI → Combat tracker: presents tracker
- Desktop UI → Gathering and fishing: presents tracker
- Desktop UI → Loot tracker: presents tracker
- Desktop UI → Market mail and trades: presents market data
- AODP upload → AODP service: uploads records
- Game event handlers → AODP upload: forwards captured data
- Farming tracker → AFM service: records privately
- Specs capture → AFM service: uploads specs
- Application startup → Automatic updates: checks versions (evidence: `AlbionDataAvalonia/App.axaml.cs`)
- Settings manager → Player and upload state: configures sharing
