Control Flex - 控制器支持

模组

原名 Control Flex - Controller Support · 作者 ifels

Control Flex 是一款专为中型至大型整合包设计的控制器模组。

0 本站下载 0 关注 更新于 1 个月前

最新 0.8.8.2-mc1.20.1-forge · 1.20.1 · Forge

一键开服(送7天)

Control Flex

Control Flex 是一款面向 Minecraft Java 版客户端的手柄控制器模组,专为希望获得完整手柄支持的玩家打造——尤其是在整合包中,原版风格的按键绑定往往无法满足需求。

功能介绍

Control Flex 通过灵活的绑定系统,将你的手柄映射到 Minecraft 及各类模组的操作中:

  • 十种触发模式 —— 按下、释放、按住、轻触、长按、切换,以及双击 / 轻触双击 / 按住双击 / 切换双击
  • 七层布局 —— 主层、Shift 1–4、屏幕(菜单)、叠加层(交互式 HUD)
  • 组合键 —— 将多个按钮绑定到同一个操作
  • 径向菜单 —— 最多 5 个菜单 × 8 个槽位(按键、命令、快捷栏物品)
  • 模拟移动 —— 左摇杆 360° 行走,支持模拟平滑或类键盘的八方向移动
  • 虚拟键盘与鼠标 —— 当某模组仅读取键盘输入时,从手柄注入真实按键信号
  • 视角与光标 —— 右摇杆控制视角、虚拟鼠标、D-Pad 槽位跳转、可选槽位吸附
  • 分屏 —— 多实例本地合作(双手柄,或单手柄加键鼠);窗口失去焦点时仍可继续游戏
  • 震动反馈 —— 可根据伤害类型自定义振动反馈
  • 模组适配 —— 自动识别模组按键;提供游戏内屏幕 / 叠加层规则;社区配置文件

内置模板(Basic、Bedrock、Recommend)可帮助你快速上手。可通过 JSON 文件添加自定义模板。使用 F9(键盘)或 Back + Start(手柄)打开设置界面。

社区 & 链接

  • 英文讨论:加入我的 Discord 服务器。
  • 中文讨论区:欢迎加入我的 Kook 频道。
  • Beta 版本:从 GitHub Releases 下载最新的开发版本。
  • 错误报告:请通过 GitHub Issues 提交问题。

1. 十种触发模式 —— 一个按钮,多种行为

每个绑定都将哪个按钮与如何触发配对。ControlFlex 支持十种触发模式,因此同一个面键可以针对不同的操作执行轻触、按住、切换、双击或释放等不同行为。

模式 触发时机 典型用途
Press(按下) 按钮按下时 一次性动作、切换、打开菜单
Release(释放) 按钮松开时 返回上一层、“松开即执行”类动作
Hold(按住) 持续按住期间 移动修饰、持续使用、Shift 层切换
Tap(轻触) 短按且未超过阈值 快速动作,避免误触长按
Long Press(长按) 按住时间超过阈值 同一按钮上的次要功能
Toggle(切换) 第一次按下开启,第二次按下关闭 持久状态切换(冲刺、步行、视角)
Double Press(双击按下) 在轻触窗口内的第二次按下,按下时触发 在 Hold / Press 基础上增加第二个一次性动作
Double Tap(双击轻触) 两次短按;在第二次松开时触发 确认 / 额外动作,且不占用第一次轻触
Double Hold(双击按住) 先短按,然后在窗口内按住 仅在“轻触后按住”时执行冲刺或潜行
Double Toggle(双击切换) 与 Toggle 相同的锁存逻辑;在第二次轻触时翻转 在同一按钮上对潜行 / 冲刺进行切换(对应按住版本)

轻触和长按的阈值可在 Other Settings(其他设置) 中全局配置(100–2000 毫秒)。对于所有 Double 模式,Tap 阈值同时也是两次轻触之间的最大间隔。Toggle(以及 Double Toggle)的工作方式类似电灯开关——首次符合条件的按下激活,再次按下停用——非常适合用于冲刺、步行模式或视角切换等持久状态。

