更新日志

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

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

[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

变更

• 改用访问转换器而非类修改器文件，以保证在 Fabric 上向后兼容

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

变更

• 使用 Multiloader 约定插件 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

变更

• 重大向后移植：来自 Puzzles Lib for Minecraft 1.21.10 的众多特性

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

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

变更

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

修复

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

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

修复

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

[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

变更

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

[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

修复

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

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

变更

• 全面改进 AbstractRegistriesDatapackGenerator，使生成的注册表值可以在其他数据供应器

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