变更日志

本项目所有值得注意的变更都将记录在此文件中。

格式基于 [Keep a Changelog]。

[v8.1.32-1.20.1] - 2025-04-05

变更

• 为事件调用器中的类型转换添加一系列安全检查

[v8.1.31-1.20.1] - 2025-03-09

修复

• 修复因调用 ContainerMenuHelper::createListBackedContainer 而导致的崩溃

[v8.1.30-1.20.1] - 2025-03-09

新增

• 回传 MenuScreensContext
• 回传 ContainerMenuHelper、ContainerSerializationHelper、ListBackedContainer、QuickMoveRuleSet

[v8.1.29-1.20.1] - 2025-03-09

修复

• 修复使用某些匠魂工具破坏方块时导致的崩溃

[v8.1.28-1.20.1] - 2025-03-08

变更

• 将捆绑的谜题访问API模组更新至v20.1.1

[v8.1.27-1.20.1] - 2025-03-08

新增

• 从1.20.4版本回传能力系统v3，这样就不再需要核心组件模组

变更

• 将Fabric织机更新至v1.9
• 更新捆绑的谜题访问API模组
• 更新大量数据提供者

[v8.1.26-1.20.1] - 2025-03-04

变更

• 包含 Mixin Extras 依赖

[v8.1.25-1.20.1] - 2024-11-15

修复

• 修复因 TooltipRenderHelper::createClientComponents 中索引越界导致的崩溃

[v8.1.24-1.20.1] - 2024-10-04

修复

• 修复 DynamicPackResources 无法生成某些资源的问题

[v8.1.23-1.20.1] - 2024-09-09

修复

• 修复 DynamicPackResources 在动态数据生成失败时提供无效数据包的问题

[v8.1.22-1.20.1] - 2024-08-26

修复

• 修复在Fabric上模型尚未重新加载之前就能计算物品模型显示覆盖的问题

[v8.1.21-1.20.1] - 2024-06-26

修复

• 修复在Fabric上创意模式玩家的 PlayerInteractEvents$AttackBlock 事件不触发的问题

[v8.1.20-1.20.1] - 2024-05-26

修复

• 尝试改进在资源重新加载期间处理缺失子重新加载监听器的方式

[v8.1.19-1.20.1] - 2024-05-09

变更

• 更新模组列表打印以更好地反映子模组关系（从1.20.4回传）

修复

• 修复在Forge上安装现代修复模组时涉及 GatherPotentialSpawnsCallback 的崩溃问题

[v8.1.18-1.20.1] - 2024-03-20

修复

• 修复在Fabric上 LivingDeathCallback 对玩家不起作用的问题

[v8.1.17-1.20.1] - 2024-02-16

修复

• 修复在Forge上物品模型覆盖不生效的问题

[v8.1.16-1.20.1] - 2024-02-01

修复

• 修复使用农夫乐事的镰刀破坏作物时导致的崩溃

[v8.1.15-1.20.1] - 2024-01-28

修复

• 修复 TagsUpdatedCallback 和 ServerLifecycleEvents.Starting 在专用服务器上不起作用的问题

[v8.1.14-1.20.1] - 2024-01-24

变更

• 延迟事件初始化以避免因类加载错误而被指责

修复

• 修复使用自定义伤害来源击杀实体不获得任何经验的问题
• 通过将有问题的代码移至相关模组来修复与赫菲斯托斯的兼容性问题，因此在赫菲斯托斯端妥善解决问题之前，只有该模组不兼容

[v8.1.13-1.20.1] - 2024-01-11

修复

• 修复放置在世界 serverconfig 目录中的服务器配置文件卸载失败并导致某些进程挂起的问题

[v8.1.12-1.20.1] - 2024-01-05

修复

• 修复缺失 ToolTypeHelper::isTrident 方法的问题

[v8.1.11-1.20.1] - 2023-12-03

修复

• 修复匿名网络处理器允许重复ID的问题

[v8.1.10-1.20.1] - 2023-12-03

变更

• 使用字符串上下文作为网络处理器ID，而非数字

[v8.1.9-1.20.1] - 2023-11-19

变更

• 对与能力相关的代码进行小幅清理
• BlockConversionHelper 的错误消息现在包含更多上下文

修复

• 修复 RegistryEntryAddedCallback 未正确同步的问题

[v8.1.8-1.20.1] - 2023-11-07

修复

• 针对安装 Controlify 后打开屏幕导致游戏崩溃的问题实施临时解决办法

