适用于 Minecraft 1.20.1, 1.21.1 的 Controlify (Controller support) 模组

一个为 Minecraft: Java 版提供最佳控制器支持的模组。

分屏！

（广告）

Controlify 分屏是一个正在开发中的独立模组，为游戏添加分屏支持！目前 JAR 文件仅在 Patreon 上提供！

Wiki

阅读 Controlify Wiki，了解更多关于如何使用 Controlify、如何配置它以及如何为它开发的信息。

什么是 Controlify？

Controlify 是 Minecraft: Java 版最佳的控制器支持模组。它在各个方面都超越了第一方基岩版的控制器支持。它功能完整，支持振动、陀螺仪、HD 触觉反馈等。

得益于使用了 SDL3 库——目前最先进的跨平台输入库，Controlify 支持所有控制器。

Controlify 的设计兼顾用户友好与功能丰富。它拥有合理的默认设置，默认灵敏度与基岩版匹配以便轻松过渡，还有一个简单而信息丰富的设置界面，让你可以随心调整体验。

功能概览

• 振动支持；Controlify 会在受到伤害、破坏方块、闪电击中时让控制器振动。
• 陀螺仪支持；Controlify 可以使用控制器中的陀螺仪进行精确瞄准。
• 厂商专属输入支持；Controlify 支持读取部分控制器（包括 Xbox、DualSense 和 Steam Deck）的背键、静音按钮（及其 LED）、触摸板等。
• GUI 操作：Controlify 允许你用控制器浏览所有 Minecraft GUI，无需鼠标或键盘。这包括物品栏、游戏外菜单和模组 GUI。它在物品栏界面中具有光标吸附功能，让你无需精确移动光标即可使用控制器。
• DualSense/DualShock 支持；即使在 Windows 上，Controlify 也不需要为 PlayStation 控制器安装任何额外软件。
• 控制器识别；Controlify 为许多控制器型号提供了专属按键图标，包括 Xbox、Playstation、Nintendo Switch、Steam Deck 等。
• 屏幕键盘；Controlify 包含一个功能齐全的屏幕键盘，让你可以用控制器打字——真正无需键盘！
• 径向菜单；Controlify 提供了一个可配置的菜单，让你把不常用的操作绑定到径向菜单，节省按键。
• DualSense HD 触觉反馈支持；Controlify 允许在 DualSense 控制器上实现高级振动效果。
• DualSense 自适应扳机支持；Controlify 允许在 DualSense 控制器上实现高级扳机效果。
• 数据驱动设计；Controlify 允许资源包更改默认绑定、主题按键图标、屏幕按键指南、屏幕键盘布局、添加更多控制器型号等。
• Steam Deck 支持
• 模组兼容性；Controlify 主导了让控制器支持与 Sodium、Iris、Simple Voice Chat、Do A Barrel Roll 等模组无缝协作的工作。
• 跨平台与多版本；Controlify 适用于 Fabric 和 NeoForge，并积极支持与更新 Minecraft 1.21.1 及以上版本。
• 更新迅速；Controlify 甚至为 Minecraft 快照更新，不过快照版本仅对 patreon 会员开放。
• 摇杆支持；Controlify 支持飞行摇杆、赛车方向盘和其他非标准摇杆。此类设备的用户可以选择将摇杆映射为标准手柄，或为摇杆创建自己的自定义绑定、默认设置和图标，从而获得功能完整的体验。

谁在使用 Controlify？

以下是我从 Controlify 用户那里收到的真实反馈，我非常自豪能够帮助他们以以前无法做到的方式享受 Minecraft：

• 想要坐下来放松地玩自己最喜爱的 Minecraft 版本的沙发玩家。
• 以前在主机上玩过 Minecraft、不想学习使用键盘鼠标的模组新手。
• 无法使用键盘鼠标和/或需要自适应控制器的无障碍需求人士。
• 希望以无障碍方式让孩子接触模组版 Minecraft 的家长。
• 单纯更喜欢用控制器而不是键盘鼠标的人。
• 想使用配套的分屏模组与朋友和家人进行本地多人游戏的人。
• 希望是你！

功能

控制器振动

Controlify 支持控制器振动，这在 PC 版 Minecraft（包括基岩版 Windows 10 版）中前所未见。你可以配置每个振动源的强度，游戏中的许多方面都有复杂的振动模式（例如受到伤害时）。

径向菜单

为了节省控制器上的按键，可以把一些不常用的操作交给径向菜单。它可以通过设置完全自定义，使用起来也很直观。任何模组按键绑定都兼容此菜单。

陀螺仪支持

Controlify 内置对控制器陀螺仪的支持，让你可以用控制器在游戏中进行精细操作。这可以与甩杆（flick stick）结合使用，让你无需妥协即可使用控制器。

容器光标

就像基岩版一样，你可以在物品栏中移动光标，并以适合控制器的方式与之交互。有用于快速移动、丢弃等的专用按键。Controlify 还带有光标吸附功能，因此你无需精确移动光标。

控制器识别

Controlify 能够自动识别你控制器的品牌和型号，并显示适用于你控制器的按键贴图。这也可以通过资源包扩展，以不同风格更改按键贴图，并添加一些你自己的、更小众的控制器标识。

摇杆支持

你可以将任何摇杆连接到该模组，并用你自己的名称和贴图进行映射，每个控制器的输入数量不受限制。

按键指南

游戏中有一个简单的叠加层，会根据你的玩家状态和视线方向显示你可以按下的按键。这对尚未记住操作的新玩家很有用。

此外，一些 GUI 会在具有控制器快捷键的元素上显示控制器按键，让你能够像应该做到的那样轻松用控制器导航。

容器化控制器

该模组的设计基于每个控制器完全独立这一事实，拥有自己的配置、绑定等。这意味着将来添加分屏游玩支持将是轻而易举的。

为模组兼容性而构建

GUI 操作已被抽象为一个简单的 API，让其他模组可以轻松为自己的 GUI 添加支持，而无需在整个模组代码库中做复杂的支持，使第三方难以集成。

视频使用 do-a-barrel-roll 和 Thrustmaster HOTAS 飞行摇杆录制

控制器死区自动校准

你控制器的死区值会自动校准，这意味着你无需为此操心。

向下移植？

该模组仅且只会适用于 1.19.4 及以上版本，这是因为在 1.19.4 中，Mojang 引入了方向键导航，可以轻松移植到控制器，而在 1.19.4 以下，这是不可能的。