Forge 1.16.5模组IDE运行正常导出JAR后游戏崩溃求助

数据老陈

2026-8-13

Forge 1.16.5模组导出JAR后崩溃：java.lang.NoSuchFieldError: STRUCTURE_PIECE

问题描述

修改已有Forge 1.16.5模组时，在IntelliJ IDEA社区版中运行完全正常，但通过Gradle任务导出JAR文件后，游戏启动时崩溃，报错java.lang.NoSuchFieldError: STRUCTURE_PIECE。未修改报错涉及的TStructures.java文件。

崩溃报告详情

Time: 09/11/22 22:43
Description: Mod loading error has occurred

java.lang.Exception: Mod Loading has failed
    at net.minecraftforge.fml.CrashReportExtender.dumpModLoadingCrashReport(CrashReportExtender.java:71) ~[forge:?] {re:classloading}
    at net.minecraftforge.fml.server.ServerModLoader.load(ServerModLoader.java:37) ~[forge:?] {re:classloading}
    at net.minecraft.server.Main.main(Main.java:95) ~[?:?] {re:classloading}
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[?:1.8.0_351] {}
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source) ~[?:1.8.0_351] {}
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) ~[?:1.8.0_351] {}
    at java.lang.reflect.Method.invoke(Unknown Source) ~[?:1.8.0_351] {}
    at net.minecraftforge.fml.loading.FMLServerLaunchProvider.lambda$launchService$0(FMLServerLaunchProvider.java:37) ~[forge-1.16.5-36.2.39.jar:36.2] {}
    at cpw.mods.modlauncher.LaunchServiceHandlerDecorator.launch(LaunchServiceHandlerDecorator.java:37) [modlauncher-8.1.3.jar:?] {}
    at cpw.mods.modlauncher.LaunchServiceHandler.launch(LaunchServiceHandler.java:54) [modlauncher-8.1.3.jar:?] {}
    at cpw.mods.modlauncher.LaunchServiceHandler.launch(LaunchServiceHandler.java:72) [modlauncher-8.1.3.jar:?] {}
    at cpw.mods.modlauncher.Launcher.run(Launcher.java:82) [modlauncher-8.1.3.jar:?] {}
    at cpw.mods.modlauncher.Launcher.main(Launcher.java:66) [modlauncher-8.1.3.jar:?] {}
    at net.minecraftforge.server.ServerMain$Runner.runLauncher(ServerMain.java:49) [forge-1.16.5-36.2.39.jar:?] {}
    at net.minecraftforge.server.ServerMain$Runner.access$100(ServerMain.java:46) [forge-1.16.5-36.2.39.jar:?] {}
    at net.minecraftforge.server.ServerMain.main(ServerMain.java:43) [forge-1.16.5-36.2.39.jar:?] {}


A detailed walkthrough of the error, its code path and all known details is as follows:
---------------------------------------------------------------------------------------

-- Head --
Thread: main
Stacktrace:
    at net.tardis.mod.world.structures.TStructures.registerStructurePiece(TStructures.java:173) ~[tardis:1.5.4] {re:classloading}
-- MOD tardis --
Details:
    Mod File: Tardis-Mod-1.16.5-1.5.4.jar
    Failure message: Tardis Mod (tardis) has failed to load correctly
        java.lang.NoSuchFieldError: STRUCTURE_PIECE
    Mod Version: 1.5.4
    Mod Issue URL: https://gitlab.com/Spectre0987/TardisMod-1-14/issues
    Exception message: java.lang.NoSuchFieldError: STRUCTURE_PIECE
Stacktrace:
    at net.tardis.mod.world.structures.TStructures.registerStructurePiece(TStructures.java:173) ~[tardis:1.5.4] {re:classloading}
    at net.tardis.mod.world.structures.TStructures$Structures.&lt;clinit&gt;(TStructures.java:37) ~[tardis:1.5.4] {re:classloading}
    at net.tardis.mod.Tardis.&lt;init&gt;(Tardis.java:138) ~[tardis:1.5.4] {re:classloading}
    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) ~[?:1.8.0_351] {}
    at sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown Source) ~[?:1.8.0_351] {}
    at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Source) ~[?:1.8.0_351] {}
    at java.lang.reflect.Constructor.newInstance(Unknown Source) ~[?:1.8.0_351] {}
    at java.lang.Class.newInstance(Unknown Source) ~[?:1.8.0_351] {}
    at net.minecraftforge.fml.javafmlmod.FMLModContainer.constructMod(FMLModContainer.java:67) ~[forge:36.2] {re:classloading}
    at net.minecraftforge.fml.ModContainer.lambda$buildTransitionHandler$4(ModContainer.java:106) ~[forge:?] {re:classloading}
    at java.util.concurrent.CompletableFuture$AsyncRun.run(Unknown Source) ~[?:1.8.0_351] {}
    at java.util.concurrent.CompletableFuture$AsyncRun.exec(Unknown Source) ~[?:1.8.0_351] {}
    at java.util.concurrent.ForkJoinTask.doExec(Unknown Source) ~[?:1.8.0_351] {}
    at java.util.concurrent.ForkJoinPool$WorkQueue.runTask(Unknown Source) ~[?:1.8.0_351] {}
    at java.util.concurrent.ForkJoinPool.runWorker(Unknown Source) ~[?:1.8.0_351] {re:computing_frames}
    at java.util.concurrent.ForkJoinWorkerThread.run(Unknown Source) ~[?:1.8.0_351] {}

