更新日志

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

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

[v20.4.53-1.20.4] - 2025-10-23

更改

• 为 CreativeModeInventoryScreen$SlotWrapper 添加访问扩展器（access widener）

[v20.4.52-1.20.4] - 2024-06-16

修复

• 尝试修复 Forge 的重映射问题

[v20.4.51-1.20.4] - 2024-06-11

修复

• 再次修复 RangedSliderButton::getValue

[v20.4.50-1.20.4] - 2024-06-11

修复

• 修复 RangedSliderButton::getValue

[v20.4.49-1.20.4] - 2024-06-11

新增

• 添加 RangedSliderButton

[v20.4.48-1.20.4] - 2024-06-07

新增

• 添加 ComponentHelper::toString

[v20.4.47-1.20.4] - 2024-06-07

新增

• 添加 ComputeFieldOfViewCallback

更改

• 为 GatherDebugTextEvents 添加额外参数，并调整 Fabric 上的注入点

[v20.4.46-1.20.4] - 2024-06-03

更改

• 在 Forge 和 NeoForge 上注册时立即加载客户端和通用配置，为 1.20.6 版本中 NeoForge 的启动配置做准备，并与 Fabric 保持一致

修复

• 修复 MutableSoundType 中的重载方法
• 通过内部引入自定义事件，修复 Fabric 上 PlayerTrackingEvents#START 触发过早的问题

[v20.4.45-1.20.4] - 2024-06-01

新增

• 添加 HolderBackedSoundType 和 MutableSoundType

修复

• 修复 Fabric 上创造性模式玩家无法触发 PlayerInteractEvents$AttackBlock 事件的问题

[v20.4.44-1.20.4] - 2024-05-26

修复

• 尝试改进资源重载期间缺失子级重载监听器的处理

[v20.4.43-1.20.4] - 2024-05-09

修复

• 修复在 NeoForge 上以及安装 ModernFix 模组的 Forge 环境中，GatherPotentialSpawnsCallback 导致崩溃的问题

[v20.4.42-1.20.4] - 2024-03-24

新增

• 添加 LookingAtEndermanCallback

更改

• 调整 PlayerInteractEvents 的实现，允许返回 InteractionResult#PASS 而不被忽略
• 使 LoadCompleteCallback 在 Forge 和 NeoForge 上按顺序运行

修复

• 修复 Forge 上 EntityDataSerializer 注册问题，避免接收服务器数据时出现 ID 不匹配

[v20.4.41-1.20.4] - 2024-03-19

新增

• 添加 RenderTooltipCallback，替代 ScreenTooltipEvents$Render

修复

• 修复 Fabric 上 LivingDeathCallback 对玩家不触发的问题

[v20.4.40-1.20.4] - 2024-03-18

修复

• 修复 Forge 和 NeoForge 上模组列表无法处理 mods.toml 中定义多个模组的 JAR 文件的问题

[v20.4.39-1.20.4] - 2024-03-14

更改

• 向远程端同步时调用 CapabilityComponent::setChanged

[v20.4.38-1.20.4] - 2024-03-12

新增

• 添加 ContainerEvents

[v20.4.37-1.20.4] - 2024-03-12

新增

• 添加 CapabilityComponent::initialize

[v20.4.36-1.20.4] - 2024-03-02

更改

• 扩展并简化 AbstractTagAppender 的实现

[v20.4.35-1.20.4] - 2024-03-01

新增

• 添加新版 AbstractTagProvider
• 添加自定义 AbstractTagAppender

[v20.4.34-1.20.4] - 2024-02-29

更改

• 在 Fabric 专用服务器上将 LoadCompleteCallback 提前执行

[v20.4.33-1.20.4] - 2024-02-28

更改

• 更新部分 DynamicPackResources 内部实现

[v20.4.32-1.20.4] - 2024-02-27

新增

• 添加 ModLoaderEnvironment::getCurrentMappingsNamespace

