# anegostudios/vssurvivalmod architecture

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

## Overview

This is Vintage Story’s vanilla survival mod: it supplies survival gameplay and the in-game interfaces that let players interact with it. A representative workflow is preparing ingredients into meals, storing or displaying items, and inspecting game information; other major branches include trade, entity activities, microblocks, and liquid containers. The tree and source index show a broad set of additional survival systems, but their runtime wiring is not sampled. Edges below are limited to relationships documented by the index or excerpts; a missing tree path is not inferred.

Main entry points: [`Block/BlockCrock.cs`](https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockCrock.cs) (Crock handling), [`Systems/Cooking/BlockCookedContainer.cs`](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/BlockCookedContainer.cs) (Cooked containers), [`Systems/Cooking/MealMeshCache.cs`](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/MealMeshCache.cs) (Meal meshes), [`Systems/Cooking/CookingRecipe.cs`](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/CookingRecipe.cs) (Cooking recipes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_food["Food and cooking"]
  node_crock["Crock handling<br/>[BlockCrock.cs]"]
  node_recipe["Cooking recipes<br/>[CookingRecipe.cs]"]
  node_ingredients["Recipe ingredients"]
  node_meal["Meal behavior<br/>[BlockMeal.cs]"]
  node_mealmesh["Meal meshes<br/>[MealMeshCache.cs]"]
  node_cooked["Cooked containers"]
end

subgraph group_storage["Storage and containers"]
  node_containerbase["Container base"]
  node_container["Block containers<br/>[BlockContainer.cs]"]
  node_groundblock["Ground storage block"]
  node_groundentity["Ground storage state<br/>[BEGroundStorage.cs]"]
  node_groundrender["Ground storage renderer"]
  node_displaybehavior["Display behavior"]
  node_displayblock["Display blocks"]
  node_liquid["Liquid containers"]
end

subgraph group_player["Player interfaces"]
  node_handbook["Handbook information"]
  node_handbookpage["Handbook item page"]
  node_tradergui["Trader interface<br/>[GuiDialogTrader.cs]"]
  node_auction["Auction system<br/>[Auction.cs]"]
  node_traderinventory["Trader inventory<br/>[InventoryTrader.cs]"]
  node_activities["Activity editor<br/>[Gui.cs]"]
  node_activitysystem["Entity activities"]
end

subgraph group_world["World systems"]
  node_microblock["Microblock state<br/>[BEMicroBlock.cs]"]
  node_liquidbehavior["Spreading liquids"]
  node_teleporter["Teleporter manager"]
  node_stability["Temporal stability"]
  node_dialogue["Dialogue controller"]
  node_survival["Survival gameplay<br/>[Core.cs]"]
end

node_player(("Player"))

node_crock -->|"uses base"| node_containerbase
node_crock -->|"uses meshes"| node_mealmesh
node_crock -->|"uses container"| node_liquid
node_crock -->|"uses recipes"| node_recipe
node_crock -->|"uses meal"| node_meal
node_meal -->|"reads recipe"| node_recipe
node_meal -->|"uses meshes"| node_mealmesh
node_recipe -->|"uses ingredients"| node_ingredients
node_mealmesh -->|"uses recipes"| node_recipe
node_mealmesh -->|"uses container"| node_container
node_cooked -->|"extends base"| node_containerbase
node_cooked -->|"uses meshes"| node_mealmesh
node_cooked -->|"uses recipes"| node_recipe
node_cooked -->|"uses meal"| node_meal
node_cooked -->|"uses crock"| node_crock
node_cooked -->|"uses storage"| node_groundblock
node_container -->|"references"| node_crock
node_groundentity -->|"uses block"| node_groundblock
node_groundentity -->|"uses renderer"| node_groundrender
node_groundentity -->|"references"| node_crock
node_groundentity -->|"uses cooked block"| node_cooked
node_displayblock -->|"uses behavior"| node_displaybehavior
node_displaybehavior -->|"uses behavior"| node_container
node_handbookpage -->|"uses text"| node_handbook
node_tradergui -->|"uses inventory"| node_traderinventory
node_tradergui -->|"uses auctions"| node_auction
node_auction -->|"uses inventory"| node_traderinventory
node_activities -->|"uses system"| node_activitysystem
node_dialogue -.->|"serves dialogue"| node_player

click node_crock "https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockCrock.cs"
click node_recipe "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/CookingRecipe.cs"
click node_ingredients "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/CookingRecipeIngredient.cs"
click node_meal "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/BlockMeal.cs"
click node_mealmesh "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/MealMeshCache.cs"
click node_cooked "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/BlockCookedContainer.cs"
click node_containerbase "https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockCookedContainerBase.cs"
click node_container "https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockContainer.cs"
click node_groundblock "https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockGroundStorage.cs"
click node_groundentity "https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntity/BEGroundStorage.cs"
click node_groundrender "https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntityRenderer/GroundStorageRenderer.cs"
click node_displaybehavior "https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntityBehavior/BEBehaviorDisplay.cs"
click node_displayblock "https://github.com/anegostudios/vssurvivalmod/blob/master/BlockBehavior/BlockBehaviorDisplay.cs"
click node_liquid "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Liquid/BlockLiquidContainerBase.cs"
click node_handbook "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Handbook/CollectibleBehaviorHandbookTextAndExtraInfo.cs"
click node_handbookpage "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Handbook/Gui/GuiHandbookItemStackPage.cs"
click node_tradergui "https://github.com/anegostudios/vssurvivalmod/blob/master/Gui/GuiDialogTrader.cs"
click node_auction "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Auction/Auction.cs"
click node_traderinventory "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Trading/InventoryTrader.cs"
click node_activities "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/EntityActivitySystem/Gui.cs"
click node_activitysystem "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/EntityActivitySystem/EntityActivitySystem.cs"
click node_microblock "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Microblock/BEMicroBlock.cs"
click node_liquidbehavior "https://github.com/anegostudios/vssurvivalmod/blob/master/BlockBehavior/BehaviorFiniteSpreadingLiquid.cs"
click node_teleporter "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/TeleporterManager.cs"
click node_stability "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/TemporalStability/TemporalStability.cs"
click node_dialogue "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Dialogue/DialogueController.cs"
click node_survival "https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Core.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_crock,node_recipe,node_ingredients,node_meal,node_mealmesh,node_cooked toneBlue
class node_containerbase,node_container,node_groundblock,node_groundentity,node_groundrender,node_displaybehavior,node_displayblock,node_liquid toneAmber
class node_handbook,node_handbookpage,node_tradergui,node_auction,node_traderinventory,node_activities,node_activitysystem toneMint
class node_microblock,node_liquidbehavior,node_teleporter,node_stability,node_dialogue,node_survival toneRose
class node_player toneIndigo
```

## Components

### Food and cooking

- [Crock handling](https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockCrock.cs): `Block/BlockCrock.cs`
- [Cooking recipes](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/CookingRecipe.cs): `Systems/Cooking/CookingRecipe.cs`
- [Recipe ingredients](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/CookingRecipeIngredient.cs): `Systems/Cooking/CookingRecipeIngredient.cs`
- [Meal behavior](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/BlockMeal.cs): `Systems/Cooking/BlockMeal.cs`
- [Meal meshes](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/MealMeshCache.cs): `Systems/Cooking/MealMeshCache.cs`
- [Cooked containers](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Cooking/BlockCookedContainer.cs): `Systems/Cooking/BlockCookedContainer.cs`

### Storage and containers

- [Container base](https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockCookedContainerBase.cs): `Block/BlockCookedContainerBase.cs`
- [Block containers](https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockContainer.cs): `Block/BlockContainer.cs`
- [Ground storage block](https://github.com/anegostudios/vssurvivalmod/blob/master/Block/BlockGroundStorage.cs): `Block/BlockGroundStorage.cs`
- [Ground storage state](https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntity/BEGroundStorage.cs): `BlockEntity/BEGroundStorage.cs`
- [Ground storage renderer](https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntityRenderer/GroundStorageRenderer.cs): `BlockEntityRenderer/GroundStorageRenderer.cs`
- [Display behavior](https://github.com/anegostudios/vssurvivalmod/blob/master/BlockEntityBehavior/BEBehaviorDisplay.cs): `BlockEntityBehavior/BEBehaviorDisplay.cs`
- [Display blocks](https://github.com/anegostudios/vssurvivalmod/blob/master/BlockBehavior/BlockBehaviorDisplay.cs): `BlockBehavior/BlockBehaviorDisplay.cs`
- [Liquid containers](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Liquid/BlockLiquidContainerBase.cs): `Systems/Liquid/BlockLiquidContainerBase.cs`

### Player interfaces

- [Handbook information](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Handbook/CollectibleBehaviorHandbookTextAndExtraInfo.cs): `Systems/Handbook/CollectibleBehaviorHandbookTextAndExtraInfo.cs`
- [Handbook item page](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Handbook/Gui/GuiHandbookItemStackPage.cs): `Systems/Handbook/Gui/GuiHandbookItemStackPage.cs`
- [Trader interface](https://github.com/anegostudios/vssurvivalmod/blob/master/Gui/GuiDialogTrader.cs): `Gui/GuiDialogTrader.cs`
- [Auction system](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Auction/Auction.cs): `Systems/Auction/Auction.cs`
- [Trader inventory](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Trading/InventoryTrader.cs): `Systems/Trading/InventoryTrader.cs`
- [Activity editor](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/EntityActivitySystem/Gui.cs): `Systems/EntityActivitySystem/Gui.cs`
- [Entity activities](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/EntityActivitySystem/EntityActivitySystem.cs): `Systems/EntityActivitySystem/EntityActivitySystem.cs`

### World systems

- [Microblock state](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Microblock/BEMicroBlock.cs): `Systems/Microblock/BEMicroBlock.cs`
- [Spreading liquids](https://github.com/anegostudios/vssurvivalmod/blob/master/BlockBehavior/BehaviorFiniteSpreadingLiquid.cs): `BlockBehavior/BehaviorFiniteSpreadingLiquid.cs`
- [Teleporter manager](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/TeleporterManager.cs): `Systems/TeleporterManager.cs`
- [Temporal stability](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/TemporalStability/TemporalStability.cs): `Systems/TemporalStability/TemporalStability.cs`
- [Dialogue controller](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Dialogue/DialogueController.cs): `Systems/Dialogue/DialogueController.cs`
- [Survival gameplay](https://github.com/anegostudios/vssurvivalmod/blob/master/Systems/Core.cs): `Systems/Core.cs`

### Other components

- **Player**

## Connections

- Crock handling → Container base: uses base (evidence: `Block/BlockCrock.cs`)
- Crock handling → Meal meshes: uses meshes (evidence: `Block/BlockCrock.cs`)
- Crock handling → Liquid containers: uses container (evidence: `Block/BlockCrock.cs`)
- Crock handling → Cooking recipes: uses recipes (evidence: `Block/BlockCrock.cs`)
- Crock handling → Meal behavior: uses meal (evidence: `Block/BlockCrock.cs`)
- Meal behavior → Cooking recipes: reads recipe (evidence: `Systems/Cooking/BlockMeal.cs`)
- Meal behavior → Meal meshes: uses meshes (evidence: `Systems/Cooking/BlockMeal.cs`)
- Cooking recipes → Recipe ingredients: uses ingredients (evidence: `Systems/Cooking/CookingRecipe.cs`)
- Meal meshes → Cooking recipes: uses recipes (evidence: `Systems/Cooking/MealMeshCache.cs`)
- Meal meshes → Block containers: uses container (evidence: `Systems/Cooking/MealMeshCache.cs`)
- Cooked containers → Container base: extends base (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Cooked containers → Meal meshes: uses meshes (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Cooked containers → Cooking recipes: uses recipes (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Cooked containers → Meal behavior: uses meal (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Cooked containers → Crock handling: uses crock (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Cooked containers → Ground storage block: uses storage (evidence: `Systems/Cooking/BlockCookedContainer.cs`)
- Block containers → Crock handling: references (evidence: `Block/BlockContainer.cs`)
- Ground storage state → Ground storage block: uses block (evidence: `BlockEntity/BEGroundStorage.cs`)
- Ground storage state → Ground storage renderer: uses renderer (evidence: `BlockEntity/BEGroundStorage.cs`)
- Ground storage state → Crock handling: references (evidence: `BlockEntity/BEGroundStorage.cs`)
- Ground storage state → Cooked containers: uses cooked block (evidence: `BlockEntity/BEGroundStorage.cs`)
- Display blocks → Display behavior: uses behavior (evidence: `BlockBehavior/BlockBehaviorDisplay.cs`)
- Display behavior → Block containers: uses behavior (evidence: `BlockEntityBehavior/BEBehaviorDisplay.cs`)
- Handbook item page → Handbook information: uses text (evidence: `Systems/Handbook/Gui/GuiHandbookItemStackPage.cs`)
- Trader interface → Trader inventory: uses inventory (evidence: `Gui/GuiDialogTrader.cs`)
- Trader interface → Auction system: uses auctions (evidence: `Gui/GuiDialogTrader.cs`)
- Auction system → Trader inventory: uses inventory (evidence: `Systems/Auction/Auction.cs`)
- Activity editor → Entity activities: uses system (evidence: `Systems/EntityActivitySystem/Gui.cs`)
- Dialogue controller → Player: serves dialogue
