变更日志

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

格式基于 [Keep a Changelog]。

[v8.1.33-1.20.1] - 2025-08-03

修复

• 修复了因 java.lang.NoSuchMethodException: fuzs.puzzleslib.impl.event.LootTableModifyEvent.<init>() 导致的 Forge 启动崩溃

[v8.1.32-1.20.1] - 2025-04-05

更改

• 为事件调用者中的转换添加了一堆安全检查

[v8.1.31-1.20.1] - 2025-03-09

修复

• 修复了调用 ContainerMenuHelper::createListBackedContainer 导致的崩溃

[v8.1.30-1.20.1] - 2025-03-09

添加

• 回溯 MenuScreensContext
• 回溯 ContainerMenuHelper、ContainerSerializationHelper、ListBackedContainer、QuickMoveRuleSet

[v8.1.29-1.20.1] - 2025-03-09

修复

• 修复了使用某些 Tinkers' Construct 工具破坏方块时的崩溃

[v8.1.28-1.20.1] - 2025-03-08

更改

• 将捆绑的 Puzzles Access Api mod 更新为 v20.1.1

[v8.1.27-1.20.1] - 2025-03-08

添加

• 回溯 1.20.4 版本的 Capability System v3，以便不再需要 Cardinal Components mod

更改

• 将 Fabric Loom 更新为 v1.9
• 更新捆绑的 Puzzles Access Api mod
• 更新一堆数据提供程序

[v8.1.26-1.20.1] - 2025-03-04

更改

• 包含 Mixin Extras 库

[v8.1.25-1.20.1] - 2024-11-15

修复

• 修复了因 TooltipRenderHelper::createClientComponents 中的越界索引导致的崩溃

[v8.1.24-1.20.1] - 2024-10-04

修复

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

[v8.1.23-1.20.1] - 2024-09-09

修复

• 修复了 DynamicPackResources 在动态数据生成失败时提供无效包的问题

[v8.1.22-1.20.1] - 2024-08-26

修复

• 修复了 Fabric 上项目模型显示覆盖在模型重新加载之前能够计算的问题

[v8.1.21-1.20.1] - 2024-06-26

修复

• 修复了 Fabric 上创建玩家交互事件 $AttackBlock 时对于创意玩家不触发的问题

[v8.1.20-1.20.1] - 2024-05-26

修复

• 尝试改进在资源重新加载期间缺少子加载监听器时的处理

[v8.1.19-1.20.1] - 2024-05-09

更改

• 更新模组列表打印以更好地反映子模组关系（回溯自 1.20.4）

修复

• 修复了安装 ModernFix mod 时 Forge 上涉及 GatherPotentialSpawnsCallback 的崩溃

[v8.1.18-1.20.1] - 2024-03-20

修复

• 修复了 Fabric 上 LivingDeathCallback 对于玩家不运行的问题

[v8.1.17-1.20.1] - 2024-02-16

修复

• 修复了 Forge 上项目模型覆盖不应用的问题

[v8.1.16-1.20.1] - 2024-02-01

修复

• 修复了使用 Farmer's Delight 的镰刀破坏作物时的崩溃

[v8.1.15-1.20.1] - 2024-01-28

修复

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

[v8.1.14-1.20.1] - 2024-01-24

更改

• 延迟事件初始化以避免因类加载错误而受到指责

修复

• 修复了使用自定义伤害源杀死实体时不产生任何经验的问题
• 通过将有问题的代码移动到相关模组来修复与 Hephaestus 的兼容性问题，因此只有该模组在 Hephaestus 端的问题得到正确解决之前不兼容

[v8.1.13-1.20.1] - 2024-01-11

修复

• 修复了卸载位于世界 serverconfig 目录中的服务器配置失败并导致某些进程挂起的问题

[v8.1.12-1.20.1] - 2024-01-05

修复

• 修复了缺少 ToolTypeHelper::isTrident 方法的问题

[v8.1.11-1.20.1] - 2023-12-03

修复

• 修复了匿名网络处理程序允许重复 ID 的问题

[v8.1.10-1.20.1] - 2023-12-03

更改

• 在网络处理程序 ID 中使用字符串上下文而不是数字

[v8.1.9-1.20.1] - 2023-11-19

更改

• 轻微的与能力相关的代码清理
• BlockConversionHelper 的错误消息现在包含更多上下文

修复

• 修复了 RegistryEntryAddedCallback 未正确同步的问题

[v8.1.8-1.20.1] - 2023-11-07

