更新日志

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

格式基于 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

更新日志

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

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

[v21.3.25-1.21.3] - 2025-10-23

变更

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

[v21.3.24-1.21.3] - 2025-01-29

修复

• 修复 CompostableBlocksContext 运行过早，导致无法直接使用物品对象的问题

[v21.3.23-1.21.3] - 2025-01-29

修复

• 修复 CompostableBlocksContext 运行过早，导致无法直接使用物品对象的问题

[v21.3.22-1.21.3] - 2025-01-29

新增

• 添加 CompostableBlocksContext

[v21.3.21-1.21.3] - 2025-01-29

新增

• 添加 DataPackRegistriesContext
• 添加 AbstractRecipeProvider::foodCooking
• 添加 BlockFamilyBuilder::hangingSign

[v21.3.20-1.21.3] - 2025-01-28

新增

• 添加 LootTableLoadCallback，弃用 LootTableLoadEvents
• 添加 TransformingRecipeOutput

[v21.3.19-1.21.3] - 2025-01-26

新增

• 添加 ClientAbstractions::registerWoodType
• 为 RegistryManager::registerBlockItem 增加一个重载方法

移除

• 移除 BlockFamilyBuilder::wallSign

[v21.3.18-1.21.3] - 2025-01-24

新增

• 添加 QuickMoveRuleSet
• 添加 ArmorMaterialBuilder
• 添加 PickProjectileCallback
• 添加 EnderPearlTeleportCallback
• 添加 BuildCreativeModeTabContentsCallback
• 添加 AbstractLanguageProvider$BlockFamilyBuilder
• 添加 RegistryManager::registerCreativeModeTab
• 添加 RegistryManager::registerRecipeBookCategory
• 添加内部命令 ModEnchantCommand
• 添加若干新的传递性访问扩展器（transitive access wideners）

修复

• 避免在模型事件完成后仍保留顶层模型位置而导致不必要的高内存占用
• 修复在某些情况下为 TooltipBuilder 设置空行时抛出异常的问题
• 修复当 TooltipBuilder 已用于某个部件后，无法再使用原版方法设置新提示文本的问题
• 修复 Fabric 上网络数据包执行存在一 tick 延迟的问题

移除

• 移除 LivingBreathEvents，因其在 Fabric 上的实现过于侵入且难以维护

[v21.3.17-1.21.3] - 2025-01-07

新增

• 添加 AbstractEquipmentModelProvider
• 添加 ClientAbstractions::isEffectVisibleInGui 和 ClientAbstractions::isEffectVisibleInInventory
• 为 InteractionResultHelper 补充缺失的方法
• 添加若干新的传递性访问扩展器
• 为 RegistryManager::registerItem 增加一个重载方法

变更

• 支持在 AbstractRegistriesDatapackGenerator 中使用乐器
• 将 AbstractRegistriesDatapackGenerator 彻底重构为 AbstractDatapackRegistriesProvider

修复

• 修复 Fabric 上的 GatherEffectScreenTooltipCallback

[v21.3.16-1.21.3] - 2024-12-27

新增

• 添加 SingleChestRenderer
• 添加 ClientAbstractions::getPartialTick，用于从 EntityRenderState 提取部分 tick 时间
• 添加 ModelLocationHelper 和 ModelTemplateHelper，为将部分辅助方法从 AbstractModelProvider 中移出做准备

变更

• 在 RegistryManager::registerPotion 中传递药水名称参数

修复

• 修复在 Fabric 上取消 InventoryMobEffectsCallback 会导致异常的问题

[v21.3.15-1.21.3] - 2024-12-25

变更

• 允许为 TooltipBuilder 设置空行，以阻止提示文本的绘制

[v21.3.14-1.21.3] - 2024-12-24

变更

• 调整 RangedSliderButton 的实现，不再需要访问扩展器，以提升与 Cloth Config 模组的兼容性
• ClientAbstractions::registerConfigScreenFactory 现在会合并所有提供的模组 ID 的配置界面，而非覆盖原始模组的配置

[v21.3.13-1.21.3] - 2024-12-08

变更

• 将 ExtractRenderStateCallback 迁移到专用的 NeoForge 事件

[v21.3.12-1.21.3] - 2024-12-06

变更

• 将 InteractionResultHelper 中的部分方法改回字段形式
• 允许 ModLoaderEnvironment::isDevelopmentEnvironment 和 ModLoaderEnvironment::isDevelopmentEnvironmentWithoutDataGeneration 检查任意模组 ID

