变更日志

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

其格式基于 [Keep a Changelog]。

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

变更

• 将捆绑的Puzzles Access Api模组更新至v20.1.1版本。

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

新增

• 从1.20.4版本回溯移植能力系统v3，这样就不再需要Cardinal Components模组了。

变更

• 将Fabric Loom更新至v1.9版本。
• 更新捆绑的Puzzles Access 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上安装ModernFix模组时，涉及 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，使其与ModernFix的动态资源协同工作。

[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

修复

• 修复在某些情况下，事件类可能过早加载的问题，解决了与例如Stylish Effects一起安装时启动时的崩溃问题。
• 修复所需的Forge版本设置错误的问题（现在需要47.2.0，而不是47.1.0）。
• 修复当存在未满足的模组版本前置要求时，Puzzles Lib在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 中添加一些新的 null 检查。

[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，用于各种原版注册表相关的辅助方法。

变更

• Puzzles Access Api模组现在与Puzzles Lib捆绑在一起。
• 全面检修数据生成类，对其进行移动和重新设计，以便通用项目可在新的 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，用于注册完全客户端端的粒子提供者。

变更

• ContentRegistrationFlags 现在通过实现 BaseModConstructor::getContentRegistrationFlags 来启用。
• 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

新增

• Puzzles Lib现在在启动时将所有已安装模组的列表打印到日志中，以便在未生成或未提供崩溃报告时帮助诊断问题。
• 此功能仅在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-08-19

新增

• 添加一个新的独立 RegistryManager，它返回 Holder.Reference 实例，而不是我们自己的 RegistryReference 实现，以便更符合原版注册系统。

[v8.0.25-1.20.1] - 2023-08-17