更新日志

本文件将记录本项目的所有重要变更。

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

[v21.1.60-mc1.21.1] - 2026-09-07

新增

• 回移 ColorCollection
• 回移 VariantUtils
• 回移 ProjectileHelper
• 回移 EntityHelper::dropFromGiftLootTable 和 EntityHelper::dropFromShearingLootTable

[v21.1.59-mc1.21.1] - 2026-09-06

新增

• 回移 ServerResourcesLoadCallback 和 ClientTagsUpdatedCallback

[v21.1.58-mc1.21.1] - 2026-09-05

新增

• 回移 BlockStateResolverContext
• 回移 AbstractMenuSelectionList

[v21.1.57-mc1.21.1] - 2026-09-02

新增

• 回移更新后的 RangedSliderButton

[v21.1.56-mc1.21.1] - 2026-08-31

新增

• 回移现代 ParticleProvider
• 回移 TrimPatternBuilder
• 回移 RegistryManager::registerCreativeModeTab

变更

• 延迟握手负载的设置，以避免在 NeoForge 上过早注册 IModBusEvents
• 在 SpawnerDataBuilder 中设置生成成本

[v21.1.55-mc1.21.1] - 2026-08-13

新增

• 回移现代原版输入类（最重要的是 InputWithModifiers）
• 回移现代 SimpleJsonResourceReloadListener
• 回移现代 DataProvider 方法
• 回移 AbstractWidgetsContainerScreen
• 回移更新后的 ScreenOpeningCallback
• 回移更新后的 GuiGraphicsHelper

变更

• 更新 EventResult#value 类型

[v21.1.54-mc1.21.1] - 2026-07-02

变更

• 改为提供访问转换器（access transformer）而非类修改器文件，以便在 Fabric 上向后兼容

[v21.1.53-mc1.21.1] - 2026-07-01

变更

• 使用 Multiloader Convention Plugins v1.1

[v21.1.52-mc1.21.1] - 2026-06-15

修复

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

[v21.1.51-mc1.21.1] - 2026-05-30

变更

• 使注册表同步对 Fabric 上的原版客户端更加宽松

修复

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

[v21.1.50-mc1.21.1] - 2026-05-28

变更

• 在 Fabric 上支持注册没有 axis 属性的可剥皮方块

[v21.1.49-mc1.21.1] - 2026-05-27

修复

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

[v21.1.48-mc1.21.1] - 2026-05-27

新增

• 回移来自 Minecraft 1.21.11 的 ChunkSectionLayer
• 回移 AbstractRecipeProvider 和 AbstractTagProvider 中缺失的 BlockSetFamily 相关方法

[v21.1.47-mc1.21.1] - 2026-05-26

新增

• 回移 BlockSetFamily
• 回移 BlockSetVariant
• 回移 ClientBlockSetFamily

修复

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

[v21.1.46-mc1.21.1] - 2026-05-23

修复

• 修复 LayerDefinition::create 中错误的 MeshDefinition 参数

[v21.1.45-mc1.21.1] - 2026-05-23

新增

• 回移来自 Minecraft 26.1 的 ModelAndTexture
• 回移来自 Minecraft 26.1 的 ClientAsset
• 回移来自 Minecraft 26.1 的 LateBoundIdMapper
• 回移来自 Minecraft 26.1 的 SpecialModelRenderer
• 回移来自 Minecraft 26.1 的 CodecExtras 中的一些编解码器

修复

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

[v21.1.44-mc1.21.1] - 2026-05-21

新增

• 回移更新后的 AbstractTagAppender

修复

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

[v21.1.43-mc1.21.1] - 2026-05-21

新增

• 添加 TransformingForwardingList
• 为 ShapesHelper 添加一些辅助方法
• 为 AbstractRecipeProvider 添加一些辅助方法

[v21.1.42-mc1.21.1] - 2026-05-20

新增

• 添加来自 Minecraft 26.1 的自定义 LayerDefinition

变更

• 回移内部开发工具

修复

• 修复自定义 PartDefinition 的 ClassCastException

[v21.1.41-mc1.21.1] - 2026-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-mc1.21.1] - 2025-12-09

变更

• 从适用于 Minecraft 1.21.10 的 Puzzles Lib 大规模回移众多特性

[v21.1.39-mc1.21.1] - 2025-10-23

变更

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩宽器

