控制 Flex x 史诗战斗

Control Flex × Epic Fight

一个兼容桥梁，通过Control Flex为Epic Fight带来完整的控制器支持。

---

功能说明

没有此模组，即使安装了Control Flex，Epic Fight 也无法识别你的控制器。Epic Fight通过自身的 IEpicFightControllerMod SPI（而非标准 KeyMapping 事件）读取输入。此桥梁将Control Flex注册为Epic Fight的控制器提供商，并在两个系统之间翻译每一次按键、摇杆移动和动作绑定。

最终效果： 使用手柄完全控制Epic Fight的整个战斗系统。

---

特性

• 所有战斗动作均可映射到控制器 — 攻击、格挡、闪避、切换模式、武器固有技能、移动技能、锁定等。
• 模拟摇杆移动与战斗集成 — 左摇杆位置直接传递给Epic Fight，实现精确走位、侧移以及速度敏感的格挡检测。
• 锁定目标 — 使用控制器按钮锁定敌人并在目标之间切换。
• 战斗模式状态同步 — 当你在采集与战斗模式间切换时，此桥梁会通知Control Flex，以便其抑制冲突的原始动作（例如在战斗模式中持双手武器时阻止"使用"动作）。
• 即插即用配置 — 首次启动时自动安装优化的按键路由、双扳机阻止机制及游戏内教程指南。无需手动设置。
• 本地化指南 — 游戏内教程支持英文和简体中文。
• 优雅降级 — 若控制器断开或Control Flex不可用，Epic Fight会自动回退至标准键盘输入，不会报错。

---

依赖项（必需）

模组	版本
Control Flex	≥ 0.8.5
Epic Fight	≥ 20.14

---

兼容性

• ❌ 不兼容 Controlify — 两个模组会覆盖相同的Epic Fight控制器绑定方法，无法共存。
• ✅ 在单人游戏和多人游戏中均可使用（仅客户端）。

---

工作原理

手柄 → Control Flex（原始输入 + 动作绑定系统）
                ↓
         cfx-compat-epicfight（翻译为 Epic Fight API 对象）
                ↓
         Epic Fight（战斗引擎：攻击、格挡、闪避、技能、锁定）

两个 Mixin @Overwrite 会将Epic Fight硬编码的Controlify引用重定向至本桥梁。一个SPI插件会在首次启动时部署兼容配置和指南资源。一个状态桥梁使Control Flex能够感知玩家当前的战斗模式，从而正确应用物品/动作抑制规则。

---

注意事项

• 此模组仅限客户端 — 无需在服务器上安装。
• 请确保进入世界前Control Flex已检测到你的控制器。
• 如果武器固有技能似乎无效，请将其绑定到与攻击相同的按钮，并在Control Flex设置中将绑定模式设为长按。