Docker Minecraft服务器镜像中CF_MODPACK_MANIFEST配置的注意事项

在使用itzg/docker-minecraft-server镜像部署CurseForge模组包时，开发者需要注意CF_MODPACK_MANIFEST环境变量的一个关键限制：它不会自动处理模组包中的覆盖文件(overrides)。

问题本质

当通过CF_MODPACK_MANIFEST指定manifest.json文件来加载自定义模组包时，系统只会下载并安装manifest中列出的模组文件，而不会处理模组包中通常包含的覆盖文件。这些覆盖文件通常包含服务端配置、世界数据等重要内容。

解决方案

对于需要完整模组包功能（包括覆盖文件）的场景，应该使用CF_MODPACK_ZIP环境变量替代。这个选项允许直接指定包含完整模组包内容的ZIP文件，其中应该包含：

1. manifest.json文件
2. 所有必需的模组文件
3. 覆盖文件目录结构

技术背景

CurseForge模组包的标准结构通常包含：

• /manifest.json：定义模组列表和依赖
• /mods/：存放模组jar文件
• /overrides/：包含需要覆盖默认配置的文件

当使用ZIP包方式部署时，镜像会自动将overrides目录中的内容解压到服务器的/data目录，完成配置覆盖。而单独使用manifest.json时，这个重要步骤会被跳过。

最佳实践建议

1. 对于已发布的模组包：优先使用CF_BASE_URL+CF_SLUG自动下载完整包

2. 对于自定义/未发布模组包：

   • 打包为ZIP格式
   • 确保包含完整的overrides目录
   • 使用CF_MODPACK_ZIP指定该ZIP文件路径

3. 无论哪种方式，都应确保ZIP包或manifest.json中的模组版本与服务器Forge版本兼容。

通过遵循这些实践，可以确保Minecraft服务器能够正确加载模组包的所有组件，包括关键的配置覆盖文件，从而获得与预期一致的模组体验。