How metaorbe/poc_destructableenv-tools works
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: DestructibleWallSwap.cs Intact-Fracture Swap · ReleaseChunkOnDamaged.cs Chunk Release · AddBreakableCoreComponents.cs Add Core Components · AssignIntactRefsTools.cs Assign Intact Refs
Components 13
Blender Prep
- Cell Parenting
blender/Text.001.py - Circle Parenting
blender/circle_script_to_parent.py - Tower Parenting
blender/CylinderLongTour_script_to_parent.py
Unity Setup
- Add Core Components
unity/Editor/AddBreakableCoreComponents.cs - Assign Intact Refs
unity/Editor/AssignIntactRefsTools.cs - Fill Fractured Groups
unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs - Setup Cell Chunks
unity/Editor/SetupChunksFromCellNames.cs
Destruction Runtime
- Intact-Fracture Swap
unity/Runtime/DestructibleWallSwap.cs - Chunk Release
unity/Runtime/ReleaseChunkOnDamaged.cs - Chunk Budget Manager
unity/Runtime/ChunkBudgetManager.cs
Other components
- Environment Artist
- Unity Editor User
- Health Damage Events
Connections 17
- Environment Artist → Cell Parenting: runs preparation
blender/Text.001.py - Environment Artist → Circle Parenting: runs preparation
blender/circle_script_to_parent.py - Environment Artist → Tower Parenting: runs preparation
blender/CylinderLongTour_script_to_parent.py - Environment Artist → Unity Editor User: imports FBX
README.md - Unity Editor User → Add Core Components: selects objects
unity/Editor/AddBreakableCoreComponents.cs - Unity Editor User → Assign Intact Refs: assigns references
unity/Editor/AssignIntactRefsTools.cs - Unity Editor User → Fill Fractured Groups: selects intact mesh
unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs - Unity Editor User → Setup Cell Chunks: selects parent
unity/Editor/SetupChunksFromCellNames.cs - Add Core Components → Intact-Fracture Swap: adds component
unity/Editor/AddBreakableCoreComponents.cs - Assign Intact Refs → Intact-Fracture Swap: sets references
unity/Editor/AssignIntactRefsTools.cs - Fill Fractured Groups → Intact-Fracture Swap: fills groups
unity/Editor/FillFracturedGroupsFromP_SelectedIntact.cs - Setup Cell Chunks → Chunk Release: adds component
unity/Editor/SetupChunksFromCellNames.cs - Intact-Fracture Swap → Health Damage Events: subscribes damage
unity/Runtime/DestructibleWallSwap.cs - Chunk Release → Health Damage Events: subscribes damage
unity/Runtime/ReleaseChunkOnDamaged.cs - Health Damage Events → Intact-Fracture Swap: raises damage event
unity/Runtime/DestructibleWallSwap.cs - Health Damage Events → Chunk Release: raises damage event
unity/Runtime/ReleaseChunkOnDamaged.cs - Chunk Release → Chunk Budget Manager: registers released chunks