[v8.1.7-1.20.1] - 2023-11-07

新增

• 添加 ComponentHelper，用于将各种文本实例转换回 Component
• 添加 LivingEquipmentChangeCallback

变更

• 提高不同模组加载器之间 BlockEvents.Break、LivingAttackCallback 和 PlayerInteractEvents.AttackBlock 的一致性

修复

• 确保 NetworkHandlerV3 的向后兼容性

[v8.1.6-1.20.1] - 2023-10-29

变更

• 将注册方块和流体渲染类型的方法移至 ClientAbstractions

修复

• 修复因 ModelProvider 中的错误Mixin导致Forgified Fabric Api崩溃的问题

[v8.1.5-1.20.1] - 2023-10-29

变更

• 调整 ModelEvents 以使其与现代修复的动态资源协同工作

[v8.1.4-1.20.1] - 2023-10-28

修复

• 修复区块事件的区块类型

[v8.1.3-1.20.1] - 2023-10-28

变更

• 禁用 LivingEvents$Breathe 和 LivingEvents$Drown，以便能将所需的Forge版本降低至47.1.3
• 在 DataProviderHelper 中添加一种支持旧版数据提供者的方法
• 重构 NetworkHandlerV3 的某些部分
• 通过引入锁并捕获可能的异常来更谨慎地触发 RegistryEntryAddedCallback，以避免整个注册过程失败
• 确保在模型事件期间抛出的异常能被捕获，不再导致游戏崩溃

修复

• 修复在Windows上动态数据生成失败的问题

[v8.1.2-1.20.1] - 2023-10-27

修复

• 设置所需的Forge版本，以便仍支持NeoForge

[v8.1.1-1.20.1] - 2023-10-26

修复

• 修复在某些情况下事件类可能加载过早的问题，解决了与例如时尚效果模组一起安装时启动时崩溃的问题
• 修复所需的Forge版本设置错误的问题（现在需要47.2.0，而不是47.1.0）
• 修复当存在未满足的模组版本要求时，谜题库在Forge上导致游戏崩溃的问题，防止Forge屏幕向用户显示相关信息

[v8.1.0-1.20.1] - 2023-10-26

• v8.0.24之后所有版本的公开发布

变更

• 扩展 AbstractModelProvider

[v8.0.41-1.20.1] - 2023-10-24

新增

• 添加获取 RenderType 的常用辅助方法
• 添加通过合并各种与方块相关的实用方法得到的 BlockConversionHelper

[v8.0.40-1.20.1] - 2023-10-23

变更

• 优化Forge上新模型事件的性能

[v8.0.39-1.20.1] - 2023-10-22

新增

• 添加 ModifyUnbakedModel、ModifyBakedModel 和 AdditionalBakedModel，以便基于模组加载器特定实现对模型进行更精细的控制
• 添加设置 BlockItem 方块的辅助方法

变更

• 在 ClientAbstractions 中不再需要提供 Minecraft 实例
• RegistryEntryAddedCallback 现在包含当前注册表
• 弃用旧的模型事件

修复

• 修复 RegistryEntryAddedCallback 在Forge上过早运行的问题，该问题会导致依赖事件期间注册内容的实现出现问题

[v8.0.38-1.20.1] - 2023-10-20

新增

• 添加 GatherDebugTextEvents$Left 和 GatherDebugTextEvents$Right
• 添加 LivingEvents$Breathe 和 LivingEvents$Drown
• 添加 RegistryEntryAddedCallback
• 添加 ServerChunkEvents$Watch 和 ServerChunkEvents$Unwatch

变更

• 当每个世界存在本地服务器配置时，允许覆盖全局服务器配置
• 允许创建不一定需要实现模组加载器特定事件的通用事件

修复

• 修复在Quilt上尝试访问生物群系修改API所需的Fabric内部字段不成功时记录错误的问题
• 修复尝试反序列化由配置项提供的无效 ResourceLocation 时导致的崩溃

[v8.0.37-1.20.1] - 2023-10-04

变更

• 在Forge数据生成期间，不再在数据提供者上设置 ExistingFileHelper
• 在 AbstractLanguageProvider 中添加一些新的空值检查

[v8.0.36-1.20.1] - 2023-10-01

变更

• 回滚对 AbstractModelProvider 的实验性更改

[v8.0.35-1.20.1] - 2023-09-29

新增

