更新日志

本项目所有重大变更均记录于此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.11.6-1.21.11] - 2026-01-09

修复

• 修复在 Fabric 上 GatherPotentialSpawnsCallback 不触发下界要塞生成的问题

[v21.11.5-1.21.11] - 2026-01-03

修复

• 修复当 MobEffectInstance 为 null 时仍运行 MobEffectEvents$Remove 的问题
• 修复 MobEffectEvents$Expire 不允许返回 EventResult 的问题

[v21.11.4-1.21.11] - 2025-12-20

新增

• 添加 GameRuleUpdatedCallback
• 恢复 GatherEffectScreenTooltipCallback

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

更改

• 再次在 Fabric 上启用所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因其当前实现灵活性不足，无法满足正常使用需求

更新日志

该项目所有显著变更均记录于此文件。

格式基于 Keep a Changelog， 并遵循 语义化版本控制。

[v21.11.6-1.21.11] - 2026-01-09

修复

• 修复在 Fabric 上 GatherPotentialSpawnsCallback 不触发要塞地牢生成事件的问题

[v21.11.5-1.21.11] - 2026-01-03

修复

• 修复当 MobEffectInstance 为 null 时仍触发 MobEffectEvents$Remove 的问题
• 修复 MobEffectEvents$Expire 不支持返回 EventResult 的问题

[v21.11.4-1.21.11] - 2025-12-20

新增

• 添加 GameRuleUpdatedCallback
• 重新添加 GatherEffectScreenTooltipCallback

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

变更

• 再次启用 Fabric 上所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

变更

• 升级至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后处理提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因其当前实现灵活性不足，无法满足正常使用需求

更新日志

该项目所有显著变更都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.11.4-1.21.11] - 2025-12-20

新增

• 添加 GameRuleUpdatedCallback
• 重新添加 GatherEffectScreenTooltipCallback

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

更改

• 再次在 Fabric 上启用所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因为当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有重要更改都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.11.4-1.21.11] - 2025-12-20

新增

• 添加 GameRuleUpdatedCallback
• 重新添加 GatherEffectScreenTooltipCallback

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

更改

• 再次在 Fabric 上启用所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从提取后事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 和 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因为当前实现不够灵活，无法正常使用

更新日志

该项目所有显著变更将记录于此文件。

格式基于 Keep a Changelog， 并遵循 语义化版本控制。

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

更改

• 在 Fabric 上重新启用所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因当前实现灵活性不足，无法满足正常使用需求

更新日志

该项目所有显著变更均记录于此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.11.3-1.21.11] - 2025-12-17

新增

• 添加 PackResourcesHelper::isPackHidden 和 PackResourcesHelper::setPackHidden

更改

• 在 Fabric 上重新启用所有与模型相关的事件

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上无法运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从提取后事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因其当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有重要变更将记录在此文件中。

格式基于 Keep a Changelog， 并遵循 语义化版本控制。

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

变更

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后置提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有显著变更均记录于此文件中。

格式基于 Keep a Changelog， 并遵循 语义化版本控制。

[v21.11.2-1.21.11] - 2025-12-14

新增

• 添加 MutableBakedQuad

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

变更

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因其当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有重要变更将记录在此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

变更

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因为当前实现不够灵活，无法正确使用

更新日志

该项目所有显著变更都将记录于此文件中。

格式基于 Keep a Changelog， 且该项目遵循 语义化版本控制。

[v21.11.1-1.21.11] - 2025-12-13

修复

• 修复 ExtractRenderStateCallback 在 Fabric 上未运行的问题

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

变更

• 更新至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因其当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有显著变更将记录于此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本规范。

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 升级至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从后提取事件和方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因当前实现不够灵活，无法满足正常使用需求

更新日志

该项目所有显著变更将记录于此文件。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.11.0-1.21.11] - 2025-12-13

新增

• 添加 DataPackReloadListenersContext

更改

