Skip to content

START_HERE.md

Latest commit

 

History

History
201 lines (135 loc) · 4.3 KB

START_HERE.md

File metadata and controls

201 lines (135 loc) · 4.3 KB
Raw

从这里开始

项目状态公告

欢迎使用 FCL 到 ZL2 控件转换器

这是一个帮助你将 Fold Craft Launcher (FCL) 控件配置转换为 ZalithLauncher 2 (ZL2) 格式的 Web 应用。当前仓库仍可继续本地运行与参考。

快速开始（3 步）

1️⃣ 安装依赖（首次运行）

npm install

⏱️ 大约需要 20-30 秒

2️⃣ 启动应用

npm run dev

✅ 看到以下输出表示成功：

VITE v5.4.21  ready in 632 ms
➜  Local:   http://localhost:5173/

3️⃣ 打开浏览器

访问 👉 http://localhost:5173

🎮 使用方法

方式一：快速体验（推荐新手）

  1. 点击左侧的 "加载示例" 按钮
  2. 点击中间的 "开始转换" 按钮
  3. 查看右侧的转换结果
  4. 点击 "复制结果" 或 "下载 JSON"

方式二：转换自己的配置

  1. 从 FCL 启动器导出控件配置
  2. 复制 JSON 内容
  3. 粘贴到左侧输入框
  4. 点击 "开始转换"
  5. 获取右侧的 ZL2 配置
  6. 在 ZL2 启动器中导入

需要帮助？

新手用户

👉 阅读 快速启动.md

普通用户

👉 阅读 使用指南.md

开发者

👉 阅读 开发文档.md

了解项目

👉 阅读 README.md

开源仓库

👉 访问 GitHub 仓库

🎯 核心功能

✅ 完整转换: 支持所有 FCL 控件类型
✅ 智能映射: 自动转换键码和坐标
✅ 安全处理: 使用安全的颜色值
✅ 一键操作: 复制或下载结果

⚠️ 重要提示

🔄 已修复：颜色值精度问题

v1.0.1 更新: 已修复大整数精度问题，现在输出的颜色值格式正确。

如果遇到 "Numeric value overflow" 错误：

  1. 按 Ctrl + F5 刷新页面
  2. 重新执行转换
  3. 检查颜色值是否为数字（无引号）

关于颜色值

转换后的配置使用了安全的颜色值，避免 ZL2 崩溃。

❌ 不要手动修改颜色值
✅ 使用 ZL2 编辑器的可视化颜色选择器

关于方向键

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

◤  ▲  ◥
◀  ○  ▶
◣  ▼  ◢

这样可以支持斜向移动（如 W+A）。

🔧 常见问题

Q: 端口被占用怎么办？

A: Vite 会自动使用下一个可用端口（5174, 5175...）

Q: 转换失败怎么办？

A: 检查 JSON 格式是否正确，查看错误提示

Q: 如何停止服务器？

A: 在命令行窗口按 Ctrl + C

📦 项目结构

fcl-to-zl2-converter/
├── src/                    # 源代码
│   ├── App.vue            # 主应用
│   ├── converter/         # 转换逻辑
│   ├── components/        # UI 组件
│   └── types/             # 类型定义
├── fcl控件文档/            # FCL 文档
├── zl2控件文档/            # ZL2 文档
├── *.md                   # 文档文件
└── package.json           # 项目配置

🚀 下一步

如果你是新手

  1. ✅ 启动应用
  2. ✅ 加载示例
  3. ✅ 体验转换
  4. 📖 阅读使用指南

如果你要转换配置

  1. ✅ 准备 FCL 配置
  2. ✅ 启动应用
  3. ✅ 执行转换
  4. ✅ 导入 ZL2

如果你是开发者

  1. ✅ 查看项目结构
  2. ✅ 阅读开发文档
  3. ✅ 理解转换逻辑
  4. ✅ 开始开发

📞 获取帮助

  • 📖 查看文档: 项目包含 7 个详细文档
  • 🔍 搜索问题: 查看常见问题解答
  • 💬 提交反馈: GitHub Issues

🎉 开始使用

现在就运行 npm run dev 开始使用吧！

祝你使用愉快！ 🎮

快速链接:

最后更新: 2024-12-18