This mod fixes the cursor centering issue that occasionally happens when opening a GUI, e.g. open a container GUI but the cursor doesn’t appear from the center which could be dangerous when you need to pull something from a chest or inventory rapidly.<\/p>\n
# For Wayland Users
\nThis mod supports centering the cursor on wayland using ydotool (an automation tool on wayland), to enable this feature, you need to configure this tool properly, here are the basic setup steps:
\n## 1. Install ydotool from source
\nThe latest version of ydotool provides seamless centering experience, however it can only be built and installed from source at the moment (the mod was using an outdated ydotool previously). <\/p>\n
To build an install it, just execute these commands in terminal under any directory:
\n“`
\n\/\/install command may vary on different platforms
\nsudo apt install git cmake scdoc<\/p>\n
git clone https:\/\/github.com\/ReimuNotMoe\/ydotool.git To determine this value, run the game with this mod and open any container GUI, the mod will center the cursor using default scaling value (1.0), then keep your cursor at that position and take out your ruler, put it on your monitor to measure its **absolute** position, record `x` or `y` as `x1` or `y1`. Next, keep the position of your game window and determine the *actual* central point, also measure its absolute position with your ruler, record `x` or `y` as `x2` or `y2`, then the scaling value should be `x2 \/ x1` or `y2 \/ y1`. **Note that the game window is better to be small (1\/2 screen width\/height is ok) and close to top-left to ensure the cursor will not go outside the screen, or its position is not reliable (be constrained to screen border)**. This step can also be done by taking screenshots and measuring the position using a painting software that displays pixel coordinates, which is more accurate. You can round the value if necessary.<\/p>\n After determining the scaling value, you can restart the game with a JVM argument `-DcursorMoveScalingValue= A Minecraft mod that fixes the cursor centering issue that occasionally happens when opening a GUI.<\/p>\n","protected":false},"featured_media":52595,"template":"","meta":{"_minecraft_slug":"cursorcentered-fix","_minecraft_project_id":"3Vf97jLY","_minecraft_author":"LitnhJacuzzi","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":347968,"_minecraft_follows":71,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"cursorcentered-fix.zip","_minecraft_size_bytes":47758,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T18:22:45.737396Z","_minecraft_date_created":"2023-04-07T03:22:54.894615Z","_minecraft_date_modified":"2026-04-08T13:39:21.298607Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cursorcentered-fix","_minecraft_icon_attachment_id":52595,"_minecraft_imported_at":"2026-06-02T21:38:39+00:00","_minecraft_import_hash":"bd901143af1b72039d786b315b3a4fe7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,158,92],"mod_loader":[99,106],"minecraft_version":[110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-52594","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-neoforge","mod_category-utility","mod_loader-fabric","mod_loader-forge","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\ncd ydotool
\nmkdir build
\ncd build
\ncmake ..
\nmake -j “$(nproc)”
\nsudo make install
\n“`
\nRunning `ydotoold -V` to verify your installation.
\n## 2. Add your user to sudo exceptions
\nThe **only** way to successfully center the cursor using ydotool in Minecraft is running ydotool command with `sudo` privilege. Thus you need to **make your user be able to run ydotool command with sudo without password**: edit \/etc\/sudoers, add two lines:
\n“`
\n
\n
\n“`
\n## 3. Specify a move scaling value (Optional)
\nThere is an internal problem of moving cursor on wayland programmatically – the actual moved position may be affected by some system values depending on your desktop environment. In other words, **the default centering position is guaranteed correct only with default mouse sensitivity and mouse acceleration disabled (also requires default UI scale in some desktop environments)**. Fortunately, the requested position and actual position seem to always satisfy a liner function relationship, so we can use a `double` factor to correct it.<\/p>\n