修复

• 修复 Fabric 上 ExplosionEvents$Start 无法正确取消的问题

[v21.3.11-1.21.3] - 2024-11-27

变更

• 为 AddDataPackReloadListenersCallback 补充缺失的注册表

[v21.3.10-1.21.3] - 2024-11-27

修复

• 修复 RegisterFuelValuesCallback 在 NeoForge 上导致 OutOfMemoryError 的问题

[v21.3.9-1.21.3] - 2024-11-27

新增

• 为 RegistryManager::registerBlockItem、RegistryManager::registerBlockEntityType 和 RegistryManager::registerPoiType 添加额外的重载方法
• 添加 ModLoaderEnvironment::isPuzzlesLibDevelopmentEnvironmentWithoutDataGeneration 和 ModLoaderEnvironment::isPuzzlesLibDevelopmentEnvironment

修复

• 修复 RegistryManager::registerBlockItem 未能复制方块名称到对应物品的问题

[v21.3.8-1.21.3] - 2024-11-25

修复

• 修复转化合成配方（transmute crafting recipes）错误地复制所有输入组件的问题

[v21.3.7-1.21.3] - 2024-11-25

修复

• 修复在 Fabric 上清除所有状态效果时崩溃的问题
• 修复 AbstractRecipeProvider 偶尔无法生成某些合成配方的问题

[v21.3.6-1.21.3] - 2024-11-24

变更

• 实现 AbstractRecipeProvider 中缺失的方法

[v21.3.5-1.21.3] - 2024-11-23

变更

• 使用专用 Mixin 实现 ExtractRenderStateCallback

[v21.3.4-1.21.3] - 2024-11-23

新增

• 添加 ExtractRenderStateCallback
• 添加 RenderPropertyKey

[v21.3.3-1.21.3] - 2024-11-19

新增

• 添加 NativeImageHelper

修复

• 修复 Fabric 上 LivingChangeTargetCallback 的实现问题

[v21.3.2-1.21.3] - 2024-11-19

修复

• 更新 GuiGraphicsHelper 以适配 GuiGraphics 中移除的 blitOffset 参数
• 修复 ClientAbstractions::registerConfigScreenFactory 在 NeoForge 上抛出异常的问题

[v21.3.1-1.21.3] - 2024-11-18

新增

• 添加 InteractionResultHelper

修复

• 修复 PuzzlesLib::isDevelopmentEnvironmentWithoutDataGeneration 判断逻辑反转的问题

[v21.3.0-1.21.3] - 2024-11-15

• 移植至 Minecraft 1.21.3

新增

• 添加 ClientAbstractions::registerConfigScreenFactory

变更

• 将 RenderNameTagCallback 重构为 RenderNameTagEvents 以适配 Minecraft 的更改
• 用 RegisterFuelValuesCallback 替代 FuelBurnTimesContext
• 将 CopyComponents 合成配方重命名为 Transmute 合成配方
• 用简化的 ChatMessageReceivedCallback 替代 ChatMessageReceivedEvents

移除

• 移除 MinecartTypeRegistry
• 移除 RenderGuiCallback，由 RenderGuiEvents 取代
• 移除 GenericExplosionHelper

更新日志

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

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

[v21.4.14-1.21.4] - 2025-10-23

变更

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

[v21.4.13-1.21.4] - 2025-03-28

变更

• 添加 CapabilityKey::clear

[v21.4.12-1.21.4] - 2025-03-14

新增

• 添加 ModConstructor::onRegisterGameplayContent
• 添加 ClientAbstractions::copyBakedQuad
• 添加 BuiltinResourcePackHelper

变更

• 在事件调用者中添加大量类型转换的安全检查

修复

• 修复在 NeoForge 上注册生成的配置翻译时可能发生的罕见启动崩溃
• 修复当多次调用 DataProviderHelper::registerDataProviders 时失败的问题

[v21.4.11-1.21.4] - 2025-03-02

新增

• 添加 CommonAbstractions::getRarityStyle
• 添加 SetupMobGoalsCallback
• 重新添加重构后的 NeoForgeDataProviderContext

变更

• 允许 AbstractLanguageProvider 检查缺失的翻译键
• 支持在 DataProviderHelper 中提供独立于专用 DataProvider 的 RegistrySetBuilder

修复

• 修复 CommonAbstractions::hasChannel 未能正确检查假玩家（fake players）的问题

[v21.4.10-1.21.4] - 2025-03-02

