> ## 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).

# Map Inputs to Mouse Actions

Mouse actions support desktop navigation and games that accept mouse input. The available action determines whether PlayAbility expects a digital trigger, a continuous motion source, or an analog axis.

## Before you begin

- Load an editable profile.
- Choose a safe application or empty area of the desktop for the first test.
- Keep a physical mouse or another reliable way to run **Release All** while tuning toggle or continuous actions.

## Map a click or double-click

1. Open **Mapping** and confirm the intended profile is active.
2. Select **Add actions**.
3. Select **Mouse**.
4. Select **Left Click**, **Right Click**, **Middle Click**, or a corresponding double-click action.
5. Select the **Add** button showing the number of selected actions.
6. On the new row, select **Select a trigger**.
7. Choose an existing compatible trigger, or select **Create a new trigger +** and configure one.
8. Choose an **Action Mode**. Use **Default** to hold a mouse button, **Short Press** for a normal click, or **Toggle** only when the button should remain held.
9. Select **Save**.

Use the dedicated double-click action when the target requires a double-click. It sends the two clicks as one action.

## Map scrolling

1. Select **Add actions**, open **Mouse**, and select **Scroll Up** or **Scroll Down**.
2. Add the action and assign a trigger.
3. Choose a scroll mode:
   - **Default** scrolls continuously while the trigger is active.
   - **Toggle** starts continuous scrolling on one activation and stops it on the next.
   - **Single Tick** sends one scroll tick per activation.
4. For **Default** or **Toggle**, adjust **Set scroll speed in pixels** from 1 to 1500 pixels.
5. Select **Save**.

The scroll-distance control is disabled in **Single Tick** mode because that mode always sends one tick.

## Map pointer movement

Choose the movement action that matches the trigger:

- **Mouse Move** provides continuous cursor control from a compatible **Head Motion Mouse** or cursor-stabilizer trigger.
- **Mouse X axis** and **Mouse Y axis** convert compatible analog axes, including physical gamepad axes, into relative cursor movement.
- **Mouse Left**, **Mouse Right**, **Mouse Up**, and **Mouse Down** move continuously in one direction from a digital trigger. Adjust **Set mouse speed in pixels** in the mapping.

To configure movement:

1. Select **Add actions**, open **Mouse**, and add the required movement action or axes.
2. Select **Select a trigger** on each new row.
3. Choose one of the compatible trigger types offered by the editor.
4. Adjust the movement range, deadzone, direction, or speed shown for that mapping.
5. Select **Save**.

The editor filters out trigger types that cannot drive the selected movement action.

## Move the pointer to an exact position

1. Select **Add actions**, open **Mouse**, and add **Mouse Position**.
2. Assign a digital trigger.
3. Under **Mouse Position**, select **Detect Position**.
4. Move the pointer to the required location and hold it still for one second.
5. Confirm the recorded X and Y coordinates.
6. Select **Test Position** to check the destination.
7. Select **Save**.

You can also enter X and Y coordinates directly. The valid range is based on the display detected by PlayAbility.

## Enable and verify mouse output

1. Turn on **Main Output** using PlayAbility's play/pause control.
2. Confirm that **Mouse Out** is active in the Controls area.
3. If using head-controlled pointer movement, also confirm that **Head Mouse Output** is active.
4. Activate the trigger in a safe test area.
5. Confirm that the button releases, scrolling stops, or movement returns to rest as expected.
6. Test the result in the target game or application.

## Troubleshooting and limitations

### The mapping responds but the pointer does not

- Turn on **Main Output** and **Mouse Out**.
- For head mouse, also turn on **Head Mouse Output** and confirm face detection is running.
- Check whether foreground-app rules are blocking effective output.
- Test in a desktop application to isolate a game-specific input issue.

### Mouse Move cannot use the trigger you want

Continuous **Mouse Move** accepts only compatible motion sources. Use **Mouse Left**, **Mouse Right**, **Mouse Up**, or **Mouse Down** for a digital trigger, or map **Mouse X axis** and **Mouse Y axis** from compatible analog axes.

### Scrolling does not stop

The mapping is probably in **Toggle** mode. Activate the trigger again, or run **Release All**. Use **Default** if scrolling should stop as soon as the trigger becomes inactive.

### A mouse button remains held

Run **Release All**. Then change a **Toggle** mapping to **Default** or **Short Press** unless a latched drag is intentional.

### Mouse Position goes to the wrong place

- Run **Detect Position** again on the display you intend to use.
- Confirm the X and Y values with **Test Position**.
- Re-record the position after changing display arrangement, resolution, or scaling.

### Movement is too fast, slow, or unstable

Edit the mapping and adjust its speed, movement range, or deadzone. For gaze or head-controlled pointing, configure cursor stabilization separately before increasing speed.

### The target game ignores mouse output

Verify the action on the desktop first. If it works there but not in the game, the game may block simulated mouse input because of its input API, exclusive-fullscreen mode, or anti-cheat.

## Related articles

- [Use Head Tracking as a Joystick or Mouse](https://help.playability.gg/en/article/use-head-tracking-as-a-joystick-or-mouse-2w0l5d/)
- [Use Dwell Controls and Cursor Stabilization](https://help.playability.gg/en/article/use-dwell-controls-and-cursor-stabilization-1qoef8a/)
- [Mute Physical Mouse and Keyboard Input on Windows](https://help.playability.gg/en/article/mute-physical-mouse-and-keyboard-input-on-windows-1kzzhxk/)