• 升级至 Minecraft 1.21.11
• 将 SubmitBlockOutlineCallback 重构为 ExtractBlockOutlineCallback
• 扩展 RenderBlockOverlayCallback 的上下文
• 统一 AbstractTagAppender，同时移除非可选的基于字符串的注册方法
• 在 UseItemEvents 中提供 InteractionHand 参数
• 将 PlayerNetworkEvents 重命名为 JOIN 和 LEAVE
• 将 RenderNameTagCallback 重命名为 SubmitNameTagCallback
• 将 RenderLivingEvents 重命名为 SubmitLivingEntityEvents

移除

• 移除 ResourceLocationHelper
• 从提取后事件及方法中移除部分刻参数
• 移除 ContainerMenuHelper::addInventorySlots
• 移除 RegistryManager::registerLegacySpawnEggItem
• 使用原版的 ContextKey 替代 SearchTreeType
• 移除 AddDataPackReloadListenersCallback 与 AddResourcePackReloadListenersCallback
• 移除 GatherEffectScreenTooltipCallback，因当前实现灵活性不足，无法满足正常使用需求

更新日志

该项目所有显著变更将记录于此文件。

格式基于 Keep a Changelog， 且本项目遵循 语义化版本规范。

[v21.10.8-1.21.10] - 2025-11-30

更改

• 恢复Fabric端因配件同步失败导致客户端断开连接的机制

修复

• 修复Fabric上按键绑定冲突未显示的问题
• 修复Fabric上LivingDropsCallback无法捕获实体装备的问题

[v21.10.7-1.21.10] - 2025-11-16

更改

• 支持默认启用且可由玩家手动禁用的内置数据包
• 防止Fabric端因配件同步失败导致客户端断开连接

修复

• 修复Fabric端因未注册事件回调导致的启动崩溃

[v21.10.6-1.21.10] - 2025-11-14

新增

• 添加 BeforeCharacterType 和 AfterCharacterType 事件

[v21.10.5-1.21.10] - 2025-10-21

更改

• ItemTooltipCallback 不再于非渲染线程调用，以防止因文本分割或测量文本宽度引发的崩溃

[v21.10.4-1.21.10] - 2025-10-20

修复

• 修复在NeoForge上加入世界时，当某个模组尝试移除现有生物生成时引发的 java.lang.UnsupportedOperationException 异常

[v21.10.3-1.21.10] - 2025-10-16

新增

• 添加 ParticleProvidersContext::registerParticleRenderType

修复

• 修复在NeoForge上设置配件值时发生的崩溃

[v21.10.2-1.21.10] - 2025-10-11

更改

• 适配NeoForge 21.10.7-beta
• 对 AbstractLanguageProvider 进行小规模重构
• 当旧值与新值相等时，不再设置配件值

修复

• 修复重复的按键分类
• 修复 GuiGraphicsHelper::blitNineSlicedSprite 使用无效的GUI精灵图集位置

[v21.10.1-1.21.10] - 2025-10-09

更改

• 适配NeoForge 21.10.3-beta

[v21.10.0-1.21.10] - 2025-10-08

更改

• 升级至Minecraft 1.21.10

更新日志

该项目所有显著变更将记录于此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.10.8-1.21.10] - 2025-11-30

变更

• 恢复Fabric客户端因配件同步失败而断开连接的行为

修复

• 修复Fabric平台上按键绑定冲突未显示的问题
• 修复Fabric平台上LivingDropsCallback无法捕获实体装备的问题

[v21.10.7-1.21.10] - 2025-11-16

变更

• 支持默认启用且可由玩家手动禁用的内置数据包
• 防止Fabric客户端因配件同步失败而断开连接

修复

• 修复Fabric平台上由于未注册事件回调导致的启动崩溃

[v21.10.6-1.21.10] - 2025-11-14

新增

• 添加BeforeCharacterType和AfterCharacterType事件

