更新日志

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

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

更新日志

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

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

[v21.1.39-1.21.1] - 2025-10-23

更改

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

[v21.1.38-1.21.1] - 2025-08-11

新增

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

[v21.1.37-1.21.1] - 2025-08-05

修复

• 修复在 NeoForge 上即使未主动格挡时也会调用 ShieldBlockCallback 的问题

[v21.1.36-1.21.1] - 2025-05-04

更改

• 允许 DataProviderHelper 支持 RegistrySetBuilder

[v21.1.35-1.21.1] - 2025-05-04

移除

• 移除 Fabric 上未使用的呼吸和溺水事件实现，以提升与 Lunar Client 的兼容性

[v21.1.34-1.21.1] - 2025-04-25

更改

• 提升与其他在 Fabric 上注入 Gui 类的模组的兼容性

[v21.1.33-1.21.1] - 2025-03-16

修复

• 修复 ModelPart$Vertex 和 ModelPart$Polygon 在 NeoForge 上无法访问的问题

[v21.1.32-1.21.1] - 2025-03-14

更改

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

[v21.1.31-1.21.1] - 2025-03-13

新增

• 添加 ModConstructor::onRegisterGameplayContent
• 添加 ModelLocationHelper 与 ModelTemplateHelper
• 添加 ResourceKeyHelper
• 添加 AbstractDatapackRegistriesProvider

[v21.1.30-1.21.1] - 2025-03-11

修复

• 修复在 NeoForge 上注册生成的配置翻译时偶发的启动崩溃问题

[v21.1.29-1.21.1] - 2025-03-09

修复

• 修复当玩家无效时 CommonAbstractions::hasChannel 在 NeoForge 上崩溃的问题

[v21.1.28-1.21.1] - 2025-02-25

新增

• 将新的方块、物品和创造模式标签页注册方法回迁至 RegistryManager
• 回迁 CompostableBlocksContext

更改

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

[v21.1.27-1.21.1] - 2025-01-17

修复

• 修复 Fabric 上网络数据包执行存在一 tick 延迟的问题

[v21.1.26-1.21.1] - 2025-01-16

更改

• 允许为 TooltipBuilder 设置空行，以防止工具提示绘制

修复

• 修复当 TooltipBuilder 已用于部件后，无法再使用原版方法设置新工具提示的问题

[v21.1.25-1.21.1] - 2025-01-10

修复

• 避免在模型事件完成后仍持有顶层模型位置导致不必要的高内存占用
• 将 BlockStateModelLoader 包装在 WeakReference 中，避免在其不再需要时仍被引用

[v21.1.24-1.21.1] - 2024-12-22

更改

• 调整 RangedSliderButton 实现，不再需要访问扩展器，以帮助与 Cloth Config 模组兼容

[v21.1.23-1.21.1] - 2024-10-24

更改

• 支持将 AbstractTagAppender 用作字符串列表构建器

[v21.1.22-1.21.1] - 2024-10-22

新增

• 添加 ChangeEntitySizeCallback
• 添加 RegistryManager::registerAttribute

更改

• 扩展 LivingEntityRenderLayersContext，增加一些额外方法

[v21.1.21-1.21.1] - 2024-10-10

更改

• 允许 PlayerSet 更宽松地处理提供的客户端世界

[v21.1.20-1.21.1] - 2024-10-10

新增

• 添加 CommonAbstractions::getPartEntityParent

修复

• 修复已移除的数据附件无法同步到客户端的问题

[v21.1.19-1.21.1] - 2024-10-05

更改

• 将 ClientParticleTypes 替换为 ClientParticleHelper

[v21.1.18-1.21.1] - 2024-10-04

更改

• 向 GuiGraphicsHelper 添加更多辅助方法

修复

• 修复 DynamicPackResources 未能生成部分资源的问题

[v21.1.17-1.21.1] - 2024-10-01

新增

• 添加 ClientAbstractions::hasChannel 与 CommonAbstractions::hasChannel

更改

• 网络消息不再发送给不理解它们的客户端和服务器

[v21.1.16-1.21.1] - 2024-09-30

更改

• 当通过 F1 隐藏 HUD 时，RenderGuiLayerEvents 不再触发

[v21.1.15-1.21.1] - 2024-09-30

更改

• 对 RenderGuiEvents 进行轻微调整

修复

• 修复其他模组的部分 GUI 图层无法渲染的问题

[v21.1.14-1.21.1] - 2024-09-29

新增

• 添加 RenderGuiEvents，取代 RenderGuiCallback

[v21.1.13-1.21.1] - 2024-09-29

更改

• 彻底重构 Fabric 上的 RenderGuiLayerEvents 实现

[v21.1.12-1.21.1] - 2024-09-29

新增

• 添加 NeoForgeCapabilityHelper::registerItemContainer
• 添加 GuiGraphicsHelper::blitTiledSprite
• 向 ClientAbstractions 添加多个辅助方法，用于处理 Gui#leftHeight 和 Gui#rightHeight

更改

• 对 ConfigTranslationsManager 进行小幅改进

移除

• 移除 ModLoaderEnvironment::getObjectShareAccess

[v21.1.11-1.21.1] - 2024-09-25

新增

• 添加 CodecExtras
• 向 ItemModelDisplayOverrides 添加一些辅助方法
• 向 ExtraStreamCodecs 添加枚举辅助方法
• 向 CreativeModeTabConfigurator 添加一些辅助方法
• 向 ShapesHelper 添加用于水平旋转形状的辅助方法

更改

• 如果通过 依赖项覆盖 启用，则允许与 Minecraft 1.21 在 Fabric 上兼容
• 允许 RegistryManager::registerBlockItem 接受 Item$Properties 供应商

修复

• 修复 RenderHighlightCallback 在 NeoForge 上崩溃的问题

[v21.1.10-1.21.1] - 2024-09-20

更改

• 允许 ItemModelDisplayOverrides 同时接受 ResourceLocation 和 ModelResourceLocation

[v21.1.9-1.21.1] - 2024-09-18

新增

• 添加 TooltipBuilder::setTooltipLineProcessor

[v21.1.8-1.21.1] - 2024-09-18

更改

• 在 TooltipBuilder 中将原始 ClientTooltipPositioner 传递给工具提示定位器工厂

