Как добавить поддержку контроллера в Minecraft на Linux

В настоящее время Minecraft: Java Edition для Linux не включает встроенную поддержку контроллеров , но вы можете добавить её с помощью клиентского мода для управления контроллером. Для простой и актуальной настройки в этом руководстве используется Fabric Loader с Controlify . Controlify поддерживает Linux через SDL3, работает с Fabric и NeoForge и добавляет ввод с контроллера для игрового процесса, меню, инвентаря, чата, переназначения клавиш, вибрации и других функций.

Что вам нужно

• Рабочая копия Minecraft: Java Edition . Официальный лаунчер поддерживает Linux; при необходимости скачайте его с Minecraft.net .
• Контроллер, который Linux может обнаружить через USB или Bluetooth.
• Загрузчик модов. В этом руководстве используется Fabric, но Controlify также поддерживает NeoForge.
• Файл Controlify, соответствующий как вашей версии Minecraft, так и вашему загрузчику модов.

Прежде чем что-либо менять, сделайте резервные копии важных миров. Также избегайте смешивания файлов модов, созданных для разных версий Minecraft; несоответствие версий — одна из самых распространенных причин сбоев при запуске.

1. Установите Fabric Loader для вашей версии Minecraft.

Сначала закройте Minecraft и лаунчер. Загрузите универсальный JAR-файл с официальной страницы установщика Fabric . Если JAR-файл не открывается двойным щелчком, запустите его из терминала с помощью команды:

java -jar fabric-installer.jar

В установщике Fabric выберите «Клиент» , укажите точную версию Minecraft, в которую вы хотите играть, оставьте включенной опцию «Создать профиль» и установите. В текущей документации Fabric для Linux рекомендуется использовать установщик таким образом, а затем выбрать профиль Fabric в лаунчере Minecraft.

2. Загрузите соответствующую сборку Controlify.

Откройте страницу Controlify на Modrinth и выберите релиз, соответствующий вашей версии Minecraft и загрузчику. В текущей документации проекта Controlify указана поддержка как Fabric , так и NeoForge , поэтому не загружайте сборку NeoForge для профиля Fabric и наоборот.

3. Поместите Controlify в папку mods.

Для стандартной директории Minecraft создайте папку mods, если она еще не существует:

mkdir -p ~/.minecraft/mods

Затем скопируйте или переместите загруженный JAR-файл Controlify в папку ~/.minecraft/mods/. Если ваша установка лаунчера использует собственную папку игры, поместите JAR-файл в modsпапку этой установки.

4. Подключите контроллер в Linux.

Подключите контроллер через USB или выполните сопряжение в настройках Bluetooth вашего компьютера. Убедитесь, что Linux распознает его, прежде чем запускать Minecraft. Controlify использует SDL3 для ввода с геймпада и джойстика; на странице поддержки контроллеров указано, что поддержка может различаться в зависимости от модели контроллера, типа подключения, операционной системы и драйвера.

5. Запустите профиль Fabric.

Откройте лаунчер Minecraft, выберите профиль Fabric, соответствующий версии, использованной на предыдущих шагах, и нажмите «Играть» . Если Minecraft запускается без Controlify, проверьте каталог игры и убедитесь, что JAR-файл находится в правильной modsпапке.

6. Настройка ввода с контроллера в Minecraft

После загрузки Controlify откройте настройки контроллера или экран профиля из параметров Minecraft. Точная формулировка и расположение элементов могут меняться в зависимости от версии, но Controlify предоставляет настройки для привязки кнопок, чувствительности, мертвых зон, вибрации и поддерживаемых расширенных функций. Он также может отображать значки кнопок, специфичные для контроллера, и позволяет управлять меню Minecraft с помощью геймпада.

Перед подключением к серверу протестируйте движение, управление камерой, навигацию по инвентарю, действия атаки/использования и управление паузой/меню в одиночном режиме. В документации Controlify указано, что на обычных серверах установка мода на стороне сервера не требуется; на серверах движение с помощью джойстика может по умолчанию соответствовать поведению клавиш WASD, как на клавиатуре, для совместимости с античитерскими программами.

Если контроллер не обнаружен

• Сначала проверьте возможность обнаружения Linux: отключите и снова подключите контроллер или отключите его и повторно выполните сопряжение по Bluetooth.
• Необходимо обеспечить совместимость всех версий: Minecraft, Fabric или NeoForge, а также Controlify.
• Проверьте каталог игры: сторонние лаунчеры и пользовательские установки могут использовать другую modsпапку.
• Попробуйте использовать USB: если Bluetooth работает нестабильно, проводное соединение может помочь выявить проблему с сопряжением или драйверами.
• Проверьте примечания для конкретной модели: такие функции, как гироскоп, ввод с сенсорной панели, тактильная обратная связь HD или адаптивные триггеры, зависят от контроллера и драйвера Linux. В официальной таблице совместимости Controlify указаны протестированные комбинации.

А что насчёт мода Controlable?

В более старой версии этого руководства использовался Forge с Controllable. Controllable по-прежнему поддерживается и теперь публикует сборки для современных загрузчиков, включая Fabric и NeoForge. Если существующий модпак уже зависит от Controllable, используйте релиз, соответствующий этому пакету. Для новой установки Linux Controlify — отличный выбор, поскольку его текущая документация явно описывает поддержку контроллеров Linux, современные загрузчики, переназначение клавиш, ввод SDL3 и возможности, специфичные для контроллеров.