> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.playability.gg/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Use Dwell Controls and Cursor Stabilization

PlayAbility offers two different profile tools for hands-free pointer use:

- **Dwell** is a trigger. It fires when the system pointer stops moving for the configured time.
- **Cursor Stabilizer** is a filter for continuous **Mouse Motion** output. It smooths jitter and small movements.

These profile tools are separate from the per-button dwell controls inside the on-screen overlay.

## Create a Dwell mapping

1. Load the profile you want to edit.
2. Open its mapping page.
3. Select **Add more actions**.
4. Choose the action that should happen after the pointer stops. For example, choose a mouse click, keyboard key, gamepad button, scroll action, or settings action.
5. Select **Add Actions**.
6. Find the new mapping and choose **Select a trigger**.
7. Select **Dwell**.
8. Set **Dwell Time** between 0.1 and 3 seconds.
9. Select **Use this trigger** or the available add-trigger button to save it.
10. If needed, edit the mapping and choose an action mode such as **Short Press**, **Long Press**, **Double Press**, **Triple Press**, or **Toggle**.

Dwell is a single event, so it does not support **Default** hold mode and normally uses **Short Press**.

## Test Dwell

1. Move the pointer to a safe location.
2. Stop moving it for the configured Dwell Time.
3. Confirm that the mapped action fires once.
4. Move the pointer again to rearm Dwell.
5. Stop at a new position and confirm that it fires again.

Dwell fires once during each stationary period. It will not repeatedly fire until the pointer moves and stops again.

## Important Dwell behavior

- **Dwell Time is global.** Changing it in one Dwell mapping changes the time used by all Dwell mappings.
- If several active mappings use Dwell, the same stationary event triggers all of them.
- Tiny pointer movement restarts the timer. Increase Dwell Time if involuntary movement causes accidental activation or makes timing difficult to predict.
- Toggle mode stays on after one Dwell event and turns off after the next rearmed Dwell event.

Use only one Dwell mapping when you want a single autoclick action. Multiple Dwell mappings are useful only when you want them to fire together.

## Add Cursor Stabilizer

Cursor Stabilizer is offered only for the continuous **Mouse Motion** action.

1. Load the profile you want to edit.
2. Open its mapping page.
3. Select **Add more actions**.
4. Open the **Mouse** tab and select the continuous **Mouse Motion** action.
5. Select **Add Actions**.
6. Find the new Mouse Motion mapping and choose **Select a trigger**.
7. Open the **Mouse** trigger filter and select **Cursor Stabilizer**.
8. Choose a preset:
   - **Low**: least smoothing and the most responsive movement.
   - **Medium**: balanced smoothing and responsiveness.
   - **High**: strongest smoothing, with more noticeable lag.
9. Save the trigger.

The stabilizer mapping enables the filter while that profile is active. It can smooth cursor movement used alongside a physical mouse or supported head-mouse setup.

## Tune and verify Cursor Stabilizer

1. Start with **Medium**.
2. Move the pointer slowly to a small target.
3. Stop and observe whether micro-movements are reduced.
4. Make several fast movements to check that the pointer remains responsive enough.
5. Choose **Low** if movement feels delayed.
6. Choose **High** if stationary jitter is still too strong.

Test with **Main Output** enabled because the stabilizer follows PlayAbility’s effective output state.

## Troubleshooting and limitations

- **Dwell never fires:** Confirm that the active profile contains a Dwell mapping, **Main Output** is enabled, and the pointer becomes completely stationary.
- **Dwell fires an unexpected action:** Check every active Dwell mapping. One stationary event activates all of them.
- **Dwell keeps firing a Toggle action:** Move the pointer to rearm it, then dwell again to toggle the action off. Use **Release All** if you need an immediate reset.
- **Changing one Dwell time changed another mapping:** Profile Dwell Time applies to every Dwell mapping.
- **Cursor Stabilizer is not listed:** Select the continuous **Mouse Motion** action first. It is not available for directional mouse actions, buttons, keyboard actions, gamepad axes, or other outputs.
- **The pointer feels slow:** Use the Low preset.
- **The pointer still jitters:** Try Medium or High, and correct the underlying mouse or head-tracking setup if necessary.
- **Absolute Head Mouse is active:** Its current Absolute mode learns camera noise and performs its own click stabilization. A separate Cursor Stabilizer is paused while Absolute Head Mouse is active so the filters do not compete.
- **You meant dwell on an overlay button:** Configure **Dwell mode** on that on-screen control instead. Overlay dwell has separate timing and action settings.

## Related articles

- [Map Inputs to Mouse Actions](https://help.playability.gg/en/article/map-inputs-to-mouse-actions-1fkp0wl/)
- [Configure Overlay Dwell Actions](https://help.playability.gg/en/article/configure-overlay-dwell-actions-17diwa0/)
- [Accessibility and Appearance Settings](https://help.playability.gg/en/article/accessibility-and-appearance-settings-2tc706/)