
Control Flex 是一款面向 Minecraft Java 版客户端的手柄控制器模组,专为希望获得完整手柄支持的玩家打造——尤其是在整合包中,原版风格的按键绑定往往无法满足需求。
功能介绍
Control Flex 通过灵活的绑定系统,将你的手柄映射到 Minecraft 及各类模组的操作中:
- 十种触发模式 —— 按下、释放、按住、轻触、长按、切换,以及双击 / 轻触双击 / 按住双击 / 切换双击
- 七层布局 —— 主层、Shift 1–4、屏幕(菜单)、叠加层(交互式 HUD)
- 组合键 —— 将多个按钮绑定到同一个操作
- 径向菜单 —— 最多 5 个菜单 × 8 个槽位(按键、命令、快捷栏物品)
- 模拟移动 —— 左摇杆 360° 行走,支持模拟平滑或类键盘的八方向移动
- 虚拟键盘与鼠标 —— 当某模组仅读取键盘输入时,从手柄注入真实按键信号
- 视角与光标 —— 右摇杆控制视角、虚拟鼠标、D-Pad 槽位跳转、可选槽位吸附
- 分屏 —— 多实例本地合作(双手柄,或单手柄加键鼠);窗口失去焦点时仍可继续游戏
- 震动反馈 —— 可根据伤害类型自定义振动反馈
- 模组适配 —— 自动识别模组按键;提供游戏内屏幕 / 叠加层规则;社区配置文件
内置模板(Basic、Bedrock、Recommend)可帮助你快速上手。可通过 JSON 文件添加自定义模板。使用 F9(键盘)或 Back + Start(手柄)打开设置界面。
社区 & 链接
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 — 仅支持窗口平铺(不处理输入)
游玩方法
- 为每个账号创建一个启动器实例。保持两者均为窗口化(非全屏)。
- 在每个使用游戏手柄的实例中安装 ControlFlex。也可选择安装 Splitscreen Support。
- 启动这两个实例。对于两个手柄的情况,在每个游戏中打开ControlFlex 设置 → 手柄选择,并选择一个不同的手柄,以免互相抢占控制。对于手柄 + 键盘组合,仅在手柄实例中分配手柄;另一名玩家在其窗口中使用键盘和鼠标。
- 在每个窗口中按下 F3+P(或通过视频选项)禁用失去焦点时暂停。未聚焦的窗口必须保持运行。如果忘记操作,ControlFlex 会在暂停界面上显示提示;点击该窗口一次,然后按 F3+P。
- 已安装 Splitscreen Support 时,按下 F11 可在半屏和四分之一屏布局之间切换。它会记住上次的位置。
- 在一个实例中创建世界(开放给局域网)。其他实例通过局域网列表中的 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 文件会引导您使用该桥接)。
如果模组仍然表现异常
- 检查键位映射 —— 该动作是否在正确的层上(屏幕 vs 叠加层 vs 主界面)?
- 为该模组打开模组适配 —— 添加屏幕/叠加层规则,或应用社区配置。
- 如果模组仅监听物理按键,请使用虚拟 KBM。
- 手动编辑或分享兼容 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

