# song682/catframe architecture

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

- Interactive diagram: https://gitdiagram.com/song682/catframe
- Repository: https://github.com/song682/catframe

## Overview

CatFrame is a Minecraft 1.7.10 mod framework that backports modern model, item-state, rendering, resource, and UI capabilities. Its principal runtime path discovers model resources, resolves block/item state, bakes models, and submits geometry through a deferred render pipeline to Minecraft. Separate branches provide atlases, data components, tags and recipes, UI, built-in packs, language registration, and search. Edges use README statements and SOURCE INDEX references; unsampled subsystems are represented by their documented directory paths, with uncertain wiring omitted.

Main entry points: [`src/main/java/decok/dfcdvadstf/catframe/CatFrame.java`](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/CatFrame.java) (CatFrame Mod), [`src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java) (Resource Discovery), [`src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java`](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java) (Vanilla Model Bridge), [`src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java`](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java) (Async Model Baking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Models and State"]
  node_loader["Resource Discovery"]
  node_resolver["Model Resolver<br/>[ModelResolver.java]"]
  node_blockstate["Block State Models"]
  node_itemstate["Item State Trees<br/>[ItemStateNode.java]"]
  node_bake["Async Model Baking"]
  node_manager["Vanilla Model Bridge"]
end

subgraph group_render["Rendering and Resources"]
  node_renderentry["Model Render API"]
  node_pipeline["Deferred Render Pipeline"]
  node_submit["Render Submission<br/>[RenderSubmit.java]"]
  node_atlas["Texture Atlas<br/>[AtlasManager.java]"]
end

subgraph group_ui["User Interface"]
  node_uiatlas["UI Texture Atlas"]
  node_screen["UI Screens<br/>[Screen.java]"]
  node_widgets["UI Components"]
  node_overlay["Overlay System"]
end

subgraph group_framework["Game Data"]
  node_components["Data Components"]
  node_tags["Tag System<br/>[TagLoader.java]"]
  node_recipes["Tag Recipes"]
  node_search["Search Trees"]
end

subgraph group_integration["Game Integration"]
  node_mod["CatFrame Mod<br/>[CatFrame.java]"]
  node_builtin["Built-in Packs"]
  node_language["Language Loading"]
end

node_player(("Player"))

node_mod -.->|"initializes"| node_loader
node_loader -->|"resolves models"| node_resolver
node_loader -->|"loads states"| node_blockstate
node_loader -->|"loads trees"| node_itemstate
node_bake -->|"uses"| node_resolver
node_bake -.->|"populates models"| node_manager
node_manager -->|"registers loaded models"| node_loader
node_manager -->|"registers trees"| node_itemstate
node_renderentry -->|"renders through"| node_pipeline
node_pipeline -->|"submits quads"| node_submit
node_loader -->|"collects textures"| node_atlas
node_atlas -->|"tracks vanilla textures"| node_manager
node_player -.->|"uses"| node_screen
node_screen -->|"composes"| node_widgets
node_player -.->|"views overlays"| node_overlay
node_overlay -->|"renders components"| node_widgets
node_mod -->|"registers"| node_uiatlas
node_mod -.->|"provides framework"| node_components
node_mod -.->|"provides framework"| node_tags
node_tags -->|"supports tag recipes"| node_recipes
node_mod -.->|"bootstraps packs"| node_builtin
node_mod -.->|"provides registration"| node_language
node_player -.->|"searches content"| node_search

click node_mod "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/CatFrame.java"
click node_loader "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java"
click node_resolver "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/core/ModelResolver.java"
click node_blockstate "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/state/BlockstateJson.java"
click node_itemstate "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/state/item/ItemStateNode.java"
click node_bake "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java"
click node_manager "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java"
click node_renderentry "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/IItemStateProvider.java"
click node_pipeline "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/render/UniformRenderPipeline.java"
click node_submit "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/render/pipeline/RenderSubmit.java"
click node_atlas "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/resources/atlas/AtlasManager.java"
click node_uiatlas "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/UiTextureAtlasManager.java"
click node_screen "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/screens/Screen.java"
click node_widgets "https://github.com/song682/catframe/tree/main/src/main/java/decok/dfcdvadstf/catframe/ui/components"
click node_overlay "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/overlay/OverlayManager.java"
click node_components "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/core/component/DataComponents.java"
click node_tags "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/tags/TagLoader.java"
click node_recipes "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/recipe/TagRecipeManager.java"
click node_builtin "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/resources/builtin/BuiltinPackBootstrap.java"
click node_language "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/adapter/forge/language/LanguageRegister.java"
click node_search "https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/searching/TextSearchTree.java"

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_loader,node_resolver,node_blockstate,node_itemstate,node_bake,node_manager toneBlue
class node_renderentry,node_pipeline,node_submit,node_atlas toneAmber
class node_uiatlas,node_screen,node_widgets,node_overlay toneMint
class node_components,node_tags,node_recipes,node_search toneRose
class node_mod,node_builtin,node_language,node_player toneIndigo
```

## Components

### Models and State

- [Resource Discovery](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java): `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`
- [Model Resolver](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/core/ModelResolver.java): `src/main/java/decok/dfcdvadstf/catframe/model/core/ModelResolver.java`
- [Block State Models](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/state/BlockstateJson.java): `src/main/java/decok/dfcdvadstf/catframe/model/state/BlockstateJson.java`
- [Item State Trees](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/state/item/ItemStateNode.java): `src/main/java/decok/dfcdvadstf/catframe/model/state/item/ItemStateNode.java`
- [Async Model Baking](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java): `src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java`
- [Vanilla Model Bridge](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java): `src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java`

### Rendering and Resources

- [Model Render API](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/IItemStateProvider.java): `src/main/java/decok/dfcdvadstf/catframe/model/IItemStateProvider.java`
- [Deferred Render Pipeline](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/render/UniformRenderPipeline.java): `src/main/java/decok/dfcdvadstf/catframe/model/render/UniformRenderPipeline.java`
- [Render Submission](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/model/render/pipeline/RenderSubmit.java): `src/main/java/decok/dfcdvadstf/catframe/model/render/pipeline/RenderSubmit.java`
- [Texture Atlas](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/resources/atlas/AtlasManager.java): `src/main/java/decok/dfcdvadstf/catframe/resources/atlas/AtlasManager.java`

### User Interface

- [UI Texture Atlas](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/UiTextureAtlasManager.java): `src/main/java/decok/dfcdvadstf/catframe/ui/UiTextureAtlasManager.java`
- [UI Screens](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/screens/Screen.java): `src/main/java/decok/dfcdvadstf/catframe/ui/screens/Screen.java`
- [UI Components](https://github.com/song682/catframe/tree/main/src/main/java/decok/dfcdvadstf/catframe/ui/components): `src/main/java/decok/dfcdvadstf/catframe/ui/components`
- [Overlay System](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/ui/overlay/OverlayManager.java): `src/main/java/decok/dfcdvadstf/catframe/ui/overlay/OverlayManager.java`

### Game Data

- [Data Components](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/core/component/DataComponents.java): `src/main/java/decok/dfcdvadstf/catframe/core/component/DataComponents.java`
- [Tag System](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/tags/TagLoader.java): `src/main/java/decok/dfcdvadstf/catframe/tags/TagLoader.java`
- [Tag Recipes](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/recipe/TagRecipeManager.java): `src/main/java/decok/dfcdvadstf/catframe/recipe/TagRecipeManager.java`
- [Search Trees](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/searching/TextSearchTree.java): `src/main/java/decok/dfcdvadstf/catframe/searching/TextSearchTree.java`

### Game Integration

- [CatFrame Mod](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/CatFrame.java): `src/main/java/decok/dfcdvadstf/catframe/CatFrame.java`
- [Built-in Packs](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/resources/builtin/BuiltinPackBootstrap.java): `src/main/java/decok/dfcdvadstf/catframe/resources/builtin/BuiltinPackBootstrap.java`
- [Language Loading](https://github.com/song682/catframe/blob/main/src/main/java/decok/dfcdvadstf/catframe/adapter/forge/language/LanguageRegister.java): `src/main/java/decok/dfcdvadstf/catframe/adapter/forge/language/LanguageRegister.java`

### Other components

- **Player**

## Connections

- CatFrame Mod → Resource Discovery: initializes (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`)
- Resource Discovery → Model Resolver: resolves models (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`)
- Resource Discovery → Block State Models: loads states (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`)
- Resource Discovery → Item State Trees: loads trees (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`)
- Async Model Baking → Model Resolver: uses (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java`)
- Async Model Baking → Vanilla Model Bridge: populates models (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/core/async/AsyncBakePipeline.java`)
- Vanilla Model Bridge → Resource Discovery: registers loaded models (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java`)
- Vanilla Model Bridge → Item State Trees: registers trees (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/VanillaModelManager.java`)
- Model Render API → Deferred Render Pipeline: renders through
- Deferred Render Pipeline → Render Submission: submits quads (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/render/UniformRenderPipeline.java`)
- Resource Discovery → Texture Atlas: collects textures (evidence: `src/main/java/decok/dfcdvadstf/catframe/model/ModelManagerDataLoader.java`)
- Texture Atlas → Vanilla Model Bridge: tracks vanilla textures (evidence: `src/main/java/decok/dfcdvadstf/catframe/resources/atlas/AtlasManager.java`)
- Player → UI Screens: uses
- UI Screens → UI Components: composes
- Player → Overlay System: views overlays
- Overlay System → UI Components: renders components (evidence: `src/main/java/decok/dfcdvadstf/catframe/ui/overlay/OverlayManager.java`)
- CatFrame Mod → UI Texture Atlas: registers (evidence: `src/main/java/decok/dfcdvadstf/catframe/proxy/ClientProxy.java`)
- CatFrame Mod → Data Components: provides framework
- CatFrame Mod → Tag System: provides framework
- Tag System → Tag Recipes: supports tag recipes
- CatFrame Mod → Built-in Packs: bootstraps packs
- CatFrame Mod → Language Loading: provides registration
- Player → Search Trees: searches content
