更新记录

v1.1.0.1 Build 50207 更新内容 2025/2/8

插件

• 🌟 新增 ItemBakedEvent 接口，预留接口供附属或其他插件，实现物品其他附加功能

• 🌟 项目高强度重构，拆分为多模块，为跨平台实现插件提供基础

• 🌟 新增 动作

  • require：用于实现简单卫语句，快速进行条件检测判断和中断

• ⚡️ 优化 创建物品时，对挂起物品的处理方式，提升性能

• ⚡️ 优化 项目为K2编译模式，提升插件开发效率，提升插件产物质量

• ⚡️ 优化 动作流解析机制，原版本不支持yaml语法的动作，现已支持解析动作如下：

• ⚡️ 完善 大量基础性代码，提升插件质量

• ⚡️ 完善 执行 /af action 时，若动作无法解析将会提示用户

• 🐛 修复 由于项目重构后，MC远古版本由于NBT导致插件功能失效的问题

• 🐛 修复 check 动作会丢失分支中空格的问题

• 🐛 修复 check 动作由于动作解析器逻辑错误导致else分支不执行的问题

文档

• 🌟 新增 items 配置项的说明文档，用于启用单文件多物品功能

• 🌟 新增 配置项 display.option.dye（控制染料颜色）相关文档说明

• 🌟 新增 配置项 display.option.attributes（控制原版属性）相关文档说明

• 🌟 新增 YAML 语法拓展和管道符特性介绍文档

• 🌟 新增 指令介绍 相关内容

• 🌟 新增 内置脚本 utils 相关方法的介绍

• 🌟 新增 内置脚本 where 方法的介绍

• 🌟 新增 动作 相关文档（attach, repeat, unsafe, emit, durability, sprint, velocity, give-item, set, async, sync, console, cooldown, remove-potion, require）

• 🌟 新增 触发器 相关文档（onShoot、onHit、onPlaceBy）

• 🌟 新增 拦截器 说明文档

• 🌟 新增 拦截器 相关文档（onDeath、onPlayerDeath、onMythicmobsDeath、onAttack、onPlayerAttack、onMythicmobsAttack、onSneak, onUnSneak、onRun/onSprint、onUnRun/onUnSprint、onInteract及其子触发器）

• 🌟 新增 开发者帮助 接口文档，完成AzureFlowAPI基础说明，如toItem、runAction等

• ⚡️ 完善 set-data 文档，添加支持复杂深度更新说明

• 🔥 移除 快速入门 章节关于插件重载后物品自动生成uuid的误导性引导

1.0.2.4 Build 41216 更新内容 2024/12/16

插件

• 🌟 新增 触发器

  • onRun/onSprint, onUnSprint/onUnRun：用于在玩家手持AF物品开始/结束奔跑时触发

  • onSneak, onUnSneak：用于在玩家手持AF物品开始/结束潜行时触发

• 🌟 新增 拦截器

  • onRun/onSprint, onUnSprint/onUnRun：用于在玩家开始/结束奔跑时触发

  • onSneak, onUnSneak：用于在玩家开始/结束潜行时触发

• 🌟 新增 display.option.dye 配置项，同时支持RGB形式（如255,255,255)和十六进制形式（#FFFFFF）

• 🌟 新增 display.option.attributes 配置项，用于为物品添加MC原版属性

• 🌟 新增 remove-potion 动作，可用于匿名移除某玩家的药水效果

• 🌟 新增 set-data 动作支持复杂表达式直接更新

• ⚡️ 优化 代码总体结构

• ⚡️ 完善 引擎层相关执行代码逻辑

• ⚡️ 完善 Yaml语法增强相关功能

• ⚡️ 完善 开发者Item接口使用的定义与规范

• ⚡️ 完善 在控制台或空手创建物品时，默认使用配置文件config.yml#settings.default-display-type配置项进行填充

• 🐛 修复 低版本兼容性问题

• 🐛 修复 由于前几个版本更新导致update动作数据更新失效的问题

• 🐛 修复 由于更新单文件多物品导致一个物品加载失败所有物品都失效的问题

