传奇自定义按钮脚本教程 - ADDBUTTONEX新增删除按钮设置方法
摘要：本篇传奇自定义按钮脚本实操教程，详细讲解ADDBUTTON基础按钮、ADDBUTTONEX特效按钮、DELBUTTON删除按钮三大核心命令的语法格式、全套参数含义、实操案例，手把手教玩家配置按钮图片、动态特效、彩色文字、悬浮备注与多界面挂载功能，同时梳理引擎适配规则、分步操作步骤、高频报错排错方法及…
本文适配996传奇引擎，详细讲解ADDBUTTON、ADDBUTTONEX、DELBUTTON三大自定义按钮脚本命令，手把手教新手完成游戏界面自定义按钮新增、特效配置、删除操作，解决自定义按钮不显示、无特效、无法删除等实操问题。
一、传奇自定义按钮脚本功能概述
传奇自定义按钮是版本定制核心功能，支持玩家在游戏屏幕、装备栏、包裹、技能等各类界面新增专属功能按钮，可绑定自定义脚本触发指令。目前主流分为三种核心命令：基础新增按钮ADDBUTTON、带附加特效进阶新增按钮ADDBUTTONEX、删除自定义按钮DELBUTTON，全方位满足版本美化、功能拓展、界面定制的实操需求，所有命令适配996引擎2015-01-08及以上版本程序。
二、基础命令ADDBUTTON（普通自定义按钮）详解
2.1 命令基础格式
ADDBUTTON 参数1 参数2 参数3 参数4 参数5 参数6 参数7 参数8 参数9 参数10
2.2 完整实操案例
#IF
#ACT
ADDBUTTON 3 1 283 284 285 10 200 1 -1 253/自定义按钮1\254/测试增加按钮
2.3 全参数精细化解析
| 参数序号 | 参数释义 | 实操用法与场景说明 |
|---|---|---|
| 参数1 | WIL补丁序号 | 需在M2引擎中查看编辑，路径为M2-查看-列表信息二-WIL资源，提前上传按钮素材并记录对应序号，素材不匹配会导致按钮空白不显示 |
| 参数2 | 脚本触发序号 | 取值范围1-100，点击按钮后触发QF脚本中[@ButtonClickX]段落（X为当前参数数值），每个按钮需设置独立序号，避免触发冲突 |
| 参数3 | 按钮默认图片序号 | 按钮未进行任何操作时展示的静态图片，对应WIL资源内的图片编号，需与补丁素材一一对应 |
| 参数4 | 鼠标经过图片序号 | 鼠标悬浮在按钮上时切换展示的图片，用于提升界面交互效果，无特殊需求可与默认图片序号一致 |
| 参数5 | 按钮按下图片序号 | 鼠标点击按钮瞬间展示的按压效果图片，完善按钮操作反馈，可根据版本风格自定义替换 |
| 参数6 | 窗口左侧距离 | 按钮距离游戏窗口左侧的像素距离，建议搭配分辨率宽变量计算，适配不同屏幕尺寸，避免按钮偏移错位 |
| 参数7 | 窗口顶边距离 | 按钮距离游戏窗口顶部的像素距离，建议搭配分辨率高变量计算，保证多分辨率下按钮位置统一规整 |
| 参数8 | 按钮移动权限 | 0=按钮固定不可拖动，1=支持玩家鼠标拖动移动，功能按钮建议设置0固定，自定义快捷按钮可设置1可移动 |
| 参数9 | 按钮文字标题 | 自定义按钮显示的文字内容，设置-1时为空白标题，仅展示图片按钮，适合纯图标风格的功能按钮 |
| 参数10 | 悬浮备注信息 | 鼠标悬浮按钮时弹出的提示文字，支持颜色分割符/、换行符\，自定义颜色功能仅2015-01-08后版本程序支持，可制作彩色提示文案 |
三、进阶命令ADDBUTTONEX（带特效自定义按钮）详解
ADDBUTTONEX是ADDBUTTON的升级命令，核心优势是支持按钮附加动态特效，可分别设置默认、悬浮、按压三种状态特效，同时支持指定按钮挂载界面，适配更多版本定制场景，是高版本传奇界面美化常用脚本。
3.1 命令基础格式
ADDBUTTONEX 参数1 参数2 参数3 参数4 参数5 参数6 参数7 参数8 参数9
3.2 完整实操案例
#IF
#ACT
ADDBUTTONEX 1|10|200|1 5 275|-1|276 9 840|10|200|0|0|40 850|10|200|0|0|40 860|10|200|0|0|40 -1|253/自定义按钮1\254/测试增加按钮
3.3 全参数精细化解析
| 参数序号 | 参数组成格式 | 实操用法与场景说明 |
|---|---|---|
| 参数1 | 触发序号|X坐标|Y坐标|是否可移动 | 触发序号1-100，对应QF脚本触发段落；X/Y为按钮像素坐标；0=不可移动、1=可移动，多按钮需错开序号与坐标，避免重叠 |
| 参数2 | 按钮WIL补丁序号 | 同基础命令，需在M2引擎WIL资源列表中提前配置素材序号，是按钮图片正常显示的核心前提 |
| 参数3 | 默认图|悬浮图|按压图 | 依次对应按钮三种状态的图片序号，用竖线分隔，完整实现按钮常规交互视觉效果 |
| 参数4 | 特效WIL补丁序号 | 专属按钮特效素材的补丁序号，无特效需求可搭配默认参数使用，必须对应引擎内上传的特效资源 |
| 参数5 | 起始帧|播放张数|速度|绘制模式|微调X|微调Y | 按钮默认状态特效参数，无特效填*；播放速度单位毫秒，绘制模式0=特效绘制、1=普通绘制，微调参数用于修正特效偏移 |
| 参数6 | 起始帧|播放张数|速度|绘制模式|微调X|微调Y | 鼠标悬浮按钮时的动态特效参数，参数逻辑同默认特效，可单独设置悬浮专属特效，提升交互质感 |
| 参数7 | 起始帧|播放张数|速度|绘制模式|微调X|微调Y | 鼠标按压按钮时的动态特效参数，无按压特效可直接填写*，简化脚本配置 |
| 参数8 | 标题文字|悬浮备注 | 支持颜色分隔、换行排版，标题填-1为空文字，备注可自定义彩色多行提示文案，适配高颜值界面需求 |
| 参数9 | 挂载界面编号 | 0=屏幕、1=装备对话框、9=包裹、17=聊天框等18种专属界面，可精准固定按钮显示位置，不遮挡游戏原生界面 |
四、删除按钮DELBUTTON命令详解
DELBUTTON为自定义按钮专属删除命令，用于清除已添加的界面自定义按钮，引擎最大支持100个自定义按钮，序号仅限1-100，超出范围无法生效。
4.1 命令基础格式
DELBUTTON 参数1 参数2
4.2 完整实操案例
#IF
#ACT
DELBUTTON 1
4.3 参数解析
参数1：按钮序号，必填项，取值范围1-100，需与新增按钮时的触发序号一致，精准定位需要删除的目标按钮。
参数2：删除权限范围，选填项；0或空=仅删除当前玩家自身按钮，1=删除全服所有用户的对应按钮，批量清理全局按钮可设置为1。
五、按钮标题彩色文字排版教程
自定义按钮标题支持多行彩色文字显示，无需额外插件，依靠脚本自带颜色分隔符与换行符即可实现，适配所有新版引擎，实操案例如下：
#IF
#ACT
ADDBUTTON 3 1 283 284 285 10 200 1 这是第一行{文字|250}\{这是第二行|249}\这是第3行 253/自定义按钮1\254/测试增加按钮
核心规则：{文字内容|颜色代码} 为单行彩色格式，\ 为自动换行符，可自由组合多行多色按钮标题，大幅提升界面美观度。
六、多引擎适配说明
1. 通用适配场景：ADDBUTTON、DELBUTTON基础命令兼容大部分主流传奇引擎，低版本引擎仅支持基础图片按钮，无彩色文字、特效功能。
2. 特效功能限制：ADDBUTTONEX特效功能、按钮彩色文字、悬浮彩色备注功能，仅2015-01-08及以上版本程序支持，老旧版本使用会出现特效失效、颜色代码乱码问题。
3. 序号兼容规则：所有引擎自定义按钮最大上限均为100个，序号1-100通用，无引擎差异，超出序号直接报错不生效。
4. 界面挂载差异：部分小众引擎不支持ADDBUTTONEX多界面挂载功能，仅支持屏幕界面（参数9=0），使用前需提前测试适配。
七、分步实操使用教程
新手可直接照搬以下步骤操作，零门槛完成自定义按钮搭建、修改、删除全套操作。
步骤1：素材配置 打开996引擎M2引擎，依次点击查看-列表信息二-WIL资源，上传按钮图片、特效图片素材，记录对应的资源序号，备用。
步骤2：脚本写入 打开版本QF脚本文件，根据需求选择ADDBUTTON/ADDBUTTONEX命令，复制对应案例代码，替换提前记录的素材序号、坐标、触发序号、文字内容等参数。
步骤3：触发配置 根据参数2设置的触发序号，在QF脚本中新建对应触发段落，例如序号为1则添加[@ButtonClick1]，写入按钮点击后需要执行的功能脚本。
步骤4：保存加载 保存所有脚本文件与引擎配置，重启游戏服务端，刷新脚本配置，无需重启客户端即可生效。
步骤5：删除操作 需要移除按钮时，写入DELBUTTON命令，填写对应按钮序号与删除范围，保存脚本后即刻生效。
八、高频报错与排错方案
问题1：添加按钮后完全不显示
成因：WIL资源序号填写错误、素材未上传引擎、坐标超出游戏窗口范围、引擎版本过低。
修复：核对M2引擎WIL资源序号，重新上传素材；调整X/Y坐标至合理范围；2015年前版本升级程序后重试。
问题2：按钮无动态特效
成因：使用老旧版本程序、特效参数填写错误、特效WIL素材缺失、参数填错分隔符。
修复：确认程序版本≥2015-01-08；无特效参数统一填写*；检查特效素材序号与脚本一致，统一使用|作为参数分隔符。
问题3：按钮点击无反应
成因：触发序号重复、QF脚本未新建对应[@ButtonClickX]段落、脚本未保存加载。
修复：修改为1-100未使用的独立序号；补全对应触发脚本段落；重新保存脚本并刷新服务端配置。
问题4：DELBUTTON删除按钮不生效
成因：按钮序号超出1-100范围、序号与新增按钮不匹配、参数权限设置错误。
修复：核对目标按钮序号，严格控制在1-100；删除全服按钮需设置参数2为1，删除个人按钮留空或填0。
九、新手实操避坑注意事项
1. 按钮序号严禁重复，多个自定义按钮需使用1-100范围内独立序号，避免触发冲突、功能错乱。
2. 彩色文字与特效功能仅高版本程序支持，老旧版本不要强行添加颜色代码与特效参数，防止脚本报错。
3. 坐标参数尽量适配游戏分辨率，不要设置过大或过小数值，防止按钮超出窗口、遮挡原生功能按钮。
4. 未使用的特效参数必须填写*，禁止留空，否则会导致脚本编译失败，按钮无法加载。
5. 批量删除全服按钮需谨慎操作，参数2设置为1会清空所有玩家对应按钮，建议测试无误后再正式使用。
十、高频FAQ问答
Q1：最多可以添加多少个自定义按钮？
A：引擎固定上限100个，序号严格限制1-100，无法超额添加，超出序号的脚本直接失效。
Q2：自定义按钮可以固定在包裹、技能栏等界面吗？
A：可以，使用ADDBUTTONEX命令，通过参数9选择对应界面编号，即可精准挂载到指定游戏界面。
Q3：为什么彩色文字显示乱码？
A：大概率是程序版本过低，彩色文字功能仅2015-01-08及以上版本支持，升级程序即可解决乱码问题。
Q4：如何让按钮仅部分玩家可见？
A：可搭配#CHECKGM、#CHECKLEVEL等判断命令，设置权限、等级条件，满足条件的玩家才加载按钮脚本。
Q5：重启服务端后自定义按钮消失怎么办？
A：脚本未保存至正式QF文件，仅临时生效，将脚本写入版本核心QF文件并保存，重启后即可永久生效。
十一、全文总结
本文完整讲解了传奇自定义按钮三大核心脚本ADDBUTTON、ADDBUTTONEX、DELBUTTON的全部实操知识点，涵盖基础普通按钮、带特效进阶按钮的创建、彩色文字设置、多界面挂载、按钮删除功能，同时汇总了引擎适配规则、实操步骤、报错排错方案与新手避坑要点，新手可直接复制脚本修改参数落地使用，快速完成传奇版本自定义界面功能定制。
