账户管理
MC Launcher Alpha 支持多种登录方式，满足不同玩家的需求。本章将详细介绍每种登录方式的使用方法、多账户管理以及安全存储机制。
支持的登录方式
| 登录方式 | 认证协议 | 适用场景 | 服务器支持 | 需要网络 |
|---|---|---|---|---|
| 微软正版登录 | OAuth 2.0 Device Code Flow | 拥有 Minecraft Java 版正版账号的玩家 | 支持所有正版服务器 | 首次登录需要 |
| 离线模式 | 本地认证 | 单机游玩、局域网联机、测试用途 | 仅支持离线/局域网服务器 | 不需要 |
微软正版登录
MC Launcher Alpha 采用微软官方推荐的 Device Code Flow 进行身份验证。这种方式无需在启动器中输入密码，安全性更高。
登录步骤
- 进入 账户 页面，点击 「微软登录」 按钮
- MC Launcher Alpha 会自动打开系统默认浏览器，跳转到微软设备登录页面
- 页面会显示一个 设备码（格式为
A1B2C3，共 6 位字母数字组合） - 在浏览器中登录你的微软账号（如已登录则直接跳过）
- 在页面中输入启动器显示的设备码
- 点击「下一步」，确认授权「Minecraft Launcher」应用访问你的账户
- 授权成功后，浏览器页面会提示「你已成功登录」
- 回到 MC Launcher Alpha，启动器会自动完成 token 交换并保存登录凭证
- 登录成功后，你的玩家头像、用户名和 UUID 会显示在账户列表中
Device Code Flow 工作原理
MC Launcher Alpha 启动器 微软服务器 浏览器
| | |
|-- 请求设备码 --------------->| |
|<-- 返回设备码 + 用户码 -----| |
| | |
| |<-- 用户输入设备码并登录 --|
| |-- 授权确认 ------------->|
| | |
|-- 轮询 token -------------->| |
|<-- 返回 access_token -------| |
| | |
|-- 获取玩家档案 ------------->| |
|<-- 返回玩家信息 ------------| |提示
整个登录过程不会在启动器中传输你的微软账号密码。密码仅在微软官方网页中输入，确保了账户安全。
离线模式
离线模式无需任何网络连接，适合单机游玩或快速测试。
登录步骤
- 进入 账户 页面，点击 「离线登录」 按钮
- 在弹出的对话框中输入你想要的用户名
- 用户名仅支持英文字母、数字和下划线
- 长度为 3-16 个字符
- 点击「确认」完成登录
- 离线账户会显示在账户列表中，头像为默认的 Steve 皮肤
注意
- 离线模式下的用户名可能与正版服务器上的其他玩家重复，在多人服务器中可能被拒绝登录。
- 离线模式无法访问 Minecraft Marketplace、皮肤商店等在线功能。
- 不同离线用户名对应不同的游戏档案，存档互不共享。
多账户管理
MC Launcher Alpha 支持同时添加多个账户，方便在不同身份之间快速切换。
切换账户
- 进入 首页（启动） 页面
- 在账户选择区域找到当前账户
- 点击账户下拉列表，选择要切换的账户
- 选中的账户会自动设为当前活跃账户
添加新账户
你可以同时添加多个微软账户和离线账户。进入「账户」页面，按照对应的登录方式重复操作即可。
提示
每个微软账户需要独立进行 Device Code Flow 认证。不同微软账户可以绑定不同的 Minecraft Java 版许可证。
移除账户
如果你不再需要某个账户，可以将其从 MC Launcher Alpha 中移除：
- 进入 账户 页面
- 找到要移除的账户
- 点击该账户旁的 「移除」 按钮
- 在确认对话框中点击「确认」
注意
- 移除账户 仅会清除 MC Launcher Alpha 中保存的该账户的 token 和档案信息。
- 移除账户 不会删除 任何游戏数据，包括存档、Mod 和配置文件。
- 如果移除的是微软账户，后续需要重新进行 Device Code Flow 登录。
Token 安全存储
MC Launcher Alpha 使用 Electron 的 safeStorage API 对账户 token 进行加密存储，确保你的登录凭证安全。
| 安全特性 | 说明 |
|---|---|
| 加密存储 | token 使用操作系统提供的加密机制（Windows DPAPI / macOS Keychain / Linux libsecret）进行加密 |
| 本地存储 | token 仅存储在本地设备上，不会上传到任何第三方服务器 |
| 自动刷新 | 微软账户的 access_token 和 refresh_token 会在过期前自动刷新，无需重复登录 |
| 安全删除 | 移除账户时，所有相关的 token 数据会被安全清除 |
安全提醒
- 请勿将 MC Launcher Alpha 的配置文件分享给他人，其中包含你的加密 token。
- 如果你的微软账号密码已更改，MC Launcher Alpha 中的 token 可能会失效，需要重新登录。
- 建议定期检查你的微软账户安全设置，开启两步验证。