MeowLauncher

一个使用纯 Python 标准库实现的 Minecraft 启动器，零第三方依赖，跨平台（Windows / Linux / macOS）。

功能特性

• 自动获取官方版本清单，支持任意版本（1.20.4、latest-release、latest-snapshot）
• 自动下载游戏客户端、依赖库（libraries）、原生库（natives）与资源文件（assets）
• 自动校验 SHA1，断点续传（已存在且校验通过则跳过）
• 原生库自动解压到 versions/<id>/natives
• 离线模式（自动生成与官方一致的离线 UUID）
• 支持新旧两版启动参数格式（1.13+ 的 arguments 与旧版 minecraftArguments）
• 自动检测 Java（支持 --java 指定、JAVA_HOME、PATH）

环境要求

• Python 3.8+
• Java（Minecraft 1.17+ 需要 Java 17+，1.12 及以前需要 Java 8）

使用方法

# 查看可用版本
python3 launcher.py --list-versions

# 启动最新发布版（离线模式，默认玩家 Steve）
python3 launcher.py --username Steve

# 启动指定版本，指定内存
python3 launcher.py --username Steve --version 1.20.4 --max-mem 4096

# 指定游戏目录与 Java 路径
python3 launcher.py --username Steve --version 1.20.4 \
    --game-dir /home/steve/.minecraft \
    --java /usr/lib/jvm/java-17/bin/java

Windows 下将 python3 换成 python 即可。

目录结构

~/.minecraft/
├── versions/<id>/          # 版本 jar、json、natives
├── libraries/              # 依赖库
└── assets/                 # 资源索引与对象

常见问题

• 未找到 Java：使用 --java 指定 Java 可执行文件路径。
• 下载慢：首次启动需要下载数百 MB 文件，请耐心等待；再次启动会自动跳过已下载文件。
• 正版账号：当前版本为离线模式，正版登录接口已预留（auth 参数），后续版本将支持 Yggdrasil 认证。

免责声明

本项目仅用于学习交流，与 Mojang / Microsoft 无关。Minecraft 版权归 Mojang Studios 所有。