[v21.10.5-1.21.10] - 2025-10-21

变更

• 当不在渲染线程时不再调用ItemTooltipCallback，以防止因文本分割或测量文本宽度导致的崩溃

[v21.10.4-1.21.10] - 2025-10-20

修复

• 修复在NeoForge上加入世界时，当某个模组尝试移除现有生物生成时出现的java.lang.UnsupportedOperationException异常

[v21.10.3-1.21.10] - 2025-10-16

新增

• 添加ParticleProvidersContext::registerParticleRenderType

修复

• 修复在NeoForge上尝试设置配件值时发生的崩溃

[v21.10.2-1.21.10] - 2025-10-11

变更

• 更新支持NeoForge 21.10.7-beta
• 对AbstractLanguageProvider进行小幅重构
• 当旧值与新值相等时不再设置配件值

修复

• 修复重复的键位分类
• 修复GuiGraphicsHelper::blitNineSlicedSprite使用了无效的GUI精灵图集位置

[v21.10.1-1.21.10] - 2025-10-09

变更

• 更新支持NeoForge 21.10.3-beta

[v21.10.0-1.21.10] - 2025-10-08

变更

• 升级至Minecraft 1.21.10

更新日志

该项目所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.10.7-1.21.10] - 2025-11-16

变更

• 支持默认启用、玩家可手动禁用的内置数据包
• 防止 Fabric 客户端因附件同步失败而断开连接

修复

• 修复 Fabric 上由于未注册事件回调导致的启动崩溃

[v21.10.6-1.21.10] - 2025-11-14

新增

• 添加 BeforeCharacterType 和 AfterCharacterType 事件

[v21.10.5-1.21.10] - 2025-10-21

变更

• ItemTooltipCallback 不再在非渲染线程中调用，以防止因文本拆分或测量文本宽度导致的崩溃

[v21.10.4-1.21.10] - 2025-10-20

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除现有生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.10.3-1.21.10] - 2025-10-16

新增

• 添加 ParticleProvidersContext::registerParticleRenderType

修复

• 修复在 NeoForge 上设置附件值时发生的崩溃

[v21.10.2-1.21.10] - 2025-10-11

变更

• 适配 NeoForge 21.10.7-beta 版本
• 对 AbstractLanguageProvider 进行小幅重构
• 当旧值与新值相等时，不再设置附件值

修复

• 修复重复的按键分类问题
• 修复 GuiGraphicsHelper::blitNineSlicedSprite 使用了无效的 GUI 精灵图集位置

[v21.10.1-1.21.10] - 2025-10-09

变更

• 适配 NeoForge 21.10.3-beta 版本

[v21.10.0-1.21.10] - 2025-10-08

变更

• 升级至 Minecraft 1.21.10

更新日志

该项目所有显著变更都将记录在此文件中。

格式基于 Keep a Changelog， 并遵循 语义化版本控制。

[v21.10.7-1.21.10] - 2025-11-16

变更

• 支持默认启用、玩家可手动禁用的内置数据包
• 防止 Fabric 客户端因附件同步失败而断开连接

修复

• 修复 Fabric 上由于未注册事件回调导致的启动崩溃

[v21.10.6-1.21.10] - 2025-11-14

新增

• 添加 BeforeCharacterType 和 AfterCharacterType 事件

[v21.10.5-1.21.10] - 2025-10-21

变更

• ItemTooltipCallback 不再于非渲染线程中调用，以防止因拆分文本或测量文本宽度导致崩溃

[v21.10.4-1.21.10] - 2025-10-20

修复

• 修复在 NeoForge 上加入世界时，当模组尝试移除已有生物生成时引发的 java.lang.UnsupportedOperationException

[v21.10.3-1.21.10] - 2025-10-16

新增

• 添加 ParticleProvidersContext::registerParticleRenderType

修复

• 修复在 NeoForge 上设置附件值时发生的崩溃

