一、悬浮按钮与自定义按钮的核心作用
GOM传奇引擎的“悬浮按钮”“自定义按钮”，是为优化玩家操作体验设计的界面功能组件。悬浮按钮固定显示在游戏界面边缘（可拖动），支持快速触发高频功能；自定义按钮则可由开发者自由设置位置、图标与功能，适配不同版本的玩法需求。
两者核心应用场景包括：快捷打开背包、技能栏、地图界面等基础功能；触发专属活动入口、副本传送、挂机开关等特色功能；引导玩家完成任务、领取奖励等操作。通过合理配置，可减少玩家操作步骤，提升游戏流畅度。
二、悬浮按钮的基础设置步骤
1. 定位悬浮按钮配置文件
进入GOM引擎服务端的Envir文件夹，找到UI配置目录（通常为Envir\UIConfig），其中“FloatingBtn.ini”为悬浮按钮核心配置文件，用文本编辑器（如Notepad++）打开即可进行参数设置。
若文件夹中无该文件，需从GOM引擎完整包中复制对应默认配置文件至该目录，再进行修改。默认配置文件已包含基础悬浮按钮模板，可在此基础上调整参数，无需从零编写。
2. 核心参数配置说明
FloatingBtn.ini文件采用“键值对”格式配置，核心参数如下：是否启用=1（1为启用，0为关闭）；初始位置=X:10,Y:100（X为水平坐标，Y为垂直坐标，按游戏界面像素设置）；按钮大小=50,50（宽50像素，高50像素，可按需调整）；默认图标=Btn_Float.png（悬浮按钮默认显示图标，需放在客户端UI图标目录）； hover图标=Btn_Float_Hover.png（鼠标悬浮时显示的图标）。
额外功能参数：可拖动=1（允许玩家拖动按钮位置）；自动隐藏=0（0为常显，1为鼠标离开后自动隐藏，3秒后恢复显示）；点击音效=Btn_Click.wav（点击按钮时的音效文件，路径需正确）。配置时需确保图标与音效文件格式符合引擎要求，路径无中文。
3. 功能绑定与生效测试
在配置文件末尾添加点击触发功能，格式为“点击事件=命令标识”。常见命令标识：打开背包=OpenBag；打开技能栏=OpenSkill；打开地图=OpenMap；传送至安全区=MoveToSafeZone。示例：点击事件=OpenMap（点击悬浮按钮后打开地图界面）。
配置完成后保存文件，重启服务端与客户端。登录游戏后，检查悬浮按钮是否正常显示，点击后能否触发对应功能，鼠标悬浮时图标是否切换，拖动功能是否生效。若图标不显示，检查图标路径与文件名是否正确；若功能未触发，核对命令标识是否有误。
三、自定义按钮的创建与功能配置
1. 自定义按钮的创建流程
自定义按钮需通过GOM引擎客户端UI编辑器（EngineUIEditor.exe，通常在引擎工具包中）创建。启动编辑器后，点击“新建按钮”，设置按钮名称（如“副本传送”）、大小、初始位置，选择按钮状态图标（默认、悬浮、点击、禁用四种状态，需分别上传对应图标）。
创建完成后，点击“保存按钮配置”，生成“CustomBtn_副本传送.ini”文件，将该文件复制至客户端UIConfig目录。同时，将按钮所用图标文件复制至客户端Data\UIIcon文件夹，确保图标文件名与配置中一致。
2. 功能绑定的两种核心方式
方式一：脚本命令绑定。进入服务端Envir\Market_Def文件夹，打开QFunction-0.txt脚本文件，添加按钮点击触发脚本。示例：“[@CustomBtnClick 副本传送]#IFCheckLevel 30#ACTMapMove 副本地图 100 100SendMsg 6 已传送至副本入口！#ELSESendMsg 6 等级不足30级，无法进入副本！”。其中“[@CustomBtnClick 副本传送]”为按钮点击触发标识，需与自定义按钮名称一致。
方式二：引擎命令直接绑定。在UI编辑器中，选择创建好的自定义按钮，在“点击命令”栏直接输入引擎内置命令，无需编写脚本。常见内置命令：AddGold 100（增加100金币）、GiveItem 元宝 1（赠送1元宝）、OpenActivity 1（打开编号为1的活动界面）。适合绑定简单的基础功能，操作更便捷。
3. 多按钮布局与样式调整
若需添加多个自定义按钮，需为每个按钮单独创建配置文件，命名格式统一为“CustomBtn_按钮名称.ini”，避免文件名重复。在UI编辑器中，可通过“对齐”“分布”功能调整多个按钮的位置，确保界面整洁，不遮挡核心游戏画面。
样式调整要点：按钮大小建议统一（如50*50像素），避免界面杂乱；图标设计需贴合功能含义（如副本传送用“门”形图标，挂机功能用“齿轮”图标）；根据游戏整体风格选择图标颜色，确保与界面背景区分明显，提升辨识度。
四、进阶功能：悬浮/自定义按钮的条件触发设置
通过脚本设置，可实现按钮“条件显示”或“条件触发”，让功能更贴合游戏玩法需求。常见条件包括等级限制、任务进度、道具拥有量等。
示例1：等级限制显示。在悬浮按钮配置文件中添加“显示条件=CheckLevel 20”，仅20级及以上玩家可看到该悬浮按钮；等级不足时按钮自动隐藏。示例2：任务进度触发。自定义按钮“领取奖励”仅在玩家完成指定任务后显示，脚本示例：“[@CustomBtnShow 领取奖励]#IFCheckTask 主线任务 完成#ACTShowBtn 领取奖励#ELSEHideBtn 领取奖励”。
条件触发设置需注意：脚本中条件命令需准确，如“CheckTask”后需填写任务名称与状态；多个条件可叠加，用“&&”连接（如CheckLevel 20 && CheckItem 门票 1，需同时满足等级20级和拥有1张门票）；若按钮需隐藏，需在脚本中添加“HideBtn 按钮名称”命令。
五、常见问题解决办法汇总
问题1：自定义按钮显示空白。解决：检查图标文件是否放在正确目录、文件名与配置一致、图标格式符合要求（建议为PNG或BMP格式）；若使用UI编辑器创建，确认已保存配置并同步至客户端。
问题2：按钮点击无响应。解决：核对脚本中触发标识与按钮名称是否一致；内置命令是否拼写正确；条件触发类按钮需确认是否满足触发条件；服务端是否已重启生效。
问题3：悬浮按钮无法拖动。解决：检查配置文件中“可拖动”参数是否设为1；客户端是否开启界面锁定功能（部分版本支持快捷键解锁）；若为自定义悬浮按钮，确认UI编辑器中已勾选“允许拖动”选项。
问题4：多按钮重叠显示。解决：在UI编辑器中调整各按钮的初始坐标，确保位置不重叠；可按功能分类排列按钮（如基础功能按钮放左侧，特色功能按钮放右侧）；避免按钮大小设置过大导致界面拥挤。
