# veywrn/stardewvalley architecture

> Architecture diagram of the GitHub repository veywrn/stardewvalley, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/veywrn/stardewvalley
- Repository: https://github.com/veywrn/stardewvalley

## Overview

##### Project type and purpose
- This is a decompiled C# XNA game (Stardew Valley) targeting Windows/.NET 4.0. It’s a single‐process desktop application (monolithic object‐oriented architecture) that uses external services for networking (Steam, Galaxy) and peer‐to‐peer sync (Lidgren).

##### File structure
- Top‐level “lib” dependencies (described in README): XNA assemblies, Steamworks.NET, Lidgren.Network, Galaxy SDK, xTile, BmFont.
- Third‐party utility libraries under the repo:
- Force.DeepCloner – runtime code‐generation deep‐cloning helper
- Ionic.Zlib – compression/CRC support
- Sickhead.Engine.Util – small reflection/input utilities
- StardewValley.GameData – pure data classes (recipes, bundles, special orders, etc.)
- Netcode – generic networking primitives (NetField, NetVector2, serialization façade, etc.)
- Main “StardewValley” namespace – core game logic subdivided into:
- Engine bootstrap (Program.cs, GameRunner.cs, Game1.cs)
- Core domain objects (Farmer, NPC, Monster, TerrainFeature, Tool, Object, Building)
- World model (GameLocation, Farm, Map, WorldDate)
- Content/UI layer (Menus, Menus/…, HUD, TemporaryAnimatedSprite)
- Minigames, Events, Quests modules
- Networking integration under StardewValley.Network (Client/Server wrappers, NetSynchronizer, NetWorldState)
- SDK helpers (SteamHelper, GalaxyHelper, LobbyUpdateListener)
- Save/Load (SaveGame.cs, Content asset loading via LocalizedContentManager)
- Project/solution files (StardewValley.sln, .csproj).

