CursorCentered Fix

Мод CursorCentered Fix для Minecraft — исправление позиционирования курсора

CursorCentered Fix решает проблему, когда курсор не появляется в центре при открытии интерфейса (GUI). В ванильном Minecraft это может быть опасно при быстром перемещении предметов между сундуками и инвентарем. Мод обеспечивает корректное центрирование курсора при загрузке окон.

Основная функция и ограничения по версиям

Мод CursorCentered Fix решает проблему, при которой курсор не появляется в центре экрана при открытии интерфейса (GUI). Это критично для ситуаций, когда нужно быстро переносить предметы из сундука в инвентарь или наоборот. В ванильном Minecraft начиная с версии 26.3 проблема была полностью устранена благодаря переходу на SDL-бэкенд, поэтому мод больше не будет обновляться для версий игры выше 26.2.

Поддержка Wayland и выбор утилиты

Для пользователей, использующих окружение Wayland, мод поддерживает центрирование курсора через внешние инструменты: ydotool или wdotool. ydotool обеспечивает бесшовный опыт, но на данный момент доступна только в виде исходного кода и работает исключительно с XWayland. Альтернативой является wdotool — активно развиваемый проект, который проще в настройке и позволяет использовать мод как бэкенд, указав соответствующий JVM-аргумент.

Компиляция и установка ydotool

Для работы с ydotool необходимо скомпилировать его из исходного кода. Выполните следующие команды в терминале (путь установки может отличаться в зависимости от платформы):

```bash
sudo apt install git cmake scdoc
git clone https://github.com/ReimuNotMoe/ydotool.git
cd ydotool
mkdir build
cd build
cmake ..
make -j "$(nproc)"
sudo make install
```

После установки проверьте корректность установки командой `ydotoold -V`. Важно помнить, что эта утилита эффективна только в связке с XWayland.

Настройка прав доступа для sudo

Единственный способ корректно центрировать курсор в Minecraft с помощью ydotool — запуск команды с привилегиями sudo. Для этого необходимо добавить вашего пользователя в исключения sudo, чтобы запускать ydotool без ввода пароля. Отредактируйте файл /etc/sudoers и добавьте две строки (путь может отличаться):

```bash
ALL=(ALL) NOPASSWD: /usr/local/bin/ydotoold
ALL=(ALL) NOPASSWD: /usr/local/bin/ydotool
```

Важное замечание о wdotool

Если вы выбираете wdotool, обратите внимание, что при компиляции из исходного кода требуется выполнить дополнительную команду установки: sudo install -m 755 target/release/wdotool /usr/local/bin/wdotool. После настройки утилиту можно использовать как бэкенд мода, указав JVM-аргумент -DuseWdotool= (где — путь к вашему композитору). Подробную инструкцию по конфигурации лучше искать на официальной странице проекта.

Корректировка коэффициента масштабирования

Существует внутренняя проблема при программном перемещении курсора на Wayland: фактическая позиция может зависеть от значений среды рабочего стола. По умолчанию корректное центрирование гарантировано только при отключенной чувствительности мыши и ускорении мыши (а также при стандартном масштабировании UI в некоторых окружениях). Поскольку запрошенная и фактическая позиции всегда удовлетворяют линейной функции, можно использовать коэффициент double для коррекции.

Расчет и применение коэффициента масштабирования

Чтобы найти этот коэффициент, запустите игру с модом и откройте любой контейнер GUI. Мод центрирует курсор со стандартным значением масштабирования (1.0). Зафиксируйте курсор в этой позиции, измерьте его абсолютную координату (x1 или y1) с помощью линейки. Затем определите фактическую центральную точку окна игры, измерьте её абсолютную координату (x2 или y2). Значение масштабирования равно `x2 / x1` или `y2 / y1`. Округлите значение при необходимости. Окно игры лучше держать небольшим (половина экрана) и близко к верхнему левому углу, чтобы курсор не выходил за границы экрана.

После определения коэффициента перезапустите игру с JVM-аргументом `-DcursorMoveScalingValue= `, чтобы применить его. Значение будет корректным, пока вы не измените чувствительность мыши, ускорение или масштабирование UI.

Известная проблема с реальным Wayland

Важно учитывать ограничение: настоящее окно Wayland (не XWayland) не может получить абсолютную позицию на экране. Следовательно, рассчитанная центральная точка будет верна только в том случае, если позиция игрового окна установлена в (0,0).