[v21.10.2-1.21.10] - 2025-10-11

变更

• 适配 NeoForge 21.10.7-beta 版本
• 对 AbstractLanguageProvider 进行小规模重构
• 当旧值与新值相同时，不再设置附件值

修复

• 修复重复的按键分类问题
• 修复 GuiGraphicsHelper::blitNineSlicedSprite 使用无效 GUI 精灵图集位置的问题

[v21.10.1-1.21.10] - 2025-10-09

变更

• 适配 NeoForge 21.10.3-beta 版本

[v21.10.0-1.21.10] - 2025-10-08

变更

• 升级至 Minecraft 1.21.10

更新日志

该项目所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.8.9-1.21.8] - 2025-10-23

更改

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩展器（access widener）

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除现有生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.8.8-1.21.8] - 2025-08-13

更改

• 重构 ConfigHolder 和 RegistryManager 的冻结机制

[v21.8.7-1.21.8] - 2025-08-13

新增

• 添加 RegistryManager::prepareTag
• 扩展 CustomItemModelOutput 中的方法

[v21.8.6-1.21.8] - 2025-08-11

新增

• 添加 RenderPropertyKey::onUpdateEntityRenderState

[v21.8.5-1.21.8] - 2025-08-10

更改

• 使用 Fabric 的实现替换 HudStatusBarHeightRegistry

修复

• 修复在 Fabric 上实体交互事件无法正常工作的问题
• 修复受限配置值的宽松验证问题

[v21.8.4-1.21.8] - 2025-08-04

新增

• 添加 AbstractLootProvider.Blocks::createHeadDrop
• 添加 CommonHelper::getRegistryAccess

更改

• 现在通过 AbstractTagProvider 构建的标签内容会进行排序，以确保动态添加的数据包注册项结果一致

[v21.8.3-1.21.8] - 2025-07-31

新增

• 添加 PackRepositorySourcesContext::registerBuiltInPack
• 在 DataProviderHelper 中支持内置资源包
• 添加 TransformingForwardingList

更改

• 现在在数据生成期间，每个模组都会始终创建 pack.mcmeta 文件

[v21.8.2-1.21.8] - 2025-07-27

修复

• 修复“配置已被注册”（Config has already been registered）异常

[v21.8.1-1.21.8] - 2025-07-27

新增

• 添加 AnchorPoint
• 添加 CommonHelper::getBlockableEventLoop

更改

• 彻底重构 ComponentHelper 实现，以正确支持作为字符串传递的旧版格式化代码

修复

• 修复 Fabric 上玩家交互事件的一些异常行为

[v21.8.0-1.21.8] - 2025-07-18

• 更新至 Minecraft 1.21.8

更新日志

该项目所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本控制。

[v21.5.13-1.21.5] - 2025-10-23

变更

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩展器（access widener）

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除已有生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.5.12-1.21.5] - 2025-05-29

修复

• 对 NeoForge 上渲染图层注册过晚的问题，临时修复 ClientLifecycleEvents$Started 触发时机过晚的问题

[v21.5.11-1.21.5] - 2025-05-29

新增

• 添加 ItemTooltipRegistryV3

变更

• 更新自定义配置界面以更好地处理启动时的配置
• 更新 RegistryManager::registerEntityDataSerializer 以使用新的 Fabric API 钩子
• 重构 CreativeModeTabHelper，包括支持绘画变体
• 更新 PlayerNetworkEvents 以使用 Fabric API 中 ServerPlayerEvents 的新事件
• 更新 AnvilEvents 以兼容 NeoForge 21.5.73+

[v21.5.10-1.21.5] - 2025-05-01

新增

• 添加 MenuProviderWithData

