Wiki 9Minecraft Wiki 9Minecraft
Cursor Centered Fix Wiki › Guides › Setting Up Wayland Support on Linux

Setting Up Wayland Support on Linux

If you play Minecraft on Linux using the Wayland display protocol, window managers restrict standard background cursor movement. The mod includes experimental Wayland support to programmatically reposition the cursor using the ydotool utility.

Installing ydotool

Because packaged repository versions may vary, set up the utility according to the mod's requirements:

1. Open your terminal.

2. Obtain and compile ydotool directly from source to ensure full compatibility with Wayland input emulation.

3. Confirm that the compiled binary is accessible in your system's execution path.

Configuring Permissions

The mod needs seamless execution permissions to move your cursor without interrupting gameplay:

1. Configure your system's sudo privileges to allow ydotool to execute without prompting for an administrative password every time a screen opens.

2. Start the required background daemon for ydotool if your installation requires an active service.

3. Launch Minecraft in your Wayland session.

4. Open a container, such as a chest or crafting table, to verify that the pointer centers upon opening.

If cursor movement is slightly offset under Wayland, combine this setup with a scaling parameter to match your desktop environment's sensitivity.