双模式可以与匹配的单击模式共享一个按钮。捆绑模板使用此功能进行潜行:按住以潜行,在同一按钮上双击切换以锁定潜行(右摇杆点击;B 键在 Bedrock 模板中)。

Main 层上的图层切换围绕按住设计;Shift 层上的返回 Main 行使用释放。径向菜单打开绑定支持按下和按住(轻按打开 vs. 按住保持打开)。

跨图层混合模式:按住 LB 用于 Shift 1,轻按 X 进行提示,长按 Y 用于坐骑/下坐骑模组按键,双击摇杆点击以锁定潜行——全部位于同一个控制器布局上。


2. 七层系统 — 倍增你的按钮而不倍增硬件

标准控制器大约有十几个面键和肩键输入;整合包可以暴露数百个操作。ControlFlex 通过七层绑定模型解决了这一问题,因此一个物理按钮在不同语境下具有不同的含义。

Main 层是你默认的游戏地图 — 移动、战斗、物品栏、快捷栏以及你每天使用的模组操作。

Shift 层 1–4是修饰符平面。在 Main 上按住图层切换绑定(例如 LB、RB 或 Back)以临时激活 Shift 1–4,每个图层都有其自己的完整绑定表。Shift 层上未分配的槽位继承匹配的 Main 绑定,因此你只需覆盖所需内容。松开切换键会自动返回 Main。

Screen 层在屏幕打开时激活 — 箱子、合成、模组 UI 和 ControlFlex 设置。确认、后退、标签切换、滚动、D-Pad 槽位跳转和容器辅助功能(快速移动、取一半等)位于此处,与世界中控制分开,因此打开菜单不会干扰你的游戏内绑定。

Overlay 层用于交互式 HUD,既不是全屏也不是普通游戏画面 — 法术轮盘、第三方径向菜单、照片/附件 HUD 以及类似的叠加层。Overlay 绑定是显式的(它们不从 Main 继承):未配置的操作保持静音,因此 HUD 不会意外触发你的战斗地图。默认值遵循游戏内感觉 — 移动、观察、跳跃、攻击、使用、滚动 — B 作为后退。当 Overlay 打开时,图层切换被抑制。需要跨 Overlay(或 Screen)保持按住的模组的按键可以被相位锁定,以便 Game 层绑定继续直到你解锁它。

七层系统将有限的手柄变成深度的控制表面:在 Main 上行走,按住 LB 进行额外战斗,按住 RB 进行实用绑定,当法术轮盘弹出时继续移动,并在打开物品栏的瞬间获得干净的 Screen 映射 — 无需重新插拔或交换配置文件。


3. 组合键 — 高级用户的和弦

当一个按钮不够用时,将多个按钮绑定在一起作为一个单一动作 — 例如 LB + Back 或 LT + A。

绑定组合
在捕获期间,按下第一个按钮,然后在500 毫秒内添加更多。UI 显示完整的和弦;所有按钮必须匹配才能触发该动作。

适用于所有触发模式
组合支持所有十种模式,包括双击 / 轻按 / 按住 / 切换 — 规则与单键绑定相同。

智能组合引擎

  • 升级规则:激活更大的组合(例如 A+B+Y)会清除较小的活动子集(A+B),使行为保持可预测。
  • 按钮共享:一个物理按钮可以通过引用计数参与多个组合。
  • Shift + 组合:先按住 Shift 修饰符,然后在该图层上按下和弦 — 这对于径向菜单和高级布局非常有用,而不会占用 Main 层槽位。

组合键是将“整合包密度”放入游戏手柄的方法:罕见操作保持在主面键之外,直到你有意将它们组合。


4. 径向菜单 — 八个槽位,五个轮盘,零菜单挖掘