[v21.5.9-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext::setEventPhase

[v21.5.8-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext
• 添加 SpawnerDataBuilder
• 添加 ItemTooltipRegistryV2
• 添加 ContainerMenuHelper::openMenu

变更

• 允许配置在启动阶段即可访问
• 使自定义注册表可选，以便在客户端与服务器间模组存在性不一致时更宽松地处理（Fabric）

修复

• 仅在允许命令时触发 CommandOverrides
• 修复事件阶段转换器未正确遵循所有父级事件阶段顺序的问题

[v21.5.7-1.21.5] - 2025-04-14

变更

• 重构向客户端发送额外数据的菜单类型实现

[v21.5.6-1.21.5] - 2025-04-14

新增

• 添加 SimpleContainerImpl
• 添加 RenderPipelinesContext
• 为 HSV 添加若干重载方法

修复

• 修复 RenderPipelines 在 NeoForge 上注册失败的问题

[v21.5.5-1.21.5] - 2025-04-10

新增

• 添加 ClientCommonHelper
• 添加 GuiHeightHelper::getMaxHeight 与 GuiHeightHelper::getMinHeight

修复

• 修复 Fabric 上 PlayLevelSoundEvents 出现 ClassCastException 的问题

[v21.5.4-1.21.5] - 2025-04-03

新增

• 添加 HSV 工具类
• 为 RegistryManager::registerSpawnEggItem 添加一个额外重载

修复

• 修复实体属性在 NeoForge 上注册失败的问题

[v21.5.3-1.21.5] - 2025-04-02

新增

• 添加 ItemTooltipRegistry
• 添加 EntityHelper::isPiglinCurrency
• 添加 AbstractLanguageProvider::mustHaveTranslationKey
• 为 ClientComponentSplitter 添加若干方法

变更

• 略微重构 AbstractAtlasProvider
• 标记 ComponentHelper 中部分方法为废弃（deprecated）

[v21.5.2-1.21.5] - 2025-04-02

新增

• 恢复 ModelLoadingHelper::missingModel
• 添加若干缺失的访问扩展器（access wideners）

移除

• 移除 BlockStateResolverContext$ResourceLoaderContext，因当前 API 已无法支持

修复

• 修复由于错误的 Mixin 导致在 Fabric 上启动崩溃的问题
• 临时修复因模组加载器缺陷导致 ClientLifecycleEvents$Started 在 NeoForge 上未触发的问题

[v21.5.1-1.21.5] - 2025-04-01

变更

• 彻底重构内部开发结构

修复

• 修复因 Minecraft 实例为 null 导致在 NeoForge 上客户端启动崩溃的问题

[v21.5.0-1.21.5] - 2025-03-31

• 移植至 Minecraft 1.21.5

新增

• 添加 RegisterConfigurationTasksCallback
• 添加 ContentRegistrationHelper 用于注册新的头颅方块类型
• 添加 QuadUtils
• 添加 CodecExtras::LIST_TAG_CODEC、CodecExtras::setOf 和 CodecExtras::decodeOnly

变更

• 完全重构网络系统，用 ModConstructor::onRegisterPayloadTypes 替代 NetworkHandler，并增加对配置阶段消息的支持
• 解耦 PlayerSet，使其不再仅限于发送数据包
• 将 CommonAbstractions 拆分为多个类，如 EntityHelper、EnchantingHelper 和 ExplosionEventHelper
• 将 ClientAbstractions 拆分为多个类，如 GuiHeightHelper、ClientWoodTypeRegistry 和 RenderTypeHelper
• 合并 EntityAttributesCreateContext 与 EntityAttributesModifyContext 为 EntityAttributesContext
• 重构 ClientStartedCallback 为 ClientLifecycleEvents
• 支持在 SkullRenderersContext 中直接注册纹理位置

移除

• 移除 SpecialBlockModelTypesContext
• 移除 JsonConfigFileUtil 与 JsonSerializationUtil
• 移除 BlockInteractionsContext、CompostableBlocksContext、FlammableBlocksContext 与 FuelValuesContext
• 移除 ReflectionHelper
• 移除 RegisterFuelValuesCallback
• 移除 RegistryHelper
• 移除 MessageV2
• 移除 ClientModConstructor::onRegisterAdditionalModels
• 移除 ClientModConstructor::onRegisterCoreShaders
• 移除 SetupMobGoalsCallback

更新日志

该项目所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.5.13-1.21.5] - 2025-10-23

更改

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩展器（access widener）

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除已存在的生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.5.12-1.21.5] - 2025-05-29

