# 更新日志 #### 版本 2.0.0 ## 变更内容 ### API \* 对整个模组进行了全面清理，使其符合现代模组开发规范 \* 新增 `SmartBrainBuilder` 类，并将各类“大脑”构建方法迁移至该类中。`SmartBrainOwner` 默认继承该类；而将其独立提取后，你也可轻松使用外部类来实现自定义 AI，仅需极少额外工作 \* 新增 `BehaviourUtil` —— 一个专用于 `BehaviorControl` 相关方法的工具类 \* 新增 `ExtendedBehaviour#tryExpire` 方法，支持在切换 `Activities` 时优雅地终止行为 \* 新增 `ExtendedSensor#onlyScanIf` 方法，为传感器提供可选条件：仅当条件满足时才执行扫描 \* 用户不再需要手动更新大脑逻辑，SBL 会自动为你完成（除非你在生物类中重写了 `customServerAIStep`） \* 用户不再需要在实体类中返回 `SmartBrainProvider` 或 `SmartBrain` 实例，SBL 将自动为你创建 \* 全面采用 Jspecify 的空值性注解（Nullability annotations），遵循行业新标准。更多信息请参见［此处］［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 文档 \* 通用代码清理与优化 \* 对模板代码实现预折叠（pre-collapsed）处理，进一步提升代码可读性