# avacmcgaugh/more-meals architecture

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

- Interactive diagram: https://gitdiagram.com/avacmcgaugh/more-meals
- Repository: https://github.com/avacmcgaugh/more-meals

## Overview

1. **Project type**
   - This is a **Vintage Story mod** called **More-Meals**.
   - The repository is almost entirely **data-driven content**, not an application with a large codebase.

2. **Primary purpose**
   - The mod’s job is to **add new meal content** to Vintage Story 1.22.
   - The README does not mention custom gameplay systems, UI, or services, so the architecture is centered on **content definitions** consumed by the game engine.

3. **Mod metadata boundary**
   - `modinfo.json` is the mod’s **entry metadata**.
   - This file is typically what Vintage Story uses to identify, load, and describe the mod, and it forms the main boundary between the game and the repository.

4. **Content namespace**
   - All game content lives under `assets/homestylemeals/`.
   - That `homestylemeals` namespace acts as the **content domain** for this mod, separating its recipes and language strings from other mods or base game assets.

5. **Recipe subsystem**
   - The key visible content area is `assets/homestylemeals/recipes/cooking/`.
   - The file `carrotonionsoup.json` is a **cooking recipe definition**, likely describing ingredients, outputs, crafting/cooking conditions, and related gameplay data.
   - This indicates the mod’s main functional subsystem is **adding craftable food recipes**.

6. **Localization subsystem**
   - `assets/homestylemeals/lang/en.json` provides **English text resources**.
   - This likely includes display names and descriptions for meals or recipe-related content, keeping user-facing strings separate from gameplay definitions.

7. **Data flow**
   - The intended flow is: **Vintage Story loads `modinfo.json` → loads namespaced assets under `assets/homestylemeals/` → registers recipe content → resolves display text from `lang/en.json`**.
   - The engine consumes these assets directly; there is no evidence of an intermediate API or runtime service.

8. **Architectural style**
   - This repo follows a **declarative content-pack style** rather than a procedural one.
   - Behavior is mostly defined by JSON files that the game interprets, so the “architecture” is primarily about **content organization and namespacing**.

9. **Technology/runtime impact**
   - The relevant runtime is **Vintage Story 1.22**.
   - That matters because asset folder conventions, mod metadata, and recipe JSON formats are all dictated by the Vintage Story modding system.

10. **What is not present**
   - No backend, database, network service, or client-side application code is visible in the tree.
   - There is also no sign of custom scripting or compiled logic in the repository snapshot provided.

11. **How to diagram it**
   - A clear diagram would show:
     - **Vintage Story engine** as the host
     - **modinfo.json** as the mod entry point
     - **assets/homestylemeals/** as the mod content namespace
     - separate lanes for **recipe definitions** and **localization**
     - arrows from the game to these assets at load time

12. **Overall summary**
   - More-Meals is a **small, content-focused mod** whose architecture is dominated by **JSON-based definitions** for recipes and text, all packaged under a single mod namespace and loaded by the Vintage Story engine.

Main entry points: [`assets/homestylemeals`](https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals) (Content namespace), [`modinfo.json`](https://github.com/avacmcgaugh/more-meals/blob/main/modinfo.json) (modinfo), [`assets/homestylemeals/lang`](https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals/lang) (Localization), [`README.md`](https://github.com/avacmcgaugh/more-meals/blob/main/README.md) (README)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g1["More-Meals mod"]
  node_n2["modinfo<br/>mod metadata<br/>[modinfo.json]"]
  node_n3["Content namespace<br/>asset domain"]
  node_n4["Meal recipes<br/>cooking content"]
  node_n5["Carrot onion soup<br/>recipe json"]
  node_n6["Localization<br/>text assets"]
  node_n7["English text<br/>lang json<br/>[en.json]"]
end

node_n1{{"Vintage Story<br/>game engine"}}
node_n8["README<br/>documentation<br/>[README.md]"]
node_n9["License"]

node_n1 -->|"loads"| node_n2
node_n1 -->|"loads"| node_n3
node_n2 -->|"binds"| node_n3
node_n3 -->|"contains"| node_n4
node_n4 -->|"defines"| node_n5
node_n3 -->|"contains"| node_n6
node_n6 -->|"provides"| node_n7
node_n5 -.->|"references"| node_n7
node_n8 -.->|"describes"| node_n2
node_n9 -.->|"pairs with"| node_n8

click node_n2 "https://github.com/avacmcgaugh/more-meals/blob/main/modinfo.json"
click node_n3 "https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals"
click node_n6 "https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals/lang"
click node_n7 "https://github.com/avacmcgaugh/more-meals/blob/main/assets/homestylemeals/lang/en.json"
click node_n8 "https://github.com/avacmcgaugh/more-meals/blob/main/README.md"
click node_n9 "https://github.com/avacmcgaugh/more-meals/tree/main/LICENSE"

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_n2,node_n3,node_n4,node_n5,node_n6,node_n7 toneBlue
class node_n1,node_n8,node_n9 toneNeutral
```

## Components

### More-Meals mod

Vintage Story mod metadata and namespaced content assets.

- [modinfo](https://github.com/avacmcgaugh/more-meals/blob/main/modinfo.json): mod metadata · Entry metadata used by Vintage Story to identify and load the mod. · `modinfo.json`
- [Content namespace](https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals): asset domain · All mod assets live under the homestylemeals namespace. · `assets/homestylemeals`
- **Meal recipes**: cooking content · Primary gameplay content area for declared meal and cooking recipes.
- **Carrot onion soup**: recipe json · A specific cooking recipe definition for a meal.
- [Localization](https://github.com/avacmcgaugh/more-meals/tree/main/assets/homestylemeals/lang): text assets · English language resources for user-facing names and descriptions. · `assets/homestylemeals/lang`
- [English text](https://github.com/avacmcgaugh/more-meals/blob/main/assets/homestylemeals/lang/en.json): lang json · English localization strings for the mod. · `assets/homestylemeals/lang/en.json`

### Other components

- **Vintage Story**: game engine · Host runtime that loads the mod and interprets its content definitions.
- [README](https://github.com/avacmcgaugh/more-meals/blob/main/README.md): documentation · Human-readable project overview and mod description. · `README.md`
- [License](https://github.com/avacmcgaugh/more-meals/tree/main/LICENSE): license · Repository license text. · `LICENSE`

## Connections

- Vintage Story → modinfo: loads · The engine reads mod metadata to register the mod.
- Vintage Story → Content namespace: loads · The engine scans the mod's namespaced assets.
- modinfo → Content namespace: binds · Metadata identifies the content namespace used by the mod.
- Content namespace → Meal recipes: contains · Recipe definitions are organized as cooking content.
- Meal recipes → Carrot onion soup: defines · This file defines one specific meal recipe.
- Content namespace → Localization: contains · Localization assets are separated into a language folder.
- Localization → English text: provides · This file supplies English strings for in-game display.
- Carrot onion soup → English text: references · Recipe content may rely on localized names and descriptions.
- README → modinfo: describes · Documentation explains the mod and its purpose.
- License → README: pairs with · Repository license accompanies the project documentation.