径向菜单提供最多五个独立轮盘,每个轮盘周围有最多八个槽位 — 打开一个轮盘,用摇杆瞄准,用 A 确认(默认值因模板而异)。

槽位可以做什么

  • 按键绑定 — 触发原版或模组 KeyMapping
  • 聊天命令 — 运行 /…(宏、家、传送等)
  • 使用物品 — 切换到并使用快捷栏槽位(例如火把、食物、工具)

如何打开它们
每个菜单都有自己的打开绑定。按下 = 轻按打开(释放不关闭)。按住 = 保持打开按钮按住;释放关闭。菜单 2–5 可以位于 Shift 层上,以便 Main 保持整洁。

自定义

  • 选择摇杆:左、右或两者
  • 图标:自动、随机、默认、物品 ID 或自定义纹理路径
  • 布局保存在 config/controlflex/radial_menu/radial_menus.json 中
  • 游戏内编辑器:选择图标、重新排序槽位、为每个菜单设置触发模式

径向菜单是你经常使用但不想永久放在面键上的物品和命令的快速通道 — 吃东西、放置火把、运行 /home、触发 JEI 或 Minemenü 风格的快捷键,无需每次打开完整物品栏或聊天。


5. 模拟移动

原版 Minecraft 仅将 WASD 视为开/关,因此转换为键的左摇杆只能以全速沿八个方向行走。开启模拟移动后,ControlFlex 提供连续的 360° 移动向量:任何角度,轻微推动缓慢行走。

打开 ControlFlex 设置 → 其他 → 模拟移动。

  • 启用模拟移动 (360°) 是总开关。关闭时会恢复数字化的 WASD 绑定;此时下方的策略将不生效。
  • 模拟平滑 —— 摇杆的方向和幅度按原样使用(具有主机风格的手感)。
  • 类键盘八向 —— 摇杆以全速锁定到八个方向,在服务器上看起来就像键盘输入。

默认值根据连接类型而定:

  • 单人游戏 / 局域网 → 模拟平滑
  • 公共服务器和 Realms → 类键盘八向,因此模拟行走不太可能被识别为异常输入

如果远程服务器仍应使用模拟平滑,请在同一页面上将其添加到白名单中(格式为 host:port 或 Realm 名称)。摇杆死区以及移动/相机响应曲线仍在校准页面上进行设置。


6. 相机与光标

  • 右摇杆视角控制,支持可配置的灵敏度、可选的 Y 轴反转,以及三种视角模式:直接转向、平滑转向和模拟鼠标(最后一种通过鼠标管线传递视角控制,适用于 Epic Fight 等战斗模组)
  • 虚拟光标:当菜单打开时,使用左摇杆驱动屏幕上的光标
  • D-Pad 槽位导航:使光标在物品栏和容器槽位之间跳转(锥形瞄准——适用于不规则网格)。左摇杆仍可自由移动光标。
  • 可选槽位吸附,用于精确对准容器槽位

7. 震动反馈

可根据伤害类型配置振动反馈——支持多种波形模式、按类型单独设置,以及针对轻/中/重打击的强度区间。


8. 虚拟键盘与鼠标

某些模组从不注册 KeyMapping——它们仅监听物理键盘或鼠标。虚拟 KBM 允许手柄在任何层注入这些真实按键(Shift、Escape、Page Up/Down、鼠标按钮、滚轮),而无需先将它们转换为 ControlFlex 动作。

捕获一个键盘/鼠标按键,然后将控制器组合键绑定到它。轻点滚动滚轮一格;按住重复触发(默认 100 毫秒,可配置)。GUI 返回键(B)会发送物理 Escape 信号,因此其效果等同于用鼠标点击 Esc。注入的按键不会在聊天或文本字段中输入内容。


9. 分屏(本地多人合作)

