文件夹与文件
Windows
Windows 版 LeviLauncher 读写的所有文件和文件夹(以 LeviLauncher 1.1.0 为准)。启动器不向系统临时文件夹(%TEMP%)写入任何东西。
概览
| 文件夹 | 位置 | 内容 |
|---|---|---|
| 设置文件夹 | %APPDATA%\LeviLauncher\ |
只有 config.json:体积小,随 Windows 配置文件漫游 |
| 本机文件夹 | %LOCALAPPDATA%\LeviLauncher\ |
日志、微软账号、窗口的 WebView2 数据;也是默认的数据根目录 |
| 数据根目录 | 本机文件夹,除非你另选一个(设置 → 基础设置 中的 根目录,或 config set data-root) |
Instances\、Backups\、Cache\ |
%APPDATA%\LeviLauncher\
config.json 启动器的设置
%LOCALAPPDATA%\LeviLauncher\ 默认的数据根目录
Logs\startup.log 启动器日志,以及之前的 startup.1.log … startup.4.log
Accounts\ 微软账号和设备记录,按当前 Windows 用户加密
WebView2\ 启动器窗口的数据
storage-migration.json 从旧布局迁移的记录(见下文)
<数据根目录>\
Instances\<实例>\ 一个实例(见下文)
Backups\
Worlds\<实例>\<文件夹>_<世界>\<世界>_<yyyyMMdd-HHmmss>.mcworld
Instances\<实例>\<实例>_<yyyyMMdd-HHmmss>.zip
Cache\
Installers\ 游戏安装包,以及 Visual C++ 和 WebView2 安装程序
Updates\ 启动器更新包,安装后删除
Downloads\ 为导入而下载的文件,超过 1 天后在启动时清理
Imports\ 交给导入处理的文件,超过 1 天后在启动时清理
gdk-pending-versions.json
gamertags.json 启动器见过的玩家档案的玩家代号Cache\ 中的所有内容都可以删除,不会丢失任何东西。LeviLauncher.exe cache clean 删除软件包缓存、为导入下载的文件和未完成的下载,LeviLauncher.exe installer remove 删除已下载的游戏安装包。更改数据根目录只是让启动器改用另一个文件夹:已有的实例、下载和备份不会被移动。
实例的文件夹
Instances\<实例>\
Minecraft.Windows.exe … 该构建的游戏文件
LeviLauncher.dll LeviLauncher 的原生加载器(x64 构建)
.levilauncher\ 启动器在实例内的状态(隐藏)
instance.json 名称、游戏版本、通道、隔离与启动选项
icon.ico 实例图标,由游戏的 LargeLogo.png 生成
xbox-auth-key-v1 UWP 实例用于 Xbox 登录的标记
.lip\ 实例中已安装软件包的状态(lip 的格式)
mods\ 模组(见“模组如何加载”)
Minecraft Bedrock\ 开启隔离时的游戏数据(预览版:Minecraft Bedrock Preview)开启和未开启隔离的实例的游戏数据文件夹见实例隔离,mods\ 见模组如何加载。
LeviLauncher 文件夹之外
| 路径 | 说明 |
|---|---|
桌面上的 Minecraft - <实例>.lnk |
实例的桌面快捷方式(创建桌面快捷方式,或 instance shortcut)。它以 --launch=<实例> 打开启动器。只写入你自己的桌面,不写公共桌面。 |
%APPDATA%\lip\ |
lip 的设置:config.toml,例如其中的 github_proxy,内置包管理器也会读取。 |
%LOCALAPPDATA%\lip\Cache\ |
内置包管理器的软件包缓存,与 lip 的相同。设置 → 包管理 中的 清理缓存 会清空它。 |
%APPDATA%\Minecraft Bedrock\、%APPDATA%\Minecraft Bedrock Preview\ |
未开启隔离的 GDK 实例的共享游戏数据。 |
%LOCALAPPDATA%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\(预览版:Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe) |
未开启隔离的 UWP 实例的共享游戏数据。 |
文件如何写入
- 文件先以
<名称>.<随机串>.tmp写在最终位置旁边,再改名到位,所以不会看到写了一半的文件。可以续传的未完成下载保存为<名称>.partial.tmp。 - 你起的名称(实例、世界)按 Windows 规则清理:去掉
<>:"/\|?*这些字符和结尾的点与空格,并避开CON、NUL等保留名。 - 启动器生成的文件命名为
<名称>_<yyyyMMdd-HHmmss>.<扩展名>,例如MyWorld_20261107-142301.mcworld。
旧布局
1.1.0 之前的 LeviLauncher 把所有东西放在 %APPDATA%\<程序名>\(例如 %APPDATA%\levilauncher.exe\),里面有 versions\、backups\、installers\、updates\、logs\ 文件夹,以及 config.json、user_gamertag_map.json 和 gdk_pending_versions.json 文件。实例中则是 version.json 和 LargeLogo.ico。
LeviLauncher 1.1.0 及更高版本第一次启动时,会把这些数据一次性迁移到上面的布局,不删除任何东西:同一个驱动器上的数据直接改名到位,另一个驱动器上的数据复制过去并保留原件,旧的 config.json 改名为 config.migrated.json。你自己选过的数据根目录留在原处。有东西无法迁移时(例如游戏还在从某个实例运行),所有步骤都会撤销,启动器本次以旧布局运行,下次启动再试。storage-migration.json 记录了什么被移到了哪里;之后桌面快捷方式会更新到新位置。