# metaorbe/poc_destructableenv-tools architecture

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

- Interactive diagram: https://gitdiagram.com/metaorbe/poc_destructableenv-tools
- Repository: https://github.com/metaorbe/poc_destructableenv-tools

## Overview

This is a small R&D toolkit for a low-cost destructible-environment prototype, with a Blender-to-FBX-to-Unity workflow. Blender scripts create parent empties for named fracture cells; Unity editor tools configure intact objects and chunks; runtime behavior swaps intact visuals for fracture groups, then releases and removes damaged chunks under a budget. The README documents the overall handoff, but the FBX transfer itself is not implemented here. Unity runtime evidence is sampled; unshown editor tools are included only where the source index documents their references.

Main entry points: [`unity/Runtime/DestructibleWallSwap.cs`](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/DestructibleWallSwap.cs) (Intact-Fracture Swap), [`unity/Runtime/ReleaseChunkOnDamaged.cs`](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/ReleaseChunkOnDamaged.cs) (Chunk Release), [`unity/Editor/AddBreakableCoreComponents.cs`](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AddBreakableCoreComponents.cs) (Add Core Components), [`unity/Editor/AssignIntactRefsTools.cs`](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AssignIntactRefsTools.cs) (Assign Intact Refs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_blender["Blender Prep"]
  node_blender_cells["Cell Parenting<br/>[Text.001.py]"]
  node_blender_circle["Circle Parenting"]
  node_blender_tour["Tower Parenting"]
end

subgraph group_editor["Unity Setup"]
  node_add_core["Add Core Components"]
  node_assign_refs["Assign Intact Refs"]
  node_fill_groups["Fill Fractured Groups"]
  node_setup_chunks["Setup Cell Chunks"]
end

subgraph group_runtime["Destruction Runtime"]
  node_wall_swap["Intact-Fracture Swap"]
  node_release_chunk["Chunk Release"]
  node_chunk_budget["Chunk Budget Manager"]
end

node_artist(("Environment Artist"))
node_unity_user(("Unity Editor User"))
node_health["Health Damage Events"]

node_artist -->|"runs preparation"| node_blender_cells
node_artist -->|"runs preparation"| node_blender_circle
node_artist -->|"runs preparation"| node_blender_tour
node_artist -.->|"imports FBX"| node_unity_user
node_unity_user -->|"selects objects"| node_add_core
node_unity_user -->|"assigns references"| node_assign_refs
node_unity_user -->|"selects intact mesh"| node_fill_groups
node_unity_user -->|"selects parent"| node_setup_chunks
node_add_core -->|"adds component"| node_wall_swap
node_assign_refs -->|"sets references"| node_wall_swap
node_fill_groups -->|"fills groups"| node_wall_swap
node_setup_chunks -->|"adds component"| node_release_chunk
node_wall_swap -->|"subscribes damage"| node_health
node_release_chunk -->|"subscribes damage"| node_health
node_health -->|"raises damage event"| node_wall_swap
node_health -->|"raises damage event"| node_release_chunk
node_release_chunk -.->|"registers released chunks"| node_chunk_budget

click node_blender_cells "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/Text.001.py"
click node_blender_circle "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/circle_script_to_parent.py"
click node_blender_tour "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/CylinderLongTour_script_to_parent.py"
click node_add_core "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AddBreakableCoreComponents.cs"
click node_assign_refs "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AssignIntactRefsTools.cs"
click node_fill_groups "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs"
click node_setup_chunks "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/SetupChunksFromCellNames.cs"
click node_wall_swap "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/DestructibleWallSwap.cs"
click node_release_chunk "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/ReleaseChunkOnDamaged.cs"
click node_chunk_budget "https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/ChunkBudgetManager.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_blender_cells,node_blender_circle,node_blender_tour,node_unity_user toneBlue
class node_add_core,node_assign_refs,node_fill_groups,node_setup_chunks toneAmber
class node_wall_swap,node_release_chunk,node_chunk_budget toneMint
class node_artist,node_health toneIndigo
```

## Components

### Blender Prep

- [Cell Parenting](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/Text.001.py): `blender/Text.001.py`
- [Circle Parenting](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/circle_script_to_parent.py): `blender/circle_script_to_parent.py`
- [Tower Parenting](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/blender/CylinderLongTour_script_to_parent.py): `blender/CylinderLongTour_script_to_parent.py`

### Unity Setup

- [Add Core Components](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AddBreakableCoreComponents.cs): `unity/Editor/AddBreakableCoreComponents.cs`
- [Assign Intact Refs](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/AssignIntactRefsTools.cs): `unity/Editor/AssignIntactRefsTools.cs`
- [Fill Fractured Groups](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs): `unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs`
- [Setup Cell Chunks](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Editor/SetupChunksFromCellNames.cs): `unity/Editor/SetupChunksFromCellNames.cs`

### Destruction Runtime

- [Intact-Fracture Swap](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/DestructibleWallSwap.cs): `unity/Runtime/DestructibleWallSwap.cs`
- [Chunk Release](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/ReleaseChunkOnDamaged.cs): `unity/Runtime/ReleaseChunkOnDamaged.cs`
- [Chunk Budget Manager](https://github.com/metaorbe/poc_destructableenv-tools/blob/main/unity/Runtime/ChunkBudgetManager.cs): `unity/Runtime/ChunkBudgetManager.cs`

### Other components

- **Environment Artist**
- **Unity Editor User**
- **Health Damage Events**

## Connections

- Environment Artist → Cell Parenting: runs preparation (evidence: `blender/Text.001.py`)
- Environment Artist → Circle Parenting: runs preparation (evidence: `blender/circle_script_to_parent.py`)
- Environment Artist → Tower Parenting: runs preparation (evidence: `blender/CylinderLongTour_script_to_parent.py`)
- Environment Artist → Unity Editor User: imports FBX (evidence: `README.md`)
- Unity Editor User → Add Core Components: selects objects (evidence: `unity/Editor/AddBreakableCoreComponents.cs`)
- Unity Editor User → Assign Intact Refs: assigns references (evidence: `unity/Editor/AssignIntactRefsTools.cs`)
- Unity Editor User → Fill Fractured Groups: selects intact mesh (evidence: `unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs`)
- Unity Editor User → Setup Cell Chunks: selects parent (evidence: `unity/Editor/SetupChunksFromCellNames.cs`)
- Add Core Components → Intact-Fracture Swap: adds component (evidence: `unity/Editor/AddBreakableCoreComponents.cs`)
- Assign Intact Refs → Intact-Fracture Swap: sets references (evidence: `unity/Editor/AssignIntactRefsTools.cs`)
- Fill Fractured Groups → Intact-Fracture Swap: fills groups (evidence: `unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs`)
- Setup Cell Chunks → Chunk Release: adds component (evidence: `unity/Editor/SetupChunksFromCellNames.cs`)
- Intact-Fracture Swap → Health Damage Events: subscribes damage (evidence: `unity/Runtime/DestructibleWallSwap.cs`)
- Chunk Release → Health Damage Events: subscribes damage (evidence: `unity/Runtime/ReleaseChunkOnDamaged.cs`)
- Health Damage Events → Intact-Fracture Swap: raises damage event (evidence: `unity/Runtime/DestructibleWallSwap.cs`)
- Health Damage Events → Chunk Release: raises damage event (evidence: `unity/Runtime/ReleaseChunkOnDamaged.cs`)
- Chunk Release → Chunk Budget Manager: registers released chunks
