跳到主要内容

FCL 到 ZL2 控件转换器

这是一个现代化的 Web 应用,旨在解决 Minecraft 启动器 Fold Craft Launcher (FCL)ZalithLauncher 2 (ZL2) 之间控件配置不兼容的问题。

🌐 在线使用

你可以直接访问在线转换器进行操作:

📖 项目背景

由于 FCL 和 ZL2 使用了完全不同的控件定义协议:

  • FCL: 采用数字键码、千分比坐标系。
  • ZL2: 采用 GLFW 键码、万分比坐标系、特殊的 Compose Color 颜色值。

手动转换 these 复杂的 JSON 配置不仅耗时,而且极易导致游戏崩溃。本工具实现了全自动、类型安全的转换流程。

✨ 核心特性

  • 全自动转换: 支持按钮、方向键、样式及事件系统的完整迁移。
  • ⌨️ 智能键码映射: 自动处理 50+ 常用键位(字母、数字、功能键、鼠标键)。
  • 📍 精准坐标换算: 自动处理千分比到万分比的缩放,确保 UI 布局一致。
  • 🎨 安全颜色处理: 采用经过验证的安全颜色值,彻底解决 ZL2 导入崩溃问题。
  • 🕹️ 方向键优化: 将 FCL 的方向键控件智能转换为 ZL2 的 8 方向独立按钮组。
  • 🚀 现代化 UI: 基于 Vue 3 + Tailwind CSS,支持实时预览和一键复制/下载。

🛠️ 技术栈

  • 框架: Vue 3 (Composition API)
  • 语言: TypeScript (类型安全)
  • 构建: Vite
  • 样式: Tailwind CSS + shadcn-vue
  • 架构: 模块化转换引擎

快速导航