下载与安装
本章介绍如何获取 VoxVer Launcher 启动器并完成安装，同时也提供从源码构建的方法供开发者参考。
下载
VoxVer Launcher 的正式发布版本托管在 GitHub Releases 上。
前往 GitHub Releases 页面，找到最新版本，下载对应的安装包。
| 文件名 | 说明 | 适用平台 |
|---|---|---|
VoxVer Launcher Setup x.x.x.exe | NSIS 安装程序（推荐） | Windows |
VoxVer Launcher x.x.x.zip | 便携版压缩包（免安装） | Windows |
VoxVer Launcher-x.x.x-arm64.dmg | macOS ARM64 安装包（推荐，Apple Silicon） | macOS (Apple Silicon) |
VoxVer Launcher-x.x.x-x64.dmg | macOS x64 安装包 | macOS (Intel) |
推荐
普通用户建议下载 NSIS 安装程序，安装后会自动创建桌面快捷方式和开始菜单项，后续更新也更方便。
Windows 安装步骤
使用安装程序
- 下载
VoxVer Launcher Setup x.x.x.exe安装包 - 双击运行安装程序
- 如果出现 Windows SmartScreen 提示，点击「更多信息」->「仍要运行」
- 按照安装向导提示选择安装路径（默认路径为
C:\Users\<用户名>\AppData\Local\Programs\VoxVer Launcher） - 选择是否创建桌面快捷方式
- 点击「安装」，等待安装完成
- 安装完成后，VoxVer Launcher 会自动启动
使用便携版
- 下载
VoxVer Launcher x.x.x.zip压缩包 - 解压到任意目录（建议路径中不包含中文或特殊字符）
- 双击
VoxVer Launcher.exe即可运行
注意
便携版不会自动创建快捷方式，也不会写入注册表。更新时需要手动下载新版本并替换文件。
macOS 安装步骤
macOS 版本目前仍在 计划开发中，暂无可用安装包。我们将尽快完成 macOS 构建并发布，请持续关注 GitHub Releases。
提示
- macOS 版本上线后将与 Windows 版本功能保持一致，计划支持 ARM64 / x64 双架构。
Linux 安装步骤
Linux 版本目前仍在 计划开发中，暂无可用安装包。我们将尽快完成 Linux 构建并发布，请持续关注 GitHub Releases。
提示
- Linux 版本上线后将与 Windows 版本功能保持一致，计划支持 x64 架构。
从源码构建
源码构建、开发环境与依赖说明已移至开发文档，请参阅 开发指南。
首次启动检查清单
完成安装后首次启动 VoxVer Launcher，建议按以下顺序进行检查和配置，确保启动器能够正常工作：
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 检查 Java 路径 | 进入「设置」页面，确认 Java 路径是否已自动检测到。若未检测到，请手动指定，详见 Java 设置 |
| 2 | 确认游戏目录 | 默认游戏目录为系统用户目录下的 .minecraft。如需更改，详见 自定义游戏路径 |
| 3 | 添加游戏账户 | 进入「账户」页面，添加微软正版账户或离线账户，详见 账户管理 |
| 4 | 安装游戏版本 | 进入「版本」页面，刷新版本列表并安装所需版本，详见 版本管理 |
| 5 | 启动游戏 | 回到首页，选择已安装的版本，点击「启动游戏」 |