更新日志

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

格式遵循 保持更新日志 规范，
本项目亦遵循 语义化版本控制 规范。

[v21.1.52-1.21.1] - 2025-06-15

已修复

• 修复 NeoForge 下 NetworkingHelper::hasChannel 未检查 Connection::isConnected 的问题

[v21.1.51-1.21.1] - 2025-05-30

已更改

• 在 Fabric 平台上放宽原版客户端的注册表同步限制

已修复

• 修复尝试打开未加载配置项的配置界面时导致崩溃的问题

[v21.1.50-1.21.1] - 2025-05-28

已更改

• 在 Fabric 平台上支持注册不含 axis 属性的可剥落方块（stripple blocks）

[v21.1.49-1.21.1] - 2025-05-27

已修复

• 修复向 BlockSetVariant#HANGING_SIGN 物品传递错误告示牌类型的问题

[v21.1.48-1.21.1] - 2025-05-27

已新增

• 回溯 Minecraft 1.21.11 中的 ChunkSectionLayer
• 回溯 AbstractRecipeProvider 与 AbstractTagProvider 中缺失的 BlockSetFamily 相关方法

[v21.1.47-1.21.1] - 2025-05-26

已新增

• 回溯 BlockSetFamily
• 回溯 BlockSetVariant
• 回溯 ClientBlockSetFamily

已修复

• 修复 NeoForge 下 RenderTypeHelper::getRenderType 未调用正确方法的问题

[v21.1.46-1.21.1] - 2025-05-23

已修复

• 修复 LayerDefinition::create 中传入了错误的 MeshDefinition 参数的问题

[v21.1.45-1.21.1] - 2025-05-23

已新增

• 回溯 Minecraft 26.1 中的 ModelAndTexture
• 回溯 Minecraft 26.1 中的 ClientAsset
• 回溯 Minecraft 26.1 中的 LateBoundIdMapper
• 回溯 Minecraft 26.1 中的 SpecialModelRenderer
• 回溯 Minecraft 26.1 中 CodecExtras 内的部分编解码器（codec）

已修复

• 确保自定义 LayerDefinition 存储的是自定义 MeshDefinition，而非原版变体

[v21.1.44-1.21.1] - 2025-05-21

已新增

• 回溯更新后的 AbstractTagAppender

已修复

• 修复在包含其他命名空间标签时标签生成失败的问题

[v21.1.43-1.21.1] - 2025-05-21

已新增

• 新增 TransformingForwardingList
• 向 ShapesHelper 新增若干辅助方法
• 向 AbstractRecipeProvider 新增若干辅助方法

[v21.1.42-1.21.1] - 2025-05-20

已新增

• 新增来自 Minecraft 26.1 的自定义 LayerDefinition

已更改

• 回溯内部开发工具

已修复

• 修复自定义 PartDefinition 引发 ClassCastException 的问题

[v21.1.41-1.21.1] - 2025-05-19

已新增

• 新增 DataAttachmentType::remove
• 回溯 EntityDamageImmunityCallback
• 回溯 StopSleepInBedCallback
• 回溯 ServerEntityEvents，并弃用 ServerEntityLevelEvents
• 回溯 ConfigHolder::registerConfigurationScreen
• 回溯 ContainerMenuHelper::openMenu
• 回溯带额外上下文参数的 TickingBlockEntity::clientTick 与 TickingBlockEntity::serverTick 方法

已更改

• 将内部 ConfigurationScreen 替换为自定义版本，该版本还支持本地化等其他功能
• 回溯数据附件同步机制
• 回溯更新后的 ComponentHelper 与 StyleCombiningCharSink

已移除

• 移除 ConfigTranslationsManager；本地化现由配置界面直接处理

已修复

• 修复 EventResultHolder 不接受 null 值的问题
• 修复某些情况下配置列表不允许为空的问题

[v21.1.40-1.21.1] - 2025-12-09

已更改

• 大幅回溯 Puzzles Lib 针对 Minecraft 1.21.10 的众多特性

[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 中支持内置资源包（built-in packs）

[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

已更改

• 为事件调用器（event invokers）中的类型转换添加大量安全检查

[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

已修复

• 修复 NeoForge 下 CommonAbstractions::hasChannel 对无效玩家引发崩溃的问题

[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 更宽容地处理所提供的客户端世界（client level）

[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 供应器（supplier）

已修复

• 修复 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 传递给提示框定位器工厂（tooltip positioner factory）

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

已修复

• 修复 Fabric 下 LivingDropsCallback 无法捕获玩家掉落物的问题
• 修复 Fabric 下部分按键绑定无法正常触发的问题

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

已更改

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

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

已新增

• 新增数据附件（data attachment）API

已更改

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

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

已更改

• 支持能力（capability）的编解码器（codec）
• 简化 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 进行小幅更新
• 在开发环境中隐藏部分烦人的提示消息（toast）

已移除

• 移除 BlockEntityHelper

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

• 移植至 Minecraft 1.21.1