2.7 KiB
2.7 KiB
Important
📢 公告：预计在 1.5.x 版本开始，停止对 macOS 平台的更新。
MeowLauncher 🐱
一个使用纯 Python 标准库实现的跨平台 Minecraft 启动器，带图形界面，支持第三方登录。
功能特性
- 🖥️ 图形界面（Tkinter），Windows / Linux / macOS 三端界面一致
- 📥 资源中心：启动器内一键下载游戏版本、Mod 与服务器插件（Modrinth）
- 🔑 第三方登录：支持 LittleSkin、Blessing Skin 等 authlib-injector 皮肤站（Yggdrasil 协议）
- ✅ 正版登录：支持 Microsoft 账号正版登录（OAuth 授权流程）
- 🎭 离线模式：自动生成与官方一致的离线 UUID
- 📦 自动获取官方版本清单，支持任意版本（
1.20.4、latest-release、latest-snapshot） - ⬇️ 自动下载客户端、依赖库、原生库、资源文件，SHA1 校验 + 断点续传
- 🧩 兼容新旧两版启动参数格式（1.13+ 的
arguments与旧版minecraftArguments） - ☕ 自动检测 Java（支持手动指定、
JAVA_HOME、PATH）
环境要求
- Python 3.8+（仅运行源码时需要，使用打包版则无需）
- Java（Minecraft 1.17+ 需要 Java 17+，1.12 及以前需要 Java 8）
使用方法
图形界面（推荐）
python3 launcher.py
或直接运行打包好的可执行文件：
- Windows:
MeowLauncher-windows-x86_64.exe - Linux:
./MeowLauncher-linux-x86_64 - macOS: 解压
MeowLauncher-macos.zip后打开MeowLauncher.app
界面操作：
- 选择登录方式：离线模式（填玩家名）、第三方登录（选皮肤站、填账号密码）或正版登录（微软账号，点「打开浏览器登录」→ 复制地址栏 URL 回来）
- 选择游戏版本（可勾选显示快照版）
- 设置最大内存、Java 路径、游戏目录（一般保持默认即可）
- 点击「启动游戏」
命令行模式
python3 launcher.py --cli --list-versions
python3 launcher.py --cli --username Steve --version 1.20.4 --max-mem 4096
第三方登录说明
支持所有兼容 authlib-injector 的皮肤站，内置预设：
| 皮肤站 | 地址 |
|---|---|
| LittleSkin | https://littleskin.cn/api/yggdrasil |
| Blessing Skin | https://skin.prinzeugen.net/api/yggdrasil |
登录时会自动下载最新版 authlib-injector.jar 并在启动时注入，无需手动配置。
常见问题
- 未找到 Java：在界面「启动设置」中手动指定 Java 可执行文件路径。
- 下载慢：首次启动需要下载数百 MB 文件，请耐心等待；再次启动会自动跳过已下载文件。
免责声明
本项目仅用于学习交流，与 Mojang / Microsoft 无关。Minecraft 版权归 Mojang Studios 所有。