一款为 Minecraft: Java 版 提供最佳手柄支持的模组。

分屏功能！

（广告）

Controlify Splitscreen 是一款正在开发中的独立模组，旨在为游戏添加分屏游玩功能！目前仅可在 Patreon 上获取 JAR 文件！

Wiki 文档

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

什么是 Controlify？

Controlify 是 Minecraft: Java 版中最好的手柄支持模组。它在各方面都超越了基岩版（Bedrock Edition）的原生手柄支持。它功能完备，支持振动反馈、陀螺仪、HD 触觉反馈等更多特性。

得益于使用了最先进的跨平台输入库 SDL3，Controlify 支持所有类型的手柄。

Controlify 的设计兼顾了易用性与功能丰富性。它拥有合理的默认设置（默认灵敏度与基岩版匹配，便于用户过渡），并提供了一个简洁而信息丰富的设置界面，让你可以根据自己的喜好调整体验。

功能概览

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

谁在使用 Controlify？

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

• 想要坐在沙发上放松游玩自己喜爱的 Minecraft 版本的客厅玩家。
• 此前只在主机上玩过 Minecraft、不想学习如何使用键盘和鼠标的初次接触模组的玩家。
• 有无障碍需求、无法使用键盘和鼠标和/或需要自适应手柄的人群。
• 希望以无障碍方式让孩子接触模组版 Minecraft 的父母。
• 只是更喜欢用手柄而非键盘鼠标游玩的人。
• 希望通过配套 分屏模组 与朋友和家人进行本地多人游戏的人。
• hopefully 就是你！

详细功能

手柄振动

Controlify 支持手柄振动功能，这在 PC 版的 Minecraft（包括基岩版 Windows 10 版）中前所未见。你可以配置每种振动源的强度，并为游戏的众多方面（例如受伤时）设置复杂的振动模式。

径向菜单

为了节省手柄按键，你可以将一些较少使用的动作分配到径向菜单中。该菜单可通过设置完全自定义，且易于使用。任何模组添加的按键绑定都与此菜单兼容。

陀螺仪支持

Controlify 内置支持手柄陀螺仪，让你可以在游戏中用手柄进行细微操作。此功能可与 Flick Stick 结合使用，让你能够毫无妥协地用手柄游玩。

容器光标

就像基岩版一样，你可以在物品栏中移动光标，并以对手柄友好的方式进行交互。设有专用按键用于快速移动、丢弃等操作。Controlify 还具备光标吸附功能，因此你无需非常精确地移动光标。

手柄识别

Controlify 能够自动识别你手柄的品牌和型号，并显示相应的按键纹理。此功能也可通过资源包扩展，以不同风格更改按键纹理，并添加你自己更小众的手柄标识。

摇杆支持

你可以将任何摇杆连接到模组，并用自己的名称和纹理进行映射，每个手柄支持的输入数量无上限。

按键指南

游戏中有一个简单的覆盖层，会根据你玩家的状态和朝向显示可按下的按键。这对于尚未记住控制方式的新玩家非常有用。

此外，某些界面会在具有手柄快捷方式的元素上显示手柄按键图标，让你能够像理应如此那样轻松地用手柄导航。

独立手柄架构

本模组的构建基于这样一个事实：每个手柄都是完全独立的，拥有自己的配置、按键绑定等。这意味着未来添加分屏游玩支持将变得非常简单。

专为模组兼容性而设计

GUI 操作已被抽象为一个简单的 API，使其他模组能够轻松为其自有界面添加支持，而无需在整个模组代码库中进行复杂的集成，从而降低了第三方集成的难度。

视频使用 Thrustmaster HOTAS 飞行摇杆配合 do-a-barrel-roll 模组录制

自动手柄死区校准

你的手柄死区值会自动校准，因此你无需为此担心。

会向后移植吗？

本模组仅且将仅适用于 1.19.4 及以上版本。这是因为在 1.19.4 中，Mojang 引入了方向键导航功能，该功能可以轻松地移植到手柄操作上；而在 1.19.4 以下版本，这是不可能实现的。