更改

• 允许在 PackResourcesHelper 中设置默认资源包位置

[v20.4.31-1.20.4] - 2024-02-24

修复

• 修复 Forge 上玩家死亡时能力提供无效持有者（holder）的问题

[v20.4.30-1.20.4] - 2024-02-23

修复

• 修复 Fabric 上 RegisterCommandsCallback 未运行的问题

[v20.4.29-1.20.4] - 2024-02-23

修复

• 修复 RenderHandEvents#OFF_HAND 触发了错误的手部事件类型

[v20.4.28-1.20.4] - 2024-02-23

新增

• 添加 RegistryManager::registerArgumentType
• 添加 RenderHandEvents，替代 RenderHandCallback

修复

• 修复客户端尝试同步已更改的能力值的问题

[v20.4.27-1.20.4] - 2024-02-22

新增

• 添加 KeyActivationHandler
• 添加 KeyMappingHelper::registerKeyMapping
• 添加 PlayerSet

[v20.4.26-1.20.4] - 2024-02-19

更改

• 弃用 ScreenHelper，推荐使用访问扩展器（Access Wideners）和 ScreenHelperV2

[v20.4.25-1.20.4] - 2024-02-19

修复

• 修复矿车类型注册表映射越界问题

[v20.4.24-1.20.4] - 2024-02-18

新增

• 添加 MinecartTypeRegistry
• 添加 ContainerMenuHelper
• 添加 NeoForgeCapabilityHelperV2#registerEntityContainer

[v20.4.23-1.20.4] - 2024-02-15

修复

• 修复因错误导入导致专用服务器崩溃的问题

[v20.4.22-1.20.4] - 2024-02-14

新增

• 添加 GenericExplosionHelper
• 添加 AbstractLootProviderV2
• 为 AbstractSoundDefinitionProvider 添加更多辅助方法
• 添加 AbstractLanguageProvider::addSpawnEgg

更改

• 在 AbstractModelProvider 中验证物品模型

修复

• 修复 AbstractBuiltInDataProvider 未使用文件助手注册生成资源的问题
• 修复 ItemDisplayOverrides 在 Forge 和 NeoForge 上崩溃的问题