[v21.1.7-1.21.1] - 2024-09-17

修复

• 修复 LivingDropsCallback 在 Fabric 上无法捕获玩家掉落物的问题
• 修复部分键位绑定在 Fabric 上无法正确触发的问题

[v21.1.6-1.21.1] - 2024-09-17

更改

• 彻底重构 AbstractRegistriesDatapackGenerator，使得生成的注册表值可在其他数据提供者中使用

[v21.1.5-1.21.1] - 2024-09-16

新增

• 添加新的数据附件 API

更改

• 撤销对能力（capabilities）的编解码器支持，改用附件实现
• 将 PlayerSet::notify 重命名为 PlayerSet::broadcast

修复

• 无

[v21.1.4-1.21.1] - 2024-09-14

更改

• 支持为能力（capabilities）使用编解码器
• 简化 ModelLayerFactory 的实现

[v21.1.3-1.21.1] - 2024-09-13

新增

• 添加 ScreenSkipper
• 添加 GsonCodecHelper
• 添加 TagFactory

[v21.1.2-1.21.1] - 2024-09-12

新增

• 添加 RegistryManager::registerTrimMaterial 和 RegistryManager::registerLootTable

[v21.1.1-1.21.1] - 2024-09-11

新增

• 添加 RegistryManager::registerDataComponentType

更改

• 对 ConfigTranslationsManager 进行小幅更新
• 在开发环境中隐藏一些烦人的提示消息

移除

• 移除 BlockEntityHelper

[v21.1.0-1.21.1] - 2024-09-10

• 移植至 Minecraft 1.21.1

更新日志

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

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

[v21.1.39-1.21.1] - 2025-10-23

更改

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

[v21.1.38-1.21.1] - 2025-08-11

新增

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

[v21.1.37-1.21.1] - 2025-08-05

修复

• 修复在 NeoForge 上即使未主动格挡时也会调用 ShieldBlockCallback 的问题

[v21.1.36-1.21.1] - 2025-05-04

更改

• 允许 DataProviderHelper 支持 RegistrySetBuilder

[v21.1.35-1.21.1] - 2025-05-04

移除

• 移除 Fabric 上未使用的呼吸和溺水事件实现，以提升与 Lunar Client 的兼容性

[v21.1.34-1.21.1] - 2025-04-25

更改

• 提升与其他在 Fabric 上注入 Gui 类的模组的兼容性

[v21.1.33-1.21.1] - 2025-03-16

修复

• 修复 ModelPart$Vertex 和 ModelPart$Polygon 在 NeoForge 上无法访问的问题

[v21.1.32-1.21.1] - 2025-03-14

更改

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

[v21.1.31-1.21.1] - 2025-03-13

新增

• 添加 ModConstructor::onRegisterGameplayContent
• 添加 ModelLocationHelper 和 ModelTemplateHelper
• 添加 ResourceKeyHelper
• 添加 AbstractDatapackRegistriesProvider

[v21.1.30-1.21.1] - 2025-03-11

修复

• 修复在 NeoForge 上注册生成的配置翻译时偶发的启动崩溃问题

[v21.1.29-1.21.1] - 2025-03-09

修复

• 修复当玩家无效时 CommonAbstractions::hasChannel 在 NeoForge 上崩溃的问题

[v21.1.28-1.21.1] - 2025-02-25

新增

• 将新的方块、物品和创造模式标签页注册方法回移植到 RegistryManager
• 回移植 CompostableBlocksContext

更改

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

[v21.1.27-1.21.1] - 2025-01-17

修复

• 修复 Fabric 上网络数据包执行存在一 tick 延迟的问题

[v21.1.26-1.21.1] - 2025-01-16

更改

• 允许为 TooltipBuilder 设置空行，以防止工具提示绘制

修复

• 修复当 TooltipBuilder 已用于某个控件后，无法再使用原版方法设置新控件提示的问题

[v21.1.25-1.21.1] - 2025-01-10

修复

• 避免在模型事件完成后仍保留顶层模型位置导致不必要的高内存占用
• 将 BlockStateModelLoader 包装在 WeakReference 中，避免在其不再需要时仍持有引用

[v21.1.24-1.21.1] - 2024-12-22

更改

• 调整 RangedSliderButton 实现，不再需要访问扩展器，以提升与 Cloth Config 模组的兼容性

[v21.1.23-1.21.1] - 2024-10-24

更改

• 支持将 AbstractTagAppender 用作字符串列表构建器

[v21.1.22-1.21.1] - 2024-10-22

新增

• 添加 ChangeEntitySizeCallback
• 添加 RegistryManager::registerAttribute

更改

• 扩展 LivingEntityRenderLayersContext，增加一些额外方法

[v21.1.21-1.21.1] - 2024-10-10

更改

• 允许 PlayerSet 更宽松地处理提供的客户端世界

[v21.1.20-1.21.1] - 2024-10-10

新增

• 添加 CommonAbstractions::getPartEntityParent

修复

• 修复已移除的数据附件无法同步到客户端的问题

[v21.1.19-1.21.1] - 2024-10-05

更改

• 将 ClientParticleTypes 替换为 ClientParticleHelper

[v21.1.18-1.21.1] - 2024-10-04

更改

• 向 GuiGraphicsHelper 添加更多辅助方法

修复

• 修复 DynamicPackResources 未能生成某些资源的问题

[v21.1.17-1.21.1] - 2024-10-01

新增

• 添加 ClientAbstractions::hasChannel 和 CommonAbstractions::hasChannel

更改

• 网络消息不再发送给不理解它们的客户端和服务器

[v21.1.16-1.21.1] - 2024-09-30

更改

• 当通过 F1 隐藏 HUD 时，RenderGuiLayerEvents 不再触发

[v21.1.15-1.21.1] - 2024-09-30

更改

• 对 RenderGuiEvents 进行轻微调整

修复

• 修复其他模组的一些 GUI 图层无法渲染的问题

[v21.1.14-1.21.1] - 2024-09-29

新增

• 添加 RenderGuiEvents，取代 RenderGuiCallback

[v21.1.13-1.21.1] - 2024-09-29

更改

• 彻底重构 Fabric 上的 RenderGuiLayerEvents 实现

[v21.1.12-1.21.1] - 2024-09-29

新增

