更新日志

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

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

更新日志

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

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

更新日志

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

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

[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.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.2-1.21.10] - 2025-10-11

变更

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

修复

• 修复了键位分类重复的问题
• 修复了 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.2-1.21.10] - 2025-10-11

更改

• 更新适配 NeoForge 21.10.7-beta
• 对 AbstractLanguageProvider 进行了小幅重构
• 当附件（Attachment）的新旧值相同时，不再设置该值

修复

• 修复了键位分类重复的问题
• 修复了 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.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.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.9.5-1.21.9] - 2025-10-08

修复

• 修复在 Fabric 上使用自定义轮廓高亮方块时导致的崩溃问题

[v21.9.4-1.21.9] - 2025-10-07

新增

• 重新添加 SubmitBlockOutlineCallback

更改

• 为 ModelLayerFactory 扩展新的辅助方法

修复

• 确保 ClientComponentSplitter::splitTooltipLines 仅在渲染线程正确运行

[v21.9.3-1.21.9] - 2025-10-05

修复

• 修复错误：The specified mixin 'fuzs.puzzleslib.neoforge.mixin.DatagenModLoaderNeoForgeMixin' was not found

[v21.9.2-1.21.9] - 2025-10-05

更改

• 更新 MobSpawnSettingsContext 的实现
• 将模组存在性检查从 ModLoaderEnvironment 移至 NetworkingHelper
• 在开发环境中允许预填 IP 地址启动服务器
• 移除数据生成关闭时的临时解决方案

修复

• 修复 GuiGraphicsHelper::blitTiledSprite 使用了错误的精灵图集位置

[v21.9.1-1.21.9] - 2025-10-02

修复

• 修复与最新 NeoForge 版本的兼容性问题

[v21.9.0-1.21.9] - 2025-09-27

新增

• 添加 ResourcePackReloadListenersContext
• 添加 ScreenHelper::isDoubleClick

更改

• 升级至 Minecraft 1.21.9
• 更新鼠标和键盘事件，以实现原版新的 MouseButtonEvent 和 KeyEvent
• GameplayContentContext::registerStrippable 不再要求方块必须具有 AXIS 属性
• AddDataPackReloadListenersCallback 现在提供完整的 ReloadableServerResources
• 将 ContainerScreenEvents 拆分为 ScreenEvents$AfterBackground 和 RenderContainerScreenContentsCallback
• 重构 SingleChestRenderer，使其也提供专用的渲染状态实现

移除

• 移除 NamedReloadListener
• 移除 Fabric 专用注册表，将其直接合并到 ModConstructor 上下文中
• 移除 ModelBakingCompleteCallback
• 移除 RenderPropertyKey，改用原版的 ContextKey
• 移除 CommonHelper::onExplosionStart
• 移除 EnumProvider
• 移除 GatherDebugInformationEvents
• 移除 RenderHighlightCallback（等待模组加载器提供替代方案）
• 移除 RenderLevelCallback（等待模组加载器提供替代方案）
• 移除 DynamicallyCopiedPackResources

更新日志

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

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

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

变更

• 升级至 Minecraft 1.21.10

更新日志

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

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

[v21.9.5-1.21.9] - 2025-10-08

修复

• 修复在 Fabric 上使用自定义轮廓高亮方块时导致崩溃的问题

[v21.9.4-1.21.9] - 2025-10-07

新增

• 重新添加 SubmitBlockOutlineCallback

更改

• 扩展 ModelLayerFactory，新增辅助方法

修复

• 确保 ClientComponentSplitter::splitTooltipLines 仅在渲染线程正确运行

[v21.9.3-1.21.9] - 2025-10-05

修复

• 修复错误：The specified mixin 'fuzs.puzzleslib.neoforge.mixin.DatagenModLoaderNeoForgeMixin' was not found

[v21.9.2-1.21.9] - 2025-10-05

更改

• 更新 MobSpawnSettingsContext 的实现
• 将模组存在性检查从 ModLoaderEnvironment 移至 NetworkingHelper
• 在开发环境中允许预填 IP 地址启动服务器
• 移除数据生成关闭的临时解决方案

