Minecraft Forge执行gradlew genIntelij Runs报Invalid patcher dependency错误

核心报错定位 #

本次报错的核心原因为 Invalid patcher dependency: net.minecraftforge:forge:1.16.3-34.1.42:userdev，按以下步骤逐一排查即可解决： #

排查步骤 #

1. 修正执行命令 #

你输入的命令存在拼写和格式错误，正确的命令应为：
gradlew genIntellijRuns
注意不要在Intellij和Runs之间加空格，且Intellij拼写中包含两个l。先执行正确命令排查是否为输入错误导致。

2. 确认Java环境配置 #

• 1.16.x版本的Minecraft Forge强制要求使用Java 8 64位版本，你当前的Java版本1.8.0_301符合要求
• 检查系统环境变量JAVA_HOME，确认路径指向你安装的Java 8 64位根目录，不要指向其他更高版本的Java路径

3. 清理损坏的依赖缓存 #

1. 关闭所有IDE窗口，停止所有Gradle后台进程
2. 删除项目根目录下的.gradle文件夹
3. 删除Gradle全局缓存中的Forge相关缓存：
   • Windows路径：C:\Users\你的用户名\.gradle\caches\forge_gradle
   • Mac/Linux路径：~/.gradle/caches/forge_gradle
4. 回到项目根目录重新执行gradlew genIntellijRuns

4. 检查构建配置文件 #

确认你使用的是官方下载的1.16.3-34.1.42版本Forge MDK，未手动修改build.gradle中的minecraft配置块，默认配置参考如下：

minecraft {
    mappings channel: 'snapshot', version: '20201028-1.16.3'
    runs {
        client {
            workingDirectory project.file('run')
            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
            property 'forge.logging.console.level', 'debug'
        }
        server {
            workingDirectory project.file('run')
            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
            property 'forge.logging.console.level', 'debug'
        }
    }
}

5. 优化依赖下载网络 #

构建过程需要下载大量依赖文件，国内网络容易出现依赖下载不完整的情况，可在项目根目录的gradle.properties文件中添加如下配置提升下载稳定性：

org.gradle.daemon=false
org.gradle.jvmargs=-Xmx4G

也可在build.gradle的repositories块中添加国内镜像源加速：

maven { url 'https://maven.aliyun.com/repository/public/' }

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