新增

• 向 AbstractRecipeProvider 添加若干用于创建高炉、烟熏炉和篝火合成配方的辅助方法

修复

• 修复在专用 NeoForge 服务器上使用自定义熔炉燃料时导致的客户端崩溃

[v21.4.9-1.21.4] - 2025-02-25

新增

• 添加 ClientSetupCallback 和 CommonSetupCallback
• 添加 LootContextKeySetFactory
• 添加 GiveItemHelper

变更

• 更新 FabricEventFactory 以更宽松地处理错误的返回值

[v21.4.8-1.21.4] - 2025-02-17

变更

• 向 DataAttachmentRegistry.Builder 添加 RegistryAccess

[v21.4.7-1.21.4] - 2025-02-09

新增

• 添加 ItemModelGenerationHelper
• 向 ModelLocationHelper 添加额外方法

修复

• 修复 AbstractParticleProvider 无法正确定位现有纹理的问题
• 修复 AbstractParticleProvider 创建粒子定义文件失败的问题

[v21.4.6-1.21.4] - 2025-02-09

新增

• 添加 ItemModelsContext，并弃用 SpecialBlockModelTypesContext

[v21.4.5-1.21.4] - 2025-02-07

新增

• 添加 FuelValuesContext，并弃用 RegisterFuelValuesCallback

变更

• 更新以支持 NeoForge 21.4.84+

[v21.4.4-1.21.4] - 2025-02-06

变更

• 允许 BlockStateResolverContext 添加 UnbakedModel 实例

修复

• 修复 NeoForge 上 BlockStateResolverContext 未缓存手动加载的 UnbakedModel 实例的问题
• 修复 NeoForge 上 BlockStateResolverContext 不断重新烘焙所有先前定位的 UnbakedBlockStateModel 实例的问题

[v21.4.3-1.21.4] - 2025-02-05

新增

• 为异步加载资源的准备添加替代的 BlockStateResolverContext::registerBlockStateResolver 实现

变更

• 重构 ModelLoadingHelper 中的方法以返回 CompletableFuture 实例
• 在 Fabric 上将选中物品名称与 GUI 高度变量一起移动，行为与 NeoForge 保持一致

修复

• 修复在实体未格挡时 NeoForge 上仍触发 ShieldBlockCallback 的问题
• 修复 Fabric 上 ClientAbstractions::getGuiRightHeight 和 ClientAbstractions::getGuiLeftHeight 对创造模式玩家返回错误值的问题

[v21.4.2-1.21.4] - 2025-02-04

新增

• 添加 BlockStateResolverContext
• 添加 ClientStartedCallback
• 添加 ModelLoadingHelper

变更

• 延迟运行 AdditionalModelsContext，直到 Fabric 上的 ModelLoadingPlugin 初始化完成

修复

• 修复 AbstractModelProvider 每次运行时都生成所有原版物品模型的问题

[v21.4.1-1.21.4] - 2025-02-03

变更

• 暂时通过劫持客户端配置来允许数据生成运行，因为 Architectury Loom 仍存在问题

[v21.4.0-1.21.4] - 2025-02-03

• 移植至 Minecraft 1.21.4

新增

• 添加 SpecialBlockModelTypesContext
• 添加 SpecialBlockModelRenderersContext
• 添加 GameRegistriesContext
• 添加 TransmuteRecipeHelper
• 添加 ExistingFilesHelper

变更

• 使用 RenderNameTagCallback 替代 RenderNameTagEvents
• 使用 ExtractRenderStateCallbackV2 替代 ExtractRenderStateCallback
• 将 ModelEvents 重构为 ModelLoadingEvents、BlockModelLoadingEvents 和 ModelBakingCompletedCallback
• 将 ColorProvidersContext 重构为 BlockColorsContext

移除

• 移除 ContentRegistrationFlags
• 移除 NeoForgeDataProviderContext
• 移除 LootTableLoadEvents
• 移除 RenderPlayerEvents
• 移除 BuildCreativeModeTabContentsContext
• 移除 CreativeModeTabContext 及其 CreativeModeTabConfigurator
• 移除 BuiltinModelItemRendererContext 及其 BuiltinItemRenderer 和 ReloadingBuiltInItemRenderer
• 移除 ItemModelPropertiesContext
• 移除 ItemModelDisplayOverrides
• 移除 AbstractRegistriesDatapackGenerator
• 移除 AbstractModelProvider 及其 ModItemModelProvider