• 添加 ForgeDataProviderContext$Factory，以更好地支持Forge上的数据生成

变更

• 对 AbstractModelProvider 进行一些实验性更改，希望能修复Forge模组的运行时问题
• 现在可以通过用 ! 标记来从 ConfigDataSet 中排除条目

[v8.0.34-1.20.1] - 2023-09-28

新增

• 添加 BlockEvents$Break 和 BlockEvents$DropExperience
• 添加 TickingBlockEntity 和 TickingEntityBlock 辅助接口，用于创建无需使用静态计时器方法的计时方块实体
• 添加 AddToastCallback，用于处理客户端的提示信息
• 添加 ScreenEvents$BeforeInitV2 和 ScreenEvents$AfterInitV2，并为屏幕实例使用类型参数
• 添加 CommonAbstractions::createPackInfo
• 添加 ModConstructor::onRegisterBlockInteractions，用于注册诸如可剥皮原木或可耕种泥土块等方块转换
• 添加 GrindstoneEvents$Update 和 GrindstoneEvents$Use
• 添加 TypedTagFactory 和 BoundTagFactory，用于创建新的 TagKey，因此已从新的 RegistryManager 中移除了标签键
• 添加 CombinedIngredients，用于创建更复杂的 Ingredient 实例
• 添加 ShapesHelper，主要用于将 VoxelShape 旋转到给定的 Direction
• 添加 DynamicPackResources，用于在运行时通过数据提供者生成资源
• 添加 RegistryHelper，用于各种原版注册表相关的辅助方法

变更

• 谜题访问API模组现在与谜题库捆绑在一起
• 全面检修数据生成类，对其进行移动和重新设计，以便通用项目能在新的 DynamicPackResources 中使用
• 优化 AbstractModPackResources，以更好地处理模组ID并允许隐藏数据包，这是Forge独有的功能
• 在Forge上提供生物群系修改的模组不再需要包含自己的生物群系修改器，该文件现在会使用内置数据包自动生成
• 全面检修 ItemAttributeModifiersCallback 的内部实现

修复

• 修复与 ItemModelDisplayOverrides 和 EventInvokerRegistry 实现相关的类加载问题
• 修复 AbstractParticleDescriptionProvider 不验证所用纹理是否存在的问题
• 修复在Fabric上当前游戏服务器未正确存储的问题

[v8.0.33-1.20.1] - 2023-09-09

变更

• 重新设计上一版本引入的重新加载监听器处理方式，以解决因未正确完成的重新加载监听器导致模组加载卡住的问题
• 更改对使用相同命名空间的多个网络处理器的内部ID的处理方式

[v8.0.32-1.20.1] - 2023-09-08

新增

• 添加 ClientParticleTypes，用于注册完全客户端端的粒子提供者

变更

• 现在通过实现 BaseModConstructor::getContentRegistrationFlags 来启用 ContentRegistrationFlags
• Fabric现在在即使并非严格要求的情况下也更严格地执行 ContentRegistrationFlags，以提高与Forge的一致性
• 大幅扩展 ParticleProvidersContext，以允许注册更多种类的粒子类型
• 全面检修 ForwardingReloadListener，以支持转发一组 PreparableReloadListener 实例，而不仅仅是单个实例
• 将 FabricReloadListener 重构为更通用的 FabricReloadListenerHelper 类

[v8.0.31-1.20.1] - 2023-09-07

新增

• 在Fabric上为 EntityRenderDispatcher#renderers 添加访问扩展器

[v8.0.30-1.20.1] - 2023-09-05

新增

• 谜题库现在在启动时会将所有已安装模组的列表打印到日志中，以便在未生成或未提供崩溃报告时帮助诊断问题
• 此功能仅在Forge上启用，因为Fabric加载器默认已经这样做了

变更

• 重构一些与模组列表条目相关的模组加载器特定代码

修复

• 修复在Fabric上 LivingDeathCallback 仅在服务器端运行的问题

[v8.0.29-1.20.1] - 2023-09-05

新增

• 添加 RenderLivingEvents

[v8.0.28-1.20.1] - 2023-09-04

变更

• 弃用 DistType，这包括对 NetworkHandlerV2 的一些重构

修复

• 修复在Fabric上客户端交互事件可能在通用交互事件之后运行的问题

[v8.0.27-1.20.1] - 2023-09-02

新增

• 添加一个用于检查服务器端是否安装了某个模组的辅助系统

[v8.0.26-1.20.1] - 2023-0