一个用 Python 写的 Minecraft 启动器,目前提供命令行界面。
维护状态 由于学业原因,开发者已没有太多精力继续维护自己的项目。本项目会继续保留在这里, 但更新与问题修复会明显放缓,请不要期待及时响应。
- 安装 1.7+ 的原版实例,以及 Fabric、NeoForge 加载器实例
- 启动 1.7+ 的游戏实例(支持在线、离线、LittleSkin 登录,可指定内存与快速进入存档 / 服务器)
- 管理多个储存库(记录、切换、查看已安装版本数)
- 备份实例数据(可分别选择存档、模组、配置、资源包、光影包,默认只备份配置)
- 删除实例
- 服务器的记录、Ping 与一键进入
- 扫描并管理本机的 Java 入口点
- 查询玩家 UUID / 名称
需要 Python 3.14。
uv run .\cli.py --helpcli.py --help 会列出所有命令,任意命令加上 --help 都能看到详细参数。
大多数涉及实例的命令都支持 -r/--repo 指定储存库名称或路径,未指定时使用配置中选中的储存库。
启动器使用自己的数据结构(VersionMeta)和文件格式(实例目录下的 *.mpk)存放实例元数据,
而原版启动器以及 PCL 等第三方启动器只会写出 Mojang 格式的 *.json。
因此从其它启动器迁移过来的实例可能“缺少描述文件”,需要生成一次 .mpk 才能被识别。
| 命令 | 说明 |
|---|---|
install |
安装版本(可选加载器与加载器版本) |
launch |
启动指定名称的实例 |
list |
列出可用的 Minecraft 版本或本地实例 |
show |
显示单个实例的详细信息 |
remove |
删除实例 |
backup |
备份实例数据 |
fix-instance-metadata |
为缺少 .mpk 的实例生成描述文件,并自动推断 |
server |
服务器的记录、Ping 与进入 |
java |
扫描 / 列出本机的 Java |
repository |
管理储存库 |
mojang |
查询玩家 UUID / 名称 |
以下工作由 DeepSeek 完成:
list命令的修复:修正位置参数version无法生效、--type all无输出乃至崩溃、 在线模式下--type不参与去重、本地实例读取版本号的优先级错误(导致整合包被误判为 愚人节版本)等问题,并统一了版本号解析与筛选逻辑。fix-instance-metadata命令(新增):把第三方启动器写出的.json转换为启动器自己的.mpk,并自动推断原版版本号、加载器与加载器版本号、客户端主文件。推断完全基于本地信息 (clientVersion、id、以及与本储存库中已知版本的发布时间比对),默认不联网; 无法可靠推断时直接跳过,不会写入可能错误的版本信息。show命令(新增):展示实例的类型、原版版本号、加载器与加载器版本号、占用空间、 存档 / 资源包 / 光影包 / 模组 / 数据包数量,以及从客户端 jar 的version.json中读取的 资源包与数据包格式版本。
此外,以下结构性调整同样由 DeepSeek 完成:
MinecraftVersion.from_string:新增构造函数,修正1.RV-Pre1被误归为愚人节版本、26.4-snapshot-2的次版本号被快照编号覆盖的问题。- 解析客户端主文件:新增
app/core/files/client_version.py,读取客户端 jar 中的version.json(资源包 / 数据包格式、协议版本、Java 版本)。 - 清理第三方库的重复副本:删除
app/core/third_party。其内容早已迁移到app/third_party,旧副本已无任何代码引用,且因引用了已删除的模块而无法导入。 - 补充待办标记:服务端安装(
app/impls/installers/server)与存档目录抽象 (app/core/minecraft/directories/level.py)尚未完成,已在源码中以TODO标注。
- 同一个核心,不同的交互方式
- 极速的体验,更少的资源占用(这俩听起来不太能搭边……)
- 少一点 BUG
项目的许可证暂未定下。