跳到主要内容

FCL 到 ZL2 控件转换器

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

🌐 在线使用

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

📖 项目背景

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

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

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

✨ 核心特性

  • 全自动转换: 支持按钮、方向键、样式及事件系统的完整迁移。
  • ⌨️ 智能键码映射: 自动处理 50+ 常用键位(字母、数字、功能键、鼠标键)。
  • 📍 精准坐标换算: 自动处理千分比到万分比的缩放,并内置 v1.0.4 增强安全检查,防止负数坐标导致崩溃。
  • 🎨 安全颜色与样式: 采用经过验证的安全颜色值,并自动钳制文字大小、边框宽度等样式参数至官方允许范围。
  • 🛡️ 智能健壮性 (v1.0.5):
    • 模式自动推断: 自动识别粘贴的 JSON 格式,若粘贴错误会提示切换模式。
    • 第三方格式识别: 能够识别 PojavLauncher/Board 等常见非标准格式并给出友好提示。
    • 空值防御: 深度优化反向转换逻辑,自动防御空值及缺失字段,确保各类不完整配置均能安全转换。
  • 🕹️ 交互逻辑模拟: 利用 滑动联动 (Swipple) 增强方向键流畅度,支持 深度检测 (Deep Touch) 分发触摸事件。
  • 🚀 现代化 UI: 基于 Vue 3 + Tailwind CSS,支持实时预览和一键复制/下载。

🛠️ 技术栈

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

快速导航