Java 版不支持在一个窗口中渲染两名玩家。本地多人合作需要两个(或更多)Minecraft 实例在同一台 PC 上运行,并通过“开放给局域网”加入。每个实例拥有独立的输入设备:两个游戏手柄,或一个游戏手柄加键盘和鼠标。ControlFlex 正是为这种设置而构建:当关闭“失去焦点时暂停”后,后台窗口仍可继续观察、挖掘和使用菜单。

所需条件

  • 两个或多个 Minecraft 账号
  • 两个游戏手柄,或一个游戏手柄加上键盘 + 鼠标
  • 能够同时运行多个实例的启动器
  • 在每个使用游戏手柄的实例中安装 ControlFlex
  • 可选:Splitscreen Support — 仅支持窗口平铺(不处理输入)

游玩方法

  1. 为每个账号创建一个启动器实例。保持两者均为窗口化(非全屏)。
  2. 在每个使用游戏手柄的实例中安装 ControlFlex。也可选择安装 Splitscreen Support。
  3. 启动这两个实例。对于两个手柄的情况,在每个游戏中打开ControlFlex 设置 → 手柄选择,并选择一个不同的手柄,以免互相抢占控制。对于手柄 + 键盘组合,仅在手柄实例中分配手柄;另一名玩家在其窗口中使用键盘和鼠标。
  4. 在每个窗口中按下 F3+P(或通过视频选项)禁用失去焦点时暂停。未聚焦的窗口必须保持运行。如果忘记操作,ControlFlex 会在暂停界面上显示提示;点击该窗口一次,然后按 F3+P。
  5. 已安装 Splitscreen Support 时,按下 F11 可在半屏和四分之一屏布局之间切换。它会记住上次的位置。
  6. 在一个实例中创建世界(开放给局域网)。其他实例通过局域网列表中的 LAN 游戏加入,或使用 localhost 加上开放给局域网时显示的端口号进行连接。

如果在非聚焦状态下游玩,建议使用直接转向或平滑转向来控制视角;模拟鼠标无法驱动操作系统的光标进入后台窗口,因此会自动回退到直接转向。


10. 模组兼容性

ControlFlex 专为整合包设计。大多数模组无需额外文件即可正常工作:启动时它会扫描 Minecraft 的 KeyMapping 注册表,并将所有非原版按键绑定暴露为可绑定的动作。JEI 配方快捷键、战斗模组的技能键、地图/小地图热键——只要模组注册了按键,就会出现在键位映射中。

当自动发现功能不够用时(例如处于错误的层级、需要独立按键行为的 HUD,或某个模组从未注册按键),0.8.7 为你提供了一个游戏内模组适配中心、一个社区配置仓库、可选的兼容 JSON、虚拟键鼠以及桥接模组——按投入精力从低到高排列。

模组适配(游戏内)

打开ControlFlex 设置 → 模组适配。所有已安装的模组都会列出名称、图标和版本。点击某个模组即可在三个标签页中进行操作:

  • 按键绑定 — 该模组已发现的各个动作;可将它们分配到主界面/屏幕/覆盖层,并绑定手柄按键
  • 屏幕适配 — 针对每个屏幕的摇杆模式、层映射,以及在该 GUI 打开时的光标规则
  • 叠加层适配 — 适用于交互式 HUD(法术轮盘、径向菜单、照片 HUD 等)的相同功能

添加屏幕或叠加层规则:在游戏中打开目标 GUI 或 HUD 一次,以便 ControlFlex 记录它,然后使用 + 添加屏幕/叠加层适配。弹出窗口会列出最近的页面(最多 50 个)。选择一个以创建规则。无法匹配到模组的条目可以自动扫描。

每个摇杆可以为该页面使用不同的行为:

行为 作用
独立 摇杆方向即动作。在 层映射 上绑定它们。叠加层的默认设置,以及屏幕右摇杆的默认设置
径向路径 摇杆追踪路径/角度 —— 法术轮盘、MineMenu 风格的环形菜单
虚拟鼠标 摇杆在该 UI 内移动光标。屏幕左摇杆的默认设置