修复

• 为安装了 Controlify 时屏幕导致游戏崩溃的问题实现了临时解决方法

[v8.1.7-1.20.1] - 2023-11-07

添加

• 添加了 ComponentHelper 用于将各种文本实例转换回 Component
• 添加了 LivingEquipmentChangeCallback

更改

• 改善了 BlockEvents.Break、LivingAttackCallback 和 PlayerInteractEvents.AttackBlock 在不同模组加载器之间的对等性

修复

• 确保 NetworkHandlerV3 的向后兼容性

[v8.1.6-1.20.1] - 2023-10-29

更改

• 将注册块和流体渲染类型的方法移动到 ClientAbstractions

修复

• 修复了因 Forge 版的 Forge Fabric Api 中的错误 Mixin 在 ModelProvider 中导致的崩溃

[v8.1.5-1.20.1] - 2023-10-29

更改

• 调整了 ModelEvents 以与 ModernFix 的动态资源配合使用

[v8.1.4-1.20.1] - 2023-10-28

修复

• 修复了块事件的块类型

[v8.1.3-1.20.1] - 2023-10-28

更改

• 禁用了 LivingEvents$Breathe 和 LivingEvents$Drown，以便能够将所需的 Forge 版本降低到 47.1.3
• 在 DataProviderHelper 中添加了一种支持旧数据提供程序的方法
• 对 NetworkHandlerV3 的一些部分进行了重构
• 在触发 RegistryEntryAddedCallback 时更加小心，引入了锁并捕获可能的异常，以避免整个注册过程失败
• 确保在模型事件中抛出的异常被捕获，不再导致游戏崩溃

修复

• 修复了动态数据生成在 Windows 上失败的问题

[v8.1.2-1.20.1] - 2023-10-27

修复

• 设置所需的 Forge 版本，以便仍然支持 NeoForge

[v8.1.1-1.20.1] - 2023-10-26

修复

• 修复了在某些情况下事件类可能加载过早的问题，解决了与例如 Stylish Effects 一起安装时的启动崩溃问题
• 修复了所需的 Forge 版本设置不正确的问题（现在需要 47.2.0，而不是 47.1.0）
• 修复了 Puzzles Lib 在 Forge 上有任何未满足的模组版本要求时导致游戏崩溃的问题，防止 Forge 屏幕通知用户显示

[v8.1.0-1.20.1] - 2023-10-26

• 发布所有在 v8.0.24 之后的版本

更改

• 扩展了 AbstractModelProvider

[v8.0.41-1.20.1] - 2023-10-24

添加

• 添加了获取 RenderType 的通用帮助方法
• 添加了从合并各种与块相关的实用方法的 BlockConversionHelper

[v8.0.40-1.20.1] - 2023-10-23

更改

• 改进了 Forge 上新模型事件的性能

[v8.0.39-1.20.1] - 2023-10-22

添加

• 添加了基于完全基于模组加载器特定实现的 ModifyUnbakedModel、ModifyBakedModel 和 AdditionalBakedModel 以更好地控制模型
• 添加了设置 BlockItem 块的帮助方法

更改

• 在 ClientAbstractions 中不再需要提供 Minecraft 实例
• RegistryEntryAddedCallback 现在包括当前注册表
• 弃用了旧的模型事件

修复

• 修复了 RegistryEntryAddedCallback 在 Forge 上运行过早的问题，导致依赖于事件期间注册的内容的实现出现问题

[v8.0.38-1.20.1] - 2023-10-20

添加

• 添加了 GatherDebugTextEvents$Left 和 GatherDebugTextEvents$Right
• 添加了 LivingEvents$Breathe 和 LivingEvents$Drown
• 添加了 RegistryEntryAddedCallback
• 添加了 ServerChunkEvents$Watch 和 ServerChunkEvents$Unwatch

更改

• 当存在本地服务器配置时，允许覆盖全局服务器配置
• 允许创建不一定需要模组加载器特定事件实现的通用事件

修复

• 修复了在 Quilt 上尝试访问 Fabric 内部字段以进行生物群系修改 API 时记录的错误
• 修复了尝试反序列化由配置项提供的无效 ResourceLocation 时的崩溃

[v8.0.37-1.20.1] - 2023-10-04

更改

• 在 Forge 数据生成期间不再在数据提供程序上设置 ExistingFileHelper
• AbstractLanguageProvider 中的一些新的 null 检查

[v8.0.36-1.20.1] - 2023-10-01

