---

---

Buggcraft 希望把“装好游戏，再和朋友玩上”这件事做得更简单。你可以安装原版或带加载器的游戏，导入别人分享的整合包，也可以把自己的游戏配置导出分享。想和朋友玩同一个世界时，直接在启动器里创建房间、发送邀请码，朋友加入后可以检查配置并同步安装。

联机时，房主在自己的电脑上运行世界，连接优先尝试 P2P 直连，无法直连时可通过节点中继。房间里可以聊天、查看成员准备进度，遇到安装问题也可以授权房主协助查看日志。

能做什么

你想做的事	Buggcraft 提供的功能
从零开始玩 Minecraft	下载游戏、选择 Forge / NeoForge / Fabric / Quilt，自动准备兼容的 Java
同时玩几个整合包	管理多个游戏目录与实例，为不同实例单独设置 Java、内存等选项
安装别人分享的包	导入 CurseForge、Modrinth 和 Buggcraft 格式的整合包，查看逐文件下载与安装进度
给游戏加点内容	搜索模组、资源包、光影和整合包，查看介绍与版本后下载
把自己的配置发给朋友	导出 .buggpack，选择体积较小的精简包或文件更完整的常规包
和朋友玩同一个存档	创建或加入房间，使用邀请码或好友邀请联机，按需同步游戏配置
下载失败后接着装	查看错误详情、继续安装或重试缺失项，复用已经校验完成的文件

下载与安装

前往 Buggcraft 下载站 或 GitHub Releases，选择适合自己电脑的版本。开发版包含较新的功能和修复，下载前请查看对应版本说明。

系统	怎么选择与运行
Windows 10 / 11，64 位	下载 Buggcraft.exe，放到准备长期使用的文件夹中运行
Linux x86_64 / ARM64	按处理器架构下载对应程序，赋予可执行权限后运行
macOS Intel / Apple Silicon	按芯片选择版本，解压后运行 .app 应用

各版本提供的平台文件以下载页为准。普通玩家使用发行包即可，无需安装 Python、编译器或开发工具。

建议为启动器、游戏和整合包留出足够的磁盘空间，并放在有写入权限的文件夹。首次运行需要准备启动器运行文件；安装游戏时还会下载游戏资源、依赖库和需要的 Java。

第一次使用

1. 放好启动器。 建议单独建立一个文件夹，例如 D:\Games\Buggcraft，再运行启动器。
2. 选择游戏账号。 在账号管理中添加账号；微软账号按提示在浏览器完成登录。游戏账号与联机节点账号分别管理，加入房间仍需满足目标世界的账号要求。
3. 安装一个游戏。 打开“下载 → 游戏下载”，选择 Minecraft 版本；玩模组时，再选择整合包或模组要求的加载器及其版本。确认名称与安装目录后开始安装。
4. 查看安装进度。 在“下载 → 下载记录”查看当前阶段和结果，点“日志”可以查看每个文件的进度与具体错误。
5. 启动游戏。 安装完成后，在首页选中实例并启动。Java 保持自动选择即可；缺少兼容版本时，按提示准备运行环境。

默认游戏目录是启动器旁边的 .minecraft；不存在时会自动创建，已有目录不会被清空。已经装过游戏的玩家，可以直接添加原有游戏目录。

整合包怎么用

导入别人分享的整合包

打开“下载 → 游戏下载 → 导入整合包”，选择本地文件；也可以把整合包文件拖入启动器，进入导入页面。

支持的常见格式：

• CurseForge 整合包：包含 manifest.json 的 ZIP。
• Modrinth 整合包：包含 modrinth.index.json 的 .mrpack 或 ZIP。
• Buggcraft 整合包：包含 buggcraft.pack.json 的 .buggpack 或 ZIP。

确认新实例名称和游戏目录后开始安装。启动器会解析清单、下载所需文件、安装游戏与加载器，并整理包内配置。普通游戏文件夹压成的 ZIP 不一定是可导入的整合包；已有完整游戏目录可以直接添加使用。

名称被占用时，请换一个新名称。 导入会创建独立实例，不直接覆盖已有实例及其存档。

下载或安装中断后，在“下载记录”找到原任务，点击“继续安装”或对应的重试按钮。已校验的完整文件会复用；本地导入的原始整合包请保留在原路径，直到安装完成。不要通过重复导入同名包来恢复任务。

