AgentFoundrySign in ↗
← All examples

blender tools

Barrel from bulged staves, hoops and heads

Generate a cooper-style barrel: separate bulged staves with gaps, iron hoops that follow the bilge and recessed head discs, each a closed solid with its own material slot, plus the outer volume in litres. Use it for taverns, cellars, ships and game props.

Recorded render of Barrel from bulged staves, hoops and heads

What this component contains

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • barrel_staves.py
  • component.json
  • graphcheck.py
  • meshcheck.py
  • preview.png
  • test_barrel_staves.py
  • test_package.py
  • verification/native.json

How it works

Operator
baltor.barrel_staves
Parameters
height, head_radius, bilge_radius, staves, stave_thickness, gap, rows, hoops and 2 more
Result
One mesh object named Barrel with stave, hoop and head material slots.
Blender
4.2 or later
Axes
Blender Z up, -Y forward
Units
metres

Recorded checks

blender 5.2.1 LTS (hash 9e2066aef7ef built 2026-08-25 02:12:34)

  • addon_install_and_enable
  • operator_runs_with_defaults
  • blender_data_matches_core
  • addon_disable_unregisters
  • script_mode_runs
  • clean_reopen_addon_file
  • clean_reopen_script_file
  • gltf_separate_export
  • engine_output_clean

Limits to consider

The bilge is a parabola in height, not a measured cooperage curve. Staves are faceted (one chord per stave across its width) and have no bevel, chime chamfer or bung hole. Hoops are plain rectangular bands with no rivets. The volume is the outer volume from the profile, not the inner capacity. Verified in Blender 5.2.1; written for the 4.2 API.