更改

• 回退了对 AbstractModelProvider 的实验性更改

[v8.0.35-1.20.1] - 2023-09-29

添加

• 添加了 ForgeDataProviderContext$Factory 以更好地支持 Forge 上的数据生成

更改

• 对 AbstractModelProvider 的一些实验性更改，希望能修复 Forge 模组上的运行时问题
• ConfigDataSet 现在可以通过用 ! 标记来排除条目

[v8.0.34-1.20.1] - 2023-09-28

添加

• 添加了 BlockEvents$Break 和 BlockEvents$DropExperience
• 添加了 TickingBlockEntity 和 TickingEntityBlock 帮助接口，无需使用静态计时器方法即可创建滴答块实体
• 添加了 AddToastCallback 用于处理客户端提示
• 添加了 ScreenEvents$BeforeInitV2 和 ScreenEvents$AfterInitV2，使用类型参数表示屏幕实例
• 添加了 CommonAbstractions::createPackInfo
• 添加了 ModConstructor::onRegisterBlockInteractions 用于注册块转换，如可剥日志或可耕泥土块
• 添加了 GrindstoneEvents$Update 和 GrindstoneEvents$Use
• 添加了 TypedTagFactory 和 BoundTagFactory 用于创建新的 TagKey，因此 TagKey 已从新的 RegistryManager 中移除
• 添加了 CombinedIngredients 用于创建更复杂的 Ingredient 实例
• 添加了 ShapesHelper，主要用于将 VoxelShape 旋转到给定的 Direction
• 添加了 DynamicPackResources 用于在运行时通过数据提供程序生成资源
• 添加了 RegistryHelper 用于各种 vanilla 注册相关的帮助方法

更改

• Puzzles Access Api mod 现在与 Puzzles Lib 捆绑在一起
• overhauled 数据生成类，将它们移动和重新设计为通用项目，以便在新的 DynamicPackResources 中使用
• 改进了 AbstractModPackResources，以更好地处理模组 ID 以及允许隐藏一个包，这是 Forge 的一个专属功能
• 在 Forge 上提供生物群系修改的模组不再需要包含自己的生物群系修改器，该文件现在使用内置数据包自动生成
• 对 ItemAttributeModifiersCallback 的内部实现进行了 overhaul

修复

• 修复了与 ItemModelDisplayOverrides 和 EventInvokerRegistry 实现相关的类加载问题
• 修复了 AbstractParticleDescriptionProvider 未验证使用的纹理是否存在的问题
• 修复了当前游戏服务器在 Fabric 上未正确存储的问题

[v8.0.33-1.20.1] - 2023-09-09

更改

• 重新设计了上一个版本中引入的重新加载监听器处理，以修复由于未正确完成的重新加载监听器而导致的模组加载卡住的问题
• 更改了使用相同命名空间的多个网络处理程序的内部 ID 处理

[v8.0.32-1.20.1] - 2023-09-08

添加

• 添加了 ClientParticleTypes 用于注册完全客户端的粒子提供程序

更改

• ContentRegistrationFlags 现在通过实现 BaseModConstructor::getContentRegistrationFlags 来启用
• Fabric 现在在不严格要求的情况下更严格地强制实施 ContentRegistrationFlags，以提高与 Forge 的对等性
• 极大地扩展了 ParticleProvidersContext，以允许注册更多种类的粒子类型
• 对 ForwardingReloadListener 进行了 overhaul，以支持转发一组 PreparableReloadListener 实例，而不仅仅是单个实例
• 对 FabricReloadListener 进行了重构，使其成为更通用的 FabricReloadListenerHelper 类

[v8.0.31-1.20.1] - 2023-09-07

添加

• 为 Fabric 上的 EntityRenderDispatcher#renderers 添加了访问扩展器

[v8.0.30-1.20.1] - 2023-09-05

添加

• Puzzles Lib 现在在启动时将所有安装的模组列表打印到日志中，以帮助在未生成或提供崩溃报告时诊断问题
• 此功能仅在 Forge 上启用，因为 Fabric Loader 本身默认就是这样做的

更改

• 对与模组列表条目相关的一些模组加载器特定代码进行了重构

修复

• 修复了 Fabric 上 LivingDeathCallback 仅在服务器端运行的问题

[v8.0.29-1.20.1] - 2023-09-05

添加

