正确设置 Minecraft 模组和整合包

正确区分模组、插件、数据包和 Bedrock 附加内容。安装合适的整合包，并检查客户端、服务器和已保存的世界。

要搭建一个模组服务器，你需要一个匹配的 Minecraft 版本、加载器（Loader）和扩展内容的组合。下载得到的 ZIP 文件或 JAR 文件本身并不能说明这些内容应该放在哪里。请先弄清楚你手头的扩展内容究竟属于哪种类型。

区分模组、插件和包

内容	用途及适用环境
Java 模组	面向明确支持的模组加载器（Modloader）和特定 Minecraft 版本的扩展内容
Paper/Bukkit 插件	面向受支持插件平台的服务器功能
Java 数据包	基于数据的 Java 版世界改动，具体取决于该版本的数据格式
资源包	影响材质或音效等外观呈现；不会自动安装新的服务器逻辑
Bedrock 行为包	Bedrock 版受支持附加内容系统中的游戏行为
光影（Shader）	在对应客户端中的画面呈现；不能替代服务器端模组

Bedrock 文档介绍了 Bedrock 版的相关内容包。请不要将 Bedrock 内容复制到 Java 版的模组文件夹中。关于 Paper 扩展，另有专门的指南安装插件。

记录下 Minecraft 版本、加载器及其版本、整合包名称和整合包版本。对于单独的模组，还要加上它们各自的版本和依赖关系。项目页面必须明确注明所需的加载器。Forge、NeoForge、Fabric 和 Quilt 并不能仅仅因为名称相似就相互替换。

此外还要查看安装说明页面：有些模组只需要放在客户端，有些只需要放在服务器端，还有一些两边都需要。因此，额外安装了纯画面类模组的客户端，其文件列表不必与服务器完全一致。但双方共用的必要玩法模组，必须与预定的组合保持一致。NeoForge 指南详细说明了如何分别安装客户端和服务器端。

如果你想要的整合包在下单时就已提供，请在下单页面选择具体的整合包版本。开通完成后，你可以在面板和启动日志中检查实际运行的 Minecraft 版本和加载器版本。请在客户端安装完全相同的预定整合包版本。

客户端导出文件并不自动等同于完整的服务器包。有些整合包会附带专门的服务器文件或安装说明。如果你打算自行上传文件，而不是把整个本地启动器文件夹都上传上去，可以参考这份指南。在加入整合包时，正确的客户端实例是下一步需要注意的事项。

在做出改动之前，请先备份服务器和世界。如果某个模组会引入新的世界内容或改动数据，请使用副本进行尝试。在手动修改文件之前，请先停止服务器。

打开模组区域，搜索所需的项目。检查所提供的版本、加载器和依赖关系。请将所需的库与模组一起安装，并等待流程结束。如果没有提供匹配的版本，一个相近的版本号并不能替代官方文档说明的支持范围。

随后启动服务器，并查看首条错误信息。只有在启动成功后才测试加入游戏。每次只修改一组功能上相关的内容，这样一旦出错，你就能识别出触发原因。

对于外来的或自动生成的世界，请在导入之前先弄清楚其所需条件。材质包只能改变内容的外观呈现，并不会提供新的方块。而包含实际模组方块的世界，则需要相应的模组基础支持。资源包无法恢复缺失的机器或维度。

请保留原始文件和所需的各个版本。只打开副本进行操作。之后检查已知的建筑、物品、容器、配方和维度。传输时请遵循上传并切换世界中的流程。

不要在唯一的正式运行世界中试探性地移除某个内容模组。这样做可能会在下次保存时导致数据丢失。安全的还原方式是同时恢复旧的模组组合及其对应的先前世界状态。

让一个普通玩家账号加入游戏。测试新模组的一项功能，以及此前一直正常工作的某项机制。检查物品栏和各个维度，保存一处小改动，并进行一次干净的重启。将所使用的版本信息记录下来，方便其他玩家参考。

不是。以项目对客户端和服务器的具体说明为准。不要一概而论地把纯客户端模组也安装到服务器上。

只有官方文档中明确说明兼容的组合才是可靠的。请为所使用的加载器选择其专门对应的整合包。

不能。请先解决报告出的版本或依赖缺口问题。资源规划应该在安装能够正常运行之后再进行。