解决docker-minecraft-server中Modrinth模组包客户端模组排除问题

在使用itzg/docker-minecraft-server部署Minecraft服务器时，用户可能会遇到需要排除客户端专用模组的情况。本文将详细介绍如何正确配置环境变量来排除不需要的模组文件。

问题背景

当通过Modrinth模组包部署Minecraft服务器时，某些客户端专用模组可能会导致服务器启动失败。常见的错误包括类加载失败或依赖缺失等问题。用户通常会尝试使用MODRINTH_EXCLUDE_FILES环境变量来排除这些模组，但有时会发现某些模组仍然被加载。

原因分析

经过深入调查，发现Modrinth模组包中的文件可能通过两种方式包含：

1. 直接作为依赖项列出的模组文件
2. 通过overrides目录覆盖的文件

MODRINTH_EXCLUDE_FILES环境变量默认只对第一种情况有效，而通过overrides目录包含的文件不会被排除。这就是为什么用户报告"citresewn"和"neko"等模组无法被排除的原因。

解决方案

最新版本的docker-minecraft-server镜像已经增加了对排除overrides文件的支持。现在可以通过以下两种方式全面排除模组：

1. 基本排除：使用MODRINTH_EXCLUDE_FILES排除直接依赖的模组

-e MODRINTH_EXCLUDE_FILES='citresewn,oculus,yungsmenutweaks,neko'

2. 排除overrides文件：新增MODRINTH_EXCLUDE_OVERRIDES_FILES环境变量

-e MODRINTH_EXCLUDE_OVERRIDES_FILES='neko'

最佳实践

对于需要完全排除客户端模组的情况，建议同时使用两个环境变量：

docker run -d \
  -e TYPE=MODRINTH \
  -e MODRINTH_LOADER=forge \
  -e MODRINTH_MODPACK=better-mc-forge-bmc4 \
  -e MODRINTH_EXCLUDE_FILES='citresewn,oculus,yungsmenutweaks,neko' \
  -e MODRINTH_EXCLUDE_OVERRIDES_FILES='neko' \
  itzg/minecraft-server:latest

替代方案

如果遇到难以排除的模组，也可以考虑手动下载模组包并使用FORGE服务器类型直接运行：

docker run -d \
  -e TYPE=FORGE \
  -e FORGE_VERSION='47.2.6' \
  -e GENERIC_PACK='/path/to/modpack.zip' \
  itzg/minecraft-server:latest

这种方法可以完全控制服务器加载的模组内容，但需要用户自行管理模组包的更新。

总结

通过理解Modrinth模组包的文件包含机制，我们可以更有效地配置服务器环境。最新的docker-minecraft-server镜像提供了更全面的模组排除功能，使服务器部署更加灵活可靠。对于复杂的模组包，结合使用排除选项或采用手动部署方式都能获得理想的结果。