更新日志

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

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

[v21.4.14-1.21.4] - 2025-10-23

更改

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

[v21.4.13-1.21.4] - 2025-03-28

更改

• 添加 CapabilityKey::clear

[v21.4.12-1.21.4] - 2025-03-14

新增

• 添加 ModConstructor::onRegisterGameplayContent
• 添加 ClientAbstractions::copyBakedQuad
• 添加 BuiltinResourcePackHelper

更改

• 在事件调用者中添加大量类型转换的安全性检查

修复

• 修复在 NeoForge 上注册生成的配置翻译时偶发的启动崩溃问题
• 修复当多次调用 DataProviderHelper::registerDataProviders 时失败的问题

[v21.4.11-1.21.4] - 2025-03-02

新增

• 添加 CommonAbstractions::getRarityStyle
• 添加 SetupMobGoalsCallback
• 重新添加重构后的 NeoForgeDataProviderContext

更改

• 允许 AbstractLanguageProvider 检查缺失的翻译键
• 支持在 DataProviderHelper 中提供独立于专用 DataProvider 的 RegistrySetBuilder

修复

• 修复 CommonAbstractions::hasChannel 未能正确检查假玩家的问题

[v21.4.10-1.21.4] - 2025-03-02

新增

• 为 AbstractRecipeProvider 添加若干用于创建熔炉烧炼、烟熏和篝火配方的辅助方法

修复

• 修复在专用 NeoForge 服务器上使用自定义熔炉燃料时导致客户端崩溃的问题

[v21.4.9-1.21.4] - 2025-02-25

新增

• 添加 ClientSetupCallback 和 CommonSetupCallback
• 添加 LootContextKeySetFactory
• 添加 GiveItemHelper

更改

• 更新 FabricEventFactory，使其对错误的返回值处理更加宽松

[v21.4.8-1.21.4] - 2025-02-17

更改

• 向 DataAttachmentRegistry.Builder 添加 RegistryAccess

[v21.4.7-1.21.4] - 2025-02-09

新增

• 添加 ItemModelGenerationHelper
• 向 ModelLocationHelper 添加更多方法

修复

• 修复 AbstractParticleProvider 无法正确定位已有纹理的问题
• 修复 AbstractParticleProvider 创建粒子定义文件失败的问题

[v21.4.6-1.21.4] - 2025-02-09

新增

• 添加 ItemModelsContext，并弃用 SpecialBlockModelTypesContext

[v21.4.5-1.21.4] - 2025-02-07

新增

• 添加 FuelValuesContext，并弃用 RegisterFuelValuesCallback

更改

• 更新以支持 NeoForge 21.4.84 及以上版本

[v21.4.4-1.21.4] - 2025-02-06

更改

• 允许 BlockStateResolverContext 添加 UnbakedModel 实例

修复

• 修复在 NeoForge 上 BlockStateResolverContext 未缓存手动加载的 UnbakedModel 实例的问题
• 修复在 NeoForge 上 BlockStateResolverContext 不断重新烘焙所有先前定位的 UnbakedBlockStateModel 实例的问题

[v21.4.3-1.21.4] - 2025-02-05

新增

• 为异步加载资源准备添加 BlockStateResolverContext::registerBlockStateResolver 的替代实现

更改

• 将 ModelLoadingHelper 中的方法改为返回 CompletableFuture 实例
• 在 Fabric 上将选中物品名称与 GUI 高度变量一起移动，与 NeoForge 行为保持一致

修复

• 修复在 NeoForge 上实体未格挡时仍触发 ShieldBlockCallback 的问题
• 修复在 Fabric 上 ClientAbstractions::getGuiRightHeight 和 ClientAbstractions::getGuiLeftHeight 对创造模式玩家返回错误值的问题

[v21.4.2-1.21.4] - 2025-02-04

新增

• 添加 BlockStateResolverContext
• 添加 ClientStartedCallback
• 添加 ModelLoadingHelper

更改

• 在 Fabric 上延迟运行 AdditionalModelsContext，直到 ModelLoadingPlugin 初始化完成

修复

• 修复 AbstractModelProvider 每次运行都会生成所有原版物品模型的问题

[v21.4.1-1.21.4] - 2025-02-03

更改

• 暂时通过劫持客户端配置来允许数据生成运行，因为 Architectury Loom 仍存在问题

[v21.4.0-1.21.4] - 2025-02-03

• 移植至 Minecraft 1.21.4

新增