[v21.1.38-mc1.21.1] - 2025-08-11

新增

• 添加 PackRepositorySourcesContext::registerBuiltInPack
• 在 DataProviderHelper 中支持内置数据包

[v21.1.37-mc1.21.1] - 2025-08-05

修复

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

[v21.1.36-mc1.21.1] - 2025-05-04

变更

• 允许 DataProviderHelper 支持 RegistrySetBuilder

[v21.1.35-mc1.21.1] - 2025-05-04

移除

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

[v21.1.34-mc1.21.1] - 2025-04-25

变更

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

[v21.1.33-mc1.21.1] - 2025-03-16

修复

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

[v21.1.32-mc1.21.1] - 2025-03-14

变更

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

[v21.1.31-mc1.21.1] - 2025-03-13

新增

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

[v21.1.30-mc1.21.1] - 2025-03-11

修复

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

[v21.1.29-mc1.21.1] - 2025-03-09

修复

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

[v21.1.28-mc1.21.1] - 2025-02-25

新增

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

变更

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

[v21.1.27-mc1.21.1] - 2025-01-17

修复

• 修复网络数据包在 Fabric 上以一个游戏刻延迟执行的问题

[v21.1.26-mc1.21.1] - 2025-01-16

变更

• 允许为 TooltipBuilder 设置空行以阻止提示框绘制

修复

• 修复在控件使用过 TooltipBuilder 后，无法使用原版方法设置新的控件提示框的问题

[v21.1.25-mc1.21.1] - 2025-01-10

修复

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

[v21.1.24-mc1.21.1] - 2024-12-22

变更

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

[v21.1.23-mc1.21.1] - 2024-10-24

变更

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

[v21.1.22-mc1.21.1] - 2024-10-22

新增

• 添加 ChangeEntitySizeCallback
• 添加 RegistryManager::registerAttribute

变更

• 为 LivingEntityRenderLayersContext 扩充一些额外的方法

[v21.1.21-mc1.21.1] - 2024-10-10

变更

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

[v21.1.20-mc1.21.1] - 2024-10-10

新增

• 添加 CommonAbstractions::getPartEntityParent

修复

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

[v21.1.19-mc1.21.1] - 2024-10-05

变更

• 用 ClientParticleHelper 替换 ClientParticleTypes

[v21.1.18-mc1.21.1] - 2024-10-04

变更

• 为 GuiGraphicsHelper 添加更多辅助方法

修复

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

[v21.1.17-mc1.21.1] - 2024-10-01

新增

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

变更

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

[v21.1.16-mc1.21.1] - 2024-09-30

变更

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

[v21.1.15-mc1.21.1] - 2024-09-30

变更

• 对 RenderGuiEvents 进行细微调整

修复

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

[v21.1.14-mc1.21.1] - 2024-09-29

新增

• 添加 RenderGuiEvents，替换 RenderGuiCallback

[v21.1.13-mc1.21.1] - 2024-09-29

变更

• 全面改进 Fabric 上 RenderGuiLayerEvents 的实现

[v21.1.12-mc1.21.1] - 2024-09-29

新增

• 添加 NeoForgeCapabilityHelper::registerItemContainer
• 添加 GuiGraphicsHelper::blitTiledSprite
• 为 ClientAbstractions 添加大量用于处理 Gui#leftHeight 和 Gui#rightHeight 的辅助方法

变更

• 对 ConfigTranslationsManager 进行小幅改进

移除

• 移除 ModLoaderEnvironment::getObjectShareAccess

[v21.1.11-mc1.21.1] - 2024-09-25

新增

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

变更

• 在 Fabric 上允许通过依赖覆盖启用与 Minecraft 1.21 的兼容性
• 允许 RegistryManager::registerBlockItem 接受 Item$Properties 供应器

修复

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

[v21.1.10-mc1.21.1] - 2024-09-20

变更

• 允许 ItemModelDisplayOverrides 同时接受 ResourceLocation 和 ModelResourceLocation

[v21.1.9-mc1.21.1] - 2024-09-18

新增

• 添加 TooltipBuilder::setTooltipLineProcessor

[v21.1.8-mc1.21.1] - 2024-09-18

变更

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

[v21.1.7-mc1.21.1] - 2024-09-17

修复

• 修复 `LivingDropsCal

... [内容过长已截断]