更新日志

版本

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