Control Flex is a client-side controller mod for Minecraft Java Edition, built for players who want full gamepad support — especially in modded packs where vanilla-style bindings are not enough.
What it does
Control Flex maps your controller to Minecraft and mod actions through a flexible binding system:
- Ten trigger modes — Press, Release, Hold, Tap, Long Press, Toggle, plus Double Press / Tap / Hold / Toggle
- Seven layers — Main, Shift 1–4, Screen (menus), and Overlay (interactive HUDs)
- Combo keys — bind multiple buttons to one action
- Radial menus — up to 5 menus × 8 slots (keys, commands, hotbar items)
- Analog movement — 360° left-stick walk, with Analog Smooth or Keyboard-like 8-way
- Virtual keyboard & mouse — inject real keys from the pad when a mod only reads the keyboard
- Camera & cursor — right-stick look, virtual mouse, D-Pad slot jump, optional slot snap
- Split-screen — multi-instance couch co-op (two pads, or one pad plus keyboard and mouse); unfocused windows keep playing
- Rumble — configurable vibration feedback by damage type
- Mod Adaptation — auto-discovers mod keys; in-game Screen / Overlay rules; community configs
Bundled templates (Basic, Bedrock, Recommend) help you get started quickly. Custom templates can be added as JSON files. Open settings with F9 (keyboard) or Back + Start (controller).
Community & Links
- English Discussion: Join my Discord server.
- 中文讨论区: 欢迎加入我的 Kook 频道。
- Beta Builds: Download the latest development versions from GitHub Releases.
- Bug Reports: Please report issues via GitHub Issues.
1. Ten Trigger Modes — One Button, Many Behaviors
Every binding pairs which button with how it fires. ControlFlex supports ten trigger modes, so the same face button can tap, hold, toggle, double-tap, or release differently per action.
| Mode |
When it fires |
Typical use |
| Press |
On button down |
One-shot actions, toggles, opening menus |
| Release |
On button up |
Layer return, “on let go” actions |
| Hold |
While held |
Movement modifiers, sustained use, Shift layer switches |
| Tap |
Short press under threshold |
Quick actions without accidental holds |
| Long Press |
Held past threshold |
Secondary functions on the same button |
| Toggle |
First press on, second press off |
Persistent state toggles (sprint, walk, POV) |
| Double Press |
Second press inside the tap window, fires on down |
A second one-shot on the same button as Hold / Press |
| Double Tap |
Two short presses; fires on the second release |
Confirm / extra action without stealing the first tap |
| Double Hold |
Short press, then press-and-hold inside the window |
Sprint or sneak only after a tap-then-hold |
| Double Toggle |
Same latch as Toggle; flips on the second tap |
Toggle sneak / sprint on the same button as the hold version |
Tap and Long Press thresholds are configurable globally (100–2000 ms) in Other Settings. The Tap threshold is also the max gap between the two taps for every Double mode. Toggle (and Double Toggle) work like a light switch — first qualifying press activates, second deactivates — ideal for persistent states like sprint, walk mode, or POV switching.
Double modes can share a button with the matching single-click mode. Bundled templates use that for sneak: Hold to sneak, Double Toggle on the same button to latch sneak (right-stick click; B on the Bedrock template).
Layer switches on Main are designed around Hold; return-to-Main rows on Shift layers use Release. Radial menu open bindings support Press and Hold (tap to open vs. hold to keep open).
Mix modes across layers: Hold LB for Shift 1, Tap X to ping, Long Press Y for a mount/dismount mod key, Double Toggle stick-click to latch sneak — all on the same controller layout.
2. Seven Layers — Multiply Your Buttons Without Multiplying Hardware
A standard controller has roughly a dozen face and shoulder inputs; a modpack can expose hundreds of actions. ControlFlex solves that with a seven-layer binding model, so one physical button can mean different things depending on context.
Main Layer is your default gameplay map — movement, combat, inventory, hotbar, and mod actions you use every day.
Shift Layers 1–4 are modifier planes. Hold a layer-switch binding on Main (for example LB, RB, or Back) to temporarily activate Shift 1–4, each with its own full binding table. Unassigned slots on a Shift layer inherit the matching Main binding, so you only override what you need. Releasing the switch returns you to Main automatically.
Screen Layer activates whenever a screen is open — chests, crafting, mod UIs, and ControlFlex Settings. Confirm, back, tab switch, scroll, D-Pad slot jump, and container helpers (quick-move, take half, etc.) live here, separate from in-world controls, so opening a menu does not fight your gameplay bindings.
Overlay Layer is for interactive HUDs that are neither a full screen nor plain gameplay — spell wheels, third-party radial menus, photo / attachment HUDs, and similar overlays. Overlay bindings are explicit (they do not inherit from Main): unconfigured actions stay silent, so a HUD cannot accidentally fire your combat map. Defaults follow the in-game feel — move, look, jump, attack, use, scroll — with B as back. Layer switches are suppressed while an overlay is open. Mods that need a key to stay held across an overlay (or screen) can be phase-locked so the Game-layer binding continues until you unlock it.
Together, seven layers turn a limited pad into a deep control surface: walk around on Main, hold LB for combat extras, hold RB for utility binds, keep moving when a spell wheel pops up, and get a clean Screen map the moment you open inventory — without re-plugging or swapping profiles.
3. Combo Keys — Chords for Power Users
When one button is not enough, bind multiple buttons together as a single action — for example LB + Back or LT + A.
Binding combos
During capture, press the first button, then add more within 500 ms. The UI shows the full chord; all buttons must match for the action to fire.
Works with every trigger mode
Combos support all ten modes, including Double Press / Tap / Hold / Toggle — same rules as single-key binds.
Smart combo engine
- Upgrade rule: activating a larger combo (e.g. A+B+Y) clears smaller active subsets (A+B) so behavior stays predictable.
- Button sharing: one physical button can participate in several combos via reference counting.
- Shift + combo: hold a Shift modifier first, then press a chord on that layer — useful for radial menus and advanced layouts without eating Main-layer slots.
Combo keys are how you fit “modpack density” onto a gamepad: rare actions stay off the main face buttons until you deliberately chord them.
4. Radial Menus — Eight Slots, Five Wheels, Zero Menu Digging
Radial menus give you up to five independent wheels, each with up to eight slots around the stick — open a wheel, aim with the stick, confirm with A (defaults vary by template).
What a slot can do
- Key binding — fire a vanilla or mod KeyMapping
- Chat command — run
/… (macros, home, warp, etc.)
- Use item — switch to and use a hotbar slot (e.g. torches, food, tools)
How you open them
Each menu has its own open binding. Press = tap to open (release does not close). Hold = keep the open button held; release closes. Menus 2–5 can sit on Shift layers so Main stays uncluttered.
Customization
- Selection stick: left, right, or both
- Icons: auto, random, default, item ID, or custom texture path
- Layouts persist in
config/controlflex/radial_menu/radial_menus.json
- In-game editor: pick icons, reorder slots, set trigger mode per menu
Radial menus are the fast lane for items and commands you use often but do not want on permanent face buttons — eat, place torches, run /home, trigger JEI or Minemenü-style shortcuts, all without opening full inventory or chat every time.
5. Analog Movement
Vanilla Minecraft only sees WASD as on/off, so a left stick that is converted to keys can only walk in eight directions at full speed. With Analog Movement on, ControlFlex feeds a continuous 360° move vector: any angle, and a light push walks slowly.
Open ControlFlex Settings → Other → Analog Movement.
- Enable Analog Movement (360°) is the master switch. Off restores digital WASD bindings; the policies below then do nothing.
- Analog Smooth — stick direction and magnitude are used as-is (the console-style feel).
- Keyboard-like 8-way — the stick is snapped to eight directions at full speed, which looks like keyboard input on a server.
Defaults follow the connection:
- Singleplayer / LAN → Analog Smooth
- Public servers and Realms → Keyboard-like 8-way, so analog walk is less likely to look like abnormal input
If a remote server should still use Analog Smooth, add it to the whitelist on that same page (host:port, or Realm name). Stick deadzones and movement / camera response curves stay on the Calibration page.
6. Camera & Cursor
- Right-stick look with configurable sensitivity, optional Y-axis invert, and three look modes: Direct Turn, Smooth Turn, and Simulate Mouse (the last routes look through the mouse pipeline for combat mods such as Epic Fight)
- Virtual cursor drives screens with the left stick when a menu is open
- D-Pad slot navigation jumps the cursor between inventory and container slots (cone targeting — works on irregular grids). The left stick still moves the cursor freely.
- Optional slot snap for precise container targeting
7. Rumble
Configurable vibration feedback by damage type — multiple waveform modes, per-type settings, and intensity bands for light / medium / heavy hits.
8. Virtual Keyboard & Mouse
Some mods never register a KeyMapping — they only watch the physical keyboard or mouse. Virtual KBM lets the gamepad inject those real keys (Shift, Escape, Page Up/Down, mouse buttons, scroll wheel) on any layer, without first turning them into ControlFlex actions.
Capture a keyboard/mouse key, then bind a controller combo to it. Tap scrolls the wheel one notch; Hold repeats (default 100 ms, configurable). GUI Back (B) sends physical Escape, so it matches clicking Esc with a mouse. Injected keys do not type into chat or text fields.
9. Split-screen (couch co-op)
Java Edition does not render two players in one window. Couch co-op is two (or more) Minecraft instances on the same PC, joined over Open to LAN. Each instance has its own input: two gamepads, or one gamepad plus keyboard and mouse. ControlFlex is built for that setup: when you turn off Pause on Lost Focus, the background window keeps looking, mining, and using menus.
What you need
- Two or more Minecraft accounts
- Two gamepads, or one gamepad and a keyboard + mouse
- A launcher that can run two instances at once
- ControlFlex in each instance that uses a gamepad
- Optional: Splitscreen Support — window tiling only (it does not handle input)
How to play
- Create one launcher instance per account. Keep both windowed (not fullscreen).
- Install ControlFlex in each gamepad instance. Optionally install Splitscreen Support as well.
- Launch both. For two pads, open ControlFlex Settings → Gamepad Selection in each game and pick a different controller so they do not steal each other. For pad + keyboard, assign the pad only in the gamepad instance; the other player uses keyboard and mouse in their window.
- Press F3+P in each window (or use video options) to disable Pause on Lost Focus. The unfocused window must keep running. If you forget, ControlFlex shows a hint on the pause screen; click the window once, then press F3+P.
- With Splitscreen Support installed, press F11 to cycle half- and quarter-screen layouts. It remembers the last position.
- Host a world on one instance (Open to LAN). Join from the others on the same PC via the LAN game in the multiplayer list, or
localhost plus the port shown when you opened to LAN.
Use Direct Turn or Smooth Turn for look if you play unfocused; Simulate Mouse cannot drive the OS cursor in a background window and falls back to Direct Turn automatically.
10. Mod Compatibility
ControlFlex is built for modpacks. Most mods work with no extra files: at startup it scans Minecraft’s KeyMapping registry and exposes every non-vanilla binding as a bindable action. JEI recipe keys, combat-mod skills, map/minimap hotkeys — if the mod registered a key, it shows up in Key Mapping.
When auto-discovery is not enough (wrong layer, a HUD that needs its own stick behavior, or a mod that never registered keys), 0.8.7 gives you an in-game Mod Adaptation center, a community config repo, optional compat JSON, Virtual KBM, and bridge mods — in that order of effort.
Mod Adaptation (in-game)
Open ControlFlex Settings → Mod Adaptation. Every installed mod is listed with name, icon, and version. Open a mod to work in three tabs:
- Key Bindings — that mod’s discovered actions; assign them to Main / Screen / Overlay and bind gamepad buttons
- Screen Adaptation — per-screen stick mode, Layer Mapping, and cursor rules while that GUI is open
- Overlay Adaptation — the same for interactive HUDs (spell wheels, radial menus, photo HUDs, and similar)
To add a Screen or Overlay rule: open the target GUI or HUD once in-game so ControlFlex records it, then use + Add Screen/Overlay Adaptation. The popup lists recent pages (up to 50). Pick one to create a rule. Entries that could not be matched to a mod can be scanned automatically.
Each stick can use a different behavior for that page:
| Behavior |
What it does |
| Independent |
Stick directions are actions. Bind them on Layer Mapping. Default on Overlay, and for the Screen right stick |
| Radial Path |
Stick traces a path / angle — spell wheels, MineMenu-style rings |
| Virtual Mouse |
Stick moves a cursor inside that UI. Default for the Screen left stick |
With no rule, Screen uses Virtual Mouse on the left stick and Independent on the right; Overlay keeps Independent on both (the layer’s four-way bindings). You can also set cursor style (system / Bedrock / hand). Virtual Mouse has cursor speed; Radial Path has threshold, radius, angle bias, show-cursor, and whether the stick restores its last angle.
Edits are copy-on-write: packaged and community files stay read-only. Your changes land under config/controlflex/compat/user/. Reset Config on a mod restores the packaged or applied community default.
Community configs
You do not have to author every rule yourself. ControlFlex can sync shared compatibility files from remote sources (the official source is ControlFlexMC/cfx-compat-configs).
From Mod Adaptation, use Sync Configs, then browse variants, preview Bindings / Screen / Overlay, and Apply. Applying backs up any existing user file first. Extra sources can be added; local JSON can be imported and exported from a mod’s detail page. Pull requests for new mod configs are welcome.
Compat JSON (pack authors & power users)
Declarative JSON is still the shareable unit behind the UI. A config can:
- Put keys on Main, Screen, and/or Overlay (
inGameKeys / screenKeys / overlayKeys)
- Choose dispatch channels per key (KeyMapping, Forge event bus, GLFW-compat polling, screen input)
- Ignore unused keys, suppress keys while holding an item, and attach tips
- Declare per-screen / per-overlay stick maps (Independent / Radial Path / Virtual Mouse, same options as the UI)
Drop files in config/controlflex/compat/user/{mod_id}.json. Bridge mods may ship files into compat/mods/ (read-only at runtime). ControlFlex ships a small built-in set in the jar — currently JEI, Epic Fight, and Nightfall — and extracts it on every launch. Everything else is auto-discovered or comes from the community repo.
A config only activates when its target mod_id (and any listed dependencies) are actually loaded, so unused files are skipped cleanly.
Bridge mods
For mods with a custom input system, runtime combat state, or raw gamepad reads, a bridge mod using the IControlFlexPlugin SPI can export compat JSON, push player states, and react to controller lifecycle events. See ControlFlexMC/control-flex-api and the Epic Fight example at ControlFlexMC/cfx-compat-epicfight (the built-in Epic Fight file points you at that bridge).
If a mod still misbehaves
- Check Key Mapping — is the action on the right layer (Screen vs Overlay vs Main)?
- Open Mod Adaptation for that mod — add a Screen/Overlay rule, or apply a community config.
- Use Virtual KBM if the mod only listens for physical keys.
- Hand-edit or share a compat JSON; or write a bridge if the mod bypasses KeyMapping entirely.
11. Templates & Profiles
Bundled layouts: Basic, Bedrock, and Recommend. Switch templates from in-game settings; drop custom JSON files into config/controlflex/templates/ to add your own. Per-template user data is stored under config/controlflex/profiles/.
Upgrading from 0.8.6.x migrates profiles, compat files, and client settings automatically on first launch. Originals are copied under config/controlflex/backup/.
SDL3 is included for Windows, macOS, and Linux — no separate install required.
Supported loaders by Minecraft version:
- 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
登录后参与评分
还没有评论,来抢沙发吧