• 添加 NeoForgeCapabilityHelper::registerItemContainer
• 添加 GuiGraphicsHelper::blitTiledSprite
• 向 ClientAbstractions 添加多个用于处理 Gui#leftHeight 和 Gui#rightHeight 的辅助方法

更改

• 对 ConfigTranslationsManager 进行小幅改进

移除

• 移除 ModLoaderEnvironment::getObjectShareAccess

[v21.1.11-1.21.1] - 2024-09-25

新增

• 添加 CodecExtras
• 向 ItemModelDisplayOverrides 添加一些辅助方法
• 向 ExtraStreamCodecs 添加枚举辅助方法
• 向 CreativeModeTabConfigurator 添加一些辅助方法
• 向 ShapesHelper 添加用于水平旋转形状的辅助方法

更改

• 如果通过 依赖项覆盖 启用，则允许与 Minecraft 1.21 在 Fabric 上兼容
• 允许 RegistryManager::registerBlockItem 接受 Item$Properties 供应商

修复

• 修复 RenderHighlightCallback 在 NeoForge 上崩溃的问题

[v21.1.10-1.21.1] - 2024-09-20

更改

• 允许 ItemModelDisplayOverrides 同时接受 ResourceLocation 和 ModelResourceLocation

[v21.1.9-1.21.1] - 2024-09-18

新增

• 添加 TooltipBuilder::setTooltipLineProcessor

[v21.1.8-1.21.1] - 2024-09-18

更改

• 在 TooltipBuilder 中将原始 ClientTooltipPositioner 传递给提示位置工厂

[v21.1.7-1.21.1] - 2024-09-17

修复

• 修复 LivingDropsCallback 在 Fabric 上无法捕获玩家掉落物的问题
• 修复某些键位绑定在 Fabric 上无法正确触发的问题

[v21.1.6-1.21.1] - 2024-09-17

更改

• 彻底重构 AbstractRegistriesDatapackGenerator，使生成的注册表值可在其他数据提供者中使用

[v21.1.5-1.21.1] - 2024-09-16

新增

• 添加新的数据附件 API

更改

• 撤销对能力系统的编解码器支持，改用附件系统
• 将 PlayerSet::notify 重命名为 PlayerSet::broadcast

[v21.1.4-1.21.1] - 2024-09-14

更改

• 支持能力系统的编解码器
• 简化 ModelLayerFactory 的实现

[v21.1.3-1.21.1] - 2024-09-13

新增

• 添加 ScreenSkipper
• 添加 GsonCodecHelper
• 添加 TagFactory

[v21.1.2-1.21.1] - 2024-09-12

新增

• 添加 RegistryManager::registerTrimMaterial 和 RegistryManager::registerLootTable

[v21.1.1-1.21.1] - 2024-09-11

新增

• 添加 RegistryManager::registerDataComponentType

更改

• 对 ConfigTranslationsManager 进行小幅更新
• 在开发环境中隐藏一些烦人的提示消息

移除

• 移除 BlockEntityHelper

[v21.1.0-1.21.1] - 2024-09-10

• 移植至 Minecraft 1.21.1

更新日志

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

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

[v20.4.53-1.20.4] - 2025-10-23

更改

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

[v20.4.52-1.20.4] - 2024-06-16

修复

• 尝试修复 Forge 的重映射问题

[v20.4.51-1.20.4] - 2024-06-11

修复

• 再次修复 RangedSliderButton::getValue

[v20.4.50-1.20.4] - 2024-06-11

修复

• 修复 RangedSliderButton::getValue

[v20.4.49-1.20.4] - 2024-06-11

新增

• 添加 RangedSliderButton

[v20.4.48-1.20.4] - 2024-06-07

新增

• 添加 ComponentHelper::toString

[v20.4.47-1.20.4] - 2024-06-07

新增

• 添加 ComputeFieldOfViewCallback

更改

• 为 GatherDebugTextEvents 增加额外参数，并调整 Fabric 上的注入点

[v20.4.46-1.20.4] - 2024-06-03

更改

• 在 Forge 和 NeoForge 上注册时立即加载客户端和通用配置，为 NeoForge 1.20.6 的启动配置做准备，并与 Fabric 保持一致

修复

• 修复 MutableSoundType 中的重载问题
• 通过内部引入自定义事件，修复 Fabric 上 PlayerTrackingEvents#START 触发过早的问题

[v20.4.45-1.20.4] - 2024-06-01

新增

• 添加 HolderBackedSoundType 和 MutableSoundType

修复

• 修复 Fabric 上创造性模式玩家使用 PlayerInteractEvents$AttackBlock 时不触发的问题

[v20.4.44-1.20.4] - 2024-05-26

修复

• 尝试改进资源重载期间缺失子级重载监听器的处理

[v20.4.43-1.20.4] - 2024-05-09

修复

• 修复在 NeoForge 上以及安装 ModernFix 模组的 Forge 环境中，GatherPotentialSpawnsCallback 导致崩溃的问题

[v20.4.42-1.20.4] - 2024-03-24

新增

• 添加 LookingAtEndermanCallback

更改

• 调整 PlayerInteractEvents 实现，允许返回 InteractionResult#PASS 而不被忽略
• 使 LoadCompleteCallback 在 Forge 和 NeoForge 上按顺序运行

修复

• 修复 Forge 上 EntityDataSerializer 注册问题，避免接收服务器数据时出现 ID 不匹配

[v20.4.41-1.20.4] - 2024-03-19

新增

• 添加 RenderTooltipCallback，替代 ScreenTooltipEvents$Render

修复

• 修复 Fabric 上 LivingDeathCallback 对玩家不触发的问题

[v20.4.40-1.20.4] - 2024-03-18

修复

• 修复 Forge 和 NeoForge 上无法处理 mods.toml 中定义多个模组的模组 JAR 文件的问题

[v20.4.39-1.20.4] - 2024-03-14

更改

• 同步到远程时调用 CapabilityComponent::setChanged

[v20.4.38-1.20.4] - 2024-03-12

新增

• 添加 ContainerEvents

[v20.4.37-1.20.4] - 2024-03-12

新增

• 添加 CapabilityComponent::initialize

[v20.4.36-1.20.4] - 2024-03-02

更改

• 扩展并简化 AbstractTagAppender 的实现

