Controlify - Controlify（手柄支持）

一个为 Minecraft: Java Edition 添加最佳控制器支持的模组。

分屏！

（广告）

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

Wiki

阅读 Controlify Wiki 以获取有关如何使用 Controlify、如何配置它以及如何基于它进行开发的更多信息。

什么是 Controlify？

Controlify 是 Minecraft: Java Edition 上最优秀的控制器支持模组。它在各个方面都超越了官方 Bedrock Edition 的控制器支持。功能完整，支持震动、陀螺仪、HD haptics 等更多特性。

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

Controlify 的设计目标是兼顾易用性与功能丰富性。它提供合理的默认设置，默认灵敏度与 Bedrock Edition 保持一致，方便用户轻松过渡；同时还拥有简单但信息丰富的设置界面，让你可以按自己的喜好调整体验。

功能概览

• 震动支持；当受到伤害、破坏方块、遭遇闪电等事件发生时，Controlify 会让你的控制器震动。
• 陀螺仪支持；Controlify 可以使用控制器中的陀螺仪进行精确瞄准。
• 厂商专属输入支持；Controlify 可在部分控制器上读取背键、静音按钮（及其 LED）、触摸板等输入，包括 Xbox、DualSense 和 Steam Deck。
• GUI 操作：Controlify 允许你使用控制器操作 Minecraft 的全部 GUI，而无需鼠标或键盘。这包括背包、游戏外菜单以及模组 GUI。它还在背包界面中提供光标吸附功能，让你无需非常精确地移动光标也能顺畅操作。
• DualSense/DualShock 支持；即使在 Windows 上，Controlify 也不需要任何额外软件即可支持 PlayStation 控制器。
• 控制器识别；Controlify 为许多控制器型号提供专门的按键图标，包括 Xbox、Playstation、Nintendo Switch、Steam Deck 等。
• 屏幕键盘；Controlify 内置了一个功能完整的屏幕键盘，让你可以直接用控制器输入——真正不需要键盘！
• 环形菜单；Controlify 提供一个可配置菜单，可将不常用操作绑定到环形菜单上，从而节省按键。
• DualSense HD haptics 支持；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 的家长。
• 单纯比起键盘和鼠标更喜欢使用控制器的人。
• 想与朋友和家人通过配套的 Splitscreen Mod 进行本地多人游戏的人。
• 希望还有你！

功能

控制器震动

Controlify 支持控制器震动，这在 Minecraft 的 PC 版本中前所未见，

包括 Bedrock Windows 10 Edition。你可以配置各个震动来源的强度，

并为游戏中的许多场景启用复杂的震动模式（例如受到伤害时）。

环形菜单

为了节省控制器上的按键，你可以将一些不常用的操作放入环形菜单中。

它可以通过设置完全自定义，而且使用直观。任何模组添加的按键绑定

都兼容这个菜单。

陀螺仪支持

Controlify 内置了对控制器陀螺仪的支持，让你能够在游戏中

使用控制器完成细微操作。这还可以与 flick stick 结合使用，

从而在不妥协体验的前提下使用控制器。

容器光标

就像 bedrock edition 一样，你可以在背包中移动光标，并以

对控制器友好的方式进行交互。还提供用于快速移动、丢弃等操作的专用按键。Controlify 也带有光标吸附功能，因此你不需要把光标移动得非常精确。

控制器识别

Controlify 能够自动识别你的控制器品牌和型号，

并显示适用于该控制器的按键纹理。这一功能还可通过资源包扩展，你可以将按键纹理替换为不同风格，并添加一些属于你自己的、更小众的控制器识别信息。

摇杆支持

你可以将任何摇杆设备连接到本模组，并使用自定义名称和纹理进行映射，而且每个控制器支持无限数量的输入。

按键指南

游戏中有一个简洁的覆盖层，会根据玩家状态和视线方向

显示当前可按下的按键。对于尚未记住操作方式的新玩家来说，

这非常有用。

此外，一些 GUI 还会在带有控制器快捷操作的元素上显示控制器按键，

让你能够像理应做到的那样轻松使用控制器进行导航。

容器化控制器

这个模组是围绕“每个控制器都是完全独立的”这一理念构建的，每个控制器都有自己的配置、绑定等。

这意味着未来添加分屏游玩支持将会非常简单。

为模组兼容性而构建

GUI 操作已被抽象为一个简单的 API，这使得其他模组可以轻松为自己的 GUI 添加支持，

而不需要在整个模组代码库中编写复杂支持逻辑，从而避免第三方集成变得困难。

视频使用 Thrustmaster HOTAS flightstick 搭配 do-a-barrel-roll 录制

自动控制器死区校准

你的控制器死区数值会自动校准，

这意味着你无需为此操心。

Backports？

这个模组仅支持并且以后也只会支持 1.19.4 及以上版本，这是因为在 1.19.4 中，Mojang

引入了方向键导航，而这很容易移植到控制器上；在低于 1.19.4 的版本中，这是不可能实现的。