更新日志

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

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

[v21.5.13-1.21.5] - 2025-10-23

变更

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

修复

• 修复在 NeoForge 上加入世界时，当某个模组尝试移除已有生物生成时出现的 java.lang.UnsupportedOperationException 异常

[v21.5.12-1.21.5] - 2025-05-29

修复

• 对 NeoForge 上渲染图层注册过晚的问题，临时修复 ClientLifecycleEvents$Started 触发时机过晚的问题

[v21.5.11-1.21.5] - 2025-05-29

新增

• 添加 ItemTooltipRegistryV3

变更

• 更新自定义配置界面以更好地处理启动时的配置
• 更新 RegistryManager::registerEntityDataSerializer 以使用新的 Fabric API 钩子
• 重构 CreativeModeTabHelper，包括支持绘画变体
• 更新 PlayerNetworkEvents 以使用 Fabric API 中 ServerPlayerEvents 的新事件
• 更新 AnvilEvents 以兼容 NeoForge 21.5.73+

[v21.5.10-1.21.5] - 2025-05-01

新增

• 添加 MenuProviderWithData

[v21.5.9-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext::setEventPhase

[v21.5.8-1.21.5] - 2025-04-23

新增

• 添加 GuiLayersContext
• 添加 SpawnerDataBuilder
• 添加 ItemTooltipRegistryV2
• 添加 ContainerMenuHelper::openMenu

变更

• 允许配置在启动阶段即可访问
• 使自定义注册表可选，以便在客户端与服务器间模组存在性不一致时更宽松地处理（Fabric）

修复

• 仅在允许命令时触发 CommandOverrides
• 修复事件阶段转换器未正确遵循所有父级事件阶段顺序的问题

[v21.5.7-1.21.5] - 2025-04-14

变更

• 重构向客户端发送额外数据的菜单类型实现

[v21.5.6-1.21.5] - 2025-04-14

新增

• 添加 SimpleContainerImpl
• 添加 RenderPipelinesContext
• 为 HSV 添加若干重载方法

修复

• 修复 RenderPipelines 在 NeoForge 上注册失败的问题

[v21.5.5-1.21.5] - 2025-04-10

新增

• 添加 ClientCommonHelper
• 添加 GuiHeightHelper::getMaxHeight 与 GuiHeightHelper::getMinHeight

修复

• 修复 Fabric 上 PlayLevelSoundEvents 出现 ClassCastException 的问题

[v21.5.4-1.21.5] - 2025-04-03

新增

• 添加 HSV 工具类
• 为 RegistryManager::registerSpawnEggItem 添加一个额外重载

修复

• 修复实体属性在 NeoForge 上注册失败的问题

[v21.5.3-1.21.5] - 2025-04-02

新增

• 添加 ItemTooltipRegistry
• 添加 EntityHelper::isPiglinCurrency
• 添加 AbstractLanguageProvider::mustHaveTranslationKey
• 为 ClientComponentSplitter 添加若干方法

变更

• 略微重构 AbstractAtlasProvider
• 标记 ComponentHelper 中部分方法为废弃（deprecated）

[v21.5.2-1.21.5] - 2025-04-02

新增

• 恢复 ModelLoadingHelper::missingModel
• 添加若干缺失的访问扩展器（access wideners）

移除

• 移除 BlockStateResolverContext$ResourceLoaderContext，因当前 API 已无法支持

修复

• 修复由于错误的 Mixin 导致在 Fabric 上启动崩溃的问题
• 临时修复因模组加载器缺陷导致 ClientLifecycleEvents$Started 在 NeoForge 上未触发的问题

[v21.5.1-1.21.5] - 2025-04-01

变更

• 彻底重构内部开发结构

修复

• 修复因 Minecraft 实例为 null 导致在 NeoForge 上客户端启动崩溃的问题

[v21.5.0-1.21.5] - 2025-03-31

• 移植至 Minecraft 1.21.5

新增

• 添加 RegisterConfigurationTasksCallback
• 添加 ContentRegistrationHelper 用于注册新的头颅方块类型
• 添加 QuadUtils
• 添加 CodecExtras::LIST_TAG_CODEC、CodecExtras::setOf 和 CodecExtras::decodeOnly

变更

• 完全重构网络系统，用 ModConstructor::onRegisterPayloadTypes 替代 NetworkHandler，并增加对配置阶段消息的支持
• 解耦 PlayerSet，使其不再仅限于发送数据包
• 将 CommonAbstractions 拆分为多个类，如 EntityHelper、EnchantingHelper 和 ExplosionEventHelper
• 将 ClientAbstractions 拆分为多个类，如 GuiHeightHelper、ClientWoodTypeRegistry 和 RenderTypeHelper
• 合并 EntityAttributesCreateContext 与 EntityAttributesModifyContext 为 EntityAttributesContext
• 重构 ClientStartedCallback 为 ClientLifecycleEvents
• 支持在 SkullRenderersContext 中直接注册纹理位置

移除

• 移除 SpecialBlockModelTypesContext
• 移除 JsonConfigFileUtil 与 JsonSerializationUtil
• 移除 BlockInteractionsContext、CompostableBlocksContext、FlammableBlocksContext 与 FuelValuesContext
• 移除 ReflectionHelper
• 移除 RegisterFuelValuesCallback
• 移除 RegistryHelper
• 移除 MessageV2
• 移除 ClientModConstructor::onRegisterAdditionalModels
• 移除 ClientModConstructor::onRegisterCoreShaders
• 移除 SetupMobGoalsCallback