一、功能核心作用与适用场景
悬浮按钮：默认悬浮于游戏界面边缘（可拖动），支持快速触发高频功能，比如背包打开、技能释放、快捷回城等，不占用固定界面空间，提升操作便捷性。自定义按钮：可添加至主界面固定位置（如界面底部、侧边），支持绑定专属功能，适合实现特色玩法入口、活动参与、角色属性快速查看等个性化需求。两者均需通过引擎UI配置工具和脚本配合实现，无需复杂代码基础。
二、功能配置前置准备
1.核心工具：GOM引擎官方UI编辑工具（如GOM-UIDesigner，引擎安装包自带，路径通常为“引擎根目录\UI工具”）、脚本编辑工具（如Notepad++）、GOM引擎服务端（确保为稳定版本，避免功能兼容问题）、传奇客户端（与引擎版本匹配，用于效果预览）。
2.文件定位：找到引擎UI配置核心文件，路径为“引擎根目录\UI\MainUI.ui”（主界面配置文件，悬浮按钮、自定义按钮均需在此文件中编辑）；脚本文件路径为“引擎根目录\Script\UIButton.script”（用于绑定按钮触发功能），提前备份原文件避免误操作后无法恢复。
三、悬浮按钮基础配置步骤
1.打开UI编辑工具加载配置文件：双击启动GOM-UIDesigner，点击“文件-导入”，选择“MainUI.ui”文件加载主界面布局。在左侧控件列表中找到“悬浮按钮控件”（标识为FloatButton），若界面中无该控件，可点击“添加控件”选择对应类型插入。
2.悬浮按钮基础属性设置：选中悬浮按钮控件，在右侧属性面板进行配置：①外观设置：上传按钮图标（支持PNG格式，建议尺寸为48*48或64*64，避免模糊），设置按钮默认状态、点击状态、悬浮状态的图标（可通过“状态切换”功能分别上传）；②位置设置：默认坐标可设为界面右侧中间（如X=1000，Y=500，具体按客户端分辨率调整），勾选“支持拖动”属性，允许玩家在游戏内自定义位置；③基础属性：设置按钮名称（如“快捷回城”，仅用于配置识别，不显示在游戏内）、显示层级（设为“顶层”，避免被其他界面遮挡）、初始显示状态（勾选“默认显示”，确保进入游戏即可看到）。
3.保存配置并导出：所有基础属性设置完成后，点击“文件-保存”更新MainUI.ui文件，将更新后的文件复制到客户端“UI”文件夹（路径为“客户端根目录\UI”），覆盖原文件。
四、悬浮按钮功能绑定与脚本编写
1.功能绑定核心逻辑：通过脚本定义按钮触发事件，将脚本与悬浮按钮的“点击事件”关联，实现点击按钮执行对应功能。常用功能包括：回城、打开背包、使用道具、释放技能等，以下以“快捷回城”为例讲解脚本编写。
2.脚本编写步骤：打开Notepad++，加载“UIButton.script”文件，在文件末尾添加脚本：FunctionFloatButton_BackCity()--定义悬浮按钮回城函数localRoleID=GetCurrentRoleID()--获取当前角色IDifRoleID~=nilthen--判断角色是否存在CallBackCity(RoleID)--调用引擎回城接口ShowSystemMsg("已触发快捷回城")--显示系统提示endEnd。
3.关联按钮与脚本：重新打开GOM-UIDesigner，选中已配置的悬浮按钮，在右侧属性面板找到“点击事件”选项，输入脚本函数名称“FloatButton_BackCity”，点击“确认关联”。保存配置后，将更新后的脚本文件复制到服务端“Script”文件夹，覆盖原文件。
五、自定义按钮配置与功能实现
1.自定义按钮添加与基础设置：在GOM-UIDesigner中加载MainUI.ui文件，点击“添加控件-自定义按钮”（标识为CustomButton），将按钮拖动至目标位置（如界面底部中间，坐标可精确设置，如X=500，Y=600）。在属性面板配置：①外观设置：上传按钮图标（尺寸建议与界面其他按钮统一，如32*32），设置按钮文字（如“特色活动”，支持调整字体、颜色、大小）；②状态设置：勾选“禁止拖动”（固定位置），设置按钮禁用状态（如未满足活动条件时灰色显示）；③层级设置：与界面其他按钮保持一致，避免遮挡或被遮挡。
2.自定义按钮功能绑定：以“打开特色活动界面”为例，编写脚本：FunctionCustomButton_Activity()localRoleLevel=GetRoleLevel(GetCurrentRoleID())--获取当前角色等级ifRoleLevel>=30then--设置等级限制OpenActivityUI(GetCurrentRoleID())--调用打开活动界面接口elseShowSystemMsg("等级需达到30级可参与活动")--等级不足提示endEnd。将脚本添加至UIButton.script文件，保存后覆盖服务端对应文件。
3.按钮显示条件设置（可选）：若需根据角色状态显示/隐藏自定义按钮，可在属性面板设置“显示条件”，关联脚本函数。示例：勾选“条件显示”，输入函数名称“ShowCustomButton_Activity()”，在脚本中编写函数：FunctionShowCustomButton_Activity()localIsOpen=GetActivityStatus("SpecialActivity")--获取活动开启状态ifIsOpen==1thenreturntrue--活动开启时显示按钮elsereturnfalse--活动关闭时隐藏按钮endEnd。
六、功能测试与效果调试
1.服务端与客户端启动：启动GOM引擎服务端（按顺序启动LoginSrv.exe、DBServer.exe、GameServer.exe），确保无报错；启动客户端，登录游戏账号进入游戏界面。
2.基础功能测试：①悬浮按钮：查看是否正常显示，拖动按钮测试是否可移动，点击按钮测试是否触发对应功能（如回城），检查系统提示是否正常；②自定义按钮：查看位置是否符合预期，未满足显示条件时是否隐藏，点击按钮测试功能是否生效（如等级不足时提示是否准确，等级达标时是否正常打开活动界面）。
3.常见问题排查：①按钮不显示：检查MainUI.ui文件是否已复制到客户端UI文件夹，按钮“初始显示状态”是否勾选，显示条件脚本是否存在语法错误；②点击无反应：检查脚本函数名称与按钮“点击事件”关联名称是否一致，脚本文件是否已覆盖服务端Script文件夹，引擎接口函数是否正确（可参考GOM引擎脚本接口文档）；③按钮图标模糊：更换尺寸匹配的图标，确保图标格式为PNG且分辨率清晰；④悬浮按钮无法拖动：检查按钮“支持拖动”属性是否勾选，客户端版本是否与引擎匹配。
七、进阶用法：多按钮组合与样式优化
1.多悬浮按钮组合：添加多个悬浮按钮，设置不同图标与功能（如回城、打开背包、使用药水），在属性面板设置“组合模式”，支持点击主按钮展开多个子按钮，收起时仅显示主按钮，节省界面空间。配置步骤：选中主悬浮按钮，勾选“组合按钮”，在“子按钮列表”中添加已配置的其他悬浮按钮，设置展开方向（上、下、左、右）。
2.按钮样式优化：通过UI编辑工具设置按钮特效，如点击时添加闪烁效果、悬浮时添加边框高亮、禁用时添加灰度滤镜；上传动态图标（GIF格式），提升按钮视觉效果。注意图标尺寸统一，避免风格混乱。
3.功能权限控制：在脚本中添加权限判断，如特定VIP等级玩家可显示专属自定义按钮（如“VIP特权”按钮），普通玩家隐藏。示例脚本：FunctionShowVIPButton()localVIPLevel=GetRoleVIPLevel(GetCurrentRoleID())ifVIPLevel>=1thenreturntrueelsereturnfalseendEnd。
悬浮按钮：默认悬浮于游戏界面边缘（可拖动），支持快速触发高频功能，比如背包打开、技能释放、快捷回城等，不占用固定界面空间，提升操作便捷性。自定义按钮：可添加至主界面固定位置（如界面底部、侧边），支持绑定专属功能，适合实现特色玩法入口、活动参与、角色属性快速查看等个性化需求。两者均需通过引擎UI配置工具和脚本配合实现，无需复杂代码基础。
二、功能配置前置准备
1.核心工具：GOM引擎官方UI编辑工具（如GOM-UIDesigner，引擎安装包自带，路径通常为“引擎根目录\UI工具”）、脚本编辑工具（如Notepad++）、GOM引擎服务端（确保为稳定版本，避免功能兼容问题）、传奇客户端（与引擎版本匹配，用于效果预览）。
2.文件定位：找到引擎UI配置核心文件，路径为“引擎根目录\UI\MainUI.ui”（主界面配置文件，悬浮按钮、自定义按钮均需在此文件中编辑）；脚本文件路径为“引擎根目录\Script\UIButton.script”（用于绑定按钮触发功能），提前备份原文件避免误操作后无法恢复。
三、悬浮按钮基础配置步骤
1.打开UI编辑工具加载配置文件：双击启动GOM-UIDesigner，点击“文件-导入”，选择“MainUI.ui”文件加载主界面布局。在左侧控件列表中找到“悬浮按钮控件”（标识为FloatButton），若界面中无该控件，可点击“添加控件”选择对应类型插入。
2.悬浮按钮基础属性设置：选中悬浮按钮控件，在右侧属性面板进行配置：①外观设置：上传按钮图标（支持PNG格式，建议尺寸为48*48或64*64，避免模糊），设置按钮默认状态、点击状态、悬浮状态的图标（可通过“状态切换”功能分别上传）；②位置设置：默认坐标可设为界面右侧中间（如X=1000，Y=500，具体按客户端分辨率调整），勾选“支持拖动”属性，允许玩家在游戏内自定义位置；③基础属性：设置按钮名称（如“快捷回城”，仅用于配置识别，不显示在游戏内）、显示层级（设为“顶层”，避免被其他界面遮挡）、初始显示状态（勾选“默认显示”，确保进入游戏即可看到）。
3.保存配置并导出：所有基础属性设置完成后，点击“文件-保存”更新MainUI.ui文件，将更新后的文件复制到客户端“UI”文件夹（路径为“客户端根目录\UI”），覆盖原文件。
四、悬浮按钮功能绑定与脚本编写
1.功能绑定核心逻辑：通过脚本定义按钮触发事件，将脚本与悬浮按钮的“点击事件”关联，实现点击按钮执行对应功能。常用功能包括：回城、打开背包、使用道具、释放技能等，以下以“快捷回城”为例讲解脚本编写。
2.脚本编写步骤：打开Notepad++，加载“UIButton.script”文件，在文件末尾添加脚本：FunctionFloatButton_BackCity()--定义悬浮按钮回城函数localRoleID=GetCurrentRoleID()--获取当前角色IDifRoleID~=nilthen--判断角色是否存在CallBackCity(RoleID)--调用引擎回城接口ShowSystemMsg("已触发快捷回城")--显示系统提示endEnd。
3.关联按钮与脚本：重新打开GOM-UIDesigner，选中已配置的悬浮按钮，在右侧属性面板找到“点击事件”选项，输入脚本函数名称“FloatButton_BackCity”，点击“确认关联”。保存配置后，将更新后的脚本文件复制到服务端“Script”文件夹，覆盖原文件。
五、自定义按钮配置与功能实现
1.自定义按钮添加与基础设置：在GOM-UIDesigner中加载MainUI.ui文件，点击“添加控件-自定义按钮”（标识为CustomButton），将按钮拖动至目标位置（如界面底部中间，坐标可精确设置，如X=500，Y=600）。在属性面板配置：①外观设置：上传按钮图标（尺寸建议与界面其他按钮统一，如32*32），设置按钮文字（如“特色活动”，支持调整字体、颜色、大小）；②状态设置：勾选“禁止拖动”（固定位置），设置按钮禁用状态（如未满足活动条件时灰色显示）；③层级设置：与界面其他按钮保持一致，避免遮挡或被遮挡。
2.自定义按钮功能绑定：以“打开特色活动界面”为例，编写脚本：FunctionCustomButton_Activity()localRoleLevel=GetRoleLevel(GetCurrentRoleID())--获取当前角色等级ifRoleLevel>=30then--设置等级限制OpenActivityUI(GetCurrentRoleID())--调用打开活动界面接口elseShowSystemMsg("等级需达到30级可参与活动")--等级不足提示endEnd。将脚本添加至UIButton.script文件，保存后覆盖服务端对应文件。
3.按钮显示条件设置（可选）：若需根据角色状态显示/隐藏自定义按钮，可在属性面板设置“显示条件”，关联脚本函数。示例：勾选“条件显示”，输入函数名称“ShowCustomButton_Activity()”，在脚本中编写函数：FunctionShowCustomButton_Activity()localIsOpen=GetActivityStatus("SpecialActivity")--获取活动开启状态ifIsOpen==1thenreturntrue--活动开启时显示按钮elsereturnfalse--活动关闭时隐藏按钮endEnd。
六、功能测试与效果调试
1.服务端与客户端启动：启动GOM引擎服务端（按顺序启动LoginSrv.exe、DBServer.exe、GameServer.exe），确保无报错；启动客户端，登录游戏账号进入游戏界面。
2.基础功能测试：①悬浮按钮：查看是否正常显示，拖动按钮测试是否可移动，点击按钮测试是否触发对应功能（如回城），检查系统提示是否正常；②自定义按钮：查看位置是否符合预期，未满足显示条件时是否隐藏，点击按钮测试功能是否生效（如等级不足时提示是否准确，等级达标时是否正常打开活动界面）。
3.常见问题排查：①按钮不显示：检查MainUI.ui文件是否已复制到客户端UI文件夹，按钮“初始显示状态”是否勾选，显示条件脚本是否存在语法错误；②点击无反应：检查脚本函数名称与按钮“点击事件”关联名称是否一致，脚本文件是否已覆盖服务端Script文件夹，引擎接口函数是否正确（可参考GOM引擎脚本接口文档）；③按钮图标模糊：更换尺寸匹配的图标，确保图标格式为PNG且分辨率清晰；④悬浮按钮无法拖动：检查按钮“支持拖动”属性是否勾选，客户端版本是否与引擎匹配。
七、进阶用法：多按钮组合与样式优化
1.多悬浮按钮组合：添加多个悬浮按钮，设置不同图标与功能（如回城、打开背包、使用药水），在属性面板设置“组合模式”，支持点击主按钮展开多个子按钮，收起时仅显示主按钮，节省界面空间。配置步骤：选中主悬浮按钮，勾选“组合按钮”，在“子按钮列表”中添加已配置的其他悬浮按钮，设置展开方向（上、下、左、右）。
2.按钮样式优化：通过UI编辑工具设置按钮特效，如点击时添加闪烁效果、悬浮时添加边框高亮、禁用时添加灰度滤镜；上传动态图标（GIF格式），提升按钮视觉效果。注意图标尺寸统一，避免风格混乱。
3.功能权限控制：在脚本中添加权限判断，如特定VIP等级玩家可显示专属自定义按钮（如“VIP特权”按钮），普通玩家隐藏。示例脚本：FunctionShowVIPButton()localVIPLevel=GetRoleVIPLevel(GetCurrentRoleID())ifVIPLevel>=1thenreturntrueelsereturnfalseendEnd。