• 添加 SpecialBlockModelTypesContext
• 添加 SpecialBlockModelRenderersContext
• 添加 GameRegistriesContext
• 添加 TransmuteRecipeHelper
• 添加 ExistingFilesHelper

更改

• 使用 RenderNameTagCallback 替代 RenderNameTagEvents
• 使用 ExtractRenderStateCallbackV2 替代 ExtractRenderStateCallback
• 将 ModelEvents 重构为 ModelLoadingEvents、BlockModelLoadingEvents 和 ModelBakingCompletedCallback
• 将 ColorProvidersContext 重构为 BlockColorsContext

移除

• 移除 ContentRegistrationFlags
• 移除 NeoForgeDataProviderContext
• 移除 LootTableLoadEvents
• 移除 RenderPlayerEvents
• 移除 BuildCreativeModeTabContentsContext
• 移除 CreativeModeTabContext，由 CreativeModeTabConfigurator 取代
• 移除 BuiltinModelItemRendererContext，由 BuiltinItemRenderer 和 ReloadingBuiltInItemRenderer 取代
• 移除 ItemModelPropertiesContext
• 移除 ItemModelDisplayOverrides
• 移除 AbstractRegistriesDatapackGenerator
• 移除 AbstractModelProvider，由 ModItemModelProvider 取代

更新日志

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

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

[v21.3.25-1.21.3] - 2025-10-23

更改

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

[v21.3.24-1.21.3] - 2025-01-29

修复

• 修复 CompostableBlocksContext 运行过早，导致无法直接使用物品对象的问题

[v21.3.23-1.21.3] - 2025-01-29

修复

• 修复 CompostableBlocksContext 运行过早，导致无法直接使用物品对象的问题

[v21.3.22-1.21.3] - 2025-01-29

新增

• 添加 CompostableBlocksContext

[v21.3.21-1.21.3] - 2025-01-29

新增

• 添加 DataPackRegistriesContext
• 添加 AbstractRecipeProvider::foodCooking
• 添加 BlockFamilyBuilder::hangingSign

[v21.3.20-1.21.3] - 2025-01-28

新增

• 添加 LootTableLoadCallback，弃用 LootTableLoadEvents
• 添加 TransformingRecipeOutput

[v21.3.19-1.21.3] - 2025-01-26

新增

• 添加 ClientAbstractions::registerWoodType
• 为 RegistryManager::registerBlockItem 增加一个重载方法

移除

• 移除 BlockFamilyBuilder::wallSign

[v21.3.18-1.21.3] - 2025-01-24

新增

• 添加 QuickMoveRuleSet
• 添加 ArmorMaterialBuilder
• 添加 PickProjectileCallback
• 添加 EnderPearlTeleportCallback
• 添加 BuildCreativeModeTabContentsCallback
• 添加 AbstractLanguageProvider$BlockFamilyBuilder
• 添加 RegistryManager::registerCreativeModeTab
• 添加 RegistryManager::registerRecipeBookCategory
• 添加内部命令 ModEnchantCommand
• 添加若干新的传递性访问扩展器（transitive access wideners）

修复

• 避免在模型事件完成后仍保留顶层模型位置而导致不必要的高内存占用
• 修复在某些情况下为 TooltipBuilder 设置空行时抛出异常的问题
• 修复当 TooltipBuilder 已用于某个控件后，无法再使用原版方法设置新控件提示文本的问题
• 修复 Fabric 上网络数据包执行存在一 tick 延迟的问题

移除

• 移除 LivingBreathEvents，因其在 Fabric 上的实现过于侵入且难以维护

[v21.3.17-1.21.3] - 2025-01-07

新增

• 添加 AbstractEquipmentModelProvider
• 添加 ClientAbstractions::isEffectVisibleInGui 和 ClientAbstractions::isEffectVisibleInInventory
• 为 InteractionResultHelper 补充缺失的方法
• 添加若干新的传递性访问扩展器
• 为 RegistryManager::registerItem 增加一个重载方法

更改

• 支持在 AbstractRegistriesDatapackGenerator 中使用乐器
• 将 AbstractRegistriesDatapackGenerator 彻底重构为 AbstractDatapackRegistriesProvider

修复

• 修复 Fabric 上的 GatherEffectScreenTooltipCallback

[v21.3.16-1.21.3] - 2024-12-27

新增

