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+ 常用键位(字母、数字、功能键、鼠标键)。
- 📍 精准坐标换算: 自动处理千分比到万分比的缩放,确保 UI 布局一致。
- 🎨 安全颜色处理: 采用经过验证的安全颜色值,彻底解决 ZL2 导入崩溃问题。
- 🕹️ 方向键优化: 将 FCL 的方向键控件智能转换为 ZL2 的 8 方向独立按钮组。
- 🚀 现代化 UI: 基于 Vue 3 + Tailwind CSS,支持实时预览和一键复制/下载。
🛠️ 技术栈
- 框架: Vue 3 (Composition API)
- 语言: TypeScript (类型安全)
- 构建: Vite
- 样式: Tailwind CSS + shadcn-vue
- 架构: 模块化转换引擎