如果没有规则,屏幕模式下左摇杆使用虚拟鼠标,右摇杆使用独立模式;叠加层模式下两者均保持独立模式(即该层的四向绑定)。您还可以设置光标样式(系统 / Bedrock / 手形)。虚拟鼠标具有光标速度选项;径向路径具有阈值、半径、角度偏置、显示光标以及摇杆是否恢复其最后角度的选项。

编辑采用写时复制机制:打包文件和社区文件保持只读。您的更改保存在 config/controlflex/compat/user/ 下。对模组执行 重置配置 可恢复打包文件或已应用的社区默认值。

社区配置

您不必亲自编写所有规则。ControlFlex 可以从远程源同步共享兼容性文件(官方源为 ControlFlexMC/cfx-compat-configs)。

从模组适配界面,使用 同步配置,然后浏览变体,预览绑定/屏幕/叠加层,并点击 应用。应用时会先备份任何现有的用户文件。可以添加额外的源;本地 JSON 可以从模组的详情页导入和导出。欢迎提交新模组配置的拉取请求。

兼容 JSON(整合包作者与高级用户)

声明式 JSON 仍然是 UI 背后可共享的基本单元。一个配置可以:

  • 将按键分配到主界面、屏幕和/或叠加层(inGameKeys / screenKeys / overlayKeys)
  • 为每个按键选择分发通道(KeyMapping、Forge 事件总线、GLFW 兼容轮询、屏幕输入)
  • 忽略未使用的按键、在持有物品时抑制按键,并附加提示
  • 声明每屏幕/每叠加层的摇杆映射(独立 / 径向路径 / 虚拟鼠标,选项与 UI 中相同)

将文件放入 config/controlflex/compat/user/{mod_id}.json。桥接模组可将文件放入 compat/mods/(运行时只读)。ControlFlex 在 jar 中包含了一组内置的小型配置 —— 目前包括 JEI、Epic Fight 和 Nightfall —— 并在每次启动时将其提取出来。其他所有内容均为自动发现或来自社区仓库。

仅当目标 mod_id(以及列出的任何 dependencies)实际加载时,配置才会激活,因此未使用的文件会被干净地跳过。

桥接模组

对于具有自定义输入系统、运行时战斗状态或原始手柄读取的模组,使用 IControlFlexPlugin SPI 的桥接模组可以导出兼容 JSON、推送玩家状态并响应控制器生命周期事件。请参阅 ControlFlexMC/control-flex-api 以及 Epic Fight 示例 ControlFlexMC/cfx-compat-epicfight(内置的 Epic Fight 文件会引导您使用该桥接)。

如果模组仍然表现异常

  1. 检查键位映射 —— 该动作是否在正确的层上(屏幕 vs 叠加层 vs 主界面)?
  2. 为该模组打开模组适配 —— 添加屏幕/叠加层规则,或应用社区配置。
  3. 如果模组仅监听物理按键,请使用虚拟 KBM。
  4. 手动编辑或分享兼容 JSON;或者如果模组完全绕过 KeyMapping,则编写桥接代码。

11. 模板与配置文件

捆绑布局:Basic、Bedrock 和 Recommend。从游戏内设置切换模板;将自定义 JSON 文件放入 config/controlflex/templates/ 以添加自己的模板。每个模板的用户数据存储在 config/controlflex/profiles/ 下。

从 0.8.6.x 升级时,配置文件、兼容文件和客户端设置会在首次启动时自动迁移。原始文件会复制到 config/controlflex/backup/ 下。


SDL3 已包含在 Windows、macOS 和 Linux 版本中 —— 无需单独安装。

支持的加载器及对应的 Minecraft 版本:

  • 26.3 — NeoForge, Fabric
  • 26.2 — NeoForge, Fabric
  • 26.1.2 — NeoForge, Fabric
  • 1.21.11 — NeoForge, Fabric
  • 1.21.1 — NeoForge, Fabric
  • 1.20.1 — Forge, Fabric

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源