文档与常见问题
从安装到联机，一步步来。
新手引导
1. 到 下载页 取对应平台的安装包，双击安装。
2. 首次启动会让你添加账号：选"离线"可立即试玩，选"微软"或"LittleSkin"可联机/用皮肤。
3. 在版本列表里选一个游戏版本，点"启动"即下载资源并进游戏。
提示：GBL 自带 JRE，无需另外安装 Java。账号数据保存在
~/.gbl 目录。LittleSkin 联机配置
LittleSkin 是正版皮肤站，配合 authlib-injector 可实现外置鉴权联机。
- 在账号管理里添加 LittleSkin 账号（认证需带
agent: {name: Minecraft, version: 1}，缺了会返回 400）。 - GBL 已内置 authlib-injector 并自动注入，启动联机服务端时选"外置联机"模式即可。
- 若下载失败，GBL 会自动尝试 GitHub 镜像兜底。
联机房间由服务器提供方决定；GBL 只负责把账号鉴权接上，不提供房间托管。
微软登录排错
微软登录走设备码流：启动器显示一串设备码 → 浏览器打开提示的地址 → 输入设备码授权。
- 一直转圈 / 拿不到令牌：检查系统代理；GBL 会读取 Windows 系统代理，微软/OAuth 走代理，Mojang 与 LittleSkin 直连。
- 儿童账号报错：错误码
2148916233多为儿童账号需家长同意；2148916238为该账号未开通 Xbox。 - 令牌过期：上传皮肤等操作前会自动 refresh，一般无需手动重登。
常见问题
- GBL 是正版启动器吗？不是。它支持离线、微软与外置联机多种账号，是否为正版取决于你用的账号类型。
- 需要装 Java 吗？不需要，安装包已自带 JRE。
- 皮肤在游戏里看不见？离线换肤依赖本地皮肤服务注入，确认启动方式选了对应模式；微软换肤为全局生效。
- macOS 打不开？右键 dmg/AppImage → "打开"放行即可（未做 Apple 公证）。
- 数据在哪？账号与配置在
~/.gbl，重装前备份该目录即可保留账号。