##### Final advice
- Essential modules at a high level—don’t try to show every class file.
- How data/state flows through the system each frame: Input → Update → Network Sync → Render → Asset/Save.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Services
    subgraph "External Dependencies"
        classDef external fill:#E0E0E0,stroke:#333,stroke-width:1px
        XNA["XNA Framework"]:::external
        Steam["Steamworks.NET / Steam API"]:::external
        Galaxy["Galaxy SDK"]:::external
        Lidgren["Lidgren.Network"]:::external
        xTile["xTile, BmFont"]:::external
    end

    %% Engine & Framework
    subgraph "Engine & Framework" 
        classDef engine fill:#D0E8FF,stroke:#333,stroke-width:1px
        Program["Program.cs"]:::engine
        GameRunner["GameRunner.cs"]:::engine
        Game1["Game1.cs"]:::engine
        GameLoop["Game Loop\n(Update → Draw)"]:::engine
        InputDispatcher["InputDispatcher"]:::engine
        GraphicsRenderer["GraphicsRenderer"]:::engine
        AudioEngine["AudioEngineWrapper"]:::engine
    end

    %% Game Logic & Data
    subgraph "Game Logic & Data"
        classDef logic fill:#DFFFD0,stroke:#333,stroke-width:1px
        subgraph "World Model"
            GameLocation["GameLocation.cs"]:::logic
            Farm["Farm.cs"]:::logic
            WorldDate["WorldDate.cs"]:::logic
        end
        subgraph "Entities"
            Farmer["Farmer.cs"]:::logic
            NPC["NPC.cs"]:::logic
            Monsters["Monsters/"]:::logic
            TerrainFeatures["TerrainFeatures/"]:::logic
            Tools["Tools/"]:::logic
            Objects["Objects/"]:::logic
            Buildings["Buildings/"]:::logic
        end
        GameData["StardewValley.GameData/"]:::logic
        AIPhysics["AI & Physics"]:::logic
    end

    %% UI & Menus
    subgraph "UI & Menus"
        classDef ui fill:#FFE4B5,stroke:#333,stroke-width:1px
        Menus["Menus/"]:::ui
        HUDMessage["HUDMessage.cs"]:::ui
        TempSprite["TemporaryAnimatedSprite.cs"]:::ui
    end

    %% Minigames, Events, Quests
    subgraph "Features"
        classDef features fill:#FFF5CC,stroke:#333,stroke-width:1px
        Minigames["Minigames/"]:::features
        Events["Events/"]:::features
        Quests["Quests/"]:::features
    end

    %% Networking Layer
    subgraph "Networking"
        classDef network fill:#E5D0FF,stroke:#333,stroke-width:1px
        Netcode["Netcode/"]:::network
        NetworkIntegration["StardewValley/Network/"]:::network
        NetSync["NetSynchronizer.cs"]:::network
        NetWorldState["NetWorldState.cs"]:::network
    end

    %% SDK Helpers
    SDKHelpers["SDKs/ (Steam, Galaxy)"]:::network

    %% Persistence & Assets
    subgraph "Assets & Persistence"
        classDef persistence fill:#F5DEB3,stroke:#333,stroke-width:1px
        SaveGame["SaveGame.cs"]:::persistence
        ContentManager["LocalizedContentManager.cs"]:::persistence
        ContentFolder["Content/ (assets)"]:::persistence
    end

    %% Utilities & Third-Party
    subgraph "Utilities & Third-Party"
        classDef util fill:#F0F0F0,stroke:#333,stroke-width:1px
        DeepCloner["Force.DeepCloner/"]:::util
        IonicZlib["Ionic.Zlib/"]:::util
        IonicCrc["Ionic/Crc/"]:::util
        Sickhead["Sickhead.Engine.Util/"]:::util
    end

    %% Relationships
    XNA --> Program
    Steam --> SDKHelpers
    Galaxy --> SDKHelpers
    Lidgren --> Netcode
    xTile --> ContentManager

    Program --> GameLoop
    GameRunner --> GameLoop
    Game1 --> GameLoop

    GameLoop -->|Update| AIPhysics
    GameLoop -->|Draw| GraphicsRenderer
    GameLoop -->|Draw| AudioEngine
    GameLoop -->|Draw| Menus
    InputDispatcher --> AIPhysics
    InputDispatcher -->|events| Farmer

    ContentManager -->|loads| GameData
    ContentManager -->|loads| HUDMessage
    ContentManager -->|loads| TempSprite

    AIPhysics --> Farmer
    AIPhysics --> NPC
    AIPhysics --> Monsters
    AIPhysics --> TerrainFeatures
    AIPhysics --> Tools
    AIPhysics --> Objects
    AIPhysics --> Buildings
    AIPhysics -->|state| WorldDate
    AIPhysics -->|state| Farm
    AIPhysics -->|state| GameLocation

    Farmer --> NetSync
    NPC --> NetSync
    NetSync <--> NetWorldState
    NetWorldState --> NetworkIntegration
    NetworkIntegration --> Netcode

    SaveGame -->|serialize| GameData
    SaveGame -->|serialize| WorldDate
    SaveGame -->|serialize| Farm
    SaveGame -->|serialize| GameLocation
    ContentManager --> SaveGame

    DeepCloner --> Netcode
    DeepCloner --> SaveGame
    IonicZlib --> SaveGame
    Sickhead --> InputDispatcher
    Sickhead --> AIPhysics

    %% Click Events
    click Program "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/Program.cs"
    click GameRunner "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/GameRunner.cs"
    click Game1 "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/Game1.cs"
    click GameLocation "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/GameLocation.cs"
    click Farm "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/Farm.cs"
    click WorldDate "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/WorldDate.cs"
    click Farmer "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/Farmer.cs"
    click NPC "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/NPC.cs"
    click Monsters "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Monsters/"
    click TerrainFeatures "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/TerrainFeatures/"
    click Tools "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Tools/"
    click Objects "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Objects/"
    click Buildings "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Buildings/"
    click GameData "https://github.com/veywrn/stardewvalley/tree/master/StardewValley.GameData/"
    click Menus "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Menus/"
    click HUDMessage "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/HUDMessage.cs"
    click TempSprite "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/TemporaryAnimatedSprite.cs"
    click Minigames "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Minigames/"
    click Events "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Events/"
    click Quests "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Quests/"
    click Netcode "https://github.com/veywrn/stardewvalley/tree/master/Netcode/"
    click NetworkIntegration "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/Network/"
    click NetSync "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/NetSynchronizer.cs"
    click NetWorldState "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/NetWorldState.cs"
    click SDKHelpers "https://github.com/veywrn/stardewvalley/tree/master/StardewValley/SDKs/"
    click SaveGame "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/SaveGame.cs"
    click ContentManager "https://github.com/veywrn/stardewvalley/blob/master/StardewValley/LocalizedContentManager.cs"
    click DeepCloner "https://github.com/veywrn/stardewvalley/tree/master/Force.DeepCloner/"
    click IonicZlib "https://github.com/veywrn/stardewvalley/tree/master/Ionic.Zlib/"
    click IonicCrc "https://github.com/veywrn/stardewvalley/tree/master/Ionic/Crc/"
    click Sickhead "https://github.com/veywrn/stardewvalley/tree/master/Sickhead.Engine.Util/"

    %% Style Definitions
    classDef engine fill:#D0E8FF,stroke:#333
    classDef logic fill:#DFFFD0,stroke:#333
    classDef ui fill:#FFE4B5,stroke:#333
    classDef network fill:#E5D0FF,stroke:#333
    classDef util fill:#F0F0F0,stroke:#333
    classDef persistence fill:#F5DEB3,stroke:#333
    classDef external fill:#E0E0E0,stroke:#333
```
