传奇引擎自定义按钮SetArrBuff脚本使用教程
本文详解传奇引擎SetArrBuff指令用法，涵盖参数解析、自动排列设置、倒计时按钮示例、点击触发逻辑、显示隐藏指令及QF脚本案例，是传奇版本开发中自定义UI按钮、倒计时功能的实用技术教程。…
在传奇版本定制开发中，自定义UI按钮、技能倒计时、状态图标展示是界面优化的核心需求。本文详细讲解传奇引擎SetArrBuff全套脚本指令，包含参数解析、倒计时配置、点击触发、关闭隐藏命令及QF脚本触发案例，助力开发者快速完成自定义按钮功能搭建。
一、SetArrBuff指令基础说明
SetArrBuff是传奇引擎专属的自定义按钮排列指令，核心特性为不指定屏幕坐标，通过分组编号批量管理UI按钮图标，区别于固定坐标的SetClientBuff指令。该功能无需手动定位按钮位置，启用按钮自动排列规则后，引擎将根据分组自动排版布局。
功能开启路径：引擎--选项-》客户端设置-》按钮自动排列，开启后所有SetArrBuff配置的按钮将生效自动排版逻辑。
二、SetArrBuff完整参数详解
该指令共包含12个可控参数，覆盖按钮素材、倒计时逻辑、闪烁动画、文字坐标、结束素材等全维度配置，参数取值范围及功能说明如下：
;参数1：分组编号，取值1-7，用于批量归类管理同组按钮
;参数2：按钮序号，取值1-200，单分组内唯一标识按钮ID
;参数3：WIL文件序号，指定客户端UI素材文件索引
;参数4：基础图片序号，按钮默认展示的素材图编号
;参数5：倒计时间，赋值-1为静态按钮无倒计时，大于0为倒计时时长（单位：秒）
;参数6：预警闪烁时间，剩余该时长时按钮开始闪烁提醒
;参数7：闪烁图片起始序号，动画素材的起始索引
;参数8：闪烁图片数量，控制闪烁动画的帧数量
;参数9：文字备注，按钮悬浮/内置提示文字
;参数10：倒计时文字X坐标，时间文本横向偏移位置
;参数11：倒计时文字Y坐标，时间文本纵向偏移位置
;参数12：结束素材开关，大于0时参数13配置生效
;参数13：倒计时结束后展示图片序号，倒计时归零后的替换素材
三、倒计时按钮配置实战示例
以下为同分组下多组倒计时按钮标准配置代码，可直接复制导入QF脚本，实现不同时长的按钮倒计时展示，所有按钮自动归入1号分组排版：
SetArrBuff 1 1 1 130 10 3 130 4 测试倒计时功能
SetArrBuff 1 2 1 130 100 10 130 4 测试倒计时功能
SetArrBuff 1 3 1 130 80 10 130 4 测试倒计时功能
SetArrBuff 1 4 1 130 60 10 130 4 测试倒计时功能
SetArrBuff 1 5 1 130 30 10 130 4 测试倒计时功能
示例解析：所有按钮归属1号分组，采用同一WIL素材文件，分别配置10秒、100秒、80秒、60秒、30秒倒计时，剩余10秒时触发闪烁动画。
四、按钮点击触发功能配置
SetArrBuff支持1-200全序号按钮添加点击交互逻辑，无需额外绑定坐标。点击触发通用标识为[@ArrBuffClickX]，X对应按钮序号，静态按钮、倒计时按钮均可绑定该触发逻辑。
核心说明：未配置该触发标识的按钮，无点击交互效果，仅展示视觉效果。
五、关闭与图标显示隐藏指令
传奇引擎提供两条配套管控指令，用于动态控制SetArrBuff按钮状态，用法参考原生SetClientBuff指令逻辑：
5.1 按钮关闭指令
CloseArrBuff：强制关闭指定分组/序号的自定义按钮，终止倒计时及动画效果
5.2 图标显示隐藏指令
ShowArrBuff：动态切换屏幕中SetArrBuff图标显示/隐藏状态，适配buff状态切换、界面折叠等场景
六、QF脚本触发完整案例
在QF脚本中配置点击触发、倒计时结束触发逻辑，实现按钮交互、状态提示功能，以下为可直接复用的标准脚本：
;QF触发-按钮点击触发
[@ArrBuffClick1]
#act
sendmsg 7 自动排列按钮点击1
;QF触发-倒计时结束触发
[@CloseArrBuff1]
#act
sendmsg 7 自动排列倒计时1关闭
[@CloseArrBuff2]
#act
sendmsg 7 自动排列倒计时2关闭
[@CloseArrBuff3]
#act
sendmsg 7 自动排列倒计时3关闭
[@CloseArrBuff4]
#act
sendmsg 7 自动排列倒计时4关闭
[@CloseArrBuff5]
#act
sendmsg 7 自动排列倒计时5关闭
脚本说明：点击1号按钮触发频道提示，5个分组倒计时结束后，分别推送对应的关闭提示信息，可根据需求替换sendmsg指令为属性增减、技能释放等逻辑。
七、开发注意要点
1. 分组编号仅限1-7，按钮序号上限为200，超出范围指令无效；
2. 倒计时参数设为-1时，按钮永久静态，不会触发结束触发脚本；
3. 闪烁动画素材需提前导入客户端WIL文件，避免按钮显示黑屏缺失资源；
4. 自动排列功能必须在引擎客户端设置中开启，否则按钮无法自动排版。
