传奇客户端动态按钮控件设置完整教程

一、教程前言

本文为传奇ESP-B版插件客户端动态控件设置实操教程，主打客户端插件按钮、组合框、自定义控件的动态创建、修改、显示隐藏等功能设置。全程采用通俗化讲解，搭配可直接复制套用的完整脚本案例，帮助传奇GM快速掌握客户端UI控件自定义搭建技巧，轻松实现游戏界面个性化功能拓展。

所有脚本无需适配各类游戏引擎，通用适配ESP-B版插件，操作简单、落地性强，新手也能快速上手搭建专属游戏客户端界面控件。

二、前期基础设置要求

在使用客户端动态控件脚本命令前，必须完成基础设置，否则功能无法正常生效：

1. 所有控件相关命令，需在插件加载阶段调用，提前勾选插件对应功能选项（具体开启方式参考下方配图）；
2. 查看游戏内控件名称需使用GM账号，在游戏界面按住Shift+Ctrl+Alt，鼠标指向任意控件，即可查看对应控件名称，可作为脚本父窗口参数使用。

三、核心命令详解：ESPClientUiChange

ESPClientUiChange是ESP插件客户端动态控件设置的核心命令，主要用于实现传奇游戏客户端组件添加、修改、显示隐藏、启用禁用、组合框创建等操作，包含4种核心运行模式，不同模式对应不同参数配置，下面逐一通俗讲解参数含义与使用规范。

3.1 模式0：添加全新客户端组件

该模式用于在游戏客户端界面，新增窗口、按钮、文本标签等自定义控件，完整参数格式：组件名|类型|父名|默认图|按下图|x|y|是否可移动|是否触发|默认是否显示|标题|鼠标指向提示

参数详细释义：

组件名：自定义唯一名称，不支持汉字，不能为空，用于后续修改、调用控件；

组件类型：0=窗口、1=按钮、2=标签文本；

父名：父窗口名称，添加至游戏主界面直接填写-1；

默认图：控件默认展示图片序号，无需背景图填写-1；

按下图：按钮点击状态图片序号，非按钮控件或无需设置填写-1；

x/y：控件在游戏界面的坐标位置；

是否可移动：0=不可鼠标拖动、1=可自由拖动；

是否触发脚本：0=点击无响应、1=点击触发QF脚本；

默认是否显示：0=创建后默认隐藏、1=创建后默认展示；

标题：控件外显文字标题，无需标题填写-1；

鼠标指向提示：-1=无提示，自定义数值可展示组件名提示。

3.2 模式1：修改已有客户端组件

针对已创建的自定义控件、系统自带控件进行参数修改，可调整控件位置、图片、标题、移动属性等，完整参数格式：组件名|父名|默认图|按下图|x|y|是否可移动|标题

无需修改的参数统一填写-1，避免覆盖原有控件设置，支持修改控件父窗口、界面坐标、显示样式等全部基础属性。

3.3 模式2：控件显示/隐藏控制

专门用于一键控制客户端控件的展示与隐藏，适配小退、重连、场景切换等场景，参数格式：组件名|状态

状态参数：0=隐藏控件、1=显示控件、-1=自动判断（当前显示则隐藏，当前隐藏则显示）。

3.4 模式3：控件启用/禁用控制

用于限制控件点击权限，禁止玩家操作指定界面控件，参数格式：组件名|状态

状态参数：0=禁止使用控件、1=恢复控件可用、-1=自动切换禁用/启用状态。

3.5 模式4：创建自定义下拉组合框

最常用的实用功能，可在游戏界面创建下拉选择框，支持多选项自定义、点击触发对应脚本功能，完整参数格式：组件名|父名|标题|x|y|控件宽度|是否显示边框|是否触发|是否提示|项目内容

参数详细释义：

项目内容支持多选项设置，多个选项使用#号分隔，选项内容可自定义为地图、功能、道具等游戏相关内容；

是否触发：1=开启脚本触发，选择不同选项可调用对应QF脚本，索引从0开始依次排序；

控件宽度建议合理设置，数值过小会导致选项文字显示不全。

四、全套可直接套用实战脚本案例

以下脚本均经过实测可用，直接复制写入对应插件脚本文件即可生效，包含组合框创建、选项触发、小退隐藏控件等全套场景。

4.1 基础组合框创建+多选项触发脚本

[@ESP反挂加载]
#act
;在游戏时装界面创建自定义下拉选择组合框
ESPClientUiChange 4 选择组合框1|DStateTabSheet2|项目选择1|70|50|80|1|1|1|ESP插件#完美测试1#完美测试2

;选择第0个选项触发脚本
[@ESPDIY_选择组合框1_0]
#act
sendmsg 6 0000

;选择第1个选项触发脚本
[@ESPDIY_选择组合框1_1]
#act
sendmsg 6 0001

;选择第2个选项触发脚本
[@ESPDIY_选择组合框1_2]
#act
sendmsg 6 0002

;选择第3个选项触发脚本
[@ESPDIY_选择组合框1_3]
#act
sendmsg 6 0003

4.2 自定义游戏场景选择组合框脚本（进阶案例）

[@ESP反挂加载]
#act
;自定义地图选择下拉组合框
ESPClientUiChange 4 选择组合框|DMsgDlg|项目选择|200|30|80|1|1|1|ESP插件#b.espgom.com#完美测试

;选中第一个选项触发提示
[@ESPDIY_选择组合框_0]
#if
#act
sendmsg 6 你选择了ESP插件

;选中第二个选项触发提示
[@ESPDIY_选择组合框_1]
#if
#act
sendmsg 6 你选择了蹦得儿你个蹦得儿

;选中第三个选项触发提示
[@ESPDIY_选择组合框_2]
#if
#act
sendmsg 6 你选择了完美测试

4.3 人物小退/重连自动隐藏控件脚本（必备）

为避免人物小退、断线重连后界面控件残留错位，需添加以下自动隐藏脚本，替换对应组件名即可使用。

;人物小退自动隐藏自定义控件
[@ESP小退控制]
#if
#act
ESPClientUiChange 2 组件名|0

;选择第0个选项触发脚本
[@ESPDIY_选择组合框1_0]
#act
sendmsg 6 0000
0

五、插件使用必读注意事项

1. 控件名称规范：游戏系统自带组件名称可查阅插件附录文档，自定义组件名称可自由设置，仅限英文、数字，不支持汉字。
2. 控件查找方法：可通过登陆器UI编辑功能搭配显示、隐藏脚本，快速查找游戏内所有可控制的组件名称。
3. 素材资源规范：所有自定义客户端控件使用的图片素材，统一存放路径为【资源目录\data\ESPDIYUI.Pak】，素材格式需适配插件要求。
4. 界面优化设置：所有自定义控件必须搭配小退、重连隐藏脚本，防止人物状态切换后出现界面重叠、控件残留问题。