___ ___ ___ ___ __
/ __><_) \ /|_ _| __| |_ _ ___ ___ / /_
| (__| \ \/ | | | _| | ' \/ -_) -_) | ' \
\___|_|\_\_/\_|_\_| |_|_||_\___\___| |_||_|
── MCore Launcher ──────────────────────────
1B1T 私有镜像专用 · 三端通用 · 开箱即玩
Electron
TypeScript
React
Tailwind
Windows · macOS · Linux
MCore Launcher
轻量私有镜像 Minecraft 启动器 · 离线登录 · 多源自动切换 · 模组下载与加载器集成
功能特性
🔁
源自动切换
1B1T 优先 · BMCLAPI · 官方源
🔧
模组加载器
Forge / NeoForge / Fabric / Quilt
🧩
API 一键部署
Fabric API · Quilted Fabric API
🎨
主题 + 毛玻璃
亮/暗/跟随系统 · 透明度可调
下载
macOS 版为 ad-hoc 签名(无开发者证书):打开 dmg 后拖入「应用程序」,首次打开请右键 →「打开」;若仍提示已损坏,执行 xattr -dr com.apple.quarantine "/Applications/MCore Launcher.app"
⚠ Windows 提示「已保护你的电脑」:安装包未签名,点「更多信息」→「仍要运行」即可。
系统要求:Node.js 20+、Java 8/16/17/21(按 MC 版本)
资源源
启动器默认从 1B1T 私有镜像拉取资源,自动降级 BMCLAPI → Mojang 官方源。
镜像覆盖:原版客户端 917 版本(jar + assets + libraries)、
Forge / NeoForge / Fabric / Quilt 加载器全版本、
fabric-api / qfapi 全版本。
快速开始
- 下载对应平台的安装包并安装
- 启动 MCore Launcher
- 左侧导航 Logo 下点击 + 添加账户(3-16 位字母数字下划线)
- 主页选择账户和版本(如 1.21.1)
- 可选:选择模组加载器及配套 API
- 点击「启动游戏」,自动下载资源并启动
数据源架构
资源同步流程:
Mojang / BMCLAPI(官方源)
↓
本地镜像 ~/1b1t-mirror(48GB)
↓
Rains3 存储桶 mcdown.cn-nb1.rains3.com(公网分发)
↓
启动器自动切换源
客户端资源同步使用独立脚本 scripts/sync-mirror.mjs,与启动器解耦。
镜像资源列表:/mirror/mc.php
技术栈
Electron + Vite + React + TypeScript + Tailwind CSS + Radix UI + Lucide
主进程 12 模块 · 渲染进程 5 页面 · 单元自测 15 项 · e2e 真机自测 11 项
更新日志
1.7.0 2026-11-13
- 新增 mousa 启动画面(460×360 无边框透明圆角,最短 2s、最长 6s,加载失败也会显示主窗口)
- 主窗口改为就绪后再显示,消除首屏白窗
- 构建链增加 scripts/copy-assets.mjs,把 splash.html 复制进 dist-electron
更新日志
1.6.0 2026-10-18
- 模组更新检测:按 jar 哈希反查 Modrinth,提示可更新版本,支持单个/全部更新
- 游戏崩溃分析:退出码异常时弹窗给出异常摘要、最近日志、崩溃报告入口
- 正常停止游戏不会再误报崩溃
- 包含 1.5.1 的 Fabric/NeoForge 启动修复、离线参数修复、已装版本加装加载器
更新日志
1.5.1 2026-10-18
- 修复 Fabric 启动缺少加载器库(classpath 遗漏)
- 修复 NeoForge 启动模块冲突(原版 jar 不再进 classpath)
- NeoForge 安装依赖增加 Maven Central/阿里云兜底,失败时给出明确缺失项
- 修复离线启动参数残留变量
- 已安装版本也可以再次打开安装对话框加装 Forge/NeoForge/Fabric
- macOS 重新签名(ad-hoc)+ dmg
更新日志
1.5.0 2026-10-18
- 新增 macOS 版 dmg(Apple Silicon / Intel,未签名)
- 新增「模组」页:Modrinth 搜索 / 一键安装 / 自动补装必需依赖 / 启用禁用删除(文件镜像优先)
- 启动提速:asar 打包、页面按需加载、Java 扫描缓存、已装版本离线启动、存档备份节流、natives 跳过重复解压
- 支持差分更新(只下载变更的界面/主进程文件)
- 修复:内存 -Xmx 位置错误被游戏忽略、规则求值、加载器版本在首页选不到、下载失败被吞、离线启动失败
- Forge / NeoForge 客户端安装改为官方 installer(镜像预灌 + 自动补 Java)