修复

• 对 NeoForge 上渲染图层注册过晚的问题，临时修复 ClientLifecycleEvents$Started 触发时机过晚的问题

[v21.5.11-1.21.5] - 2025-05-29

新增

• 添加 ItemTooltipRegistryV3

更改

• 更新自定义配置界面以更好地处理启动时的配置
• 更新 RegistryManager::registerEntityDataSerializer 以使用新的 Fabric API 钩子
• 重构 CreativeModeTabHelper，包括支持绘画变体
• 更新 PlayerNetworkEvents 以使用 Fabric API 中 ServerPlayerEvents 的新事件
• 更新 AnvilEvents 以兼容 NeoForge 21.5.73 及以上版本

[v21.5.10-1.21.5] - 2025-05-01

新增

• 添加 MenuProviderWithData

[v21.5.9-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext::setEventPhase

[v21.5.8-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext
• 添加 SpawnerDataBuilder
• 添加 ItemTooltipRegistryV2
• 添加 ContainerMenuHelper::openMenu

更改

• 允许配置在启动期间即可访问
• 使自定义注册表可选，以便在客户端和服务端模组存在不一致时对 Fabric 更加宽容

修复

• 仅在允许命令时触发 CommandOverrides
• 修复事件阶段转换器未正确遵循所有父级事件阶段顺序的问题

[v21.5.7-1.21.5] - 2025-04-14

更改

• 重构向客户端发送额外数据的菜单类型实现

[v21.5.6-1.21.5] - 2025-04-14

新增

• 添加 SimpleContainerImpl
• 添加 RenderPipelinesContext
• 为 HSV 添加一些重载方法

修复

• 修复 RenderPipelines 在 NeoForge 上注册失败的问题

[v21.5.5-1.21.5] - 2025-04-10

新增

• 添加 ClientCommonHelper
• 添加 GuiHeightHelper::getMaxHeight 和 GuiHeightHelper::getMinHeight

修复

• 修复 Fabric 上 PlayLevelSoundEvents 出现 ClassCastException 的问题

[v21.5.4-1.21.5] - 2025-04-03

新增

• 添加 HSV 工具类
• 为 RegistryManager::registerSpawnEggItem 添加一个额外的重载

修复

• 修复实体属性在 NeoForge 上注册失败的问题

[v21.5.3-1.21.5] - 2025-04-02

新增

• 添加 ItemTooltipRegistry
• 添加 EntityHelper::isPiglinCurrency
• 添加 AbstractLanguageProvider::mustHaveTranslationKey
• 为 ClientComponentSplitter 添加若干方法

更改

• 略微重构 AbstractAtlasProvider
• 标记 ComponentHelper 中部分方法为废弃（deprecated）

[v21.5.2-1.21.5] - 2025-04-02

新增

• 恢复 ModelLoadingHelper::missingModel
• 添加若干缺失的访问扩展器（access wideners）

移除

• 移除 BlockStateResolverContext$ResourceLoaderContext，因当前 API 已无法支持

修复

• 修复由于错误的 Mixin 导致在 Fabric 上启动崩溃的问题
• 临时修复因模组加载器 Bug 导致 ClientLifecycleEvents$Started 在 NeoForge 上未触发的问题

[v21.5.1-1.21.5] - 2025-04-01

更改

• 彻底重构内部开发结构

修复

• 修复因 Minecraft 实例为 null 导致在 NeoForge 上客户端启动崩溃的问题

[v21.5.0-1.21.5] - 2025-03-31

• 移植至 Minecraft 1.21.5

新增

• 添加 RegisterConfigurationTasksCallback
• 添加 ContentRegistrationHelper 用于注册新的头颅方块类型
• 添加 QuadUtils
• 添加 CodecExtras::LIST_TAG_CODEC、CodecExtras::setOf 和 CodecExtras::decodeOnly

更改

• 完全重构网络系统，用 ModConstructor::onRegisterPayloadTypes 替代 NetworkHandler，并增加对配置阶段消息的支持
• 解耦 PlayerSet，使其不再仅限于发送数据包
• 将 CommonAbstractions 拆分为多个类，如 EntityHelper、EnchantingHelper 和 ExplosionEventHelper
• 将 ClientAbstractions 拆分为多个类，如 GuiHeightHelper、ClientWoodTypeRegistry 和 RenderTypeHelper
• 合并 EntityAttributesCreateContext 与 EntityAttributesModifyContext 为 EntityAttributesContext
• 将 ClientStartedCallback 重构为 ClientLifecycleEvents
• 支持在 SkullRenderersContext 中直接注册纹理位置

移除

• 移除 SpecialBlockModelTypesContext
• 移除 JsonConfigFileUtil 与 JsonSerializationUtil
• 移除 BlockInteractionsContext、CompostableBlocksContext、FlammableBlocksContext 与 FuelValuesContext
• 移除 ReflectionHelper
• 移除 RegisterFuelValuesCallback
• 移除 RegistryHelper
• 移除 MessageV2
• 移除 ClientModConstructor::onRegisterAdditionalModels
• 移除 ClientModConstructor::onRegisterCoreShaders
• 移除 SetupMobGoalsCallback

更新日志

该项目所有重要变更都将记录在此文件中。

格式基于 Keep a Changelog， 并且该项目遵循 语义化版本控制。

[v21.8.9-1.21.8] - 2025-10-23

更改

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩展器（access widener）

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除已存在的生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.8.8-1.21.8] - 2025-08-13

更改

• 重构 ConfigHolder 和 RegistryManager 的冻结机制

[v21.8.7-1.21.8] - 2025-08-13

新增

• 添加 RegistryManager::prepareTag
• 扩展 CustomItemModelOutput 中的方法

[v21.8.6-1.21.8] - 2025-08-11

新增

• 添加 RenderPropertyKey::onUpdateEntityRenderState

[v21.8.5-1.21.8] - 2025-08-10

更改

• 使用 Fabric 的实现替换 HudStatusBarHeightRegistry

修复

• 修复在 Fabric 上实体交互事件无法正常工作的问题
• 修复受限配置值的宽松验证问题

[v21.8.4-1.21.8] - 2025-08-04

新增

• 添加 AbstractLootProvider.Blocks::createHeadDrop
• 添加 CommonHelper::getRegistryAccess

更改

• 现在通过 AbstractTagProvider 构建的标签内容会进行排序，以确保动态添加的数据包注册项结果一致

[v21.8.3-1.21.8] - 2025-07-31

新增

• 添加 PackRepositorySourcesContext::registerBuiltInPack
• 在 DataProviderHelper 中支持内置资源包
• 添加 TransformingForwardingList

更改

• 现在在数据生成期间，每个模组都会始终创建 pack.mcmeta 文件

[v21.8.2-1.21.8] - 2025-07-27

修复

• 修复“配置已被注册”（Config has already been registered）异常

[v21.8.1-1.21.8] - 2025-07-27

新增

• 添加 AnchorPoint
• 添加 CommonHelper::getBlockableEventLoop

更改

• 彻底重构 ComponentHelper 实现，以正确支持作为字符串传递的旧版格式化代码

修复

• 修复 Fabric 上玩家交互事件的一些异常行为

[v21.8.0-1.21.8] - 2025-07-18

• 更新至 Minecraft 1.21.8