更新日志

版本

1.17

变更内容

API

• 对整个模组进行了全面清理，使其符合现代模组开发规范
• 新增 SmartBrainBuilder 类，并将各类“大脑”构建方法迁移至其中。SmartBrainOwner 默认继承该类；如今将其独立出来后，您可更轻松地在外部类中实现自定义AI逻辑
• 新增 BehaviourUtil 工具类，用于辅助处理与 BehaviorControl 相关的方法
• 新增 ExtendedBehaviour#tryExpire 方法，支持在切换 Activities 时优雅地终止行为
• 新增 ExtendedSensor#onlyScanIf 方法，允许传感器仅在满足指定条件时执行扫描
• 用户不再需要手动更新“大脑”状态，SBL 会自动为您完成（除非您在实体类中重写了 customServerAIStep）
• 用户不再需要在实体类中返回 SmartBrainProvider 或 SmartBrain 实例，SBL 将自动为您创建
• 依照业界新标准，全面采用 Jspecify 的空值性注解。更多信息请参阅 [此处][https://jspecify.dev]
• 将 SBLLoader 重命名为 SBLPlatform
• 将 SBLConstants#LOADER 重命名为 SBLConstants#PLATFORM
• 移除 EntityRetrievalUtil#streamEntities —— 其带来的收益不足以弥补所引发的混淆
• 移除 EntityRetrievalUtil#findEntities —— 该方法原本仅提供“最大实体数量”的短路机制，而此功能现已整合进其他方法中
• 移除 BrainUtil#forEachBehaviour
• 将 GroupBehaviour#getBehaviours 的返回类型由 Iterator 改为 Iterable
• 新增 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
• 将 SBL 所有与“大脑”相关类中的泛型参数 T 统一重命名为 BO，以提升类型含义的一致性与可读性
• 在各类行为与传感器中，向上提升所有链式调用方法的多态重载，确保其均返回自身实例
• 统一规范 SBL 所有与“大脑”相关类中泛型类型的顺序

内部改进

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