宽恕标签

宽恕标签

当一个标签中的某个条目不存在时,保留该标签的其他条目,而不是丢弃整个标签,并在服务器日志中记录被跳过的条目。

如果一个数据包或模组列出了不存在的标签条目,原版 Minecraft 会丢弃整个标签。Forgiving Tags 会保留所有确实存在的条目,只跳过不存在的那些。

功能

  • 保留每一个存在的标签条目,只丢弃不存在的条目。
  • 为每个受影响的标签向服务器日志写入一行,写明标签名称和每一个被跳过的条目。
  • 如果有内容被跳过,会在聊天中向玩家提示一次:玩家加入时,以及数据重载之后。
  • 不改动其他任何东西。不添加方块、物品或命令。

一个已测试的案例(Minecraft 26.3)

在我们针对 Minecraft 26.3 的测试中,一个向原版标签 minecraft:wool 添加一个不存在条目的数据包会导致原版服务器无法启动,因为其他游戏数据依赖该标签。服务器日志显示:Failed to load datapacks, can't proceed with server load. 未安装此模组的 NeoForge 服务器也会出现同样情况。

使用 Forgiving Tags 后,同一个数据包可以正常加载。服务器启动,白色羊毛仍保留在标签中,日志显示:

[Forgiving Tags] Tag minecraft:wool skipped entries that do not exist: lmftprobe:no_such_wool (from file/lmftwool); its other entries were kept

(lmftprobe:no_such_wool 是我们测试包中缺失条目的名称。)我们还测试了测试数据包中的一个物品标签和一个方块标签:缺失的条目被跳过,其他条目被保留。

设置

文件 config/forgivingtags.json 会在游戏首次随模组启动时创建。

设置 默认值 作用
showChatWarning true 设为 false 可关闭聊天警告。日志行仍会保留。
onlyOperatorsSeeWarning false 设为 true 时,仅向管理员(可使用管理命令的玩家)显示聊天警告。

要在没有配置文件的情况下关闭聊天警告,请使用 Java 选项 -Dforgivingtags.disable_chat_warning=true 启动游戏或服务器。

相较 LMFT 的变化

  • 运行于 Minecraft 26.3(原版止步于 1.21.11),支持 Fabric 和 NeoForge。
  • 针对 26.3 的标签加载器重写了游戏钩子。
  • 聊天警告不包含网址,也不包含点击操作。它只说明部分标签条目被跳过,服务器日志会列出每一个。
  • 修复了“仅管理员”设置。原版将警告对管理员隐藏,却向其他所有人显示。在 onlyOperatorsSeeWarning 设为 true 时,我们观察到管理员收到了警告,而非管理员玩家没有收到。
  • 设置文件(config/forgivingtags.json)和 Java 开关(-Dforgivingtags.disable_chat_warning=true)使用了新名称。
  • 名称不同、代码结构不同、措辞也不同。除此之外,理念和行为相同。

安装

  • Minecraft 26.3 和 Java 25。
  • Fabric:Fabric Loader 0.19.3 或更新版本。不需要 Fabric API。
  • NeoForge:26.3.0.57-beta 或更新版本,且处于 26.3 系列内。
  • 将对应加载器的文件放入服务器的 mods 文件夹。对于单人游戏,放入你自己游戏的 mods 文件夹。
  • 加入的玩家不需要安装此模组。未安装的玩家会看到同样的英文聊天警告。

已测试版本

  • Minecraft 26.3 上的专用服务器:Fabric Loader 0.19.3 和 0.19.5(单独使用,以及 0.19.5 搭配 Fabric API 0.162.0+26.3)、NeoForge 26.3.0.57-beta 和 26.3.0.77。
  • 在上述所有加载器版本中,物品标签和方块标签中的缺失条目均被跳过,其他条目被保留。上述 minecraft:wool 案例在 Fabric Loader 0.19.5、NeoForge 26.3.0.57-beta 和 NeoForge 26.3.0.77 上测试过。没有缺失条目的数据包不会产生跳过条目的日志行。
  • 数据重载(/reload)在 Fabric Loader 0.19.5 和 NeoForge 26.3.0.57-beta 上测试过。
  • 安装此模组的客户端在 Fabric Loader 0.19.5 和 NeoForge 26.3.0.57-beta 上成功启动至标题界面。
  • 玩家在安装此模组的服务器上加入(Fabric Loader 0.19.5 和 NeoForge 26.3.0.57-beta),玩家自己的游戏无论是否安装此模组均可。警告在加入时出现一次,在 /reload 后出现一次。开启 onlyOperatorsSeeWarning 时,只有管理员看到。showChatWarning 为 false 时,没有人看到。没有缺失条目的数据包不会产生警告。
  • 使用 Java 选项 -Dforgivingtags.disable_chat_warning=true 启动的服务器(Fabric Loader 0.19.5 和 NeoForge 26.3.0.57-beta):没有人看到警告,包括管理员,且日志行保留。
  • 未测试:单人世界、多名玩家同时在线、与其他模组共存(Fabric 服务器上的 Fabric API 除外)。

整合包

我们的代码为 CC0。文件还包含在 CC BY 4.0 下改编自 LMFT 的代码,署名信息在文件内部,因此整合包可以原样包含该文件。

鸣谢

此模组包含改编自 Blodhgarm 的 Load My F***ing Tags(LMFT)的代码。原版源代码:https://github.com/Dragon-Seeker/LoadMyFingTags

原版发布的许可证:CurseForge 上为 Creative Commons Attribution 4.0 International(CC BY 4.0),GitHub 和 Modrinth 上为 CC0-1.0。此移植版遵循 CC BY 4.0。许可证文本见:https://creativecommons.org/licenses/by/4.0/

原始理念及其修复形态属于 Blodhgarm:当标签列出了一个不存在的条目时,保留存在的条目,记录被跳过的内容,并在聊天中向玩家提示一次。此移植版基于 Minecraft 1.21.11 的 1.1.1 版本。

此移植版经过了修改:移植到 Minecraft 26.3 的 Fabric 和 NeoForge,重写了游戏钩子,修复了仅管理员设置,并采用了新的名称和措辞。原版代码不附带任何担保(CC BY 4.0 第 5 条)。KingdomForge 自己的代码为 CC0-1.0。

关于此页面

此移植版的代码和此页面由 AI 工具编写,随后由我们在游戏内测试。我们仅在此移植版中使用了 AI 工具;原模组作者并未参与其中。图片为真实游戏截图。

与 Mojang 或 Microsoft 无关联。此为独立移植版,并非由 Load My F*ing Tags 的作者制作或认可。

支持

喜欢它?在 Ko-fi 上支持 KingdomForge:https://ko-fi.com/kingdomforge