如何将Forge Mod导入Eclipse 完成模组编辑与自定义功能开发

前置准备 #

• 首先确认目标模组对应Minecraft版本为1.16.5，下载版本严格匹配的Forge MDK（模组开发包）
• 安装适配的JDK 8并配置好系统环境变量，1.16.5版本模组开发仅支持JDK 8
• 提前安装Eclipse IDE for Java Developers版本，确保Java开发相关插件已正常启用

步骤1：初始化Forge开发环境 #

• 将下载好的Forge MDK压缩包解压到本地空白文件夹
• 在解压后的文件夹地址栏输入cmd回车打开命令行窗口，执行命令：
  gradlew genSources eclipse
• 等待命令执行完成，期间会自动下载开发所需依赖资源，全程需要保持网络畅通

步骤2：导入目标模组资源 #

提示：CurseForge下载的模组jar为已编译产物，需先反编译获得可编辑源代码

• 将下载的模组jar文件放入MDK目录下的mods文件夹
• 使用反编译工具（如JD-GUI、Luyten）打开模组jar，将反编译得到的源代码按包名结构复制到MDK目录的src/main/java路径下
• 将模组jar内resources目录下的所有资源（模型、材质、语言文件、配置定义等）复制到MDK的src/main/resources路径下
• 打开Eclipse，选择导入-现有项目到工作空间，选择刚才初始化完成的MDK文件夹完成项目导入

步骤3：修复编译错误 #

• 项目导入后Eclipse会自动构建，出现编译报错时按以下规则逐一修复：
  • 缺失的依赖包放入libs文件夹后，右键项目选择刷新-Gradle-刷新Gradle项目即可自动识别
  • 反编译产生的语法错误需手动修正，常见问题包括丢失的泛型声明、异常捕获逻辑缺失、变量名重复等
  • 确认mods.toml配置文件中的模组ID、版本、依赖声明和原模组保持一致，避免运行时识别失败

步骤4：新增自定义内容 #

• 新增Java类建议放在原模组的包路径或其子包下，适配原模组的类加载逻辑
• 新增的物品、实体、技能等内容需严格遵循Forge注册规范，在对应注册事件中完成注册，不要破坏原模组的原有注册逻辑
• 新增资源文件按原模组的路径规则存放，例如物品材质需放在resources/assets/[原模组ID]/textures/item路径下
• 功能开发完成后，执行命令gradlew build即可打包生成新的模组jar文件

注意事项 #

• 二次开发产物如果需要公开发布，需先确认原模组的开源协议，获得原作者授权，避免版权纠纷
• 开发前建议备份原模组所有文件，避免修改出错无法回滚

内容的提问来源于stack exchange，提问作者ItsJustLogic