70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
> [!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）
|
||
|
||
## 使用方法
|
||
|
||
### 图形界面（推荐）
|
||
|
||
```bash
|
||
python3 launcher.py
|
||
```
|
||
|
||
或直接运行打包好的可执行文件：
|
||
- Windows: `MeowLauncher-windows-x86_64.exe`
|
||
- Linux: `./MeowLauncher-linux-x86_64`
|
||
- macOS: 解压 `MeowLauncher-macos.zip` 后打开 `MeowLauncher.app`
|
||
|
||
界面操作：
|
||
1. 选择登录方式：离线模式（填玩家名）、第三方登录（选皮肤站、填账号密码）或正版登录（微软账号，点「打开浏览器登录」→ 复制地址栏 URL 回来）
|
||
2. 选择游戏版本（可勾选显示快照版）
|
||
3. 设置最大内存、Java 路径、游戏目录（一般保持默认即可）
|
||
4. 点击「启动游戏」
|
||
|
||
### 命令行模式
|
||
|
||
```bash
|
||
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 所有。
|