Cursor Centered Fix Mod FAQ

Make sure the mod is actually loaded and that you're opening a GUI while the game window has focus. If the window just regained focus, the centering happens on GUI open, so try closing and reopening the GUI.

You need ydotool installed and working, since the mod uses it to move the cursor programmatically. Once ydotool is set up and the mod can call it, cursor centering should work when you open GUIs.

Yes, ydotool typically needs elevated privileges to move the cursor. Configure sudo so the mod can run ydotool without prompting every time, otherwise centering may silently fail.

It corrects how far the cursor moves when the mod centers it, which matters if your system sensitivity or UI scale makes the cursor land off-center. Set it as a JVM argument and adjust until the cursor lands in the middle.

Add -DcursorMoveScalingValue= to your JVM arguments before launching the game. Start with a small value and tweak it based on where the cursor ends up after opening a GUI.

That's the scaling value. Increase or decrease -DcursorMoveScalingValue until the cursor consistently lands in the middle of the GUI on your display setup.

The core centering behavior works on standard desktop platforms, but the Wayland-specific ydotool path is Linux-only. On Windows and macOS you don't need ydotool.

No, it only acts when a GUI opens, so it doesn't run during normal gameplay. Any delay you see is usually from ydotool being slow to respond, not from the mod itself.

The mod centers the cursor when the GUI opens, so if the window regains focus at a bad moment the position can be off. Closing and reopening the GUI usually fixes it.

Yes, it's client-side and works anywhere, including multiplayer and PvP. It's most useful for fast inventory management where an off-center cursor causes misclicks.