• 🐛 修复 sound动作参数异常的问题，并兼容非原版MC音效

• 🐛 修复 time模块调用失效的问题

• 🐛 修复 format模块调用失效的问题

1.0.2.4-rc1 更新内容 2024/11/15

插件

• 🌟 新增 动作

  • remove-potion：用于移除施加在玩家上的指定效果(41115 issue#23)

• 🐛 修复 由于低版本无副手特性，造成的触发器预注册报错而引起的插件加载失败问题(41115 issue#27)

1.0.2.4-rc1 更新内容 2024/10/09

插件

• 🌟 新增 单文件多物品功能，可通过使用items声明多个物品(41006)

• 🌟 新增 拦截器：

  • onInteract及其子触发器: 用于拦截玩家交互事件(41009)

• 🌟 新增 内置脚本

  • utils.pause(ms): 用于阻塞当前线程运行，可用于实现延迟效果(41009)

• ⚡️ 优化 set-data 的参数，支持深层数据修改与更新(41006)

• ⚡️ 优化 插件Hook后的提示信息(41006)

• 🐛 修复 使用IRegistry造成的意外的空指针异常(41009)

• 🐛 修复 为了兼容低版本采用老版本Material接口导致高版本材质获取错误的问题(41006)

1.0.2.4-rc1 更新内容 2024/10/06

插件

• 🎯 预备 更新预设 presets，用于处理物品配置预设

• 🌟 新增 功能特性

  • 拦截器(interceptors)：用于全局处理某一服务器事件

  • Yaml语法增强与管道符(yaml enhance and pipeline)：在Yaml声明式物品配置中可使用yaml原生语法形式的列表与字典，同时衍生出管道符用法，具体参见Wiki

• 🌟 新增 拦截器

  • onDeath：实体死亡时拦截

    • onPlayerDeath：玩家死亡时拦截

    • onMythicmobsDeath(MM怪物名称)：MM怪物死亡时拦截

  • onAttack：实体攻击时拦截

    • onPlayerAttack：玩家攻击时拦截

    • onMythicmobsAttack：MM怪物攻击时拦截

• 🌟 新增 内置脚本

  • where: 用于找到指定id/alias物品所在的槽位，返回值为列表

• 🌟 新增 多种动作

  • attach(获取)：用于将当前动作上下文切换为指定槽位物品

• 🌟 新增 指令/af action [actions.../] 可用于以当前手持物品为目标执行动作

• 🌟 新增 物品调试日志功能，可快捷查看物品构建流程与交互触发过程，同时查看benchmark等指标

• ⚡️ 优化 物品构建时出错的报错提示

• ⚡️ 优化 重载插件的信息提示

• ⚡️ 解决 set-data动作强制要求空格的问题

• ⚡️ 完善 插件开发接口

  • AzureFlowAPI.toItem(...)

  • AzureFlowAPI.executeActionFlow(...)

  • AzureFlowAPI.getData(...)

• 🐛 修复 check等复合动作不支持深度嵌套使用的问题，修改了动作脚本解析引擎和机制

• 🐛 修复 由于动作流上下文更新不同步导致无法直接解引用data的问题

• 🐛 修复 sound 动作参数解析错误的问题

• 🐛 修复 give指令指定amount时由于异步问题导致的物品数量不对

• 🐛 修复 低版本durability动作报错的问题

• 🐛 兼容 服务端版本至1.21.1

1.0.2.3-rc3 更新内容 2024/06/20

插件

• 🎯 预备 为新特性(拦截器)的更新做了准备

• 🌟 新增 内置脚本

  • list.choice(n=1, weights)：用于(权重)抽取列表的N个元素，可重复出现

  • list.sample(n=1, weights)：用于(权重)采样列表的N个元素，元素不可重复出现

• 🌟 新增 多种新动作

  • repeat(重复)：用于重复执行某动作

  • unsafe系列: 非安全操作，请前往wiki了解详情

  • emit(发射): 用于创建自定义触发器

  • durability(耐久): 用于设置物品的耐久值，可用于实现自定义耐久度

  • sprint(冲刺): 用于给玩家添加一个当前视角下的动量，可用于实现冲刺效果

  • velocity(动量): 用于给玩家添加一个动量，可用于实现各类弹射效果

  • give(给予): 用于给予玩家AzureFlow物品库的物品

  • set(设置变量): 用于设置当前动作上下文的某变量

  • async(异步): 用于异步执行某动作

  • sync(同步): 用于同步执行某动作

  • console(控制台): 用于以控制台身份执行某命令

  • cooldown(冷却): 用于设置物品的冷却值（注意：与交互的冷却值不同，该冷却仅设置物品展示的冷却效果，例如末影珍珠的使用冷却效果）

• 🌟 新增 多种触发器

  • onShoot: 用于弓箭发射时触发

  • onHit: 用于投掷物命中时触发

  • onPlaceBy(*): 用于某一物品被另一物品放置(替换)时触发，详情参见wiki

• ⚡️ 优化 触发器检测逻辑，减少在物品上进行无效空触发的性能损失

• ⚡️ 优化 物品的预构建流程，同时优化了物品数据存储的NBT结构

• 🐛 修复 批量获取物品时会由于异步问题导致的物品数量不满足预期的问题

• 🐛 修复 获取物品时新物品无法直接堆叠到原有相同物品，即物品堆叠数量的问题

文档

⚡️ 完善 文档速查-动作 章节下的内容，为不同的动作添加了分类 ⚡️ 完善 部分动作的示例配置

1.0.2.3-rc1版本更新内容(2023-03-05)

• 改进 随机模块 weight 方法, 可权重随机复杂数据类型

1.0.2.2-rc1版本更新内容(2023-03-05)

• 新增 随机模块 weight 方法, 用于权重随机

• 新增 when 内置函数, 用于数据分支策略

• 新增 option.unbreakable, 用于设置物品是否不可破坏

• 新增 option.custom_model_data 用于设置自定义材质数据

• 新增 durability 动作, 用于设置物品的耐久

• 新增 onPlace, onBreak 触发器
• 新增 数组自动展开功能

• 修复 computed 计算属性失效的问题

• 新增 math 模块 ceil floor round方法
• 修复 音效配置 错误时的报错, 改善用户体验

• 支持 复杂数据存储, 例如 数组, 对象等

• 完善 表达式引用的底层实现为计算属性

1.0.2.1-rc1版本更新内容(2023-02-04)

• 新增 actionbar和title动作

• 新增 掉落物彩色发光动作与名称配置

• 新增 动作流域中可直接引用data

• 新增 模板物品 QualityWeapon

• 修复 check动作分支判断错误

• 修复 高版本控制台没有颜色的bug

• 修复 重载后触发器与动作报错的问题

• 完善 配置文件解析机制

• 完善 继承多个物品时，动作的追加

1.0.2-rc1-hotfix1版本更新内容(2023-01-31)

• 修复 插件不支持MythicMobs 5.0+的问题

1.0.2-rc1版本更新内容(2023-01-09)

• 新增 函数调用注记符(*)

• 新增 动作data, health, hunger

• 新增 触发器onConsume, onMythicMobsDrop, onInteract, onDrop, onPickUp, onHeld, onUnHeld, onShiftLeftClick, onShiftLeftClickAir, onShiftLeftClickBlock, onShiftRightClick, onShiftRightClickAir, onShiftRightClickBlock, onMainHand, onOffHand, onChangeHand

• 新增 测试性指令af create

• 新增 全局外部脚本文件

• 支持 MythicMobs掉落

• 修复 af reload命令无效的问题

• 文档更新 module列表

1.0.1-rc1版本更新内容(2022-12-23)

• 新增 配置项data、computed

• 新增 动作update、run

• 全局添加bukkit, server, sound, material对象

• 全局添加import，Array#random, Array#shuffle方法

• 添加 配置项：别名alias

• 优化 动作编译与执行系统

• 废弃 define配置项为不推荐选项

• 支持 PAPI变量检测

• 完善 指令系统，修复未知情况下指令自动补全时后台报错问题

• 新增 get和give指令--suppress静默参数