HMCL启动器数据迁移：更换设备时的配置转移
项目地址: https://gitcode.com/gh_mirrors/hmc/HMCL 你是否曾遇到更换电脑后，HMCL启动器的账号、游戏版本和设置需要重新配置的困扰？本文将详细介绍如何完整迁移HMCL的所有配置数据，让你在新设备上快速恢复熟悉的游戏环境。通过本文，你将学会识别关键配置文件、使用两种迁移方法（手动复制和备份恢复），以及验证迁移结果的完整步骤。
迁移前准备：了解HMCL数据存储结构
HMCL的核心配置文件和数据分散存储在多个位置，迁移前需要了解这些关键文件的路径和作用。以下是必须迁移的核心文件：
-
全局配置文件：config.json
存储启动器全局设置，包括界面主题、下载源和代理配置等。位于HMCL安装目录下的.minecraft文件夹中。 -
账号信息文件：accounts.json
保存所有已登录的Minecraft账号信息（加密存储），路径与全局配置文件相同。 -
游戏版本数据：launcher_profiles.json
记录已安装的游戏版本、Modpack配置和启动参数，位于游戏根目录。 -
版本设置文件：hmclversion.cfg
每个游戏版本独立的配置文件，包括JVM参数、内存分配等，位于对应版本的文件夹内。
方法一：手动复制关键文件（适合高级用户）
手动迁移需定位并复制核心配置文件，步骤如下：
1. 导出源设备数据
- 打开旧设备上的HMCL，进入设置 > 启动器设置，记录当前游戏目录位置
- 关闭HMCL，打开文件管理器，导航至游戏目录
- 复制以下文件/文件夹到U盘或云存储：
config.json和accounts.json.minecraft/versions文件夹（包含所有游戏版本）.minecraft/mods文件夹（Mod文件）.minecraft/saves文件夹（存档数据）
2. 导入新设备
- 在新设备安装相同版本的HMCL，运行一次后关闭
- 将复制的文件粘贴到新设备的对应游戏目录
- 替换新生成的
config.json和accounts.json
注意：若新旧设备操作系统不同（如Windows迁移到macOS），需检查HMCL/src/main/java/org/jackhuang/hmcl/setting/ConfigHolder.java中的平台特定配置，确保路径格式正确。
方法二：使用备份与恢复功能（推荐普通用户）
HMCL内置的备份功能可一键导出所有配置，步骤如下：
1. 创建备份
- 在旧设备打开HMCL，点击设置 > 备份与恢复
- 选择创建备份，勾选以下选项：
- 账号数据
- 游戏版本
- 全局设置
- 存档和Mod
- 设置备份路径（建议保存到外部存储），点击开始备份
2. 恢复备份
- 在新设备安装HMCL并运行一次后关闭
- 将备份文件复制到新设备，打开HMCL
- 进入设置 > 备份与恢复 > 恢复备份，选择备份文件
- 等待恢复完成，重启HMCL即可
迁移后验证：确保数据完整
迁移完成后，需验证以下内容是否正常：
- 账号验证：检查所有账号是否正常显示，尝试切换账号确认无登录问题
- 版本检查：在版本列表中确认所有游戏版本都已迁移，点击启动测试能否正常运行
- 设置核对：进入设置，检查下载源、内存分配等是否与旧设备一致
- Mod和存档：启动游戏后确认Mod加载正常，存档可读取
若遇到启动失败，可查看HMCL/src/main/java/org/jackhuang/hmcl/game/LogExporter.java导出日志，排查配置冲突。
常见问题解决
问题1：迁移后账号无法登录
原因：账号信息文件权限不足或路径错误
解决：检查accounts.json文件权限，确保新设备上HMCL有读写权限。
问题2：游戏版本显示但无法启动
原因：版本配置文件路径引用错误
解决：删除迁移的launcher_profiles.json，让HMCL重新生成，再手动添加版本。
问题3：Mod加载异常
原因：Mod文件损坏或版本不兼容
解决：对比新旧设备的mods文件夹，重新复制缺失或损坏的Mod文件。
迁移工具推荐
对于频繁更换设备的用户，推荐使用以下工具简化迁移流程：
- 同步工具：使用云同步软件（如OneDrive）同步整个游戏目录
- 备份脚本：通过批处理或Shell脚本自动备份关键文件
- 便携版HMCL：将启动器和游戏文件全部放入U盘，实现真正的即插即用
通过以上方法，你可以轻松实现HMCL配置的完整迁移。建议定期备份关键文件，以应对设备故障或系统重装。如需更详细的操作指南，可参考项目官方文档：README.md。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
