传奇M2引擎添加自动排列按钮教程客户端按钮分组排版脚本

admin3小时前3

本文详解传奇M2引擎自动排列按钮功能，讲解AddArrButton指令语法、九大参数含义，提供背包界面批量按钮配置示例与QF触发脚本，附带按钮删除指令及常见避坑要点，助力传奇版本开发者快速完成客户端界面按钮自动排版配置。…

一、功能概述

传奇M2引擎客户端支持添加自定义自动排列按钮，该功能核心用于游戏内多按钮规整排版，解决自定义按钮坐标错乱、界面布局杂乱问题。自动排列按钮指令与传统ADDBUTTON指令功能相近，核心区别在于支持系统自动计算按钮坐标，无需手动设置点位，适配背包、时装、属性等多游戏界面批量添加功能按钮场景，是传奇版本定制、界面优化的常用核心脚本功能。

二、功能开启入口

按钮自动排列功能原生集成于M2引擎客户端配置中，具体开启路径：引擎---选项-》客户端设置-》按钮自动排列，开启后即可生效后续所有自动排列按钮脚本指令。

三、核心指令语法详解

3.1 添加自动排列按钮指令

指令格式：AddArrButton 参数1 参数2 参数3 参数4 参数5 参数6 参数7 参数8 参数9

该指令用于在指定游戏界面创建可自动排版的自定义按钮，共包含9个必填参数，所有参数按顺序填写，缺一不可。

3.2 九大参数详细说明

参数1：分组编号，取值范围1-7，用于归类同界面的按钮。重点注意：不同界面的按钮禁止划入同一个分组，例如主屏幕按钮与背包按钮同组，会导致坐标计算错误，出现按钮错位、重叠问题。

参数2：脚本触发序号，绑定QF脚本中的触发段，对应QF内[@ArrButtonClickX]，X为此参数数值，点击按钮后即可执行对应QF脚本逻辑。

参数3：WIL补丁序号，需在M2引擎中配置，查询编辑路径：M2-查看-列表信息二-WIL资源，提前导入按钮图片资源后获取对应序号。

参数4：按钮默认图片，按钮未触发、鼠标未悬浮时显示的资源图片ID。

参数5：鼠标经过图片，鼠标悬浮在按钮上时切换显示的资源图片ID。

参数6：按钮按下图片，鼠标点击按钮瞬间切换显示的资源图片ID。

参数7：界面挂载位置，指定按钮显示的游戏界面，对应数值如下：0屏幕上、1装备对话框上、2装备、3时装、4状态、5属性、6称号、7技能、8出战、9包裹、10聊天框左侧界面、11聊天框右侧界面、12商铺界面、13查看对方装备对话框上、14查看对方装备、15查看对方时装、16查看对称号、17聊天框。

参数8：按钮文字标题，按钮表面展示的文字内容，填写-1时为空白标题，适合纯图标无文字的按钮设计。

参数9：悬浮备注信息，鼠标停留在按钮上时，弹出的悬浮提示框文字内容，用于说明按钮功能。