Fabric模组lang语言文件未被加载 物品名称显示异常如何解决

可能原因排查项 #

• 文件名大小写匹配问题：Minecraft 1.11+ 对资源文件大小写敏感，首先确认语言文件名严格为en_gb.json，若运行环境为Linux、macOS等大小写敏感系统，单个字母大小写错误就会导致文件不被识别。若你开发的是基岩版模组，基岩版语言文件采用.lang后缀而非.json，格式不匹配也会加载失败。
• 命名空间与物品ID不匹配：语言文件的键前缀为item.cauldrons.，需要确认你注册物品时使用的命名空间确实为cauldrons，同时物品ID的拼写和gold-base、iron-base完全一致，任意一处拼写不一致都会导致翻译无法匹配。
• JSON语法错误：你提供的片段语法无问题，但要确认整个文件没有多余尾逗号、引号不闭合、编码为带BOM的UTF-8等问题，Minecraft的JSON解析器对语法要求严格，单处语法错误就会导致整个语言文件不加载，可先通过JSON校验工具确认文件语法合法。
• 资源文件未被正确打包：检查编译后的模组jar包中是否存在assets/cauldrons/lang/en_gb.json路径的文件，很多时候构建脚本未配置资源目录包含规则，会导致开发环境下的资源文件没有被打包到最终产物中，自然无法被游戏读取。
• 模组开发框架的资源加载规则限制：若你使用的是高版本Forge、Fabric等开发框架，部分自定义资源加载逻辑会屏蔽默认路径的扫描，需要在模组的主配置文件中额外声明资源目录，才能正常加载语言文件。

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