更新日志

版本

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 声明，使 API 使用更一致、更清晰
• 全面重写了整个模组的 JavaDoc 文档
• 常规代码清理与优化
• 为模板代码实现了预折叠功能，进一步提升代码可读性