更新日志

版本

2.0.0

变更内容

API

• 对整个模组进行了全面清理，使其符合现代模组开发规范
• 新增 SmartBrainBuilder 类，并将各类“脑部构建”方法迁移至该类中。SmartBrainOwner 默认继承它；而将其独立出来后，你可更轻松地在外部类中实现AI逻辑（仅需极少额外工作）
• 新增 BehaviourUtil —— 一个用于处理 BehaviorControl 相关方法的工具类
• 新增 ExtendedBehaviour#tryExpire 方法——允许在切换 Activities 时优雅终止行为
• 新增 ExtendedSensor#onlyScanIf —— 为传感器添加可选条件：仅当条件满足时才执行扫描
• 用户不再需要手动更新“脑部”状态，SBL 会自动为你完成（除非你在自定义生物类中覆写了 customServerAIStep）
• 用户不再需要在实体类中返回 SmartBrainProvider 或 SmartBrain 实例，SBL 将自动创建
• 依据行业新标准，全面采用 Jspecify 的空值性注解。更多信息请参见 [此处][https://jspecify.dev]
• 将 SetRandomFlyingTarget 和 SetRandomHoverTarget 合并为 SetRandomFlyTarget
• 将 ExtendedBehaviour#doStartCheck 重命名为 canStart
• 将 SBLLoader 重命名为 SBLPlatform
• 将 SBLConstants#LOADER 重命名为 SBLConstants#PLATFORM
• 移除 EntityRetrievalUtil#streamEntities —— 其收益远不及由此引发的理解混乱
• 移除 EntityRetrievalUtil#findEntities —— 该方法原本仅提供“最大实体数量”的短路机制，现已内建于其他方法中
• 移除 BrainUtil#forEachBehaviour
• 将 GroupBehaviour#getBehaviours 的返回类型由 Iterator 改为 Iterable
• 新增 GroupBehaviour#add 方法，支持手动向 GroupBehaviour 中添加单个行为
• 新增 BrainBehaviourPredicate#isChildOfBehaviour 辅助方法
• 将 net.tslat.smartbrainlib.object 包重命名为 net.tslat.smartbrainlib.library.object
• 将 BrainBehaviourConsumer、BrainBehaviourPredicate、ToFloatBiFunction 和 TriPredicate 迁移至 net.tslat.smartbrainlib.library.interfaces
• 使 ExtendedTargetingConditions 继承 BiPredicate
• 将 FreePositionTracker 重命名为 ExactPositionTracker
• 将 MemoryTest#hasNoMemories 重命名为 MemoryTest#noMemories
• 将 MemoryTest#builder(int) 重命名为 MemoryTest#sized(int)
• 将 BrainActivityGroup 重命名为 ActivityBuilder
• 将 EntityFilteringSensor 重命名为 NearestVisibleEntityFilteredSensor
• 将 ExtendedBehaviour#runForBetween 重命名为 #runFor
• 将 ExtendedBehaviour#cooldownForBetween 重命名为 #cooldownFor
• 将 SBL 所有与“脑部”相关的类中泛型参数 T 统一重命名为 BO，以确保类型含义清晰且一致
• 在行为与传感器类中，向上提升所有链式调用方法（返回自身）的多态重载
• 统一规范 SBL 所有与“脑部”相关的类中泛型类型的顺序
• 新增 BreezeSpecificSensor
• 更新 ExtendedBehaviour#getMemoryRequirements，改用 Mojang 新增的 MemoryCondition 接口
• 将 SBLShufflingList 重命名为 WeightedShuffleableList
• 移除 SeekRandomNearbyPosition

内部改进

• 大幅完善 EntityRetrievalUtil 中的 JavaDoc 注释
• 依照 Java 25 新标准，将全部 JavaDoc 转换为 Markdown 格式
• 重构模板/示例代码结构
• 为每个包添加 package-info.java 声明，以实现更统一、更清晰的 API 使用体验
• 全面重写整个模组的 JavaDoc 文档
• 常规代码清理与优化
• 为模板代码实现预折叠功能，进一步提升代码可读性