发芽启动器 · 全新系统安装与使用说明
版本：1.1.0（持续更新中） ｜ 适用：Windows 11（也兼容 Windows 10）
是新的启动器，可能有恶性bug（包括启动器核心功能失效，报错），希望各位尊敬的用户及时汇报，拜托了！！！我会及时修复的（大多数可以完成14天之内）
如果杀软汇报本启动器是病毒，请将该启动器加入杀软白名单，那是误报！
自8月30日起，约7天更新一次
QQ:2698778715
一、快速开始（3 步用起来）
第 1 步：安装（仅ZIP格式，MSI文件BBSMC禁止上传）
双击 发芽启动器-1.1.x.zip，解压到你希望的该启动器被安装的位置，即可完成安装。如果需要更新，将zip解压目录作为之前安装启动器的目录，它会自动替换文件。
- ✅ 无需安装任何依赖：Python、Java、运行库统统不用装，安装包全部自带
如果之前装过旧版本，直接覆盖安装即可，配置和游戏版本都会保留。
第 2 步：启动游戏
- 打开启动器，在「启动游戏」页点击「扫描版本」，会自动全盘扫描所有磁盘中的我的世界版本，可以无缝游玩上次玩的版本，支持PCL2,HMCL等主流启动器
- 选择你想玩的 Minecraft 版本（如 1.20.1）
- 点击「▶ 启动游戏」
🎁 首次启动会自动下载 Java：如果你的电脑没有 Java，启动器会从清华镜像自动下载合适的 Java 运行时（PCL2 同款机制），无需手动配置。首次启动游戏还需要下载游戏文件（几百 MB，取决于网络），耐心等待即可。
第 3 步：开始玩
启动成功后会弹出游戏窗口。首次进游戏建议先调好视频设置（低 → 高 逐步提升，避免卡顿）。
二、左侧导航栏功能总览
启动器左侧导航栏从上到下依次是：
| 导航项 | 功能 |
|---|---|
| ▶ 启动游戏 | 版本扫描、版本选择、启动/停止游戏、实时日志 |
| ⬇ 下载 | 下载游戏版本、模组、光影、整合包、资源包、数据包、服务端、插件 |
| 📊 下载管理 | 查看所有下载任务的进度、速度、剩余时间 |
| 🌐 联机 | 局域网/跨网联机、房间列表、一键开服 |
| 🤖 AI 助手 | 内置 AI 助手（问答、修崩溃、装模组、写配置） |
| 🎨 皮肤 | 皮肤管理（下载、预览、应用） |
| ⚙ 设置 | 登录方式、AI 模型、内存分配、语音识别等 |
| 🎛 个性化 | 界面主题颜色、按钮动效等外观定制 |
| ℹ 关于 | 版本信息、致谢 |
三、各功能详细介绍
🎮 启动游戏
- 版本扫描：自动扫描电脑上所有已安装的 Minecraft 版本（包括其他启动器装的）
- 启动/停止：一键启动或强制停止游戏
- 实时日志：启动日志实时显示，游戏出问题可以直接复制给 AI 助手分析
版本选择列表的标识（颜色说明）：
| 标识 | 含义 |
|---|---|
| 🔴 红色版本名 | 基础版本（父版本）：被其他版本依赖的底座版本。例如「1.20.1」原版是被「1.20.1-Forge」依赖的底座。鼠标悬停可看到它被哪些版本依赖；有删除保护，不能单独删除（删了依赖它的版本会崩）这是官方标准，PCL也有，只是把父版本藏起来了。 |
| 🔵 蓝色版本名 | 服务端版本：从「下载 → 服务端」下载的版本。悬停提示"这是服务端"；选中它后点「启动」就是离线开服，不需要本地客户端 |
| 黑色版本名 | 普通客户端版本 |
💡 隔离文件夹 game：每个版本在
发芽启动器\versions\<版本名>\下有独立的game\子目录，存档、mods、配置都隔离在这个文件夹里，互不影响。也就是说：
- 不同版本之间存档/模组完全独立，不会串数据
- 想备份某个版本的存档，直接备份
versions\<版本名>\game\saves即可- 整合包风格版本（版本根目录自带 mods/config 的）游戏数据直接放版本根，不额外建 game 子目录
- 在该启动器中下载的所有版本都无法被pcl2，HMCL等主流启动器直接启动。即使在其他启动器里进行文件补全后可以启动也无法加载模组。如果需要在其他启动器中游玩在该启动器中下载的版本必须手动迁移模组文件夹。
⬇ 下载中心
下载中心有 8 个分类子页，全部支持搜索、按版本/加载器筛选：
| 子页 | 说明 |
|---|---|
| 版本 | 下载任意 Minecraft 版本（含远古版本），自动配好 Java |
| 服务端 | 下载Vanilla / Spigot /Paper / Forge / NeoForge / Fabric / Quilt 服务端，一键开服 |
| 模组 | 从 Modrinth / CurseForge 搜索下载模组，自动补装缺失的前置模组 （开发中，可能失效） |
| 光影 | 光影包（shader）下载，配 Iris/Optifine 使用 |
| 整合包 | 从 Modrinth 下载整合包，一键导入 |
| 资源包 | 材质/资源包下载 |
| 数据包 | 数据包下载（机械动力等玩法增强） |
| 插件 | 服务端插件下载（Paper/Spigot 等） |
特色：
- 下载失败自动重试（带退避），进度清晰
- 使用高速多线程下载引擎（未优先使用国内镜像站可能速度较慢。）
- 模组下载自动检测并补装依赖（如 Iris 自动装 Sodium）开发中，可能失效并仅支持modrinth的模组,Curseforge端的模组可以让AI助手帮你补全。
- 多个下载任务并发互不干扰，各自独立进度条
📊 下载管理
- 所有下载任务的实时进度（百分比、剩余时间、总大小）
- 历史记录（最近 30 条）
🌐 联机
两种组网方式：
- Tailscale 组网（推荐，跨网稳定）
- 点「📥 安装」→「🔑 登录」（用微软/Google/GitHub 账号）→ 获得虚拟 IP
- 朋友也装 Tailscale 后，输入你的虚拟 IP 即可联机，像在同一局域网一样
- 陶瓦联机（国内低延迟）
- 基于 EasyTier 的去中心化组网，免注册
- 创建房间 → 生成邀请码 → 朋友填码加入
- ⚠️ 注意：陶瓦依赖 EasyTier 公共节点，官方节点目前失效（全网问题，非本启动器缺陷），因此当前陶瓦卡片标注「无可用节点」——跨网联机在不自行配置的情况下止咳药使用 Tailscale
- 红石联机
- 免注册，与陶瓦联机相似。由于我未找到其他使用红石联机的启动器，导致无法完成测试。若有bug请及时汇报。
其他功能：
- 房间列表：发现局域网内开放的服务器房间，一键加入
- 一键开服：下载官方服务端并启动离线服（可选 原版/Forge/Fabric 等）
- AI 联机诊断：联机连不上时让 AI 帮你分析原因，但无法自动修复。
🤖 AI 助手（使用GLM4.7flash与千问2.5）
内置 AI 助手（开箱即用，无需配置），能帮你：
- 修崩溃：崩溃时自动读日志 → 匹配内置 41 条崩溃诊断知识库 → 给出根因和修复步骤
- 装模组/整合包：直接说"帮我找 1.20.1 的机械动力"，AI 搜索并下载
- 写配置：改启动参数、优化内存、调视频设置
- 解答问题：Minecraft 机制、版本兼容、模组用法等
- 日常事务：查资料、下载文件、整理信息、写脚本
- 尽管已经做了如此多的优化但不要将过于复杂的版本崩溃直接喂给AI助手，他可能真的修不好。因为真的找不到更强的免费模型了。
模型选择（设置 → AI 助手）：
- 「默认（免费模型）」：开箱即用
- 「千问（阿里百炼）」/「DeepSeek」/「智谱 GLM」/「Kimi」等：用自己的 API Key
- AI 助手页支持多轮对话、停止生成、清空会话
🎨 皮肤
- 从皮肤站搜索下载皮肤
- 本地预览、一键应用
- ⚠️ 说明：离线模式（未登录正版账号）下，皮肤只在自己视角显示；要让别人看到你的皮肤，需要正版账号或安装 CSL 模组
⚙ 设置
| 设置项 | 说明 |
|---|---|
| 登录方式 | 离线模式（免账号）/ 正版登录（微软账号） |
| AI 助手 | 模型源、API Key（支持多 Key 逗号分隔轮询）、模型列表获取 |
| 内存分配 | 游戏可用内存（默认自动 = 物理内存一半，可手动调整） |
| CurseForge | 填写 API Key 走官方源（不填用公益镜像） |
| 语音识别 | 下载/管理语音识别模型，AI 页可语音提问 |
🎛 个性化
- 界面主题：配色自定义，保存即生效（无需重启）
- 按钮悬停动效、圆角卡片风格
四、常见问题（FAQ）
**Q1：全新系统需要先装 Java 吗？**不需要。启动器首次启动游戏时自动下载合适的 Java。
**Q2：需要装 Python 吗？**不需要。安装包自带完整 Python 运行时。
**Q3：断网能用吗？**能启动已下载的版本；下载类功能（版本/模组/Java）需要网络。
**Q4：老版本（1.7.10/1.8）怎么玩？**下载对应版本 + 对应 Forge 即可。启动器会自动为老版本匹配 Java 8（新版 Java 跑不了老版本，这是 Minecraft 本身限制）。
**Q5：和网易版冲突吗？**不冲突，完全独立。建议玩启动器版时先关闭网易版，避免资源竞争。
**Q6：游戏崩溃了怎么办？**把崩溃信息发给 AI 助手（"帮我看看游戏为什么崩了"），它会读日志、匹配诊断知识库、给出修复步骤。
五、系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11（64 位） |
| 内存 | 建议 8GB 以上（游戏 + 启动器） |
| 硬盘 | 至少 2GB 空闲（游戏本体另需 1-10GB） |
| 网络 | 首次下载游戏/Java/模组需联网 |
发芽启动器 —— 免费、无捆绑、开箱即用的 Minecraft 启动器