一、功能核心概述
GOM传奇引擎的“悬浮按钮”“自定义按钮”功能，可在游戏界面添加个性化操作入口，提升玩家交互体验。悬浮按钮支持固定位置悬浮显示，常见用于快捷回收、随身商店、自动挂机等高频功能；自定义按钮可按需设置图标、名称及触发动作，适配活动入口、专属福利、功能跳转等场景。两者均通过引擎配置文件及脚本实现功能绑定，操作流程清晰，适配多数传奇版本。
功能适用场景：悬浮按钮适合放置全局通用功能，支持玩家随时调用；自定义按钮可根据版本更新灵活增减，比如节日活动期间添加活动入口，活动结束后隐藏。配置时需注意按钮位置避免遮挡核心游戏界面，功能绑定需确保脚本路径正确，避免触发异常。
二、悬浮按钮配置完整流程
1. 基础配置文件修改
打开GOM引擎服务端目录，进入Mir200\Envir\UiConfig文件夹，找到“FloatingButton.ini”文件（若不存在则新建该文件），用文本编辑器打开。文件首行添加“Enable=1”，表示启用悬浮按钮功能；添加“PosX=100”“PosY=200”，分别设置按钮横向、纵向坐标（单位为像素，可根据游戏分辨率调整）；添加“IconPath=Data\Ui\Floating\btn1.png”，指定按钮图标路径（图标建议尺寸为64*64像素，支持PNG格式）。
核心参数设置：添加“ShowType=1”，设置按钮显示方式（1为始终显示，2为隐藏后鼠标悬浮显示，3为按快捷键显示）；添加“ClickKey=112”，设置快捷触发键（112对应F1键，可参考键盘ASCII码表修改）；添加“Tooltip=快捷回收”，设置鼠标悬浮时显示的提示文字，提升玩家认知度。
2. 功能脚本绑定操作
悬浮按钮触发动作需通过脚本绑定实现。打开服务端Mir200\Envir\QuestDiary\ActionScript文件夹，新建脚本文件（命名格式为“FloatingBtn_功能名称.txt”，如“FloatingBtn_Recycle.txt”）。在脚本中编写功能逻辑，以快捷回收为例，添加“#ACT”指令，后续紧跟回收相关操作代码，比如“TakeItem 元宝 10”“GiveItem 金刚石 1”（具体代码需结合版本核心脚本规则）。
脚本关联配置：返回“FloatingButton.ini”文件，添加“ScriptPath=QuestDiary\ActionScript\FloatingBtn_Recycle.txt”，指定绑定的脚本路径；添加“ScriptParam=0”，设置脚本传入参数（无参数时填0）。保存文件后，重启GOM引擎服务端，使配置生效。
3. 显示效果测试调整
启动游戏客户端，登录测试账号，查看悬浮按钮是否正常显示。若位置不当，修改“FloatingButton.ini”中的PosX、PosY参数；若图标不显示，检查图标路径是否正确，确保客户端Data\Ui\Floating目录下存在对应图标文件；点击按钮测试功能是否触发，若未生效，核对脚本路径及脚本代码语法，排查是否存在指令错误。
三、自定义按钮配置操作步骤
1. 按钮创建基础设置
进入GOM引擎配置器（桌面快捷方式启动），切换至“UI设置”选项卡，找到“自定义按钮配置”模块，点击“添加按钮”。在弹出的配置窗口中，设置按钮名称（如“节日福利”），选择按钮图标（支持本地图片导入，建议尺寸与悬浮按钮一致），设置按钮显示位置（可选择固定区域或自定义坐标）。
显示规则设置：勾选“启用按钮”选项，设置显示条件（1为所有玩家可见，2为指定等级以上可见，3为指定职业可见）；若选择指定条件，需在下方填写对应参数，比如等级条件填“50”，职业条件填“1”（1为战士，2为法师，3为道士）。设置完成后，点击“保存配置”。
2. 功能触发方式绑定
自定义按钮支持两种触发方式：脚本触发和命令触发。脚本触发与悬浮按钮一致，在“自定义按钮配置”窗口中，选择“脚本触发”，填写脚本路径及参数；命令触发需填写游戏内命令，比如“@SendToActivity 1”（该命令需在服务端命令脚本中提前定义对应功能）。
多状态设置：支持为按钮添加多状态显示，比如“未激活”“已激活”“冷却中”，分别上传对应状态图标，设置状态切换条件（如完成指定任务后切换为已激活状态）。状态切换逻辑需在服务端脚本中添加判断代码，通过修改按钮状态参数实现。
3. 批量管理与版本适配
若需添加多个自定义按钮，重复上述创建步骤，注意避免按钮位置重叠。支持对已创建按钮进行编辑、删除、排序操作，通过拖拽调整按钮在界面中的显示顺序。不同分辨率客户端适配需设置多套坐标参数，在“自定义按钮配置”中选择“分辨率适配”，添加不同分辨率下的PosX、PosY参数，确保按钮在各分辨率下正常显示。
四、常见问题处理方法
1. 按钮不显示问题排查
核心排查方向：检查配置文件或引擎配置器中“启用按钮”选项是否勾选；确认图标路径或导入的图标文件格式正确（仅支持PNG、BMP格式）；服务端未重启导致配置未生效，重启Mir200.exe、LoginSrv.exe等核心程序；客户端缓存导致显示异常，删除客户端Data目录下的Cache文件夹后重新登录。
2. 功能触发失效解决
脚本触发失效：检查脚本路径是否填写正确，路径分隔符需使用“\”而非“/”；脚本中存在语法错误，比如指令拼写错误、参数缺失，可通过引擎日志文件（Mir200\Log文件夹下）查看报错信息；脚本权限不足，确保脚本文件处于ActionScript目录下，且文件名称符合命名规则。
命令触发失效：确认填写的游戏命令在服务端“Command.ini”文件中已定义；命令参数填写错误，核对命令所需参数数量及格式；玩家权限不足，部分命令仅支持管理员使用，需在脚本中添加权限判断代码。
3. 界面遮挡与分辨率适配
按钮位置遮挡：调整PosX、PosY参数，将按钮移至界面边缘（如右侧、底部），避开角色信息、技能栏、地图等核心区域；设置按钮隐藏规则，比如战斗状态下自动隐藏，非战斗状态显示，通过脚本添加“战斗状态判断”逻辑实现。
分辨率适配问题：针对不同分辨率客户端，创建多套按钮配置方案，在“UI设置”中启用“自动适配分辨率”功能；将按钮坐标设置为相对比例（如横向占比20%、纵向占比30%），而非固定像素值，提升适配性。
五、功能拓展与进阶用法
1. 多按钮组合与交互逻辑
支持悬浮按钮与自定义按钮组合使用，比如点击悬浮按钮展开多个自定义子按钮，形成功能菜单。配置时需在悬浮按钮脚本中添加“显示子按钮”指令，在自定义按钮中设置“父按钮ID”，绑定至对应悬浮按钮；添加子按钮显示/隐藏动画效果，通过修改UI配置文件中的“动画参数”实现（如淡入淡出、滑动显示）。
2. 数据统计与功能优化
在按钮脚本中添加数据统计代码，记录按钮点击次数、触发频率，通过引擎日志输出数据，用于分析玩家功能使用习惯；根据统计结果调整按钮位置及功能优先级，将高频功能按钮放置在更显眼位置；优化按钮响应速度，减少脚本中冗余代码，避免触发时出现卡顿。
3. 版本更新与配置迁移
版本更新时，需备份“FloatingButton.ini”文件及自定义按钮配置文件（UiConfig文件夹下），避免配置丢失；迁移至新服务端时，将备份文件复制至对应目录，修改脚本路径、图标路径等关联信息，确保与新服务端目录结构一致；若引擎版本升级，检查配置参数是否兼容，部分旧版本参数可能需替换为新版本支持的参数格式。