修复

• 修复 GuiGraphicsHelper::blitTiledSprite 使用了错误的精灵图集位置

[v21.9.1-1.21.9] - 2025-10-02

修复

• 修复与最新 NeoForge 版本的兼容性问题

[v21.9.0-1.21.9] - 2025-09-27

新增

• 添加 ResourcePackReloadListenersContext
• 添加 ScreenHelper::isDoubleClick

更改

• 升级至 Minecraft 1.21.9
• 更新鼠标和键盘事件，以实现原版新的 MouseButtonEvent 和 KeyEvent
• GameplayContentContext::registerStrippable 不再要求方块具有 AXIS 属性
• AddDataPackReloadListenersCallback 现在提供完整的 ReloadableServerResources
• 将 ContainerScreenEvents 拆分为 ScreenEvents$AfterBackground 和 RenderContainerScreenContentsCallback
• 重构 SingleChestRenderer，使其也提供专用的渲染状态实现

移除

• 移除 NamedReloadListener
• 移除专用的 Fabric 注册表，将其直接合并到 ModConstructor 上下文中
• 移除 ModelBakingCompleteCallback
• 移除 RenderPropertyKey，改用原版的 ContextKey
• 移除 CommonHelper::onExplosionStart
• 移除 EnumProvider
• 移除 GatherDebugInformationEvents
• 移除 RenderHighlightCallback（等待模组加载器提供替代方案）
• 移除 RenderLevelCallback（等待模组加载器提供替代方案）
• 移除 DynamicallyCopiedPackResources

更新日志

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

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

[v21.9.4-1.21.9] - 2025-10-07

新增

• 重新添加 SubmitBlockOutlineCallback

更改

• 扩展 ModelLayerFactory，新增辅助方法

修复

• 确保 ClientComponentSplitter::splitTooltipLines 仅在渲染线程正确运行

[v21.9.3-1.21.9] - 2025-10-05

修复

• 修复错误：未找到指定的 Mixin 'fuzs.puzzleslib.neoforge.mixin.DatagenModLoaderNeoForgeMixin'

[v21.9.2-1.21.9] - 2025-10-05

更改

• 更新 MobSpawnSettingsContext 的实现
• 将模组存在性检查从 ModLoaderEnvironment 移至 NetworkingHelper
• 在开发环境中允许预填 IP 地址启动服务器
• 移除数据生成关闭时的临时解决方案

修复

• 修复 GuiGraphicsHelper::blitTiledSprite 使用了错误的精灵图集位置

[v21.9.1-1.21.9] - 2025-10-02

修复

• 修复与最新 NeoForge 版本的兼容性问题

[v21.9.0-1.21.9] - 2025-09-27

新增

• 添加 ResourcePackReloadListenersContext
• 添加 ScreenHelper::isDoubleClick

更改

• 升级至 Minecraft 1.21.9
• 更新鼠标和键盘事件，以实现原版新的 MouseButtonEvent 和 KeyEvent
• GameplayContentContext::registerStrippable 不再要求方块具有 AXIS 属性
• AddDataPackReloadListenersCallback 现在提供完整的 ReloadableServerResources
• 将 ContainerScreenEvents 拆分为 ScreenEvents$AfterBackground 和 RenderContainerScreenContentsCallback
• 重构 SingleChestRenderer，使其也提供专用的渲染状态实现

移除

• 移除 NamedReloadListener
• 移除 Fabric 专用注册表，将其直接合并到 ModConstructor 上下文中
• 移除 ModelBakingCompleteCallback
• 移除 RenderPropertyKey，改用原版的 ContextKey
• 移除 CommonHelper::onExplosionStart
• 移除 EnumProvider
• 移除 GatherDebugInformationEvents
• 移除 RenderHighlightCallback（等待模组加载器提供替代方案）
• 移除 RenderLevelCallback（等待模组加载器提供替代方案）
• 移除 DynamicallyCopiedPackResources