Capsule
A capsule — a cylindrical body with a hemispherical cap at each end.
Capsule is a cylindrical body capped with a hemisphere at each end — character proxies, pills, grips.
Geometry
Height is the height of the cylindrical body alone. The overall height is Height + Radius × 2.
The pivot sits at the base of the cylindrical body, so the lower hemisphere hangs Radius below the pivot. To stand a capsule exactly on the ground, raise the object by Radius or adjust the pivot.
Sides divides the circumference, Rings divides the hemispherical caps and Height Segments divides the cylindrical body.
Parameters
| Label | Script key | Default | Range | Description |
|---|---|---|---|---|
| Radius | r | 0.5 | 0.01 ~ 1000 | Radius in meters — also the radius of the caps |
| Height | h | 1 | -1000 ~ 1000 | Height of the cylindrical body, in meters |
| Height Segments | seg | 1 | 1 ~ 128 | Divisions along the body height |
| Sides | sides | 12 | 3 ~ 128 | Divisions around the circumference |
| Rings | rings | 6 | 2 ~ 128 | Ring divisions in each hemispherical cap |
The script key for Height Segments is seg (canonical name segments). It is one of the few parameters whose Inspector label and key differ.
How to create
-
Drag in empty space to set the radius.
-
Click to confirm, then move the mouse up to set the body Height.
-
Click again to finish.
Scene view editing
The ±X and ±Z handles drive Radius and the ±Y handles drive Height (the body). Growing Radius also grows the caps, which increases the overall height.
Tips
When matching Unity's Capsule Collider, mind the difference: Unity's Height is the overall height, while this shape's Height is the body only.
If the capsule is only a collision proxy, turn on Collider Mode — no render mesh is built and only a Capsule Collider remains.
Script
In a script this shape is written as capsule.
capsule "Pill" r=0.15 h=0.4 @0,0,0
capsule "PlayerProxy" r=0.3 h=1.2 collider=1 @2,0,0
See also — Shape Type List · Creating Shapes and Modes · Scene Script Syntax