Barrel
Every setting of the barrel in Souls Prop Builder, as the panel shows it.
Stave barrel: bulged staves, metal or rope hoops, top and bottom heads. Each stave, hoop and head board breaks off on its own in SDF.
Dimensions
| Setting | What it does |
|---|---|
| Height | Height of the barrel in cm, from the ground to the top rim (at least 10). Staves, hoops and heads are all placed from it. |
| End diameter | Outside diameter of both ends, top and bottom, in cm (at least 6). The middle is wider by the Bulge. |
| Bulge | Widest diameter divided by the end diameter (1 to 1.6). The staves curve out evenly to the widest point at mid height; 1 = straight sides. |
Staves
| Setting | What it does |
|---|---|
| Staves | How many staves go around (6 to 48). More staves give a rounder wall and narrower boards. |
| Thickness | Thickness of each stave in cm, measured inward from the outside. It never goes past 45% of the end radius (bottom radius on a bucket). |
| Gap | Space between two neighbouring staves, in cm. 0 = staves tight against each other. |
| Width variation | Makes the staves unequal in width (0 to 0.5): each one is up to this share wider or narrower than the average, set by the seed. The head boards vary the same way. |
| Segments | Sections along the height of each stave (2 to 24). More segments follow the bulge more smoothly but add triangles; a straight bucket needs few. |
| Uneven top | Each top corner of each stave ends up to this many cm below the rim, at random (seed driven), so the top is cut askew like an old barrel. 0 = all level. |
| Uneven bottom | Each bottom corner of each stave starts up to this many cm above the ground, at random (seed driven). 0 = all staves stand flat on the ground. |
Hoops
| Setting | What it does |
|---|---|
| Hoop type | Metal: a flat iron band hugging the staves, with optional nails. Rope: a twisted rope ring, set by Strands, Twist and the Rope look. |
| Count | How many hoops (0 to 8). Changing it puts every hoop back on the automatic layout for that count; then move each one with its own height slider. |
| Segments | Metal: 0 = one flat side per stave, lying flat on it; higher = a rounder band with that many sides. Rope: at least this many sections around the ring (the twist may need more). |
| Width | Metal: height of the band along the barrel, in cm. Rope: diameter of the rope, in cm. |
| Thickness | Thickness of the metal band in cm, how far it stands out from the staves. |
| Nails | A dome nail head on every metal hoop over the middle of each stave still there at that height. Band and nails stay one piece for SDF. |
| Nail head | Diameter of the nail heads in cm. Never wider than 90% of the band’s width. |
| Reset hoop heights | Puts the hoops back on the automatic heights for their count, then rebuilds if Live update is on. |
| Rope | Modeled: round strands in the geometry. Game: a light tube with one crest and groove per strand; a tiling normal map made by the add-on draws the strands (written next to the FBX for Unreal). |
| Strands | How many strands are twisted together in the ropes (2 to 8): rope hoops and the ropes laid over a barrel. The bucket’s rope bail has its own, under Handle. |
| Twist | How tightly the strands wind: turns per rope diameter of length (0 to 1). A rope ring always closes on a whole number of turns. |
| Strand sides | Roundness of each strand of the modeled rope (3 to 16). More sides, rounder strands, more triangles. |
| Low poly + high poly | Ropes become plain 8-sided tubes. A hidden <name>_high copy keeps the twisted ropes; Export low + high writes both FBX to bake them in Painter (By Mesh Name). |
Heads
| Setting | What it does |
|---|---|
| Top head | Closes the top with boards laid side by side, set the Inset below the rim. Off: the barrel is open. |
| Bottom head | Closes the bottom with boards laid side by side, set the Inset above the bottom rim. |
| Inset | How far each head sits inside the staves, in cm from its rim (the top head below the top rim, the bottom one above the bottom rim). |
| Thickness | Thickness of the head boards in cm. |
| Board width | Rough width of each head board in cm, when Count is 0: the head is split into as many boards as fit, so they come close to it. They vary with the stave width variation. |
| Gap | Space between two head boards, in cm. |
| Count | How many boards make each head (0 to 40). 0 = automatic, from the board width. |
| Angle | Turns the direction of the head boards around the barrel’s axis, in degrees. |
Ropes & cloth
| Setting | What it does |
|---|---|
| Rope wraps | Bands of rope turns thrown around the barrel over the hoops and cloth. Each turn leans its own way (seed driven); turns that touch or cross blend into one piece. |
| Rope width | Diameter of the wrapped rope, in cm (0.5 to 8). |
| Bottom band | Height of the lower band’s first turn, as a share of the barrel’s height (0 = ground, 1 = rim). The other turns stack above it. |
| Bottom turns | Rope turns in the lower band (0 to 12). 0 = no lower band. |
| Top band | Height of the upper band’s first turn, as a share of the barrel’s height (0 = ground, 1 = rim). The other turns stack above it. |
| Top turns | Rope turns in the upper band (0 to 12). 0 = no upper band. |
| Rope lashing | Ropes running up one side, over the rim, across the top through the centre and down the other side. With wraps on, their ends tuck under the lowest turn. |
| Ropes | How many lashing ropes cross at the centre of the top (1 to 6), spread evenly around the barrel. |
| Rope width | Diameter of the lashing ropes, in cm (0.5 to 8). |
| Angle | Turns the whole lashing around the barrel, in degrees. The seed adds its own small turn on top. |
| Crossing blend | Where two laid ropes cross (0 to 1): 0 = one passes fully over the other, 1 = both at the same level, 0.5 = a slight bump. Crossing ropes are fused into one piece. |
| Strands | How many strands are twisted together in the ropes (2 to 8): rope hoops and the ropes laid over a barrel. The bucket’s rope bail has its own, under Handle. |
| Twist | How tightly the strands wind: turns per rope diameter of length (0 to 1). A rope ring always closes on a whole number of turns. |
| Strand sides | Roundness of each strand of the modeled rope (3 to 16). More sides, rounder strands, more triangles. |
| Cloth cover | A torn square cloth over the top: it lies on the head, rolls over the rim and falls down the staves in folds, pressed under the ropes. Procedural, no simulation. |
| Size | Side of the square cloth, as a multiple of the barrel’s rim diameter (0.8 to 2.5). Bigger reaches further down the sides, up to the Drop. |
| Drop | How far down the sides the cloth may hang, as a share of the barrel’s height (0.05 to 0.9). Below that line it is torn off. |
| Tear | How torn the cloth is (0 to 1): ragged borders and long torn tongues at the hem. 0 = clean square edges and a straight hem. |
| Holes | Holes worn through the cloth near its border (0 to 12), placed by the seed. |
| Thickness | Thickness of the cloth in cm (0.05 to 1). It is a closed shell, one solid piece for SDF, growing outward from the barrel. |
| Cloth seed | Another throw of the cloth: a new offset, turn, folds, tears and holes, the barrel unchanged. |
| Rope | Modeled: round strands in the geometry. Game: a light tube with one crest and groove per strand; a tiling normal map made by the add-on draws the strands (written next to the FBX for Unreal). |
| Low poly + high poly | Ropes become plain 8-sided tubes. A hidden <name>_high copy keeps the twisted ropes; Export low + high writes both FBX to bake them in Painter (By Mesh Name). |
Damage
| Setting | What it does |
|---|---|
| Missing staves | How many staves are removed, picked at random (never the bucket’s ears). Nails over a missing stave go with it. |
| Broken staves | How many staves are snapped across, picked at random (never the bucket’s ears): the part kept stands on the ground or hangs from the top. |
| Kept length | Share of its height a broken stave keeps (0.2 to 0.9). |
Last updated: 2026-11-09