FCL 到 ZL2 控件转换器

项目状态公告

• 本项目现已开源。
• GitHub 仓库地址: https://github.com/NingZeStudio/fcl-to-zl2_controller
• 新的控件转换网站已发布: https://cc.miawa.cn/
• 当前网站不再维护，请优先使用新站。

历史在线地址

• 旧站入口: https://ftzc.lemwood.cn/
• 说明: 该地址保留为历史在线入口，不再作为持续维护的主站。

这是一个基于 Vue 3 + TypeScript + Vite 的 Web 应用，用于将 Fold Craft Launcher (FCL) 控件配置转换为 ZalithLauncher 2 (ZL2) 格式。

功能特性

• 完整的 FCL 到 ZL2 控件转换
• 自动键码映射（FCL → GLFW）
• 方向键转换为 8 方向按钮
• 安全的颜色值处理（避免崩溃）
• 实时转换预览
• 一键复制或下载结果
• 响应式设计，支持移动端

使用说明

1. 在左侧输入框粘贴 FCL 控件的 JSON 配置
2. 点击"开始转换"按钮
3. 在右侧查看转换后的 ZL2 配置
4. 复制或下载转换结果
5. 在 ZL2 启动器中导入转换后的配置

转换规则

坐标系统

• FCL: 0-1000 (0%-100%)
• ZL2: 0-10000 (0%-100%)
• 转换公式: ZL2坐标 = FCL坐标 × 10

尺寸系统

• FCL: 百分比值 (如 50 = 5%)
• ZL2: 百分比值 (如 500 = 5%)
• 转换公式: ZL2尺寸 = FCL尺寸 × 10

键码映射

• FCL 使用数字键码 (如 17 = W键)
• ZL2 使用 GLFW 键码 (如 GLFW_KEY_W)
• 自动映射常用键盘和鼠标按键

方向键转换

FCL 的方向键控件会被转换为 8 个独立按钮：

• ◤ (左上) = W + A
• ▲ (上) = W
• ◥ (右上) = W + D
• ◀ (左) = A
• ▶ (右) = D
• ◣ (左下) = S + A
• ▼ (下) = S
• ◢ (右下) = S + D

颜色值处理

为避免 ZL2 崩溃，转换器使用经过验证的安全颜色值：

• 背景色: -9223372036854775808 (半透明黑)
• 按下背景: -5510004026390872064 (灰色)
• 文字/边框: -4294967296 (白色)