# Idle Sway Settings

FocalRig uses the same **Idle Sway Settings** for subtle motion while the character is standing still or moving slowly.

Nodes that use Idle Sway:
- [Aim Weapon](aim-weapon.md)
- [First Person Camera Control](first-person-camera-control.md)

Each axis runs at a different frequency ratio so the motion does not visibly loop in a short pattern. The effect fades out as movement speed increases.

## Properties

| Property | Type | Description |
|----------|------|-------------|
| Frequency | float (Hz) | Base oscillation frequency |
| Frequency Multipliers | [Frequency Multipliers](#frequency-multipliers) | Per-axis frequency multipliers relative to **Frequency** |
| Vertical Amplitude | float (cm) | Vertical position sway amplitude |
| Horizontal Amplitude | float (cm) | Horizontal position sway amplitude |
| Pitch Amplitude | float (deg) | Pitch rotation sway amplitude |
| Yaw Amplitude | float (deg) | Yaw rotation sway amplitude |
| Roll Amplitude | float (deg) | Roll rotation sway amplitude |
| Phase Offset | float | Phase offset relative to the sway cycle (0 to 1, one full cycle) |
| Speed Range | Range (cm/s) | Speed range over which sway intensity fades from 1 to 0 |
| Speed Source | [Idle Sway Speed Source](#idle-sway-speed-source) | Where to read the current movement speed from |
| Manual Speed | float (cm/s) | Movement speed used when **Speed Source** is **Manual** |
| Intensity Smoothing | [Smoothing Settings](smoothing.md) | Smoothing for sway intensity so it does not snap on and off |
| Weight Multiplier While Falling | float | Multiplier applied while the character is falling or jumping |
| Weight | float | Overall sway weight (0 = no effect, 1 = full effect) |

## Frequency Multipliers

| Property | Type | Description |
|----------|------|-------------|
| Vertical | float | Multiplier for the vertical position oscillation |
| Horizontal | float | Multiplier for the horizontal position oscillation |
| Pitch | float | Multiplier for the pitch rotation oscillation |
| Yaw | float | Multiplier for the yaw rotation oscillation |
| Roll | float | Multiplier for the roll rotation oscillation |

## Idle Sway Speed Source

| Value | Description |
|-------|-------------|
| **NavMovement** | Auto-detects speed from a movement component that implements `INavMovementInterface` |
| **Manual** | Uses the provided **Manual Speed** value |