Buggcraft 格式的导入页还可以选择优先使用包内原地址，或使用设置中的下载源。任务里的下载来源以实际请求为准。

在线寻找整合包

在下载页切换到“整合包”，搜索项目，查看介绍与文件版本后下载。下载完成后，可从下载记录打开文件所在目录，再通过“导入整合包”创建游戏实例。

整合包文件下载完成和游戏安装完成是两个步骤；看到 ZIP 或 MRPACK 下载成功后，还需要完成导入。

把自己的整合包分享出去

在“实例”中找到目标实例，选择“导出整合包”：

• 精简导出：能对应到公开下载源的文件记录为下载信息，适合减小分享文件体积。
• 常规导出：保留更完整的本地模组和实例资源，适合保存或分享自己的配置。

朋友拿到 .buggpack 后，按上面的方式导入即可。两种方式导入时都可能需要下载游戏本体、加载器或其他依赖，不代表完全离线安装。导出可能包含实例内的存档与配置，分享前请确认其中没有不希望公开的内容。

和朋友联机

节点帮助玩家查找房间、完成连接，并在需要时中继流量。世界和存档由房主的电脑运行与保存，适合朋友一起玩已有世界或整合包，无需另开专用游戏服务器。

先连接一个节点

1. 从首页进入联机大厅，在节点菜单打开“添加与管理节点”。
2. 填写节点提供的域名、IP 或 HTTPS 地址，点击“浏览器登录”。
3. 在浏览器登录或注册节点账号，确认授权这台启动器；完成后回到启动器，节点会自动保存。

朋友使用同一个节点最方便；节点互联时，也可以从同一联邦内的节点进入。

房主创建房间

1. 选择准备联机的游戏实例，点击“创建房间”，填写房间名称和加入方式。
2. 可以选择“先开房，稍后进入游戏”，让朋友先加入并准备配置；已经进入世界时，也可以关联已开放的世界。
3. 启动 Minecraft 并进入目标存档，按 Esc → 对局域网开放 → 开始局域网世界。回到启动器，确认房间已关联这个世界。
4. 把房间邀请码发给朋友，或通过好友入口发送邀请；公开房间也可以从大厅列表加入。

朋友加入房间

1. 在大厅点击“加入房间”并粘贴邀请码，或从公开房间、好友邀请进入。
2. 检查游戏版本、加载器和模组配置。配置不一致时，点击“同步安装”，查看进度并等待准备完成。
3. 房主开放世界后，点击“进入游戏”；需要手动连接时，在 Minecraft 多人游戏中找到房间，或复制启动器提供的游戏地址到“直接连接”。

房间里的“成员”页可以查看准备进度、线路与延迟。“安装日志”可以查看同步过程；需要房主帮忙时，可授权共享本次安装日志，也可以随时停止。

文件共享加速有什么用

房主可在创建房间时开启“文件共享加速”，房间页会显示处理进度和结果。启动器先核对模组、游戏核心、加载器、库和资源等文件的信息，正常资源按可用来源下载；缺失或持续过慢的文件按需由 Buggcraft 源站临时缓存，也可在可用时通过 P2P 从房主获取。

这里处理的是具体资源文件。开启后，源站按需请求文件，不要求房主上传整个整合包 ZIP。共享文件可能被他人获取，含敏感或不希望公开内容的配置请勿开启共享。

联机时需要注意

• 房主需要保持游戏世界开放，电脑性能、上行带宽和模组数量都会影响联机体验。
• 默认优先尝试 P2P，无法直连时使用节点中继；连接不稳定时，可以尝试“仅通过节点中转”。
• 关闭大厅窗口会保留连接；退出主启动器会结束自己的联机连接，房主退出会关闭房间。
• 房主退出世界后，朋友需要等待重新开放；重新开放或网络恢复后，可能需要重新进入游戏。

详细操作见联机使用指南。

模组、资源包和光影

在下载页选择“模组”“资源包”或“光影包”，搜索后打开项目，查看适用的 Minecraft 版本、加载器与文件说明，再安装到目标实例。

下载前先确认选对实例和文件版本。 模组依赖需按项目说明补齐；光影还需要兼容的 Iris、Oculus 等渲染模组。放入光影文件本身不会自动让原版游戏获得光影支持。

下载源在“设置 → 通用设置”中调整：

