
控制 Flex x EMI
Control Flex与EMI之间的兼容性桥接
Control Flex × EMI
一个兼容桥接模组,将 EMI 的配方查看器接入你的手柄——无需触碰键盘即可查看配方、收藏、合成、隐藏以及作弊给予。
功能说明
没有此模组,手柄完全无法驱动 EMI。
EMI 将按键绑定保存在自己的系统中:每个绑定都存在于 EMI 的 binds.* 配置中,并在 EMI 自己的界面内匹配(matchesKey / matchesMouse)。EMI 没有注册任何原版 KeyMapping——一个都没有。
ControlFlex 通过扫描 mc.options.keyMappings 来构建其动作池。因此 EMI 在 ControlFlex 的模组列表中是一个空集,在原版 选项 → 控制 → 按键绑定 中同样不可见。
结果:键盘可以驱动 EMI,手柄不行。 并非因为没有绑定任何东西,而是因为 ControlFlex 没有可绑定的对象。
此桥接模组注册了 伪按键映射,ControlFlex 可以自行发现它们,并将每次按下通过 EMI 自身的交互入口转发给 EMI。
结果: 将光标指向一个物品堆,按下绑定的按钮,EMI 会执行与按下其自身按键完全相同的操作。
特性
- 手柄上的 EMI 操作——查看配方 / 用途、收藏、物品堆树、配方树、后退和前进。
- 搜索与开关——聚焦搜索栏、清空搜索栏、开启和关闭 EMI。
- 无需键盘合成——合成一个 / 一组,到物品栏或到光标。
- 创造模式作弊给予——一个物品或一组,到物品栏或到光标。
- 管理显示内容——隐藏物品、按 ID 隐藏、复制配方 ID。
- 作用于悬停的物品堆——遵循 EMI 自身的定位规则,不额外叠加逻辑。
- 无伪造输入——不向按键状态注入任何内容,也不向界面的
keyPressed推送合成按键事件。由 EMI 自身的调度器完成工作。 - 完全可重新绑定——每个动作都会出现在 ControlFlex 绑定设置中的“Control Flex x EMI”分类下,拥有与任何内置按键相同的触发类型和层级。
- 遵循 EMI 自身的门控——当文本框获得焦点,或 EMI 被关闭或正在重载时,除“切换 EMI”外不会触发任何操作。
- 键盘仍然可用——桥接模组从不写入 EMI 的
binds.*配置,因此你的键盘设置不受影响。 - 无 Mixin,无补丁——仅调用公开的 EMI API;ControlFlex 和 EMI 保持未修改状态。
依赖(必需)
每个 Minecraft 版本都是独立的 JAR——选择与你游戏版本匹配的行,然后选择对应加载器的 JAR。
| Minecraft | 加载器 | ControlFlex | EMI |
|---|---|---|---|
| 1.18.2 | Fabric | ≥ 0.8.8 | ≥ 0.7.3 |
| 1.19.2 | Forge · Fabric | ≥ 0.8.8 | ≥ 1.0.9 |
| 1.20.1 | Forge · Fabric | ≥ 0.8.8 | ≥ 1.1.0 |
| 1.21.1 | Fabric · NeoForge | ≥ 0.8.8 | ≥ 1.1.0 |
针对 EMI 0.7.3(1.18.2)、1.0.9(1.19.2)、1.1.24(1.20.1 和 1.21.1)构建并测试。
这是一个客户端模组。所有版本均需要 EMI 和 ControlFlex——没有它们,桥接模组不会执行任何操作。
动作
| 分组 | 动作 |
|---|---|
| 界面 | 切换 EMI · 聚焦搜索 · 清空搜索 |
| 浏览 | 查看配方 · 查看用途 · 添加到收藏 · 查看物品堆树 · 查看配方树 · 后退 · 前进 |
| 合成 | 合成一个 · 合成一组 · 合成一个到物品栏 · 合成一组到物品栏 · 合成一个到光标 |
| 创造模式 | 作弊给予一个到物品栏 · 作弊给予一组到物品栏 · 作弊给予一个到光标 · 作弊给予一组到光标 |
| 管理 | 隐藏物品 · 按 ID 隐藏物品 · 复制配方 ID |
动作列表随 EMI 版本增长:1.20.1 和 1.21.1 提供全部 22 个动作,1.19.2 有 20 个(无前进、无复制配方 ID),1.18.2 有 18 个(上述两项之外,还缺少隐藏物品 / 按 ID 隐藏物品)——较早的 EMI 版本根本没有可驱动的此类功能。
兼容性
- ✅ 适用于单人游戏和多人游戏——仅客户端,服务器无需安装任何内容。
- ✅ 单一源码,在所有加载器上行为一致——1.19.2 和 1.20.1 支持 Forge · Fabric,1.21.1 支持 Fabric · NeoForge,1.18.2 仅支持 Fabric。
- ✅ 可与 EMI 自身的键盘绑定共存。一次按钮按下仅触发一次动作——不会重复执行。
- 📌 合成、隐藏和作弊给予仅作用于EMI 侧边栏中悬停的物品堆——这是 EMI 自身的规则,并非此桥接模组添加的。
- 📌 动作在 ControlFlex 中绑定。此模组不添加自己的按键设置。
工作原理
一个绑定的手柄按钮
↓
ControlFlex 触发伪按键 key.cfx_compat_emi.view_recipes
↓
cfx-compat-emi 在客户端 tick 中检测到下降沿
↓
EMI 自身的调度器 EmiScreenManager.stackInteraction(...)
↓
EMI 的行为与按下其自身按键完全一致
ControlFlex 写入按键状态而非触发按键事件,因此桥接模组在每个客户端 tick 中监视其伪按键的下降沿,并将该下降沿路由到对应的 EMI 调用——物品堆动作使用 stackInteraction,导航和搜索使用 genericInteraction,配方相关动作使用 recipeInteraction。
桥接模组还附带一个小型兼容配置,将所有动作按键列在 ControlFlex 的 GUI 层级下。没有它,ControlFlex 会将这些按键保留在 MAIN 层级,并在界面打开时永远不会调度它们——按键看起来已绑定但实际上无效。
不支持的内容
defaultStack、deleteCursorStack和showCraft——前两个是深埋在 EMI 配方界面内部的內联逻辑;第三个是按住状态而非一次性动作。displayAllRecipes——存在于 EMI 1.20.1 的源码树中,但不在已发布的 1.1.24 JAR 中。- 配方界面上的“复制配方 ID”——EMI 将该上下文保存在私有字段中。该功能可从侧边栏收藏中使用。
- 重新绑定 EMI 自身的按键。 ControlFlex 绑定决定哪个手柄按钮触发动作;它不会重写 EMI 的
binds.*。
注意事项
- 此模组仅客户端——无需在服务器上安装,也不会影响任何服务器端内容。
- 如果某个动作似乎无效,请检查 EMI 界面是否确实已打开,且光标是否位于你想要的物品堆上——EMI 在键盘上同样会忽略相同的按键。
- 安装同时匹配你的 Minecraft 版本和加载器(Forge / Fabric / NeoForge)的 JAR。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。