传奇BUFF图标设置教程 客户端倒计时脚本参数详解

传奇游戏客户端BUFF图标可视化展示、倒计时触发脚本是版本制作、功能优化的常用核心脚本功能，主要用于实现屏幕右上角BUFF图标展示、倒计时进度提示、时间到自动触发脚本、图标隐藏等一系列个性化游戏效果。本文将详细讲解传奇SetClientBuff、CloseClientBuff脚本的完整功能、参数用法…

传奇游戏客户端BUFF图标可视化展示、倒计时触发脚本是版本制作、功能优化的常用核心脚本功能，主要用于实现屏幕右上角BUFF图标展示、倒计时进度提示、时间到自动触发脚本、图标隐藏等一系列个性化游戏效果。本文将详细讲解传奇SetClientBuff、CloseClientBuff脚本的完整功能、参数用法、新增特性及实操案例，方便传奇开发者快速上手配置。

一、传奇BUFF图标核心功能介绍

传奇客户端BUFF图标设置功能，核心作用是在游戏屏幕右上角展示专属BUFF图标，同时在图标下方显示精准倒计时数值。设定的倒计时时长结束后，系统将自动触发对应游戏脚本，并且页面展示的BUFF图标会自动消失，适配各类状态增益、限时buff、限时任务、技能冷却等游戏场景。

该功能支持按钮模式、倒计时模式双重展示形态，可自定义图标坐标、文字备注、播放特效、展示位置等多项参数，满足传奇版本多样化的界面及功能定制需求。

二、SetClientBuff脚本标准格式与参数解析

SetClientBuff是传奇设置客户端BUFF图标与倒计时的核心脚本指令，整体包含六大核心参数，参数之间统一使用竖线「|」分隔，支持自定义特效、位置、时长、备注等配置，完整标准格式如下：

SetClientBuff WIL文件序号 图片序号 倒计时间 文字备注 微调坐标X 微调坐标Y 附加特性

1、基础参数详细说明

WIL文件序号：取值范围为1~100，2023年传奇脚本更新后，将原本20个的序号上限扩展至100个，大幅提升多BUFF同时配置的数量上限，适配多状态叠加的游戏场景。

图片序号：对应游戏素材库中的BUFF图标图片编号，可自定义搭配各类风格的增益、减益状态图标。

倒计时间：单位为秒，参数上限同步升级，从原本65535秒扩展至2100000秒。特殊数值定义：-1为按钮模式、-2为永久时间模式，大于0的数值为正常倒计时时长。

文字备注：BUFF图标配套展示的文字说明，-1按钮模式下也支持自定义文字备注，用于标注BUFF效果、任务提示、技能状态等内容。

微调坐标X、微调坐标Y：用于精准调整BUFF图标在游戏屏幕的展示位置，数值可自由微调，适配不同界面布局。

附加特性：可设置特效参数，无需附加特效时可设置为空；若需占位适配新增参数，可使用「*」代替空值。

2、附加特效参数规则

附加特效共包含7项细分参数，依次为：特效WIL序号|特效开始图片|播放张数|播放速度(毫秒)|播放模式|微调X|微调Y

播放模式分为两种：0为特效绘制模式、1为普通绘制模式，开发者可根据视觉效果需求自主选择。

3、脚本触发机制

倒计时模式下，倒计时结束后会在QF脚本中触发【@CloseClientBuffX】（X对应设置的WIL文件序号）；按钮模式下，玩家点击图标后，会触发QF脚本中对应【@文字备注】的自定义脚本逻辑。

三、2023年脚本新增优化特性

2023年传奇官方对SetClientBuff脚本进行全面升级，扩容参数上限并新增多项实用功能，大幅优化BUFF配置灵活性：

1、序号扩容：WIL文件序号上限由20个扩展至100个，支持游戏内同时配置上百种不同BUFF状态。

2、时长扩容：倒计时时长上限从65535秒升级为2100000秒，支持超长期限时BUFF、限时活动配置。

3、永久模式：新增-2参数，可设置永久生效的BUFF图标，无倒计时限制。

4、时间展示优化：新增倒计时详细剩余时间描述，玩家可精准查看BUFF剩余时长。

5、位置自定义参数：新增参数9，支持三种展示位置切换，0=按小地图位置展示、1=屏幕左侧展示、2=屏幕右侧展示。

6、自动排序参数：新增参数10，可设置倒计时结束后BUFF图标是否自动重新排序，界面展示更规整。

7、空值占位适配：若无需使用附加特效，但需要配置参数9、参数10，可使用「*」作为空值占位符，不影响脚本正常运行。

8、按钮模式升级：-1按钮模式全面支持自定义文字备注，可实现点击图标触发对应功能提示、弹窗、任务跳转等操作。

四、BUFF关闭脚本功能说明

传奇提供专属的BUFF关闭脚本指令，可手动终止正在展示或倒计时的客户端BUFF效果，快速隐藏屏幕BUFF图标。

关闭脚本格式：CloseClientBuff 序号(1~20)

该指令通过输入对应BUFF的WIL文件序号，即可强制关闭对应客户端BUFF展示，常用于手动取消增益状态、结束限时活动提示等场景，操作简单、响应速度快。

五、传奇BUFF脚本实操案例

为方便开发者直接套用，整理两组常用的SetClientBuff脚本实操案例，涵盖永久展示、按钮触发两种主流场景：

案例1：多参数占位+右侧展示+自动排序配置

SetClientBuff 12 1 1561 -1 254/测试说明啊\251/第一个图 0 0 * 2 1

参数解析：序号12、常规图片素材、按钮模式、自定义文字备注、坐标0偏移、无附加特效（*占位）、屏幕右侧展示、倒计时结束自动排序。

案例2：按钮模式自定义触发字段配置

SetClientBuff 12 4 236 -1 触发字段|254/测试说明啊\251/第三个图 4 0

参数解析：序号12、专属图片素材、按钮模式、自定义触发文字备注、微调X坐标4、Y坐标0，点击图标可触发对应自定义脚本。

六、完整可用触发脚本示例

以下为可直接复制使用的完整BUFF展示触发脚本，包含特效配置、倒计时设置，适配绝大多数传奇版本：

[@显示BUFF]

#ACT

SetClientBuff 9 1 275 60 文字备注 0 0 9|840|10|200|0|0|40

该脚本可实现：序号9BUFF、默认图片素材、60秒倒计时、无坐标偏移、配套专属播放特效，倒计时结束自动触发关闭脚本，图标消失。