How To

Installation:

Typical Workflow

1. Select your Reference (armature) and Targets (feet).

2. Pick Axis, set Ground Value (0.0 for most rigs), adjust Tolerance if needed.

3. Define Frame Range and Bake Step.

4. If you see pops at contact boundaries, set Trim Contact Range (e.g., Start=1, End=1).

5. Click Bake. Base action is pushed to NLA if needed; a Combine overlay is created and pinned per contact.

Parameters in UI

• Reference
  The object that defines the local space and up axis (typically the armature). Contact segments are measured in this space.

• Axis
  Local up-axis used for contact detection (e.g., Z).

• Ground Value
  Local value that counts as “on the ground”. Default 0.0.

• Tolerance
  Allowed deviation from Ground Value for detection. Default 0.001.
  Increase value if keys are not precisely on a flat curve.

• Targets
  One or more bones/objects to pin (e.g., foot.L, foot.R). Each target is processed independently.

• Frame Range
  Start/End frames to bake.

• Bake Step
  Key spacing inside detected contact segments (detection itself still scans per frame). Default = 1.

• Trim Contact Range
  Shorten pinned segments to soften transitions if the source walk has keys right at the boundary or slides on entry/exit.

  • Start: drop N frames at the beginning of each contact segment.

  • End: drop N frames at the end of each contact segment.
    Note: trimming may slightly increase sliding within the trimmed tails/heads but reduces visible pops.

• Mode

  • Bake New Action (Non-Destructive): Creates a new overlay action (Combine, Extrapolation Nothing). Base stays untouched in NLA.

  • Bake Override (Destructive): Writes keys directly to the target (use when you need final, baked data).