Forge 1.20.4 MDK执行gradlew genEclipseRuns构建失败求助

排查与修复步骤 #

• 重新获取完整MDK包
  直接去官方渠道重新下载Forge 1.20.4的MDK压缩包，解压后确保build.gradle、settings.gradle等核心配置文件无缺失或损坏——部分中断的下载会导致配置文件异常，引发插件版本匹配问题。

• 重置Gradle缓存并检查仓库配置

  1. 删除项目根目录下的.gradle文件夹，清除本地缓存的仓库索引和插件文件
  2. 打开settings.gradle，确认插件仓库配置正确：

     pluginManagement {
         repositories {
             maven { url = 'https://maven.minecraftforge.net/' }
             gradlePluginPortal()
             mavenCentral()
         }
     }
     

  3. 重新执行./gradlew genEclipseRuns，让Gradle重新拉取仓库信息

• 切换兼容的Java版本
  Forge 1.20.4要求使用Java 17，最新版Java（如Java 21+）可能存在兼容性冲突。卸载当前最新Java，安装Java 17（推荐Adoptium Temurin或Oracle OpenJDK），并将系统JAVA_HOME环境变量指向Java 17的安装目录，再重新运行构建命令。

• 手动指定可用的插件版本
  若版本范围匹配失败，直接修改build.gradle中的插件版本为已知可用值，比如将：

  id 'net.minecraftforge.gradle' version '[6.0.16,6.2)'
  

  替换为：

  id 'net.minecraftforge.gradle' version '6.1.0'
  

  确认版本存在于MinecraftForge仓库后，重新执行构建。

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