• 添加了 `RenderLivingEvents

变更日志

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

格式基于 [Keep a Changelog]。

[v8.1.33-1.20.1] - 2025-08-03

修复

• 修复了由 java.lang.NoSuchMethodException: fuzs.puzzleslib.impl.event.LootTableModifyEvent.<init>() 导致的 Forge 启动崩溃

[v8.1.32-1.20.1] - 2025-04-05

更改

• 为事件调用者中的强制转换添加了一堆安全检查

[v8.1.31-1.20.1] - 2025-03-09

修复

• 修复了调用 ContainerMenuHelper::createListBackedContainer 导致的崩溃

[v8.1.30-1.20.1] - 2025-03-09

添加

• 回溯 MenuScreensContext
• 回溯 ContainerMenuHelper、ContainerSerializationHelper、ListBackedContainer、QuickMoveRuleSet

[v8.1.29-1.20.1] - 2025-03-09

修复

• 修复了使用某些 Tinkers' Construct 工具破坏方块时的崩溃

[v8.1.28-1.20.1] - 2025-03-08

更改

• 将捆绑的 Puzzles Access Api mod 更新到 v20.1.1

[v8.1.27-1.20.1] - 2025-03-08

添加

• 回溯 1.20.4 版本的 Capability System v3，以便不再需要 Cardinal Components mod

更改

• 将 Fabric Loom 更新到 v1.9
• 更新捆绑的 Puzzles Access Api mod
• 更新一堆数据提供程序

[v8.1.26-1.20.1] - 2025-03-04

更改

• 包含 Mixin Extras 库

[v8.1.25-1.20.1] - 2024-11-15

修复

• 修复了由于 TooltipRenderHelper::createClientComponents 中的越界索引导致的崩溃

[v8.1.24-1.20.1] - 2024-10-04

修复

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

[v8.1.23-1.20.1] - 2024-09-09

修复

• 修复了 DynamicPackResources 在动态数据生成失败时提供无效包的问题

[v8.1.22-1.20.1] - 2024-08-26

修复

• 修复了在 Fabric 上重新加载模型之前，项模型显示覆盖能够计算的问题

[v8.1.21-1.20.1] - 2024-06-26

修复

• 修复了在 Fabric 上创建模式玩家时，PlayerInteractEvents$AttackBlock 未触发的问题

[v8.1.20-1.20.1] - 2024-05-26

修复

• 尝试改进在资源重新加载期间缺少子重新加载监听器的处理

[v8.1.19-1.20.1] - 2024-05-09

更改

• 更新模组列表打印，以更好地反映子模组关系（回溯自 1.20.4）

修复

• 修复了在 Forge 上安装 ModernFix mod 时，涉及 GatherPotentialSpawnsCallback 的崩溃

[v8.1.18-1.20.1] - 2024-03-20

修复

• 修复了在 Fabric 上，LivingDeathCallback 未为玩家运行的问题

[v8.1.17-1.20.1] - 2024-02-16

修复

• 修复了在 Forge 上，项模型覆盖未应用的问题

[v8.1.16-1.20.1] - 2024-02-01

修复

• 修复了使用农夫乐事的镰刀破坏作物时的崩溃

[v8.1.15-1.20.1] - 2024-01-28

修复

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

[v8.1.14-1.20.1] - 2024-01-24

更改

• 延迟事件初始化，以避免因类加载错误而受到指责

修复

• 修复了使用自定义伤害源杀死实体时不产生任何经验的问题
• 通过将有问题的代码移动到相关模组，修复了与 Hephaestus 的兼容性问题，因此只有该模组在 Hephaestus 端的问题得到正确解决之前不兼容

[v8.1.13-1.20.1] - 2024-01-11

修复

• 修复了卸载位于世界 serverconfig 目录中的服务器配置失败并导致某些进程挂起的问题

[v8.1.12-1.20.1] - 2024-01-05

修复

• 修复了缺少 ToolTypeHelper::isTrident 方法的问题

[v8.1.11-1.20.1] - 2023-12-03

修复

• 修复了匿名网络处理程序允许重复 ID 的问题

[v8.1.10-1.20.1] - 2023-12-03

更改

• 在网络处理程序 ID 中使用字符串上下文，而不是数字

[v8.1.9-1.20.1] - 2023-11-19

更改

• 轻微的功能相关代码清理
• BlockConversionHelper 的错误消息现在包含更多上下文

修复

• 修复了 RegistryEntryAddedCallback 未正确同步的问题

[v8.1.8-1.20.1] - 2023-11-07

修复

• 为在安装 Controlify 时打开屏幕导致游戏崩溃实施了临时解决方案

[v8.1.7-1.20.1] - 2023-11-07

添加

• 添加了 ComponentHelper 用于将各种文本实例转换回 Component
• 添加了 LivingEquipmentChangeCallback

更改

• 改善 BlockEvents.Break、LivingAttackCallback 和 PlayerInteractEvents.AttackBlock 在不同模组加载器之间的对等性

修复

• 确保 NetworkHandlerV3 的向后兼容性

[v8.1.6-1.20.1] - 2023-10-29

更改

• 将注册块和流体渲染类型的方法移动到 ClientAbstractions

修复

• 修复了由于 Forge 的 Fabric Api 中的错误 Mixin 在 ModelProvider 中导致的崩溃

[v8.1.5-1.20.1] - 2023-10-29

更改

• 调整 ModelEvents 以与 ModernFix 的动态资源配合使用

[v8.1.4-1.20.1] - 2023-10-28

修复

• 修复了块事件块类型

[v8.1.3-1.20.1] - 2023-10-28

更改

• 禁用 LivingEvents$Breathe 和 LivingEvents$Drown，以便能够将所需的 Forge 版本降低到 47.1.3
• 在 DataProviderHelper 中添加了一种支持旧数据提供程序的方法
• 重构了 NetworkHandlerV3 的一些部分
• 在触发 RegistryEntryAddedCallback 时更加小心，引入了一个锁并捕获可能的异常，以避免整个注册过程失败
• 确保在模型事件中抛出的异常被捕获，不再导致游戏崩溃

修复

• 修复了在 Windows 上动态数据生成失败的问题

[v8.1.2-1.20.1] - 2023-10-27

修复

• 设置所需的 Forge 版本，以便仍然支持 NeoForge

[v8.1.1-1.20.1] - 2023-10-26

修复

• 修复了在某些情况下事件类可能加载过早的问题，解决了与例如 Stylish Effects 一起安装时的启动崩溃问题
• 修复了所需的 Forge 版本设置错误（现在需要 47.2.0，而不是 47.1.0）
• 修复了 Puzzles Lib 在 Forge 上存在任何未满足的模组版本要求时导致游戏崩溃的问题，防止 Forge 屏幕通知用户显示

[v8.1.0-1.20.1] - 2023-10-26

• 发布所有在 v8.0.24 之后的版本

更改

• 扩展 AbstractModelProvider

[v8.0.41-1.20.1] - 2023-10-24

添加

• 添加了用于获取 RenderType 的通用辅助方法
• 添加了从合并各种与块相关的实用方法中提取的 BlockConversionHelper

[v8.0.40-1.20.1] - 2023-10-23

更改

• 优化了 Forge 上新模型事件的性能

[v8.0.39-1.20.1] - 2023-10-22

添加

• 添加了基于完全基于模组加载器特定实现的更精细控制模型的 ModifyUnbakedModel、ModifyBakedModel 和 AdditionalBakedModel
• 添加了用于设置 BlockItem 块的辅助方法

更改

• 在 ClientAbstractions 中不再需要提供 Minecraft 实例
• RegistryEntryAddedCallback 现在包括当前注册表
• 弃用了旧的模型事件

修复

• 修复了 RegistryEntryAddedCallback 在 Forge 上运行过早的问题，导致依赖于事件期间注册的内容的实现出现问题

[v8.0.38-1.20.1] - 2023-10-20

添加

• 添加了 GatherDebugTextEvents$Left 和 GatherDebugTextEvents$Right
• 添加了 LivingEvents$Breathe 和 LivingEvents$Drown
• 添加了 RegistryEntryAddedCallback
• 添加了 ServerChunkEvents$Watch 和 ServerChunkEvents$Unwatch

更改

• 当存在本地服务器配置时，允许覆盖全局服务器配置
• 允许创建不一定需要模组加载器特定事件实现的通用事件

修复

• 修复了在 Quilt 上尝试访问 Fabric 内部字段以进行生物群系修改 API 时记录的错误
• 修复了尝试反序列化由配置条目提供的无效 ResourceLocation 时的崩溃

[v8.0.37-1.20.1] - 2023-10-04

更改

• 在 Forge 数据生成期间，不再在数据提供程序上设置 ExistingFileHelper
• AbstractLanguageProvider 中的一些新的 null 检查

[v8.0.36-1.20.1] - 2023-10-01

更改

• 回退了对 AbstractModelProvider 的实验性更改

[v8.0.35-1.20.1] - 2023-09-29

添加

• 添加了 ForgeDataProviderContext$Factory 以更好地支持 Forge 上的数据生成

更改

• 对 AbstractModelProvider 的一些实验性更改，希望能修复 Forge 模组上的运行时问题
• ConfigDataSet 现在可以通过标记为 ! 来排除条目

[v8.0.34-1.20.1] - 2023-09-28

添加

• 添加了 BlockEvents$Break 和 BlockEvents$DropExperience
• 添加了 TickingBlockEntity 和 TickingEntityBlock 辅助接口，用于创建无需使用静态计时器方法的滴答块实体
• 添加了 AddToastCallback 用于处理客户端提示
• 添加了 ScreenEvents$BeforeInitV2 和 ScreenEvents$AfterInitV2，使用类型参数表示屏幕实例
• 添加了 CommonAbstractions::createPackInfo
• 添加了 ModConstructor::onRegisterBlockInteractions 用于注册块转换，如可剥离的原木或可耕种的泥土块
• 添加了 GrindstoneEvents$Update 和 GrindstoneEvents$Use
• 添加了 TypedTagFactory 和 BoundTagFactory 用于创建新的 TagKey，因此标签键已从新的 RegistryManager 中删除
• 添加了 CombinedIngredients 用于创建更复杂的 Ingredient 实例
• 添加了 ShapesHelper，主要用于将 VoxelShape 旋转到给定的 Direction
• 添加了 DynamicPackResources 用于在运行时通过数据提供程序生成资源
• 添加了 RegistryHelper 用于各种香草注册相关的辅助方法

更改

• Puzzles Access Api mod 现在与 Puzzles Lib 捆绑在一起
• overhauled 数据生成类，将它们移动和重新设计用于通用项目，以便在新的 DynamicPackResources 中使用
• 改进了 AbstractModPackResources，以更好地处理模组 ID 以及允许隐藏包，这是 Forge 的独家功能
• 在 Forge 上提供生物群系修改的模组不再需要包含自己的生物群系修改器，该文件现在使用内置的数据包自动生成
• overhauled 内部实现的 ItemAttributeModifiersCallback

修复

• 修复了与 ItemModelDisplayOverrides 和 EventInvokerRegistry 实现相关的类加载问题
• 修复了 AbstractParticleDescriptionProvider 未验证使用的纹理的存在
• 修复了当前游戏服务器在 Fabric 上未正确存储的问题

[v8.0.33-1.20.1] - 2023-09-09

更改

• 重新设计了上一个版本中引入的重新加载监听器处理，以修复由于未正确完成的重新加载监听器而导致的模组加载卡住的问题
• 更改了使用相同命名空间的多个网络处理程序的内部 ID 处理

[v8.0.32-1.20.1] - 2023-09-08

添加

• 添加了 ClientParticleTypes 用于注册完全客户端粒子提供程序

更改

• ContentRegistrationFlags 现在通过实现 BaseModConstructor::getContentRegistrationFlags 来启用
• Fabric 现在在不需要严格要求的情况下更严格地执行 ContentRegistrationFlags，以提高与 Forge 的对等性
• 极大地扩展了 ParticleProvidersContext，以允许注册更多种类的粒子类型
• overhauled ForwardingReloadListener 以支持转发一组 PreparableReloadListener 实例，而不仅仅是单个实例
• 重构了 FabricReloadListener 为更通用的 FabricReloadListenerHelper 类

[v8.0.31-1.20.1] - 2023-09-07

添加

• 为 Fabric 上的 EntityRenderDispatcher#renderers 添加访问扩展器

[v8.0.30-1.20.1] - 2023-09-05

添加

• Puzzles Lib 现在在启动时将所有安装的模组列表打印到日志中，以帮助在未生成或提供崩溃报告时诊断问题
• 此功能仅在 Forge 上启用，因为 Fabric Loader 本身默认就是这样做的

更改

• 重构了一些与模组列表条目相关的模组加载器特定代码

修复

• 修复了在 Fabric 上，LivingDeathCallback 仅在服务器端运行的问题

[v8.0.29-1.20.1] - 2023-09-05

添加

• 添加了 RenderLivingEvents

[v8.0.2

变更日志

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

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

[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

修复

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

[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 上延迟一个滴答执行的问题

[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

更改

• 用 ClientParticleHelper 替换 ClientParticleTypes

[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 中添加用于水平旋转形状的辅助方法

更改

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

修复

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

[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， 并且此项目遵循 语义版本控制。

[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

修复

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

[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 上延迟一帧执行的问题

[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

更改

• 用 ClientParticleHelper 替换 ClientParticleTypes

[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

更改

• 彻底 overhaul RenderGuiLayerEvents 在 Fabric 上的实现

[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 添加用于水平旋转形状的辅助方法

更改

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

修复

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

[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

更改

• 彻底 overhaul 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

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

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

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

[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

修复

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

[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 上延迟一帧执行的问题

[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

更改

• 用ClientParticleHelper替换ClientParticleTypes

[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添加用于水平旋转形状的辅助方法

更改

• 如果通过依赖覆盖在 Fabric 上启用，则允许与 Minecraft 1.21 兼容
• 允许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， 并且此项目遵循 语义版本控制。

[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

修复

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

[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 上延迟一帧执行

[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

更改

• 用 ClientParticleHelper 替换 ClientParticleTypes

[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 添加用于水平旋转形状的辅助方法

更改

• 如果通过 依赖覆盖 启用，则允许在 Fabric 上与 Minecraft 1.21 兼容
• 允许 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， 并且本项目遵循 语义版本控制。

[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

更改

• 彻底 overhaul ComponentHelper 实现，以正确支持作为字符串一部分传递的旧格式代码

修复

• 修复 Fabric 上一些与玩家交互事件相关的怪癖

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

• 更新到 Minecraft 1.21.8

变更日志

本项目的所有重大更改都将记录在此文件中。

格式基于保持变更日志， 并且本项目遵循语义版本控制。

[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

更改

• 彻底 overhaul ComponentHelper实现，以正确支持作为字符串一部分传递的旧格式代码

修复

• 修复 Fabric 上玩家交互事件的一些怪癖

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

• 更新到 Minecraft 1.21.8

变更日志

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

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

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

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

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

• 更新至 Minecraft 1.21.8

变更日志

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

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

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

• 更新至 Minecraft 1.21.8

变更日志

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

格式基于 保持变更日志， 并且此项目遵循 语义版本控制。

[v21.7.1-1.21.7] - 2025-07-04

添加

• 重新添加 RenderGuiEvents

[v21.7.0-1.21.7] - 2025-07-01

• 更新到 Minecraft 1.21.7

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

[v21.7.1-1.21.7] - 2025-07-04

添加

• 重新添加RenderGuiEvents

[v21.7.0-1.21.7] - 2025-07-01

• 更新至 Minecraft 1.21.7

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

[v21.7.0-1.21.7] - 2025-07-01

• 更新到 Minecraft 1.21.7

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

[v21.7.0-1.21.7] - 2025-07-01

• 更新至 Minecraft 1.21.7

变更日志

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

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

[v21.6.6-1.21.6] - 2025-06-25

添加

• 添加 DrawItemStackOverlayCallback，弃用 ItemDecorationsContext

更改

• 更新为 NeoForge 21.6.16+

修复

• 修复更多状态栏高度提供程序问题

[v21.6.5-1.21.6] - 2025-06-25

修复

• 修复更多状态栏高度提供程序问题

[v21.6.4-1.21.6] - 2025-06-25

修复

• 修复更多状态栏高度提供程序问题

[v21.6.3-1.21.6] - 2025-06-25

添加

• 添加 ModLoaderEnvironment::isModPresentClientside

修复

• 修复各种状态栏高度提供程序问题

[v21.6.2-1.21.6] - 2025-06-19

添加

• 向 ContainerSerializationHelper 添加更多实用方法

更改

• 恢复附件以使用 Codec 而不是 MapCodec 进行序列化

[v21.6.1-1.21.6] - 2025-06-18

添加

• 添加 ValueSerializationHelper
• 添加 GuiGraphicsHelper::drawInBatch8xOutline

修复

• 修复在 Fabric 上 Minecraft 1.21.6 之前创建的世界中读取怪物字段 puzzleslib:spawn_type 的问题
• 修复 Fabric 上的 GatherEffectScreenTooltipCallback 注入点

[v21.6.0-1.21.6] - 2025-06-18

• 更新至 Minecraft 1.21.6

添加

• 添加 PictureInPictureRendererContext
• 添加 CommonHelper::getMinecraftServer
• 添加 CodecExtras::fromEnum
• 添加 RegistryManager::registerEnchantmentEffectComponentType
• 添加 ResourceKeyHelper::getResourceLocation
• 向 EnchantingHelper 添加许多附魔值效果奖励辅助方法
• 添加 ModPackMetadataProvider

更改

• 迁移 GuiLayersContext 以使用自定义层实现
• 重新设计 FogEvents 以考虑 vanilla 更改
• 简化 RenderLevelEvents 实现为 RenderLevelCallback
• 大大简化 ContainerSerializationHelper
• 用单个 CreateAnvilResultCallback 替换 AnvilEvents
• 用单个 CreateGrindstoneResultCallback 替换 GrindstoneEvents
• 将一些方法从 LookupHelper 移动到专用类
• 将 AbstractParticleProvider 和 AbstractEquipmentProvider 移动到公共模块

删除

• 删除 fuzs.puzzleslib.api.capability.v3
• 删除 fuzs.puzzleslib.api.network.v3
• 删除 RenderGuiLayerEvents
• 删除弃用的 ItemTooltipRegistry 类
• 删除 RenderTypeHelper，所有功能现在由 RenderTypesContext 涵盖
• 删除 ExtendedMenuSupplier
• 删除 EnchantingHelper::isBookEnchantable
• 删除 BlockEvents.FarmlandTrample
• 从公共 API 中删除默认的可变值类
• 删除 ComputeEnchantedLootBonusCallback
• 删除 EnchantingHelper::getMobLootingLevel
• 删除 ServerEntityLevelEvents.Spawn

变更日志

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

格式基于保持变更日志， 并且此项目遵循语义版本控制。

[v21.6.6-1.21.6] - 2025-06-25

添加

• 添加DrawItemStackOverlayCallback，弃用ItemDecorationsContext

更改

• 更新为 NeoForge 21.6.16+

修复

• 修复更多状态栏高度提供程序问题

[v21.6.5-1.21.6] - 2025-06-25

修复

• 修复更多状态栏高度提供程序问题

[v21.6.4-1.21.6] - 2025-06-25

修复

• 修复更多状态栏高度提供程序问题

[v21.6.3-1.21.6] - 2025-06-25

添加

• 添加ModLoaderEnvironment::isModPresentClientside

修复

• 修复各种状态栏高度提供程序问题

[v21.6.2-1.21.6] - 2025-06-19

添加

• 向ContainerSerializationHelper添加更多实用方法

更改

• 恢复附件以使用Codec而不是MapCodec进行序列化

[v21.6.1-1.21.6] - 2025-06-18

添加

• 添加ValueSerializationHelper
• 添加GuiGraphicsHelper::drawInBatch8xOutline

修复

• 修复在 Fabric 上 Minecraft 1.21.6 之前创建的世界中读取puzzleslib:spawn_type字段的问题
• 修复 Fabric 上的GatherEffectScreenTooltipCallback注入点

[v21.6.0-1.21.6] - 2025-06-18

• 更新到 Minecraft 1.21.6

添加

• 添加PictureInPictureRendererContext
• 添加CommonHelper::getMinecraftServer
• 添加CodecExtras::fromEnum
• 添加RegistryManager::registerEnchantmentEffectComponentType
• 添加ResourceKeyHelper::getResourceLocation
• 向EnchantingHelper添加许多附魔值效果加成辅助方法
• 添加ModPackMetadataProvider

更改

• 迁移GuiLayersContext以使用自定义层实现
• 重新设计FogEvents以考虑 vanilla 更改
• 简化RenderLevelEvents实现为RenderLevelCallback
• 大大简化ContainerSerializationHelper
• 用单个CreateAnvilResultCallback替换AnvilEvents
• 用单个CreateGrindstoneResultCallback替换GrindstoneEvents
• 将LookupHelper的一些方法移动到专用类
• 将AbstractParticleProvider和AbstractEquipmentProvider移动到公共模块

移除

• 移除fuzs.puzzleslib.api.capability.v3
• 移除fuzs.puzzleslib.api.network.v3
• 移除RenderGuiLayerEvents
• 移除弃用的ItemTooltipRegistry类
• 移除RenderTypeHelper，所有功能现在都由RenderTypesContext覆盖
• 移除ExtendedMenuSupplier
• 移除EnchantingHelper::isBookEnchantable
• 移除BlockEvents.FarmlandTrample
• 从公共 api 中移除默认的可变值类
• 移除ComputeEnchantedLootBonusCallback
• 移除EnchantingHelper::getMobLootingLevel
• 移除ServerEntityLevelEvents.Spawn