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