[v20.4.35-1.20.4] - 2024-03-01

新增

• 添加新版 AbstractTagProvider
• 添加自定义 AbstractTagAppender

[v20.4.34-1.20.4] - 2024-02-29

更改

• 在 Fabric 专用服务器上将 LoadCompleteCallback 提前执行

[v20.4.33-1.20.4] - 2024-02-28

更改

• 更新部分 DynamicPackResources 内部实现

[v20.4.32-1.20.4] - 2024-02-27

新增

• 添加 ModLoaderEnvironment::getCurrentMappingsNamespace

更改

• 允许在 PackResourcesHelper 中设置默认资源包位置

[v20.4.31-1.20.4] - 2024-02-24

修复

• 修复 Forge 上玩家死亡时能力提供无效持有者（holder）的问题

[v20.4.30-1.20.4] - 2024-02-23

修复

• 修复 Fabric 上 RegisterCommandsCallback 不运行的问题

[v20.4.29-1.20.4] - 2024-02-23

修复

• 修复 RenderHandEvents#OFF_HAND 触发了错误的手部事件类型

[v20.4.28-1.20.4] - 2024-02-23

新增

• 添加 RegistryManager::registerArgumentType
• 添加 RenderHandEvents，替代 RenderHandCallback

修复

• 修复客户端尝试同步已更改的能力值的问题

[v20.4.27-1.20.4] - 2024-02-22

新增

• 添加 KeyActivationHandler
• 添加 KeyMappingHelper::registerKeyMapping
• 添加 PlayerSet

[v20.4.26-1.20.4] - 2024-02-19

更改

• 弃用 ScreenHelper，推荐使用访问扩展器（Access Wideners）和 ScreenHelperV2

[v20.4.25-1.20.4] - 2024-02-19

修复

• 修复矿车类型注册表映射越界问题

[v20.4.24-1.20.4] - 2024-02-18

新增

• 添加 MinecartTypeRegistry
• 添加 ContainerMenuHelper
• 添加 NeoForgeCapabilityHelperV2#registerEntityContainer

[v20.4.23-1.20.4] - 2024-02-15

修复

• 修复因错误导入导致专用服务器崩溃的问题

[v20.4.22-1.20.4] - 2024-02-14

新增

• 添加 GenericExplosionHelper
• 添加 AbstractLootProviderV2
• 为 AbstractSoundDefinitionProvider 添加更多辅助方法
• 添加 AbstractLanguageProvider::addSpawnEgg

更改

• 在 AbstractModelProvider 中验证物品模型

修复

• 修复 AbstractBuiltInDataProvider 未使用文件助手注册生成资源的问题
• 修复 ItemDisplayOverrides 在 Forge 和 NeoForge 上崩溃的问题

