传奇自定义按钮脚本ADDBUTTON与DELBUTTON命令使用教程
在传奇版本搭建与脚本开发中，自定义界面按钮是优化游戏操作、丰富游戏功能的核心手段。通过专属脚本命令，开发者可自由添加、删除游戏界面各类自定义按钮，适配主界面、背包、装备栏、大地图等数十个游戏位置，还支持图片展示、文字变色、悬浮提示等个性化效果。本文详细讲解传奇ADDBUTTON、DELBUTTON核…
在传奇版本搭建与脚本开发中，自定义界面按钮是优化游戏操作、丰富游戏功能的核心手段。通过专属脚本命令，开发者可自由添加、删除游戏界面各类自定义按钮，适配主界面、背包、装备栏、大地图等数十个游戏位置，还支持图片展示、文字变色、悬浮提示等个性化效果。本文详细讲解传奇ADDBUTTON、DELBUTTON核心脚本命令的语法、参数细则、实操案例及历年扩展功能，帮助玩家和开发者快速掌握传奇自定义按钮制作技巧。
一、传奇自定义按钮核心功能介绍
传奇脚本内置自定义按钮编辑功能，依托ADDBUTTON新增按钮命令、DELBUTTON删除按钮命令，可实现游戏界面按钮的自定义配置。该功能支持自定义按钮图标、界面位置、移动权限、文字标题、悬浮备注，同时兼容图片渲染、文字颜色自定义、大地图适配等拓展效果，最大支持添加200个自定义游戏按钮，完全满足传奇私服各类界面功能拓展需求。
二、ADDBUTTON新增自定义按钮命令详解
2.1 基础命令格式
命令：ADDBUTTON 参数1 参数2 参数3 参数4 参数5 参数6 参数7 参数8 参数9 参数10
2.2 基础脚本实例
[@main]
<自定义按钮/@main1>
[@main1]
#IF
#ACT
ADDBUTTON 3 1 283 284 285 10 200 1 -1 自定义按钮1\测试增加按钮
2.3 十项参数完整说明
参数1：WIL补丁序号，可在M2引擎-查看-列表信息二-WIL资源界面中编辑设置，为按钮绑定专属补丁资源。
参数2：脚本触发序号，对应QF脚本内[@ButtonClickX]触发事件，X即为该参数数值，点击按钮即可触发对应脚本功能。
参数3：按钮默认图片，设置按钮常规状态下显示的图片资源序号。
参数4：鼠标经过图片，设置鼠标悬浮在按钮上时显示的图片资源序号。
参数5：按钮按下图片，设置鼠标点击按钮瞬间显示的图片资源序号。
参数6：窗口左边距，控制按钮距离游戏窗口左侧的像素距离，建议搭配分辨率宽变量计算，适配不同游戏窗口尺寸。
参数7：窗口顶边距，控制按钮距离游戏窗口顶部的像素距离，建议搭配分辨率高变量计算，保证多分辨率界面适配。
参数8：按钮挂载界面（移动权限），用于指定按钮挂载的游戏界面位置，同时定义按钮移动权限，全部可选位置如下：
0=主界面-不能移动，1=主界面-可以移动，2=人物装备栏，3=人物背包栏，4=英雄装备栏，5=英雄背包栏，6=聊天框左侧龙界面，7=聊天框右侧等级界面，8=商铺界面，9=时装界面，10=英雄时装，11=技能栏，12=英雄技能栏，13=称号栏，14=英雄称号栏，15=状态栏，16=英雄状态栏，17=属性栏，18=英雄属性栏，19=人物出战栏，20=行会界面，21=详细属性位置，22=宠物界面，23=宠物背包，24=人物首饰，25=英雄首饰，26=人物神佑，27=英雄神佑，28=查看他人装备，29=查看他人时装，30=查看他人称号，31=查看他人首饰盒，32=查看他人神佑袋，33=M大地图，34=英雄出战栏，35=查看他人出战栏，36=人物时装首饰，37=英雄时装首饰，38=他人时装首饰，39=人物时装神佑，40=英雄时装神佑，41=他人时装神佑，42=可视化默认仓库，43=可视化无限仓库
参数9：按钮文字标题，支持换行符号实现文字换行，设置为-1时为空标题、不显示文字，同时支持图片渲染、彩色文字拓展功能。
参数10：悬浮框备注信息，鼠标移动至按钮上展示的提示文字，支持自定义文字颜色，格式为「颜色代码#文字内容」。
2.4 彩色文字悬浮提示实例
[@main2]
#IF
#ACT
ADDBUTTON 3 1 283 284 285 10 200 1 -1 251#自定义按钮1\250#测试增加按钮
ADDBUTTON 38 1 73 73 73 520 1 0 251#装备回收 251#在线回收\250#在线回收
三、DELBUTTON删除自定义按钮命令详解
3.1 基础命令格式
命令：DELBUTTON 参数1 参数2
3.2 脚本实操案例
#IF
#ACT
DELBUTTON 1 1
3.3 参数功能说明
参数1：按钮序号，取值范围为1-200，对应已添加的自定义按钮编号；参数2：删除权限控制，0或为空时仅删除当前玩家的自定义按钮，1时删除全服所有用户的对应按钮。
重要限制：传奇版本自定义按钮最大序号为200，仅支持1-200序号的按钮新增与删除，超出序号无法生效。
四、自定义按钮文字颜色自定义教程
传奇脚本支持自定义按钮文字颜色，可自由设置0-255区间颜色数值，通用插入格式：{文字内容|文字颜色0-255}，可实现单行、多行差异化彩色文字效果。
彩色文字组合实例：
AddButton 1 6 135 136 137 10 15 6 这是第一行{文字|250}\{这是第二行|249}\这是第3行 这是一个提示信息
五、2019年ADDBUTTON图片功能扩展说明
2019年3月传奇脚本更新后，ADDBUTTON命令新增图片渲染拓展参数，支持多类型图片素材展示，可实现纯图片、图片+文字组合按钮效果，各类图片调用格式如下：
img:图片序号:文件序号:X:Y
Looks:图片:X:Y
DnItems:图片:X:Y
StateItem:图片:X:Y
NewopUI:图片:X:Y
PlayImg:文件序号:开始图片:播放张数:速度:X:Y:绘制模式(0:普通绘制,1:透明绘制)
图片按钮实操案例：
AddButton 1 6 135 136 137 0 15 6 游戏\活动 这是一个提示信息
补充：传奇任务引导对话框可使用AddDlg、AddDlgEx专属命令制作，适配弹窗类引导功能需求。
六、2023年大地图功能扩展适配教程
2023年2月脚本更新后，自定义按钮支持M大地图界面适配，可自由指定绘制地图、还原当前地图、关闭地图绘制区域，搭配ADDBUTTON和Maptoggle命令实现大地图自定义功能。
地图参数规则：参数数值大于-1时，绘制指定地图；数值为-1时，显示当前所在地图；数值为-2时，关闭大地图绘制区域。
大地图按钮脚本案例：
[@测试1]
#IF
#ACT
AddButton 1 2 135 136 137 0 15 33 测试按钮2 这是一个提示信息
[@测试2]
#IF
#ACT
;Maptoggle 1
;SendMsg 6 切换到沃玛森林
;Maptoggle -1
;SendMsg 6 还原大地图为当前地图
Maptoggle -2
SendMsg 6 关闭大地图绘制区域（黑色一块）
七、总结
传奇自定义按钮脚本是版本定制、功能拓展的核心脚本工具，ADDBUTTON命令可全方位自定义按钮样式、位置、特效、提示内容，DELBUTTON命令可精准清理冗余按钮，搭配文字变色、图片渲染、大地图适配等拓展功能，可实现装备回收、活动入口、地图切换、功能引导等各类自定义界面需求。开发者掌握参数搭配规则和脚本写法，可快速优化传奇游戏界面交互，丰富游戏玩法体验。
