命令行
Windows
不带参数运行 LeviLauncher.exe 会打开启动器窗口。带上命令时,它在终端中运行并在完成后退出,命令采用 <名词> <动词> 的格式:
text
LeviLauncher.exe <command> [arguments] [flags]本页列出 LeviLauncher 1.1.0 的全部命令。LeviLauncher.exe help <command> 会打印每个命令的参数和示例,LeviLauncher.exe help 打印总览。命令行的输出是英文。
text
LeviLauncher.exe install latest --loader --use
LeviLauncher.exe play
LeviLauncher.exe mod install LiteLDev/LegacyMoney
LeviLauncher.exe world export "My World" -o D:\Backups
LeviLauncher.exe instance list --json在 shell 中运行
LeviLauncher.exe 是窗口程序,所以 shell 默认不会等待它结束。需要在提示符返回之前看到输出,或需要它的退出码时:
- 在 cmd 中使用
start /wait LeviLauncher.exe ...,然后读取%ERRORLEVEL%; - 在 PowerShell 中把输出接到管道(
LeviLauncher.exe instance list | Out-String),或使用Start-Process -Wait -NoNewWindow。
命令行不会打开窗口,窗口开着时也可以运行。
命令
日常
| 命令 | 作用 |
|---|---|
play [<instance>] |
启动游戏并等到游戏窗口出现(launch 的别名) |
install <version|file> |
下载 Minecraft 并安装为新实例(= instance create) |
use [<instance>] |
设置或显示默认实例 |
stop [<instance>|<pid>...] |
关闭正在运行的 Minecraft(= process stop) |
管理实例
| 命令 | 作用 |
|---|---|
instance list [<filter>] |
列出已安装的实例 |
instance show [<instance>] |
显示实例的设置、注册状态、加载器、玩家和内容数量(也可写作 instance <instance>) |
instance create <version|file> |
下载 Minecraft 并安装为新实例 |
instance copy-data [<instance>] --from system|<instance> |
把游戏数据(世界、设置)复制到使用自有数据的实例 |
instance rename <instance> <new-name> |
重命名实例 |
instance set [<instance>] |
更改实例设置(控制台、编辑器模式、自有数据、启动参数、环境变量、图标) |
instance remove <instance>... |
永久删除实例及其文件夹中的一切 |
instance register [<instance>] |
让 Windows 把该实例当作其通道已安装的 Minecraft |
instance unregister [<instance>] |
解除实例在 Windows 中的注册(游戏数据保留) |
instance shortcut [<instance>] |
创建启动该实例的桌面快捷方式,或删除它 |
instance path [<instance>] [<kind>] |
打印实例的某个文件夹(并可打开它) |
mod list [<filter>] |
列出实例的模组 |
mod show <package> |
显示模组目录中的一个模组 |
mod search [<words>] |
搜索 LeviLamina 模组目录 |
mod install <package[@version]>... |
从模组目录安装、升级或降级模组 |
mod update [<mod>...] |
把目录中的模组更新到最新版本 |
mod import <file>... |
从 .mcmod、.zip 或 .dll 文件添加模组 |
mod set <mod> |
修改模组的清单(manifest) |
mod remove <mod>... |
从实例中删除模组 |
mod enable <mod>... | --all |
开启模组 |
mod disable <mod>... | --all |
关闭模组而不删除 |
mod path [<mod>] |
打印某个模组或实例模组文件夹的路径 |
loader versions |
列出某个游戏版本可用的 LeviLamina 版本 |
loader install [<version>] |
在实例上安装 LeviLamina,或更换其版本 |
loader remove |
从实例中删除 LeviLamina |
world list [<filter>] |
列出实例和玩家的世界 |
world import <file.mcworld>... |
从 .mcworld 文件导入世界 |
world export <world>... |
把世界导出(备份)为 .mcworld 文件 |
world copy <world>... |
把世界复制到另一个实例 |
world rename <world> <new-name> |
更改世界的显示名称 |
world get <world> [<key>[/<sub>...]] |
读取 level.dat 中的世界设置 |
world set <world> <key>[/<sub>...]=<value>... |
修改 level.dat 中的世界设置 |
world remove <world>... |
永久删除世界 |
pack list [<filter>] |
列出资源包、行为包和皮肤包 |
pack import <file.mcpack|file.mcaddon>... |
从 .mcpack 和 .mcaddon 文件安装包和附加包 |
pack copy <pack>... | --all |
把包复制到另一个实例 |
pack remove <pack>... |
删除已安装的包 |
screenshot list |
列出实例和玩家的截图,最新的在前 |
screenshot remove <name|path>... | --all |
删除截图 |
server list [<filter>] |
列出保存的服务器并检查是否在线 |
player list |
列出 GDK 实例的玩家档案 |
backup list [<instance>] |
列出实例备份和世界备份(预览功能) |
backup create [<instance>] |
备份实例的游戏数据和模组(预览功能) |
backup restore [<instance>] <archive.zip> |
恢复实例备份(预览功能) |
查找可安装的内容
| 命令 | 作用 |
|---|---|
installer search [<version>] |
列出可以安装的 Minecraft 构建 |
installer download <version> |
只下载某个构建的安装包,不安装 |
installer list |
列出已下载的安装包,包括未完成的下载 |
installer remove <version|file>... |
删除已下载的安装包以释放磁盘空间 |
installer mirrors <version> |
测量某个 GDK 构建的下载镜像 |
curseforge search [<words>] |
在 CurseForge 上搜索世界、附加包、资源包和皮肤(名词的别名:cf) |
curseforge show <id> |
显示一个 CurseForge 项目 |
curseforge categories |
列出可用于筛选的 CurseForge 类别和分类 |
curseforge install <id> |
下载一个 CurseForge 文件并导入到实例 |
这台电脑与启动器
| 命令 | 作用 |
|---|---|
process list |
列出正在运行的 Minecraft 进程,包括不是由启动器启动的(别名:ps) |
process stop [<instance>|<pid>...] |
强制关闭正在运行的 Minecraft(上次自动保存之后的进度会丢失) |
account status |
显示已登录的微软账号以及它拥有哪些版本 |
account login |
登录微软账号,或切换账号 |
account logout |
让启动器忘记它的微软账号 |
config list |
列出启动器设置和文件夹 |
config get <key> |
打印某个设置的值 |
config set <key> <value> |
修改某个设置 |
config unset <key> |
把某个设置恢复为默认值 |
cache clean [packages|downloads|partial]... |
释放缓存占用的磁盘空间 |
doctor [--fix [<fix>...]] |
检查这台电脑上 Minecraft 和模组需要的东西;--fix 修复(vcruntime、gameinput、loader-migration、developer-mode) |
self-update |
把 LeviLauncher 自身更新到最新版本 |
version |
打印版本信息 |
help [<command>...] |
任意命令的帮助和示例 |
每个 list 动词也可以写作 ls,每个 remove 动词也可以写作 rm。config 读取和修改的设置列在全部设置中。
版本与软件包
install和installer的<version>是installer search列出的构建:完整版本号(1.21.50.07)、带点的前缀(1.21.50表示最新的1.21.50.x;1.21.5不匹配它)或latest。<file>是本地的.msixvc、.appx、.msix、.appxbundle或.msixbundle。mod install的<package>是owner/repo、github.com/owner/repo或一个 URL,可以加上#variant和@version。
全局参数
以下参数适用于所有命令:
| 参数 | 含义 |
|---|---|
-i、--instance <name> |
要操作的实例 |
-p、--player <id|gamertag> |
玩家档案(GDK 实例) |
--json |
在 stdout 上输出机器可读的结果 |
-q、--quiet |
只打印标识符;不显示进度和提示 |
-v、--verbose |
显示更多细节,并把启动器日志输出到 stderr |
-y、--yes |
对所有确认回答“是” |
--no-input |
从不提示输入 |
-h、--help |
显示命令的帮助 |
--version |
打印版本 |
使用哪个实例:-i,否则环境变量 LEVILAUNCHER_INSTANCE,否则默认实例(use),否则唯一的实例。使用哪个玩家:-p,否则 LEVILAUNCHER_PLAYER,否则唯一的档案,否则已登录账号的档案。
输出
- 结果输出到 stdout。进度、提示和错误输出到 stderr;错误以
error:开头,附带hint:和错误码,例如[ERR_GAME_RUNNING]。 --json打印一个 JSON 文档:列表为数组,其他为对象;键名为 camelCase,时间为 RFC 3339 格式,大小以字节为单位。-q只打印标识符,每行一个。
退出码
| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 失败 |
| 2 | 用法错误 |
| 3 | 未找到 |
| 4 | 冲突(例如游戏正在运行) |
| 5 | 登录或授权 |
| 6 | 网络 |
| 7 | 部分完成 |
| 8 | 需要更改系统或管理员权限 |
| 9 | 超时 |
| 10 | 已取消 |
| 130 | 被中断(Ctrl-C) |
launch --wait-exit 改为返回游戏自己的退出码。
窗口参数
以下参数会打开窗口,而不是运行命令:
| 参数 | 作用 |
|---|---|
--launch=<instance> |
打开启动器并启动该实例;桌面快捷方式使用的就是它。启动器已经在运行时,在已运行的启动器中启动该实例。 |
--debug |
同时在控制台窗口中显示启动器日志(也可以写作 debug、-debug 和 /debug)。 |