解决docker-minecraft-server中1.20.1版本AUTO_CURSEFORGE加载Modpack失败的问题

在使用docker-minecraft-server项目部署1.20.1版本的Minecraft服务器时，用户可能会遇到AUTO_CURSEFORGE类型无法正确加载Modpack的问题。本文将详细分析问题原因并提供解决方案。

问题现象分析

当尝试通过AUTO_CURSEFORGE方式加载1.20.1版本的Modpack时，服务器启动过程中会出现以下关键错误：

1. 核心类缺失错误：系统提示java.lang.NoClassDefFoundError: org/apache/commons/codec/digest/DigestUtils，这表明Apache Commons Codec库中的DigestUtils类无法被找到。

2. Mod重复冲突：日志中显示Found duplicate mods: Mod ID: 'jei'，表明存在重复的JEI（Just Enough Items）Mod。

3. 系统Mod加载失败：最终抛出Failed to find system mod: minecraft错误，导致服务器无法启动。

根本原因

经过分析，这些问题主要由以下几个因素导致：

1. 类路径问题：Forge ModLoader在初始化时无法正确加载Apache Commons Codec库，这通常是由于依赖关系解析不完整或类加载器配置问题造成的。

2. Mod冲突：Modpack中可能同时包含了JEI Mod及其兼容性插件，导致系统检测到重复的Mod ID。

3. 数据目录不一致：长期运行的服务器或多次尝试后，数据目录中的缓存文件可能已损坏或不一致。

解决方案

1. 清理并重建数据目录

首先建议完全清理现有的数据目录，确保从一个干净的状态开始：

rm -rf ./minecraft-data

这将删除所有缓存和配置文件，避免旧数据干扰新Modpack的加载。

2. 强制重新安装Modloader

在docker-compose.yml配置中添加以下环境变量：

environment:
  CF_FORCE_REINSTALL_MODLOADER: "true"

这将强制重新下载和安装Forge ModLoader，确保所有依赖库完整且版本正确。

3. 确保使用正确的Modpack文件

确认使用的是专门为服务器设计的Modpack文件，而非客户端版本。在CurseForge页面查找标有"Server Pack"或类似标识的文件。

4. 检查Mod冲突

如果问题仍然存在，可以：

1. 手动检查Mod列表，移除重复的Mod
2. 联系Modpack作者报告兼容性问题
3. 尝试使用较新或较旧的Modpack版本

最佳实践建议

1. 定期清理缓存：长期运行的服务器应定期清理缓存文件，特别是在更新Modpack版本时。

2. 使用专用服务器Modpack：始终优先选择专为服务器优化的Modpack版本，它们通常已经解决了常见的兼容性问题。

3. 监控资源使用：大型Modpack可能需要更多内存，确保为容器分配足够的资源。

4. 日志分析：养成分析服务器日志的习惯，可以早期发现问题并快速定位原因。

通过以上方法，大多数1.20.1版本的Modpack加载问题都能得到有效解决。如果问题仍然存在，建议提供完整的错误日志以便进一步分析特定情况下的问题。