使用NeoForge 1.21注册Minecraft物品时的纹理与元数据错误

问题1：generateModMetadata任务失败（模板解析错误） #

错误原因 #

templates目录是NeoForge专门用于处理**模板文本文件（如neoforge.mods.toml.template）**的目录，你将二进制纹理文件（nuka_cola.png）放入该目录后，Gradle的模板解析任务会把PNG文件当成Groovy脚本解析，二进制字符（如制表符、不可见字符）触发了解析错误，同时导致文件复制失败。

解决步骤 #

• 新建标准资源目录：在项目src/main下创建resources目录，这是Minecraft模组存放所有资源文件的标准位置。
• 迁移资源文件：将templates/assets/falloutmc/下的所有内容（注意你的路径里texures是拼写错误，要改成textures）移动到src/main/resources/assets/falloutmc/目录下。
• 保留templates目录的正确用途：仅将模板文本文件（如META-INF/neoforge.mods.toml.template）放在templates目录中，不要存放任何二进制文件。

问题2：重命名目录后出现Invalid bare key: '${mod_id}'错误 #

错误原因 #

你直接将templates重命名为resources后，原本的模板文件neoforge.mods.toml.template没有经过Gradle的模板替换流程，导致文件中保留了未解析的变量${mod_id}，NightConfig解析模组元数据时无法识别该裸键。

解决步骤 #

1. 恢复目录结构：将重命名后的resources改回templates，并重新创建src/main/resources目录存放资源文件（按问题1的步骤处理）。
2. 配置模板变量：
   • 在项目根目录的gradle.properties文件中添加（如果没有则新建）：

     mod_id=falloutmc
     

   • 确保templates/META-INF/neoforge.mods.toml.template中的modId字段使用该变量：

     modId = "${mod_id}"
     

3. 配置build.gradle（可选，确保Gradle正确处理模板）：
   在build.gradle的neoforge块中明确模组ID：

   neoforge {
       mods {
           falloutmc {
               id = 'falloutmc'
               version = '1.0.0'
               displayName = 'FalloutMC'
           }
       }
   }
   

4. 清理并重新构建：
   打开终端执行以下命令，清理旧构建文件并重新生成正确的元数据：

   # Windows系统
   gradlew.bat clean build
   
   # Linux/macOS系统
   ./gradlew clean build
   

额外注意事项 #

• 你的纹理文件路径存在拼写错误：texures应改为textures，否则游戏无法找到纹理文件，物品会显示紫色/黑色方块。
• 物品模型文件nuka_cola.json的内容是正确的，只要放在src/main/resources/assets/falloutmc/models/item/目录下即可正常加载。

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