Control Flex - 控制器支持

模组

原名 Control Flex - Controller Support · 作者 ifels

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

0 本站下载 0 关注 更新于 17 小时前

最新 0.9.0-mc26.3-fabric · 26.3 · Fabric

一键开服(送7天)

Control Flex

Control Flex 是一款面向 Minecraft Java 版客户端的手柄控制模组,专为希望获得完整手柄支持的玩家打造——尤其是在那些 vanilla(原版)按键绑定不够用的整合包中。

功能简介

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

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

内置模板(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 相同的锁存机制;在第二次轻按时翻转 在与按住版本相同的按钮上切换潜行 / 疾跑

在其他设置中,可以全局配置点击和长按的阈值(100–2000 毫秒)。点击阈值同时也是每种双击模式下的两次点击最大间隔。切换(以及双击切换)的工作原理类似于电灯开关 — 第一次符合条件的按下激活,第二次按下关闭 — 非常适合用于持久状态,如疾跑、行走模式或第一人称视角切换。

双击模式可以与对应的单击模式共享同一个按键。捆绑模板利用这一点来实现潜行:按住以潜行,在同一按键上使用双击切换来锁定潜行状态(右摇杆点击;Bedrock 模板中使用 B 键)。

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 槽位跳转以及容器辅助功能(快速移动、拿走一半等)都位于此层,与游戏内控制分离,这样打开菜单时不会干扰你的 gameplay 绑定。

Overlay 层用于交互式 HUD,这些 HUD 既不是完整屏幕也不是纯游戏玩法 — 法术轮盘、第三方径向菜单、照片/附件 HUD 以及类似的叠加层。Overlay 绑定是显式的(它们不从 Main 层继承):未配置的操作保持静默,因此 HUD 不会意外触发你的战斗地图。默认设置遵循游戏内的感觉 — 移动、注视、跳跃、攻击、使用、滚动 — 并以 B 作为返回键。当 Overlay 打开时,图层切换会被抑制。需要跨越 Overlay(或屏幕)保持按住的模组的按键可以被相位锁定,以便 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 视为开/关信号,因此转换为键位的左摇杆只能以全速沿八个方向移动。开启 Analog Movement(模拟移动)后,ControlFlex 会提供连续的 360° 移动向量:支持任意角度,且轻推摇杆可实现缓慢行走。

打开 ControlFlex Settings → Other → Analog Movement。

  • Enable Analog Movement (360°) 是总开关。关闭它将恢复数字式 WASD 绑定;此时下方的策略选项将不再生效。
  • Analog Smooth — 直接使用摇杆的方向和幅度(类似主机游戏的体验)。
  • Keyboard-like 8-way — 摇杆会被锁定到八个方向并以全速移动,在服务器端看起来就像键盘输入。

默认设置会根据连接类型自动调整:

  • 单人游戏 / LAN → Analog Smooth
  • 公共服务器和 Realms → Keyboard-like 8-way,以减少模拟移动被误判为异常输入的可能性

如果远程服务器仍希望使用 Analog Smooth,请在同一页面的 whitelist(白名单)中添加该服务器地址(格式为 host:port 或 Realm 名称)。摇杆死区及移动/镜头响应曲线仍在 Calibration 页面进行配置。


6. 镜头与光标

  • 右摇杆视角控制,支持可配置的灵敏度、可选的 Y 轴反转,以及三种视角模式:Direct Turn、Smooth Turn 和 Simulate Mouse(最后一种会将视角操作通过鼠标管道转发,适用于 Epic Fight 等战斗模组)
  • 虚拟光标:当菜单打开时,可通过左摇杆驱动屏幕上的光标
  • D-Pad 槽位导航:使光标在背包和容器槽位之间跳转(采用锥形瞄准机制 — 兼容不规则网格布局)。左摇杆仍可自由移动光标。
  • 可选槽位吸附,用于精确瞄准容器中的特定槽位

7. 震动反馈

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


8. 虚拟键盘与鼠标

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

捕获一个键盘/鼠标按键,然后为其绑定一个手柄组合键。轻触滚轮对应操作会使滚轮转动一格;长按则会重复触发(默认间隔 100 ms,可配置)。GUI Back(B 键)会发送物理 Escape 信号,因此其效果等同于用鼠标点击 Esc。注入的按键不会在聊天框或文本字段中输入字符。


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

Java Edition 无法在一个窗口中渲染两名玩家。本地多人合作需要 两个(或多个)Minecraft 实例 运行在同一台 PC 上,并通过 Open to LAN 加入。每个实例拥有独立的操作设备:两个手柄,或 一个手柄加键盘和鼠标。ControlFlex 专为这种设置打造:当你关闭“失去焦点时暂停”功能后,后台窗口仍能继续控制视角、挖掘和使用菜单。

所需条件

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

游玩方法

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

如果在非聚焦状态下游玩,建议使用 Direct Turn 或 Smooth Turn 进行视角控制;Simulate Mouse 无法驱动后台窗口的操作系统光标,会自动回退至 Direct Turn。


10. 模组兼容性

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

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

模组适配(游戏内)

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

  • 按键绑定 — 该模组已发现的行动;将其分配至主界面 / 屏幕 / 叠加层,并绑定手柄按钮
  • 屏幕适配 — 针对每个屏幕的摇杆模式、图层映射,以及在该 GUI 打开时的光标规则
  • 叠加层适配 — 针对交互式 HUD(法术轮盘、径向菜单、摄影 HUD 等)的相同设置

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

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

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

若无规则,屏幕模式左侧摇杆使用虚拟鼠标,右侧摇杆使用独立模式;叠加层对两个摇杆均保持独立模式(即图层的四向绑定)。你还可以设置光标样式(系统 / Bedrock / 手形)。虚拟鼠标支持光标速度调节;径向路径支持阈值、半径、角度偏置、显示光标以及是否让摇杆恢复上一角度。

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

社区配置

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

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

兼容 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/。


Windows、macOS 和 Linux 均包含 SDL3 —— 无需单独安装。

按 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
  • 1.19.2 — Forge, Fabric
  • 1.18.2 — Forge, Fabric
  • 1.16.5 — Forge, Fabric
  • 1.12.2 — Forge
  • 1.10.2 — Forge
  • 1.8.9 — Forge
  • 1.7.10 — Forge

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源