FCL 到 ZL2 控件转换器
这是一个现代化的 Web 应用,旨在解决 Minecraft 启动器 Fold Craft Launcher (FCL) 与 ZalithLauncher 2 (ZL2) 之间控件配置不兼容的问题。
🌐 在线使用
你可以直接访问在线转换器进行操作:
- 官方地址: https://ftzc.lemwood.cn/
📖 项目背景
由于 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
- 架构: 模块化转换引擎