• 游戏与加载器下载源：用于游戏本体和加载器相关下载，与模组源分别设置。
• 模组与整合包下载源顺序：可用“上移 / 下移”调整优先级，先尝试靠前的来源，失败后再尝试后续来源；也可以选择“自动测速”。

整合包若选择优先包内地址，会先按该包的下载信息处理。跨平台替换文件时仍需通过原清单校验，不会只凭相似名称安装另一个版本。下载记录及文件进度中可以看到实际使用的下载源。

Java、内存和文件位置

Java 和内存怎么设置

一般保持 Java 自动选择、内存自动分配即可。不同 Minecraft 版本及加载器对 Java 的要求不同，不建议把所有实例强制指向同一个 Java。

需要手动管理时，进入“设置 → Java 管理”，扫描已有环境、添加 Java 可执行文件，或直接下载兼容版本。启动器下载的 Java 放在自己的缓存路径中，无需修改系统环境变量。也可以在实例设置中单独指定 Java 和内存。

玩大型整合包时，优先参考作者的内存建议，并给系统和其他程序留出空间；分配的内存并非越多越好。

游戏目录和启动器缓存有什么区别

位置	主要保存什么
.minecraft 游戏目录	游戏版本、实例、模组、存档、资源与游戏依赖
.buggcraft 启动器缓存目录	启动器配置、下载缓存、下载的 Java、启动器运行库与日志

默认两者都位于启动器文件夹内。可在“设置 → 通用设置 → 文件缓存路径”更换启动器缓存目录；更改后下次启动迁移，游戏目录单独管理。

想搬到另一块硬盘或做成便携包，建议保留整个启动器文件夹，包括程序、缓存、需要携带的 .minecraft，以及存在时的 buggcraft-storage.txt 位置文件。外部自定义目录不会因复制启动器而一起搬走。分享前退出个人账号，换电脑后重新登录。

已有游戏可以从“实例 → 版本列表 → 添加游戏文件夹”登记原有的 .minecraft，无需先复制一份。

常见问题

下载失败，要把整个整合包重装吗？

先查看“下载记录 → 日志”的具体原因，再使用原任务的继续或重试功能。已经校验完成的文件会复用。模组仍有缺失时，按页面提示重试或补入完全相同的文件，不要用其他版本随意替换。

选择了 CurseForge，为什么看到 Modrinth 在下载？

可能是包内地址优先，也可能是前面的来源不可用后进入了后续来源。请同时检查导入任务的下载方式、设置中的来源顺序和文件日志；项目搜索来源与文件实际下载来源也可能不同。

已经有 .minecraft，第一次启动会覆盖吗？

不会因创建默认目录而清空现有文件。添加已有目录即可使用；安装新内容前请选好目标实例。

删除实例会删存档吗？

永久删除会删除对应目录中的本地文件，包括其中的存档。若只想从列表移除，请在确认框中选择保留本地文件的方式；重要存档先备份，再确认操作范围。

能和使用其他启动器的玩家一起玩吗？

游戏本身是否兼容取决于版本、加载器、模组和账号要求。使用 Buggcraft 的房间邀请、配置同步与节点联机流程，需要参与者运行相应启动器功能。

启动器就是 Minecraft 吗？

启动器负责安装、管理与启动游戏。Minecraft Java 版账号的购买、授权及目标服务器的账号要求仍适用。

遇到问题

可以在启动器的“反馈问题”中描述情况，提交前查看页面列出的自动收集信息；也可以到 GitHub Issues 反馈。

尽量提供启动器版本、系统、游戏与加载器版本、复现步骤和报错时间。下载问题附任务日志，闪退附游戏日志，联机问题说明是房主还是加入者、使用 P2P 还是中继。有这些信息，更容易直接定位问题。公开分享日志前请检查其中的账号、路径和网络信息，移除密码与令牌。

开发与贡献

想参与开发、自行打包或接入联机能力，可从文档索引开始，按需查看 Windows 构建、macOS 构建、GitHub 构建和桥接接入。联机核心与自建节点见 minecraft-tunnel-native。

开源许可

Buggcraft 使用 GNU Affero General Public License v3.0 或更高版本 发布。第三方组件遵循各自许可；Minecraft 及相关名称、资源属于其权利人。本项目并非 Mojang 或 Microsoft 官方产品。