GreyFox Studio · Blender
Souls Prop Builder
Souls-like props built piece by piece in Blender, ready to break in Unreal Engine with Souls Destruction Framework.
- Blender 4.5
- Blender 5.1
- Python
- Procedural Props
- SDF Ready
- Packed UVs
- FBX for Unreal
Designed for dark fantasy and souls-like environments: cellars, camps, crypts, roadsides, execution grounds.
Made for Souls Destruction Framework
Souls Prop Builder is the Blender companion of Souls Destruction Framework, GreyFox Studio’s destruction framework for Unreal Engine 5.7 and 5.8, available on Fab. Every prop leaves Blender ready to break piece by piece in Souls Destruction Framework — nothing to clean up, nothing to split by hand.
Overview
Souls Prop Builder is a Blender add-on that builds souls-like props from a handful of settings. Every board, stave, post, hoop, bar and plate is modeled as its own closed piece inside one mesh, so the prop breaks piece by piece in Unreal Engine with Souls Destruction Framework, or with any system that breaks a static mesh along its geometry islands.
Pick a prop -> Build Prop -> Tune it live -> Break a few pieces -> Export FBX -> Break it in Souls Destruction Framework
Made for Souls Destruction Framework
Souls Destruction Framework breaks a prop along its geometry islands: one island, one body. Souls Prop Builder builds every prop for exactly that, and checks it after every build and again at export:
- every board, stave, plank, bar and plate is its own closed piece — one island, one body in SDF
- where a tenon, a rail end or a bar end fits into another piece, that piece gets a real socket with 0.5 mm of play, so no two bodies start inside each other
- no two pieces come within 0.5 mm of each other, so SDF never welds them back together
- small hardware is fused into the piece it holds (rivets, nail heads, rings under 15 cm³) instead of flying off alone
- damaged props stay ready: missing and broken pieces keep every rule above
- the status line ends with SDF-ready when nothing is left to resolve
Build the prop, export the FBX, import it in Unreal Engine and set it up in Souls Destruction Framework: it breaks board by board, stave by stave, bar by bar.
Features
Fourteen props
| Prop | What you get |
|---|---|
| Crate | Corner posts and rails, boards on every side, lid, floor, braces, metal caps and straps |
| Barrel | Bent staves, metal or rope hoops, board heads, nails |
| Explosive barrel | A nailed barrel lashed with ropes under a torn cloth |
| Bucket | Tapered staves, hoops, a floor, and an iron bail or a laid rope knotted outside two ears |
| Pillory | Forked posts on sled feet, two boards with head and hand holes, hinge and hasp |
| Table | Trestle table: plank top, splayed legs, braces, a keyed stretcher |
| Bench | Thick seat, leaning legs tenoned through it, foot rails and stretcher |
| Church pew | Shaped ends with rosettes, paneled back with gothic openings, book shelf |
| High-back chair | Turned legs, framed back, crest, finials and arms |
| Ceramic pot | Amphora, jar or vase, in one shell or already cut into shards |
| Cart | Plank bed, side boards and posts, spoked wheels, shafts, chains |
| Barricade | Rough log posts, nailed planks, a diagonal batten and stakes |
| Coffin | Gothic, planked or rough, with lid planks, cross, cleats, rope and handles |
| Gibbet cage | Two-piece iron bars under a neck ring, riveted hoops, floor, hat and chain |
Damage
- missing and broken pieces by count, per prop: boards, staves, planks, spokes, bars, hoops…
- a random share on top, with a pattern you can reroll
- broken wood ends in splinters, broken iron ends torn and thinned; damaged props stay ready for Souls Destruction Framework
Ready to texture and export
- Generate UV map: one packed, non-overlapping layout at one texel density, flat faces laid flat
- Export UV map: the layout as a PNG (1K to 8K), colored by material
- Export FBX for Unreal Engine: one static mesh in centimeters, -Z forward / Y up, material slots
M_SPB_Wood,M_SPB_Metal,M_SPB_Rope,M_SPB_Cloth,M_SPB_Ceramic - light game ropes with a twisted high-poly twin and a low/high FBX pair for baking in Substance 3D Painter
- every setting saved to a JSON recipe, to build the same prop again or share it
Its own panel
A dark card with gold accents in the Souls Prop tab of the 3D Viewport sidebar: prop tiles, collapsible sections, sliders and switches. Rest the mouse on any control for half a second and an info card explains what it does, with a small picture. Prefer Blender’s own panels? Turn on Classic panels in the add-on preferences.
How it works
- In the Souls Prop tab, click a prop tile.
- Set its size in centimeters and press Build Prop.
- With Live update on, every change rebuilds the prop in place; New seed gives another variation with the same settings.
- Open Damage to remove or break pieces.
- Export FBX: the texturing UV map is made for you.
- Import it in Unreal Engine and break it with Souls Destruction Framework.
Requirements
| Blender | 4.5 LTS or newer — tested on Blender 4.5.9 LTS and 5.1 |
| Platforms | Windows, macOS, Linux (pure Python, nothing else to install) |
| Units | Sizes in the panel are in centimeters |
| Installation | Edit > Preferences > Get Extensions > Install from Disk, pick the zip |
| Destruction in Unreal | Souls Destruction Framework — Unreal Engine 5.7 and 5.8, available on Fab |
Polygon budget
Faces of each prop with its default settings, as built:
| Prop | Faces | Pieces |
|---|---|---|
| Crate | 385 | 44 |
| Barrel | 1,662 | 34 |
| Bucket | 537 | 18 |
| Coffin | 1,203 | 11 |
| Bench | 1,543 | 8 |
| Table | 1,977 | 19 |
| Pillory | 3,045 | 14 |
| Barricade | 4,395 | 11 |
| Ceramic pot | 6,150 | 1 |
| High-back chair | 11,685 | 27 |
| Gibbet cage | 12,299 | 30 |
| Cart | 13,719 | 64 |
| Church pew | 25,437 | 28 |
| Explosive barrel | 32,173 | 35 |
Scope limitation
Souls Prop Builder builds geometry, material slots and a packed UV map; it does not make textures. The image analysis (turning a reference picture into settings) reads crates, barrels and buckets only, and needs your own Anthropic API key. Tested on Blender 4.5.9 LTS and 5.1.
FAQ
Do I need Souls Destruction Framework? No, but it is what Souls Prop Builder is made for. The FBX is a standard static mesh: any engine imports it, and any destruction system that breaks a mesh along its islands uses the pieces as they are. With Souls Destruction Framework, the props break piece by piece with no extra work.
Do I need internet? No. Only the optional image analysis calls the Anthropic API, with your own key.
Can I edit a prop by hand after building it? Yes, it is a normal mesh. Turn Live update off first, or the next setting change rebuilds it.
Can I sell games or assets that use props made with Souls Prop Builder? Yes. The meshes you make with Souls Prop Builder are yours, for personal and commercial projects.