侧栏八个大页，逐页说清楚

顶部三行分别是游戏版本、当前账号、内存策略，右侧是一枚很大的「启动游戏」。版本下拉里没有东西时会直接提示前往版本管理安装，不会让你对着一个空列表发呆。

• 启动前自动补齐缺失的资源与库，缺文件不用自己下
• 内存策略默认「智能分配」，按启动那一刻的实时可用内存算，不是写死的固定值
• 四张实时状态卡：Java 就绪、网络连通、下载任务、磁盘余量，红黄绿一眼看得懂
• 四个快捷入口：新装版本、模组中心、账号管理、数据目录（直接打开资源管理器定位到 APP\MCGAME）
• 左下角常驻当前账号，右下角是运行状态灯与版本号

状态卡里的「网络异常」通常只是某个源站不通，下载引擎会自动换源，不影响已经在本地的资源启动。

模型用 LLamaSharp 加载 GGUF 权重，推理完全在本地完成。RTX 30–50 系走 CUDA 12 后端，显存够就整层卸载到显卡；没有支持的独显时自动切 CPU 后端，只是慢一点，功能一样。

• 对话区支持「仅处理 Minecraft 任务」开关，关掉它就只回答游戏相关的问题
• 模型设置子页：选择已下载的模型、把 .gguf 文件直接拖进来、查看与删除已有模型
• 自然语言先转成结构化意图，再走确定性的 Modrinth 安装流程 —— 模型只负责理解，不负责瞎猜参数
• 能做的事：找版本、搜模组、装整合包、解释崩溃日志、给内存与 JVM 参数建议
• GPU 加速开关在「设置 → 泡芙助理」里，显存低于 4 GB 会自动禁用加速

安装包不含 2.3 GB 的模型权重。想用它需要先拿到模型文件（群公告有含模型的完整资源包），拖进模型页即可；没有模型时，其余七个页面完全不受影响。

本地版本：列表里能对单个实例做启动、重命名、克隆、导出、删除，并按正式版 / 快照 / 远古版 / 愚人节版筛选。克隆用来试模组冲突，导出用来分享给朋友。

新装版本：三步向导 —— 选游戏版本 → 选 loader → 确认安装，全程有实时进度条，中途能取消。

版本设置：每个实例单独设内存上下限、用哪个 Java、窗口分辨率与全屏、loader 版本，互不影响。

版本工具：六个标签页，出问题主要在这里查。

• 配置快照
• 日志与崩溃
• 启动记录
• 脚本与磁盘
• 环境校验
• 资源与存档

• 崩溃时自动归纳可能原因，OOM 会上调 Xmx 再试一次
• 完整性快检 / 深检，缺什么补什么，不用重装
• 存档、材质、光影、截图都能一键定位到目录

管理模组：启用 / 禁用不用删文件，兼容性检查会标出与当前版本或 loader 不匹配的项，批量迁移能在「移动」和「复制」之间选（复制用来保命，移动用来省磁盘），一键更新会按当前版本找新版本模组。

下载模组：接 Modrinth 热榜与搜索，结果自动按当前实例的游戏版本与 loader 过滤，还会把依赖一起解出来 —— 不会出现装完才发现少个前置库的情况。

• 把 .jar 或压缩包直接拖到窗口上，按内部结构自动判断是模组、材质包、光影还是整合包
• 禁用状态用改名保留原文件，随时能开回来
• 模组列表支持按名字与来源排序，几百个模组也能找

在线侧直接浏览 Modrinth 整合包，选中后装成一个新实例，依赖与配置一次到位。本地侧支持五种主流打包格式，从别的启动器搬家基本不用动手改目录。

• Modrinth .mrpack
• CurseForge
• Prism / MultiMC
• HMCL / Technic
• 懒人包 / PCL2 文件夹

• 导入时能选择覆盖、合并或另建新实例，不会偷偷改你正在玩的包
• 自己调好的包可以导出成 .mrpack 发给朋友
• 大型包（例如 GTNH）导入后会提示套用对应的 JVM 预设

所有下载任务集中在这里：排队顺序、聚合速率、单任务进度、暂停 / 重试 / 取消。最小化到托盘后继续下载，不用开着窗口等。

• Mojang 与 BMCLAPI 双源，一个源慢或断了自动切另一个
• 单文件最多 8 分块并发，配合 Range 断点续传，网断了不用从头下
• 每个文件落地后做 SHA1 校验，校验不过自动重下
• 可按类别限制并发，避免材质把库的带宽抢光
• 支持全局限速，边下边玩不掉帧

正版登录走微软 OAuth 授权码流程：本机在 127.0.0.1:54321 起一个一次性回环监听接回调，拿到令牌后依次换 Xbox Live、XSTS、Minecraft 服务票据。整个过程只和你的微软账号与微软服务器通信，启动器不经过任何第三方服务器。

• 令牌用 Windows 自带的 DPAPI 加密后存本地，换一台机器就解不开，不会被拷走
• 多账号并存、随时切换，离线账号用于没有正版的场景
• 正版皮肤直接拉取；离线皮肤按 UUID 生成确定性头像并本地缓存，下次断网也认得
• 支持上传 / 更换皮肤（用的是你自己的微软账号权限）

请使用你自己购买的微软账号。本站与 Mojang、Microsoft 无关联，也不会向你索要账号密码。

游戏设置

内存上下限、窗口分辨率与全屏、JVM 参数模板、启动参数

Java 运行时

推荐档位提示、内置 JDK 8 / 21 / 25 选择、下载源（Adoptium / 华为云 / 清华）

路径设置

数据根目录、实例目录、下载缓存位置，搬家时改这里

网络设置

资源下载源、代理设置、超时与重试

外观设置

主题卡片选择、背景图与透明度、窗口圆角与动效

下载设置

速率预设、线程数、分块数、全局限速

高级设置

自更新开关、环境自检、日志级别与导出

泡芙助理

GPU 加速开关、显存阈值、模型目录

配置写入是原子的（先写临时文件再替换），断电也不会写出半个坏配置。环境自检会把 .NET 运行时、系统位数、VC++ 运行库、Java、磁盘空间、源站连通性一次查完并给出修法。

1. 装好并打开安装后直接启动，首次运行会跑一次环境自检，缺什么会明确告诉你缺什么。
2. 装一个版本版本管理 → 新装版本 → 选正式版 → 选 Fabric 或 NeoForge → 等待进度完成。
3. 登录账号账号页点微软登录，浏览器里授权后自动回到启动器；没有正版就先建离线账号。
4. 回主页启动主页选刚装的版本和账号，点启动游戏。想加模组去模组管理下载，想换外观去设置 → 外观。