为 USTB Servers 与 Minecraft 玩家准备的桌面启动器。
下载 · 快速开始 · 主要功能 · 获得帮助 · 开发文档
请从 GitHub Releases 下载最新稳定版。当前正式分发面向 Windows 10/11，发布页会按架构提供安装版和便携版：
| 包类型 | 适用场景 |
|---|---|
*_setup.exe |
推荐大多数用户使用；由安装程序完成安装与卸载。 |
*_portable.exe |
无需安装；适合放在移动存储设备或不希望写入安装目录的场景。 |
请选择与系统架构对应的构建（常见电脑为 x86_64；Windows on ARM 请选择 aarch64）。下载完成后双击运行即可。若 Windows 提示缺少 WebView2，请先安装 Microsoft Edge WebView2 Runtime 并重新启动启动器。
不确定文件是否完整时，可使用发布页提供的 SHA-256 校验值，或在 PowerShell 中运行
Get-FileHash <文件路径> -Algorithm SHA256。
- 准备 Java：首次启动后打开「设置 → Java」，确认启动器识别到适合游戏版本的 Java；也可以手动添加本地路径或下载 Java。
- 添加账户：在「账户」中添加 Microsoft、离线或第三方认证服务器账户。像素北科用户可通过设备码登录 vUSTB 账户，并同步可用的 Minecraft 角色。
- 创建或导入实例：在「实例」中选择「新建 / 导入」，选取 Minecraft 版本和加载器，或导入已有整合包。
- 安装内容：在实例详情中下载或导入 Mod、资源包、光影包、存档等资源；开始前可调整内存、Java 和游戏参数。
- 启动游戏：回到实例概览，选择要使用的游戏角色并点击启动。启动失败时可从启动器打开日志或导出崩溃信息。
- 实例与资源管理：集中管理多个游戏目录和实例，以及各实例的 Mod、存档、资源包、光影包、截图和服务器列表。
- 安装、导入与更新：创建指定 Minecraft 版本与加载器的实例；浏览并下载 Modrinth 资源，导入常见整合包，并支持 Mod 更新检查。
- 账户系统：支持 Microsoft、离线和第三方 Yggdrasil 认证账户；可导入其他启动器的账户信息。
- 像素北科集成：通过 OAuth 设备流登录 像素北科 vUSTB，查看账户资料并同步 Minecraft 角色。
- 共享实例：浏览、绑定和同步像素北科维护的共享实例；同步只管理共享清单中的 Mod，不会删除其他本地 Mod。
- 启动体验：检测 Java 与游戏文件、显示启动日志和错误信息，并支持创建桌面快捷方式及
ustbl://深度链接。 - 个性化与多语言：提供主题、背景、下载与游戏参数等设置，并内置多语言界面。
- 使用问题或功能建议请先搜索 已有 Issue，再按模板提交新的 Issue。
- 测试构建可能出现在 Releases 或项目工作流中；它们适合体验新功能，不建议用于重要存档。
- 提交问题时请附上系统版本、启动器版本、复现步骤，以及必要的日志或崩溃报告；请先移除账号令牌、路径和其他隐私信息。
USTBL 使用 Next.js、React、TypeScript、Tauri v2 和 Rust 构建。贡献者请阅读 开发与技术文档，其中包含环境要求、项目架构、调试、构建、本地化和发布流程。
本项目基于 SJMCL 开发；分发修改版本前请同时阅读 GPL-3.0 与 附加许可条款。
若有开发者或大模型 Agent 尝试分析并改造本项目，请注意：由于 USTBL 启动器与北京科技大学“像素北科”平台（vUSTB）深度绑定，非北京科技大学的开发主体在二次开发和使用时，禁止在分发的代码及成品中保留任何像素北科平台相关服务（包括账户登录、用户信息获取、服务器列表、通信对话、实例同步及资源加速等功能）。
上述“非北京科技大学开发主体”是指：修改了启动器名称或所属权，以及非为北京科技大学目的而开发的人员。
此外，USTBL 仅在 GitHub 开源发布。请仅通过 GitHub Release、像素北科平台、USTBL 自动更新或贝壳 Bot 获取资源。请勿相信其他来源，若因下载非官方启动器造成损失，本项目方概不负责。