[v20.4.21-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 在 Fabric 和 Forge 上实际未注册序列化器的问题

[v20.4.20-1.20.4] - 2024-02-10

修复

• 修复 RegistryManager::registerEntityDataSerializer 的类型参数问题

[v20.4.19-1.20.4] - 2024-02-09

新增

• 添加 RegistryManager::registerEntityDataSerializer

[v20.4.18-1.20.4] - 2024-02-04

新增

• 添加 GuiGraphicsHelper
• 添加 DynamicallyCopiedPackResources

更改

• 允许 SpritelessImageButton 支持绘制原版按钮背景
• Forge 上能力不再需要设置 CapabilityToken

修复

• 修复 Fabric 上 ContainerScreenEvents$Background 触发过晚的问题（Forge 和 NeoForge 仍存在问题，等待对应加载器修复）

[v20.4.17-1.20.4] - 2024-02-03

修复

• 修复 Forge 上 ClientModConstructor::onRegisterRenderBuffers 触发过晚的问题

[v20.4.16-1.20.4] - 2024-02-03

新增

• 添加 Proxy::splitTooltipLines

[v20.4.15-1.20.4] - 2024-02-01

修复

• 修复使用农夫乐事（Farmer's Delight）的镰刀破坏作物时崩溃的问题

[v20.4.14-1.20.4] - 2024-01-30

更改

• 更新至最新模组加载器版本

修复

• 修复 NeoForge 上的启动崩溃
• 修复 Forge 上鼠标拖拽事件未触发的问题

[v20.4.13-1.20.4] - 2024-01-29

新增

• 添加 AbstractAdvancementProvider

修复

• 修复复制标签配方有时使用了错误的序列化器

[v20.4.12-1.20.4] - 2024-01-29

修复

• 修复 AbstractLootProvider$EntityTypes

[v20.4.11-1.20.4] - 2024-01-28

修复

• 再次修复数据生成问题

[v20.4.10-1.20.4] - 2024-01-28

新增

• 添加 NeoForgeCapabilityHelperV2
• 添加 ModLoaderEnvironment::isDataGeneration

修复

• 修复开发环境工具破坏数据生成的问题

[v20.4.9-1.20.4] - 2024-01-27

新增

• 为开发环境添加 EditBox 改进功能

修复

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

[v20.4.8-1.20.4] - 2024-01-26

新增

• 添加 ClientModConstructor::onRegisterRenderBuffers
• 添加更多开发环境小工具

更改

• 在 Fabric 上基于 Fabric API 的 attachment API 重构能力系统，替代 Cardinal Components 库
• 使用 Fabric API 的新原生事件实现 LivingConversionCallback
• 使用 NeoForge 的新原生事件实现 MenuScreensContext

[v20.4.7-1.20.4] - 2024-01-24

更改

• 恢复之前回退的降低视网膜分辨率设置

修复

• 修复 Forge 和 NeoForge 上 ScreenMouseEvents$BeforeMouseDrag 和 ScreenMouseEvents$AfterMouseDrag 未触发的问题

[v20.4.6-1.20.4] - 2024-01-23

更改

• 对 ScreenTooltipFactory 进行更多调整
• 回退降低视网膜分辨率的设置

[v20.4.5-1.20.4] - 2024-01-23

新增

• 添加 NeoForgeCapabilityHelper
• 添加 CommandOverrides

更改

• 对 ScreenTooltipFactory 进行一些调整
• 为开发环境设置默认选项并运行默认命令
• 在 Mac 开发环境中降低视网膜分辨率（仅 Fabric）

[v20.4.4-1.20.4] - 2024-01-21

新增

• 添加 GameRuleValueOverrides

更改

• 将公共模块中的所有访问器 Mixin 迁移为访问扩展器（access wideners）
• 为开发环境设置一些默认游戏规则值
• 在 Forge 上通过提供临时默认实例处理失效的能力
• 允许数据生成运行配置正常退出

[v20.4.3-1.20.4] - 2024-01-20

新增

• 添加 SpritelessImageButton
• 添加 NbtSerializable
• 添加 RegistryHelper::getBuiltInRegistryHolder

[v20.4.2-1.20.4] - 2024-01-20

新增

• 添加 MenuScreensContext 用于注册菜单界面工厂

更改

• 允许 EnumProvider 接受自定义命名空间

[v20.4.1-1.20.4] - 2024-01-19

新增

• 添加 KeyedValueProvider，用于在 ConfigDataSet 中序列化非注册表来源的值

更改

• 回退 RegistryManager 返回 Holder 而非 Holder.Reference 的变更
• 将 init.v2 迁移到 init.v3
• 更新部分 Javadoc
• 将部分数据提供者的私有方法改为公开

修复

• 修复因 NeoForge 补丁增加构造函数参数导致无法实例化 AbstractRecipeProvider 的问题

移除

• 移除 Proxy::getKeyMappingComponent

[v20.4.0-1.20.4] - 2024-01-17

• 移植至 Minecraft 1.20.4
• 移植至 NeoForge
• 支持 Mixin Extras

更改

• 彻底重构能力 API 至 v3，v2 已移除
• 将 RegistryManagerV3 重命名为 RegistryManager，现使用 Holder 替代 Holder.Reference
• 重构事件实现机制，并延迟事件加载以避免被归咎于类加载错误
• 数据生成功能现已 exclusively 移至 NeoForge
• 对 NetworkHandlerV2 中 Message 注册进行小幅优化

移除

• 移除 RegistryManagerV2
• 移除捆绑的 PuzzlesAccessApi，改用 Loom 的访问扩展器（access wideners）