# Physics

Character Assembly prepares supported grooms for hair simulation using Geometry Nodes and Blender's XPBD solver. Physics controls apply to the character selected in Rig Instances.

Canonical URL: https://docs.polyhammer.com/blender-addons/character-assembly/0.4.3/physics
Product: character-assembly
Version: 0.4.3
Channel: production
Updated: 2026-11-21T13:45:20Z
Documentation source: initial main snapshot approved 2026-11-21T13:45:20Z
Documentation commit: d87da04962b36aa48df302d706fa045807534a82
Release tag commit: 7f33482b572edc96905957c6837b3a8f39d9699b
Owner-approved migration baseline: use current main documentation for the current stable release once; all subsequent releases use their tag snapshots.

Character Assembly prepares supported grooms for hair simulation using Geometry Nodes and Blender's
XPBD solver. Physics controls apply to the character selected in **Rig Instances**.

[Video: MetaHuman hair simulation in Blender](https://docs.polyhammer.com/docs-assets/character-assembly/20394717e939172fa06f7afd81da4a3da899959e9d98df33f97239af33467f49/images/physics/hair-simulation.webm)

## Enable Hair Simulation [#enable-hair-simulation]

1. Open the **Character Assembly** tab and select your character in **Rig Instances**.
2. Enable the checkbox in the **Physics** panel header.
3. Play from the scene's start frame to preview the simulation.

Until you bake, hair simulation is calculated as the animation plays. Jumping directly to a later
frame does not calculate the frames before it.

If the panel says **No groom on this character can be simulated**, the imported character has no
simulation guides available. Check that the export includes a groom with simulation data and that
**Hair** was enabled during import.

## Bake the Simulation [#bake-the-simulation]

1. Save your `.blend` file.
2. Set the scene's start and end frames to the animation range.
3. Set **Warm-up Frames** if the hair needs time to settle before the first frame.
4. Click **Bake Simulation** and wait for it to finish.

The bake stores this character's hair simulation on disk beside the saved file. You can then scrub
the timeline freely and render the animation. Keep the bake files with the `.blend` when moving
the project.

After changing animation, physics settings, or collision, click the trash button beside
**Bake Simulation** (**Delete Bake**), then bake again.

## Custom Collision [#custom-collision]

Assembly assigns an automatic collision mesh. In the import dialog, **Collision Source** selects **Body, Head and Outfit** (default), **Body and Head**, or **Head Only**. Reapplying the manifest and rebuilding collision detail retain that character's choice.

To use your own:

1. Prepare a mesh covering the surfaces the hair should collide with. Keep it simple to reduce
   simulation cost, and make sure it follows the character where needed.
2. Select the character and expand **Physics > Collision**.
3. Choose your mesh in the object picker.
4. Adjust **Margin**, preview the motion, and re-bake.

The selected mesh replaces the collider assignment for this character's simulated grooms. Clearing
the picker removes that assignment; it does not restore the automatic collider.

## Settings [#settings]

| Control | What it does |
| --- | --- |
| **Stiffness** | Higher values hold the hair closer to its authored shape; lower values allow more movement. |
| **Gravity Preloading** | Higher values treat the authored shape as already settled under gravity. Lower values let it sag further. |
| **Warm-up Frames** | Simulate extra frames before the animation starts so the hair can settle. |
| **Margin** | Set the clearance between the hair and collision mesh. |
| **Edge Contacts** | Catch strands crossing a collision face between simulation steps. More accurate, but slower. |

## Groom Groups and Existing Scenes [#groom-groups-and-existing-scenes]

New schema V2 exports keep each Unreal hair group's simulation settings and component overrides.
Groups enabled for simulation have independent guide objects, particle counts and caches. Static
strands still follow the attachment surface. Simulation remains off until you enable it in Blender.
The Blender solver has different material and iteration controls from Unreal; source values are
retained, but settings without a measured equivalent are not copied into unrelated Blender controls.

Surface bindings use a dedicated `CA_SurfaceBinding` map, so overlapping texture islands, UV seams
and missing texture UVs do not leave strands behind. The character's texture UVs are preserved.
Every render strand and guide binding is checked against Blender's UV sampler during attachment.

Re-export and re-import existing beta characters to use the corrected group settings and bindings.
Released V1 packages remain importable with their existing flat physics settings. Particle counts
above the validated 16-point limit are clamped with a warning on import.