• 添加 SingleChestRenderer
• 添加 ClientAbstractions::getPartialTick，用于从 EntityRenderState 中提取部分 tick 时间
• 添加 ModelLocationHelper 和 ModelTemplateHelper，为将部分辅助方法从 AbstractModelProvider 中移出做准备

更改

• 在 RegistryManager::registerPotion 中传递药水名称参数

修复

• 修复在 Fabric 上取消 InventoryMobEffectsCallback 会导致异常的问题

[v21.3.15-1.21.3] - 2024-12-25

更改

• 允许为 TooltipBuilder 设置空行，以阻止提示文本的绘制

[v21.3.14-1.21.3] - 2024-12-24

更改

• 调整 RangedSliderButton 的实现，不再需要访问扩展器，以提升与 Cloth Config 模组的兼容性
• ClientAbstractions::registerConfigScreenFactory 现在会合并所有提供的模组 ID 的配置，而不是覆盖原始模组的配置

[v21.3.13-1.21.3] - 2024-12-08

更改

• 将 ExtractRenderStateCallback 迁移到专用的 NeoForge 事件

[v21.3.12-1.21.3] - 2024-12-06

更改

• 将 InteractionResultHelper 中的部分方法改回字段形式
• 允许 ModLoaderEnvironment::isDevelopmentEnvironment 和 ModLoaderEnvironment::isDevelopmentEnvironmentWithoutDataGeneration 检查任意模组 ID

修复

• 修复 Fabric 上 ExplosionEvents$Start 无法正确取消的问题

[v21.3.11-1.21.3] - 2024-11-27

更改

• 为 AddDataPackReloadListenersCallback 补充缺失的注册表

[v21.3.10-1.21.3] - 2024-11-27

修复

• 修复 RegisterFuelValuesCallback 在 NeoForge 上导致 OutOfMemoryError 的问题

[v21.3.9-1.21.3] - 2024-11-27

新增

• 为 RegistryManager::registerBlockItem、RegistryManager::registerBlockEntityType 和 RegistryManager::registerPoiType 添加额外的重载方法
• 添加 ModLoaderEnvironment::isPuzzlesLibDevelopmentEnvironmentWithoutDataGeneration 和 ModLoaderEnvironment::isPuzzlesLibDevelopmentEnvironment

修复

• 修复 RegistryManager::registerBlockItem 未能复制方块名称到对应物品的问题

[v21.3.8-1.21.3] - 2024-11-25

修复

• 修复转化合成配方（transmute crafting recipes）错误地复制所有输入组件的问题

[v21.3.7-1.21.3] - 2024-11-25

修复

• 修复在 Fabric 上清除所有状态效果时崩溃的问题
• 修复 AbstractRecipeProvider 偶尔无法生成部分合成配方的问题

[v21.3.6-1.21.3] - 2024-11-24

更改

• 实现 AbstractRecipeProvider 中缺失的方法

[v21.3.5-1.21.3] - 2024-11-23

更改

• 使用专用 Mixin 实现 ExtractRenderStateCallback

[v21.3.4-1.21.3] - 2024-11-23

新增

• 添加 ExtractRenderStateCallback
• 添加 RenderPropertyKey

[v21.3.3-1.21.3] - 2024-11-19

新增

• 添加 NativeImageHelper

修复

• 修复 Fabric 上 LivingChangeTargetCallback 的实现问题

[v21.3.2-1.21.3] - 2024-11-19

修复

• 更新 GuiGraphicsHelper 以适配 GuiGraphics 中移除的 blitOffset 参数
• 修复 ClientAbstractions::registerConfigScreenFactory 在 NeoForge 上抛出异常的问题

[v21.3.1-1.21.3] - 2024-11-18

新增

• 添加 InteractionResultHelper

修复

• 修复 PuzzlesLib::isDevelopmentEnvironmentWithoutDataGeneration 判断逻辑反转的问题

[v21.3.0-1.21.3] - 2024-11-15

• 移植至 Minecraft 1.21.3

新增

• 添加 ClientAbstractions::registerConfigScreenFactory

更改

• 将 RenderNameTagCallback 重构为 RenderNameTagEvents 以适配 Minecraft 的变更
• 用 RegisterFuelValuesCallback 替代 FuelBurnTimesContext
• 将 CopyComponents 合成配方重命名为 Transmute 合成配方
• 用简化的 ChatMessageReceivedCallback 替代 ChatMessageReceivedEvents

移除

• 移除 MinecartTypeRegistry
• 移除 RenderGuiCallback，改用 RenderGuiEvents
• 移除 GenericExplosionHelper