build.gradle 配置

buildscript {
    repositories {
        maven { url = 'https://maven.minecraftforge.net' }
        maven { url='https://repo.spongepowered.org/repository/maven-public' }
        jcenter()
        mavenCentral()
    }
    dependencies {
        classpath group: 'net.minecraftforge.gradle', name: 'ForgeGradle', version: '4.1+', changing: true
        classpath group: 'org.spongepowered', name: 'mixingradle', version: '0.7-SNAPSHOT'
        classpath "gradle.plugin.com.matthewprenger:CurseGradle:1.4.0"
    }
}
apply plugin: 'net.minecraftforge.gradle'
apply plugin: 'org.spongepowered.mixin'
apply plugin: 'eclipse'
apply plugin: 'maven-publish'
apply plugin: "com.matthewprenger.cursegradle"

version = "${mod_version}"
group = "${mod_base_package}"
archivesBaseName = "${project.jar_name}-${minecraft_version}"

java.toolchain.languageVersion = JavaLanguageVersion.of(8)

minecraft {
    mappings channel: "${mappings_channel}", version: "${mappings_version}"
    
    runs {
        client {
            workingDirectory project.file('run')
            arg "-mixin.config=tardis.mixins.json"
            property 'mixin.env.remapRefMap', 'true'
            property 'mixin.env.refMapRemappingFile', "${buildDir}/createSrgToMcp/output.srg"
            property 'forge.logging.console.level', 'debug'
            mods {
                "${mod_id}" {
                    source sourceSets.main
                }
            }
        }

        server {
            workingDirectory project.file('run')
            property 'mixin.env.remapRefMap', 'true'
            property 'mixin.env.refMapRemappingFile', "${buildDir}/createSrgToMcp/output.srg"
            property 'forge.logging.console.level', 'debug'
            mods {
                "${mod_id}" {
                    source sourceSets.main
                }
            }
        }

        data {
            workingDirectory project.file('run')
            property 'forge.logging.markers', 'SCAN,REGISTRIES,REGISTRYDUMP'
            property 'forge.logging.console.level', 'debug'
            property 'mixin.env.remapRefMap', 'true'
            property 'mixin.env.refMapRemappingFile', "${buildDir}/createSrgToMcp/output.srg"
            args '--mod', mod_id, '--all', '--output', file('src/main/generated/')
            mods {
                "${mod_id}" {
                    source sourceSets.main
                }
            }
        }
    }
    accessTransformer = file('src/main/resources/META-INF/accesstransformer.cfg')
}

mixin {
    add sourceSets.main, "${mod_id}.refmap.json"
}

repositories{
  maven { url "https://dvs1.progwml6.com/files/maven/" } //JEI Maven
  maven { url "https://maven.blamejared.com/" } // IE Maven
  maven { url "https://www.cursemaven.com" } //Curse Maven
  //maven { url "https://maven.enginehub.org/repo/" } //WorldEdit Maven
  maven { url 'https://modmaven.dev/' } //Mekanism Maven
}

dependencies {
    minecraft "net.minecraftforge:forge:${forge_version}"
    annotationProcessor "org.spongepowered:mixin:${mixin_version}:processor"
    //compileOnly fg.deobf("blusunrize.immersiveengineering:ImmersiveEngineering:${ie_version}")
    //runtimeOnly fg.deobf("blusunrize.immersiveengineering:ImmersiveEngineering:${ie_version}")
    compileOnly fg.deobf("mezz.jei:jei-${jei_version}:api")
    runtimeOnly fg.deobf("mezz.jei:jei-${jei_version}")
    runtimeOnly fg.deobf("curse.maven:configured-457570:${configured_version}")
    runtimeOnly fg.deobf("curse.maven:terraforged-363820:3451426")
    //runtimeOnly  ("com.sk89q.worldedit:worldedit-core:${world_edit_version}")
    //runtimeOnly fg.deobf("com.sk89q.worldedit:worldedit-forge-mc${world_edit_mc_version}:${world_edit_version}")
    runtimeOnly fg.deobf("mekanism:Mekanism:${mekanism_version}")// core
    runtimeOnly fg.deobf("mekanism:Mekanism:${mekanism_version}:generators")// Mekanism: Generators 
}

