基于 Tauri 和 React 构建的快速、开源 Minecraft 启动器。
🌐 English
整理实例、发现社区内容、管理 Java、启动 Minecraft…一个应用就够了！
|
井井有条的实例管理 创建、分组、复制、导出、置顶、搜索和筛选实例。 自由选择安装路径，并导入已有的 MultiMC 或 Prism 实例库。 |
无需打开浏览器即可获取内容 从 Modrinth 或 CurseForge 安装模组、整合包、光影、资源包和数据包。 排序、更新并保存可复用的模组档案。 |
|
触手可及的玩家工具 管理世界和备份，浏览截图，实时追踪服务器状态，并为每个实例单独控制资源包和光影。 |
自动处理账户与 Java 使用 Microsoft、离线或 Yggdrasil 账户。Refract 会查找或下载正确的 Java 运行时，并提供可选的性能预设。 |
Refract 还包含自动更新、崩溃报告复制、可自定义主题、Discord Rich Presence 以及 Java Edition 许可证验证。
curl -fsSL https://refractmc.net/install.sh | sh
| 平台 | 下载包 |
|---|---|
| Windows 10/11 | 下载 .exe |
| macOS — Apple Silicon | 下载 ARM64 .dmg |
| macOS — Intel | 下载 Intel .dmg |
| Linux — AppImage | 下载 .AppImage |
| Linux — Debian/Ubuntu | 下载 .deb |
| Linux — Fedora | 下载 .rpm |
| Linux — Arch/AUR | yay -S refract-launcher-bin |
| 其他包 | 查看最新版本 |
Note
macOS 构建目前未签名。首次启动时，请右键点击 Refract， 选择打开，然后确认安全提示。
React 渲染层负责启动器体验。Tauri 和 Rust 提供原生外壳、安全凭据存储、下载、文件操作和平台集成。
- Node.js 20 或更高版本
- pnpm 9 或更高版本
- Rust stable
- 对应操作系统的 Tauri 前置依赖
Windows 打包还需要 WebView2 和 Microsoft C++ 构建工具。
git clone https://github.com/RefractMC/Refract_MC.git
cd Refract_MC
pnpm install
pnpm dev生成本地未签名构建：
pnpm build有关验证命令、签名构建、项目规范和 pull request 指南，请参见 CONTRIBUTING.md。
仓库结构
apps/renderer包含共享的 React 渲染层。apps/tauri包含 Tauri 外壳和 Rust 后端。packages/core包含共享的启动器逻辑。packages/plugin-api包含公共插件 API。locales包含翻译文件。docs包含项目文档。
Refract 将用户界面字符串存放在 locales 目录中。要添加新语言，请复制 locales/en.json，以 BCP 47 语言标签命名，翻译所有值，并保持每个 JSON 键不变。
翻译指南 说明了语言注册、 参数化字符串、验证和 pull request 命名规范。
- 通过 GitHub Issues 报告可复现的 bug。
- 加入 Refract Discord 寻求社区帮助、参与项目讨论。
- 报告漏洞前请阅读 安全策略。
- 提交 pull request 前请阅读 贡献指南。
Refract 采用 GNU General Public License v3.0 许可证。