[v20.4.21-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 在 Fabric 和 Forge 上实际未注册序列化器的问题

[v20.4.20-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 的类型参数问题

[v20.4.19-1.20.4] - 2024-02-09

新增

• 添加 RegistryManager::registerEntityDataSerializer

[v20.4.18-1.20.4] - 2024-02-04

新增

• 添加 GuiGraphicsHelper
• 添加 DynamicallyCopiedPackResources

更改

• 允许 SpritelessImageButton 支持绘制原版按钮背景
• 在 Forge 上 CapabilityToken 不再需要为能力显式设置

修复

• 修复 Fabric 上 ContainerScreenEvents$Background 触发过晚的问题（Forge 和 NeoForge 仍存在问题，等待对应加载器修复）

[v20.4.17-1.20.4] - 2024-02-03

修复

• 修复 Forge 上 ClientModConstructor::onRegisterRenderBuffers 触发过晚的问题

[v20.4.16-1.20.4] - 2024-02-03

新增

• 添加 Proxy::splitTooltipLines

[v20.4.15-1.20.4] - 2024-02-01

修复

• 修复使用农夫乐事（Farmer's Delight）的镰刀破坏作物时崩溃的问题

[v20.4.14-1.20.4] - 2024-01-30

更改

• 更新至最新模组加载器版本

修复

• 修复 NeoForge 上启动崩溃问题
• 修复 Forge 上鼠标拖拽事件不触发的问题

[v20.4.13-1.20.4] - 2024-01-29

新增

• 添加 AbstractAdvancementProvider

修复

• 修复复制标签配方有时使用了错误的序列化器

[v20.4.12-1.20.4] - 2024-01-29

修复

• 修复 AbstractLootProvider$EntityTypes

[v20.4.11-1.20.4] - 2024-01-28

修复

• 再次修复数据生成问题

[v20.4.10-1.20.4] - 2024-01-28

新增

• 添加 NeoForgeCapabilityHelperV2
• 添加 ModLoaderEnvironment::isDataGeneration

修复

• 修复开发环境工具破坏数据生成的问题

[v20.4.9-1.20.4] - 2024-01-27

新增

• 为开发环境添加 EditBox 改进功能

修复

• 修复专用服务器上 TagsUpdatedCallback 和 ServerLifecycleEvents.Starting 不运行的问题

[v20.4.8-1.20.4] - 2024-01-26

新增

• 添加 ClientModConstructor::onRegisterRenderBuffers
• 添加更多开发环境小工具

更改

• 在 Fabric 上重新基于 Fabric API 的 attachment API 实现能力系统，替代 Cardinal Components 库
• 使用 Fabric API 的新原生事件实现 LivingConversionCallback
• 使用 NeoForge 的新原生事件实现 MenuScreensContext

[v20.4.7-1.20.4] - 2024-01-24

更改

• 恢复之前回退的降低视网膜分辨率设置

修复

• 修复 Forge 和 NeoForge 上 ScreenMouseEvents$BeforeMouseDrag 与 ScreenMouseEvents$AfterMouseDrag 不触发的问题

[v20.4.6-1.20.4] - 2024-01-23

更改

• 对 ScreenTooltipFactory 进行更多调整
• 回退降低视网膜分辨率的设置

[v20.4.5-1.20.4] - 2024-01-23

新增

• 添加 NeoForgeCapabilityHelper
• 添加 CommandOverrides

更改

• 对 ScreenTooltipFactory 进行一些调整
• 为开发环境设置默认选项并运行默认命令
• 在 Mac 开发环境中降低视网膜分辨率（仅 Fabric）

[v20.4.4-1.20.4] - 2024-01-21

新增

• 添加 GameRuleValueOverrides

更改

• 将公共模块中的所有访问器 Mixin 迁移到访问扩展器（access wideners）
• 为开发环境设置一些默认游戏规则值
• 在 Forge 上通过提供临时默认实例处理失效的能力
• 允许数据生成运行配置正常退出

[v20.4.3-1.20.4] - 2024-01-20

新增

• 添加 SpritelessImageButton
• 添加 NbtSerializable
• 添加 RegistryHelper::getBuiltInRegistryHolder

[v20.4.2-1.20.4] - 2024-01-20

新增

• 添加 MenuScreensContext 用于注册菜单界面工厂

更改

• 允许 EnumProvider 接受自定义命名空间

[v20.4.1-1.20.4] - 2024-01-19

新增

• 添加 KeyedValueProvider，用于在 ConfigDataSet 中序列化非注册表来源的值

更改

• 回退 RegistryManager 返回 Holder 而非 Holder.Reference 的变更
• 将 init.v2 迁移至 init.v3
• 更新部分 Javadoc
• 将数据提供者中的一些方法设为 public

修复

• 修复因 NeoForge 补丁增加构造函数参数导致无法实例化 AbstractRecipeProvider 的问题

移除

• 移除 Proxy::getKeyMappingComponent

[v20.4.0-1.20.4] - 2024-01-17

• 移植至 Minecraft 1.20.4
• 移植至 NeoForge
• 支持 Mixin Extras

更改

• 彻底重构能力 API 为 v3 版本，v2 已移除
• 将 RegistryManagerV3 重命名为 RegistryManager，现使用 Holder 而非 Holder.Reference
• 重构事件实现，并延迟事件加载以避免被归咎于类加载错误
• 数据生成 exclusively 移至 NeoForge
• 对 NetworkHandlerV2 中 Message 注册进行小幅优化

移除

• 移除 RegistryManagerV2
• 移除捆绑的 PuzzlesAccessApi，转而使用 Loom 的访问扩展器

更新日志

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

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

[v20.4.53-1.20.4] - 2025-10-23

更改

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

[v20.4.52-1.20.4] - 2024-06-16

修复

• 尝试修复 Forge 的重映射问题

[v20.4.51-1.20.4] - 2024-06-11

修复

• 再次修复 RangedSliderButton::getValue

[v20.4.50-1.20.4] - 2024-06-11

修复

• 修复 RangedSliderButton::getValue

[v20.4.49-1.20.4] - 2024-06-11

新增

• 添加 RangedSliderButton

[v20.4.48-1.20.4] - 2024-06-07

新增

• 添加 ComponentHelper::toString

[v20.4.47-1.20.4] - 2024-06-07

新增

• 添加 ComputeFieldOfViewCallback

更改

• 为 GatherDebugTextEvents 添加额外参数，并调整 Fabric 上的注入点

[v20.4.46-1.20.4] - 2024-06-03

更改

• 在 Forge 和 NeoForge 上注册时立即加载客户端和通用配置，以准备 NeoForge 在 1.20.6 中的启动配置，并与 Fabric 保持一致

修复

• 修复 MutableSoundType 中的重载问题
• 通过内部引入自定义事件，修复 Fabric 上 PlayerTrackingEvents#START 触发过早的问题

[v20.4.45-1.20.4] - 2024-06-01

新增

• 添加 HolderBackedSoundType 和 MutableSoundType

修复

• 修复 Fabric 上创造性模式玩家使用 PlayerInteractEvents$AttackBlock 时不触发的问题

[v20.4.44-1.20.4] - 2024-05-26

修复

• 尝试改进资源重载期间缺失子级重载监听器的处理

[v20.4.43-1.20.4] - 2024-05-09

修复

• 修复在 NeoForge 上以及安装 ModernFix 模组的 Forge 环境中，GatherPotentialSpawnsCallback 导致崩溃的问题

[v20.4.42-1.20.4] - 2024-03-24

新增

• 添加 LookingAtEndermanCallback

更改

• 调整 PlayerInteractEvents 实现，允许返回 InteractionResult#PASS 而不被忽略
• 使 LoadCompleteCallback 在 Forge 和 NeoForge 上按顺序运行

修复

• 修复 Forge 上 EntityDataSerializer 注册问题，避免接收服务器数据时出现 ID 不匹配

[v20.4.41-1.20.4] - 2024-03-19

新增

• 添加 RenderTooltipCallback，替代 ScreenTooltipEvents$Render

修复

• 修复 Fabric 上 LivingDeathCallback 对玩家不触发的问题

[v20.4.40-1.20.4] - 2024-03-18

修复

• 修复 Forge 和 NeoForge 上无法处理 mods.toml 中定义多个模组的模组 JAR 文件的问题

[v20.4.39-1.20.4] - 2024-03-14

更改

• 向远程同步时调用 CapabilityComponent::setChanged

[v20.4.38-1.20.4] - 2024-03-12

新增

• 添加 ContainerEvents

[v20.4.37-1.20.4] - 2024-03-12

新增

• 添加 CapabilityComponent::initialize

[v20.4.36-1.20.4] - 2024-03-02

更改

• 扩展并简化 AbstractTagAppender 的实现

[v20.4.35-1.20.4] - 2024-03-01

新增

• 添加新版 AbstractTagProvider
• 添加自定义 AbstractTagAppender

[v20.4.34-1.20.4] - 2024-02-29

更改

• 在 Fabric 的专用服务器上将 LoadCompleteCallback 提前执行

[v20.4.33-1.20.4] - 2024-02-28

更改

• 更新部分 DynamicPackResources 内部实现

[v20.4.32-1.20.4] - 2024-02-27

新增

• 添加 ModLoaderEnvironment::getCurrentMappingsNamespace

更改

• 允许在 PackResourcesHelper 中设置默认资源包位置

[v20.4.31-1.20.4] - 2024-02-24

修复

• 修复 Forge 上玩家死亡时能力提供无效持有者（holder）的问题

[v20.4.30-1.20.4] - 2024-02-23

修复

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

[v20.4.29-1.20.4] - 2024-02-23

修复

• 修复 RenderHandEvents#OFF_HAND 触发了错误的手部事件类型

[v20.4.28-1.20.4] - 2024-02-23

新增

• 添加 RegistryManager::registerArgumentType
• 添加 RenderHandEvents，替代 RenderHandCallback

修复

• 修复客户端尝试同步已更改的能力值的问题

[v20.4.27-1.20.4] - 2024-02-22

新增

• 添加 KeyActivationHandler
• 添加 KeyMappingHelper::registerKeyMapping
• 添加 PlayerSet

[v20.4.26-1.20.4] - 2024-02-19

更改

• 弃用 ScreenHelper，推荐使用访问扩展器（Access Wideners）和 ScreenHelperV2

[v20.4.25-1.20.4] - 2024-02-19

修复

• 修复矿车类型注册表映射越界问题

[v20.4.24-1.20.4] - 2024-02-18

新增

• 添加 MinecartTypeRegistry
• 添加 ContainerMenuHelper
• 添加 NeoForgeCapabilityHelperV2#registerEntityContainer

[v20.4.23-1.20.4] - 2024-02-15

修复

• 修复因错误导入导致专用服务器崩溃的问题

[v20.4.22-1.20.4] - 2024-02-14

新增

• 添加 GenericExplosionHelper
• 添加 AbstractLootProviderV2
• 为 AbstractSoundDefinitionProvider 添加更多辅助方法
• 添加 AbstractLanguageProvider::addSpawnEgg

更改

• 在 AbstractModelProvider 中验证物品模型

修复

• 修复 AbstractBuiltInDataProvider 未使用文件助手注册生成资源的问题
• 修复 ItemDisplayOverrides 在 Forge 和 NeoForge 上崩溃的问题

[v20.4.21-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 在 Fabric 和 Forge 上实际未注册序列化器的问题

[v20.4.20-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 的类型参数问题

[v20.4.19-1.20.4] - 2024-02-09

新增

• 添加 RegistryManager::registerEntityDataSerializer

[v20.4.18-1.20.4] - 2024-02-04

新增

• 添加 GuiGraphicsHelper
• 添加 DynamicallyCopiedPackResources

更改

• 允许 SpritelessImageButton 支持绘制原版按钮背景
• Forge 上能力不再需要设置 CapabilityToken

修复

• 修复 ContainerScreenEvents$Background 在 Fabric 上触发过晚的问题（Forge 和 NeoForge 仍存在问题，等待对应加载器修复）

[v20.4.17-1.20.4] - 2024-02-03

修复

• 修复 ClientModConstructor::onRegisterRenderBuffers 在 Forge 上运行过晚的问题

[v20.4.16-1.20.4] - 2024-02-03

新增

• 添加 Proxy::splitTooltipLines

[v20.4.15-1.20.4] - 2024-02-01

修复

• 修复使用农夫乐事（Farmer's Delight）的镰刀收割作物时崩溃的问题

[v20.4.14-1.20.4] - 2024-01-30

更改

• 更新至最新模组加载器版本

修复

• 修复 NeoForge 上的启动崩溃
• 修复 Forge 上鼠标拖拽事件未触发的问题

[v20.4.13-1.20.4] - 2024-01-29

新增

• 添加 AbstractAdvancementProvider

修复

• 修复复制标签配方有时使用了错误的序列化器

[v20.4.12-1.20.4] - 2024-01-29

修复

• 修复 AbstractLootProvider$EntityTypes

[v20.4.11-1.20.4] - 2024-01-28

修复

• 再次修复数据生成问题

[v20.4.10-1.20.4] - 2024-01-28

新增

• 添加 NeoForgeCapabilityHelperV2
• 添加 ModLoaderEnvironment::isDataGeneration

修复

• 修复开发环境工具破坏数据生成的问题

[v20.4.9-1.20.4] - 2024-01-27

新增

• 为开发环境添加 EditBox 改进功能

修复

• 修复 TagsUpdatedCallback 和 ServerLifecycleEvents.Starting 在专用服务器上未运行的问题

[v20.4.8-1.20.4] - 2024-01-26

新增

• 添加 ClientModConstructor::onRegisterRenderBuffers
• 添加更多开发环境的小型工具

更改

• 在 Fabric 上基于 Fabric API 的 attachment API 重新实现能力系统，取代 Cardinal Components 库
• 使用 Fabric API 的新原生事件实现 LivingConversionCallback
• 使用 NeoForge 的新原生事件实现 MenuScreensContext

[v20.4.7-1.20.4] - 2024-01-24

更改

• 恢复之前回退的降低视网膜分辨率设置

修复

• 修复 ScreenMouseEvents$BeforeMouseDrag 和 ScreenMouseEvents$AfterMouseDrag 在 Forge 和 NeoForge 上未触发的问题

[v20.4.6-1.20.4] - 2024-01-23

更改

• 对 ScreenTooltipFactory 进行更多调整
• 回退降低的视网膜分辨率

[v20.4.5-1.20.4] - 2024-01-23

新增

• 添加 NeoForgeCapabilityHelper
• 添加 CommandOverrides

更改

• 对 ScreenTooltipFactory 进行一些调整
• 为开发环境设置默认选项并运行默认命令
• 在 Mac 开发环境中降低视网膜分辨率（仅 Fabric）

[v20.4.4-1.20.4] - 2024-01-21

新增

• 添加 GameRuleValueOverrides

更改

• 将公共模块中的所有访问器 Mixin 迁移至访问扩展器（access wideners）
• 为开发环境设置一些默认游戏规则值
• 通过提供临时默认实例处理 Forge 上失效的能力
• 允许数据生成运行配置正常退出

[v20.4.3-1.20.4] - 2024-01-20

新增

• 添加 SpritelessImageButton
• 添加 NbtSerializable
• 添加 RegistryHelper::getBuiltInRegistryHolder

[v20.4.2-1.20.4] - 2024-01-20

新增

• 添加 MenuScreensContext 用于注册菜单界面工厂

更改

• 允许 EnumProvider 接受自定义命名空间

[v20.4.1-1.20.4] - 2024-01-19

新增

• 添加 KeyedValueProvider，用于在 ConfigDataSet 中序列化非注册表来源的值

更改

• 回退 RegistryManager 返回 Holder 而非 Holder.Reference 的变更
• 将 init.v2 迁移到 init.v3
• 更新部分 Javadoc
• 将数据提供者中的一些方法设为 public

修复

• 修复因 NeoForge 补丁增加构造函数参数导致无法实例化 AbstractRecipeProvider 的问题

移除

• 移除 Proxy::getKeyMappingComponent

[v20.4.0-1.20.4] - 2024-01-17

• 移植至 Minecraft 1.20.4
• 移植至 NeoForge
• 支持 Mixin Extras

更改

• 彻底重构能力 API 为 v3 版本，v2 已移除
• 将 RegistryManagerV3 重命名为 RegistryManager，现使用 Holder 而非 Holder.Reference
• 重构事件实现，并延迟事件加载以避免被归咎于类加载错误
• 数据生成 exclusively 移至 NeoForge
• 对 NetworkHandlerV2 中 Message 注册进行小幅重构

移除

• 移除 RegistryManagerV2
• 移除捆绑的 PuzzlesAccessApi，改用 Loom 的访问扩展器（access wideners）

更新日志

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

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

[v20.4.53-1.20.4] - 2025-10-23

更改

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

[v20.4.52-1.20.4] - 2024-06-16

修复

• 尝试修复 Forge 的重映射问题

[v20.4.51-1.20.4] - 2024-06-11

修复

• 再次修复 RangedSliderButton::getValue

[v20.4.50-1.20.4] - 2024-06-11

修复

• 修复 RangedSliderButton::getValue

[v20.4.49-1.20.4] - 2024-06-11

新增

• 添加 RangedSliderButton

[v20.4.48-1.20.4] - 2024-06-07

新增

• 添加 ComponentHelper::toString

[v20.4.47-1.20.4] - 2024-06-07

新增

• 添加 ComputeFieldOfViewCallback

更改

• 为 GatherDebugTextEvents 添加额外参数，并调整 Fabric 上的注入点

[v20.4.46-1.20.4] - 2024-06-03

更改

• 在 Forge 和 NeoForge 上注册时立即加载客户端和通用配置，为 1.20.6 版本中 NeoForge 的启动配置做准备，并与 Fabric 保持一致

修复

• 修复 MutableSoundType 中的重载方法
• 通过内部引入自定义事件，修复 Fabric 上 PlayerTrackingEvents#START 触发过早的问题

[v20.4.45-1.20.4] - 2024-06-01

新增

• 添加 HolderBackedSoundType 和 MutableSoundType

修复

• 修复 Fabric 上创造性模式玩家无法触发 PlayerInteractEvents$AttackBlock 事件的问题

[v20.4.44-1.20.4] - 2024-05-26

修复

• 尝试改进资源重载期间缺失子级重载监听器的处理

[v20.4.43-1.20.4] - 2024-05-09

修复

• 修复在 NeoForge 上以及安装 ModernFix 模组的 Forge 环境中，GatherPotentialSpawnsCallback 导致崩溃的问题

[v20.4.42-1.20.4] - 2024-03-24

新增

• 添加 LookingAtEndermanCallback

更改

• 调整 PlayerInteractEvents 的实现，允许返回 InteractionResult#PASS 而不被忽略
• 使 LoadCompleteCallback 在 Forge 和 NeoForge 上按顺序运行

修复

• 修复 Forge 上 EntityDataSerializer 注册问题，避免接收服务器数据时出现 ID 不匹配

[v20.4.41-1.20.4] - 2024-03-19

新增

• 添加 RenderTooltipCallback，替代 ScreenTooltipEvents$Render

修复

• 修复 Fabric 上 LivingDeathCallback 对玩家不触发的问题

[v20.4.40-1.20.4] - 2024-03-18

修复

• 修复 Forge 和 NeoForge 上模组列表无法处理 mods.toml 中定义多个模组的 JAR 文件的问题

[v20.4.39-1.20.4] - 2024-03-14

更改

• 向远程端同步时调用 CapabilityComponent::setChanged

[v20.4.38-1.20.4] - 2024-03-12

新增

• 添加 ContainerEvents

[v20.4.37-1.20.4] - 2024-03-12

新增

• 添加 CapabilityComponent::initialize

[v20.4.36-1.20.4] - 2024-03-02

更改

• 扩展并简化 AbstractTagAppender 的实现

[v20.4.35-1.20.4] - 2024-03-01

新增

• 添加新版 AbstractTagProvider
• 添加自定义 AbstractTagAppender

[v20.4.34-1.20.4] - 2024-02-29

更改

• 在 Fabric 专用服务器上将 LoadCompleteCallback 提前执行

[v20.4.33-1.20.4] - 2024-02-28

更改

• 更新部分 DynamicPackResources 内部实现

[v20.4.32-1.20.4] - 2024-02-27

新增

• 添加 ModLoaderEnvironment::getCurrentMappingsNamespace

更改

• 允许在 PackResourcesHelper 中设置默认资源包位置

[v20.4.31-1.20.4] - 2024-02-24

修复

• 修复 Forge 上玩家死亡时能力提供无效持有者（holder）的问题

[v20.4.30-1.20.4] - 2024-02-23

修复

• 修复 Fabric 上 RegisterCommandsCallback 未运行的问题

[v20.4.29-1.20.4] - 2024-02-23

修复

• 修复 RenderHandEvents#OFF_HAND 触发了错误的手部事件类型

[v20.4.28-1.20.4] - 2024-02-23

新增

• 添加 RegistryManager::registerArgumentType
• 添加 RenderHandEvents，替代 RenderHandCallback

修复

• 修复客户端尝试同步已更改的能力值的问题

[v20.4.27-1.20.4] - 2024-02-22

新增

• 添加 KeyActivationHandler
• 添加 KeyMappingHelper::registerKeyMapping
• 添加 PlayerSet

[v20.4.26-1.20.4] - 2024-02-19

更改

• 弃用 ScreenHelper，推荐使用访问扩展器（Access Wideners）和 ScreenHelperV2

[v20.4.25-1.20.4] - 2024-02-19

修复

• 修复矿车类型注册表映射越界问题

[v20.4.24-1.20.4] - 2024-02-18

新增

• 添加 MinecartTypeRegistry
• 添加 ContainerMenuHelper
• 添加 NeoForgeCapabilityHelperV2#registerEntityContainer

[v20.4.23-1.20.4] - 2024-02-15

修复

• 修复因错误导入导致专用服务器崩溃的问题

[v20.4.22-1.20.4] - 2024-02-14

新增

• 添加 GenericExplosionHelper
• 添加 AbstractLootProviderV2
• 为 AbstractSoundDefinitionProvider 添加更多辅助方法
• 添加 AbstractLanguageProvider::addSpawnEgg

更改

• 在 AbstractModelProvider 中验证物品模型

修复

• 修复 AbstractBuiltInDataProvider 未使用文件助手注册生成资源的问题
• 修复 ItemDisplayOverrides 在 Forge 和 NeoForge 上崩溃的问题

[v20.4.21-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 在 Fabric 和 Forge 上实际未注册序列化器的问题

[v20.4.20-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 的类型参数问题

[v20.4.19-1.20.4] - 2024-02-09

新增

• 添加 RegistryManager::registerEntityDataSerializer

[v20.4.18-1.20.4] - 2024-02-04

新增

• 添加 GuiGraphicsHelper
• 添加 DynamicallyCopiedPackResources

更改

• 允许 SpritelessImageButton 支持绘制原版按钮背景
• Forge 上能力不再需要设置 CapabilityToken

修复

• 修复 Fabric 上 ContainerScreenEvents$Background 触发过晚的问题（Forge 和 NeoForge 仍存在问题，等待对应加载器修复）

[v20.4.17-1.20.4] - 2024-02-03

修复

• 修复 Forge 上 ClientModConstructor::onRegisterRenderBuffers 触发过晚的问题

[v20.4.16-1.20.4] - 2024-02-03

新增

• 添加 Proxy::splitTooltipLines

[v20.4.15-1.20.4] - 2024-02-01

修复

• 修复使用农夫乐事（Farmer's Delight）的镰刀破坏作物时崩溃的问题

[v20.4.14-1.20.4] - 2024-01-30

更改

• 更新至最新模组加载器版本

修复

• 修复 NeoForge 上的启动崩溃
• 修复 Forge 上鼠标拖拽事件未触发的问题

[v20.4.13-1.20.4] - 2024-01-29

新增

• 添加 AbstractAdvancementProvider

修复

• 修复复制标签配方有时使用了错误的序列化器

[v20.4.12-1.20.4] - 2024-01-29

修复

• 修复 AbstractLootProvider$EntityTypes

[v20.4.11-1.20.4] - 2024-01-28

修复

• 再次修复数据生成问题

[v20.4.10-1.20.4] - 2024-01-28

新增

• 添加 NeoForgeCapabilityHelperV2
• 添加 ModLoaderEnvironment::isDataGeneration

修复

• 修复开发环境工具破坏数据生成的问题

[v20.4.9-1.20.4] - 2024-01-27

新增

• 为开发环境添加 EditBox 改进功能

修复

• 修复专用服务器上 TagsUpdatedCallback 和 ServerLifecycleEvents.Starting 未运行的问题

[v20.4.8-1.20.4] - 2024-01-26

新增

• 添加 ClientModConstructor::onRegisterRenderBuffers
• 添加更多开发环境小工具

更改

• 在 Fabric 上基于 Fabric API 的 attachment API 重构能力系统，替代 Cardinal Components 库
• 使用 Fabric API 的新原生事件实现 LivingConversionCallback
• 使用 NeoForge 的新原生事件实现 MenuScreensContext

[v20.4.7-1.20.4] - 2024-01-24

更改

• 恢复之前回退的降低视网膜分辨率设置

修复

• 修复 Forge 和 NeoForge 上 ScreenMouseEvents$BeforeMouseDrag 和 ScreenMouseEvents$AfterMouseDrag 未触发的问题

[v20.4.6-1.20.4] - 2024-01-23

更改

• 对 ScreenTooltipFactory 进行更多调整
• 回退降低视网膜分辨率的设置

[v20.4.5-1.20.4] - 2024-01-23

新增

• 添加 NeoForgeCapabilityHelper
• 添加 CommandOverrides

更改

• 对 ScreenTooltipFactory 进行一些调整
• 为开发环境设置默认选项并运行默认命令
• 在 Mac 开发环境中降低视网膜分辨率（仅 Fabric）

[v20.4.4-1.20.4] - 2024-01-21

新增

• 添加 GameRuleValueOverrides

更改

• 将公共模块中的所有访问器 Mixin 迁移为访问扩展器（access wideners）
• 为开发环境设置一些默认游戏规则值
• 在 Forge 上通过提供临时默认实例处理失效的能力
• 允许数据生成运行配置正常退出

[v20.4.3-1.20.4] - 2024-01-20

新增

• 添加 SpritelessImageButton
• 添加 NbtSerializable
• 添加 RegistryHelper::getBuiltInRegistryHolder

[v20.4.2-1.20.4] - 2024-01-20

新增

• 添加 MenuScreensContext 用于注册菜单界面工厂

更改

• 允许 EnumProvider 接受自定义命名空间

[v20.4.1-1.20.4] - 2024-01-19

新增

• 添加 KeyedValueProvider，用于在 ConfigDataSet 中序列化非注册表来源的值

更改

• 回退 RegistryManager 返回 Holder 而非 Holder.Reference 的变更
• 将 init.v2 迁移到 init.v3
• 更新部分 Javadoc
• 将部分数据提供者的私有方法改为公开

修复

• 修复因 NeoForge 补丁增加构造函数参数导致无法实例化 AbstractRecipeProvider 的问题

移除

• 移除 Proxy::getKeyMappingComponent

[v20.4.0-1.20.4] - 2024-01-17

• 移植至 Minecraft 1.20.4
• 移植至 NeoForge
• 支持 Mixin Extras

更改

• 彻底重构能力 API 至 v3，v2 已移除
• 将 RegistryManagerV3 重命名为 RegistryManager，现使用 Holder 替代 Holder.Reference
• 重构事件实现机制，并延迟事件加载以避免被归咎于类加载错误
• 数据生成功能现已 exclusively 移至 NeoForge
• 对 NetworkHandlerV2 中 Message 注册进行小幅优化

移除

• 移除 RegistryManagerV2
• 移除捆绑的 PuzzlesAccessApi，改用 Loom 的访问扩展器（access wideners）

更新日志

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

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

[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.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.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