//Reference: https://github.com/SizableShrimp/ForgeTemplate/blob/1.16.x/build.gradle#L158-L188
def resourceTargets = ['META-INF/mods.toml', 'pack.mcmeta']
def intoTargets = ["$rootDir/out/production/resources/", "$rootDir/out/production/${project.name}.main/", "$rootDir/bin/main/"]
def replaceProperties = [mod_id: mod_id, mod_name: mod_name, mod_version: mod_version,
                   mod_authors: mod_authors, credits:credits, mod_description: mod_description,
                   display_url:display_url, logo_file:logo_file,
                   issue_tracker_url: issue_tracker_url,
                   update_json_url: update_json_url,
                   license: license,
                   forge_version_range: forge_version_range, minecraft_version_range: minecraft_version_range,
                   loader_version_range: loader_version_range]
processResources {
    inputs.properties replaceProperties
    replaceProperties.put 'project', project

    filesMatching(resourceTargets) {
        expand replaceProperties
    }

    intoTargets.each { target ->
        if (file(target).exists()) {
            copy {
                from(sourceSets.main.resources) {
                    include resourceTargets
                    expand replaceProperties
                }
                into target
            }
        }
    }
}

jar {
    manifest {
        attributes([
                "Specification-Title"     : mod_id,
                "Specification-Vendor"    : mod_authors,
                "Specification-Version"   : "1.0.0",
                "Implementation-Title"    : project.name,
                "Implementation-Version"  : mod_version,
                "Implementation-Vendor"   : mod_authors,
                "Implementation-Timestamp": new Date().format("yyyy-MM-dd'T'HH:mm:ssZ"),
                "MixinConfigs": "${mod_id}.mixins.json"
        ])
    }
}

def reobfFile = file("$buildDir/reobfJar/output.jar")
def reobfArtifact = artifacts.add('default', reobfFile) {
    type 'jar'
    builtBy 'reobfJar'
}
publishing {
    publications {
        mavenJava(MavenPublication) {
            artifact reobfArtifact
        }
    }
    repositories {
        maven {
            url "file:///${project.projectDir}/mcmodsrepo"
        }
    }
}

解决思路

1. 确保使用重映射后的JAR文件

IDE运行时自动处理了MCP到SRG的映射，但普通jar任务生成的文件未经过重映射，游戏运行时无法识别MCP字段名。

执行Gradle任务：clean reobfJar
从build/reobfJar/output.jar获取产物进行测试，不要用build/libs/下的普通JAR。

2. 验证Forge与映射版本一致性

检查gradle.properties中的forge_version是否与IDE运行配置中使用的Forge版本完全一致，版本不匹配可能导致字段映射差异。
确认minecraft块中的mappings channel和version配置正确，比如使用mcp映射时，STRUCTURE_PIECE是正确的字段名；若使用official映射，需改为STRUCTURE_PIECE_TYPE（但IDE运行正常说明当前映射是匹配的，重点检查版本一致性）。

3. 检查注册表字段的正确引用

在Forge 1.16.5中，IStructurePieceType对应的注册表应为Registry.STRUCTURE_PIECE_TYPE，但旧代码可能使用了STRUCTURE_PIECE的MCP映射名。如果映射配置切换到官方映射，这个字段名会失效。

确认当前使用的映射类型：若为official，将代码中的Registry.STRUCTURE_PIECE替换为Registry.STRUCTURE_PIECE_TYPE，重新构建测试。

4. 清理构建缓存

旧的构建缓存可能存在未正确重映射的文件，导致新生成的JAR异常。

执行clean build任务，彻底清除缓存后重新构建。

5. 检查IDE运行环境与构建环境的差异

IDE可能使用了本地缓存的依赖或映射，与Gradle构建环境不一致：

刷新Gradle项目，确保IDE同步最新的依赖和配置。
删除IDE的run目录，重新生成运行环境后测试，再对比导出的JAR是否正常。

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

Forge 1.16.5模组IDE运行正常导出JAR后游戏崩溃求助

问题描述

崩溃报告详情

相关代码片段

TStructures.java 第173行附近

TStructures.java 第37行附近

build.gradle 配置

解决思路

1. 确保使用重映射后的JAR文件

2. 验证Forge与映射版本一致性

3. 检查注册表字段的正确引用

4. 清理构建缓存

5. 检查IDE运行环境与构建环境的差异

Forge 1.16.5模组IDE运行正常 导出JAR后游戏崩溃求助

问题描述 #

崩溃报告详情 #

相关代码片段 #

TStructures.java 第173行附近 #

TStructures.java 第37行附近 #

build.gradle 配置 #

解决思路 #

1. 确保使用重映射后的JAR文件 #

2. 验证Forge与映射版本一致性 #

3. 检查注册表字段的正确引用 #

4. 清理构建缓存 #

5. 检查IDE运行环境与构建环境的差异 #

Forge 1.16.5模组IDE运行正常导出JAR后游戏崩溃求助

问题描述

崩溃报告详情

相关代码片段

TStructures.java 第173行附近

TStructures.java 第37行附近

build.gradle 配置

解决思路

1. 确保使用重映射后的JAR文件

2. 验证Forge与映射版本一致性

3. 检查注册表字段的正确引用

4. 清理构建缓存

5. 检查IDE运行环境与构建环境的差异