
Control Flex 是一款面向 Minecraft Java 版客户端的手柄控制模组,专为希望获得完整手柄支持的玩家打造——尤其是在那些 vanilla(原版)按键绑定不够用的整合包中。
功能简介
Control Flex 通过灵活的绑定系统,将你的手柄映射到 Minecraft 及各类模组的操作中:
- 十种触发模式 — 按下、松开、按住、轻按、长按、切换,以及双击 / 轻按 / 按住 / 切换
- 七层层级 — 主层、Shift 1–4、屏幕(菜单)、叠加层(交互式 HUD)
- 组合键 — 将多个按钮绑定到同一个操作
- 径向菜单 — 最多 5 个菜单 × 8 个槽位(按键、命令、快捷栏物品)
- 模拟移动 — 左摇杆 360° 行走,支持 Analog Smooth 或类似键盘的八向移动
- 虚拟键盘与鼠标 — 当某些模组仅读取键盘输入时,从手柄注入真实按键信号
- 视角与光标 — 右摇杆控制视角、虚拟鼠标、方向键切换快捷栏槽位,可选槽位吸附
- 分屏 — 多实例本地多人合作(两个手柄,或一个手柄加键鼠);窗口失去焦点时游戏继续运行
- 震动反馈 — 可根据伤害类型自定义振动反馈
- 模组适配 — 自动发现模组按键;支持在游戏内设置屏幕 / 叠加层规则;社区配置文件
内置模板(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 相同的锁存机制;在第二次轻按时翻转 |
在与按住版本相同的按钮上切换潜行 / 疾跑 |
在其他设置中,可以全局配置点击和长按的阈值(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 — 仅负责窗口平铺布局(不处理输入)
游玩方法
- 为每个账号创建一个启动器实例。保持两者均为窗口化(非全屏)。
- 在每个使用手柄的游戏中安装 ControlFlex。也可选择安装 Splitscreen Support。
- 启动所有实例。对于双手柄情况,在每个游戏中打开 ControlFlex Settings → Gamepad Selection,并选择不同的手柄,避免互相抢占控制权。对于“手柄+键盘”组合,仅在手柄对应的实例中分配手柄;另一名玩家在其窗口中使用键盘和鼠标。
- 在每个窗口中按下 F3+P(或通过视频选项)禁用 Pause on Lost Focus(失去焦点时暂停)。未聚焦的窗口必须保持运行。如果忘记此步骤,ControlFlex 会在暂停界面上显示提示;只需点击一次该窗口,然后按下 F3+P 即可。
- 若已安装 Splitscreen Support,按 F11 可在半屏和四分之一屏布局间切换。系统会记住上次的位置。
- 在一个实例中创建世界(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 文件会指引你使用该桥接模组)。
如果模组仍然表现异常
- 检查按键映射 —— 行动是否在正确的图层上(屏幕 vs 叠加层 vs 主界面)?
- 为该模组打开模组适配 —— 添加屏幕/叠加层规则,或应用社区配置。
- 若模组仅监听物理按键,请使用虚拟 KBM。
- 手动编辑或分享兼容 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

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
- 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
登录后参与评分
还没有评论,来抢沙发吧