更新日志

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

格式基于 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 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 上延迟一tick执行的问题

[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

变更

• 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，使生成的注册表值可用于其他数据供应器

[v21.1.5-mc1.21.1] - 2024-09-16

新增

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