一、NPC不显示问题排查与解决
1.核查NPC配置文件完整性与参数
打开服务端Mir200\Envir文件夹，找到NPC.txt文件（部分版本为NPCConfig.txt），用文本编辑器打开。确认目标NPC的配置行完整，核心参数无缺失或错误：需包含NPC名称、地图ID、坐标（XY）、外观ID、脚本路径等信息。例如正确格式为“新手向导3320320101QuestDiary\NPC\NewbieGuide.txt”。
重点检查项：地图ID是否与实际地图匹配（如比奇城地图ID通常为3），坐标是否超出地图边界（可通过地图编辑器打开对应.map文件核对有效坐标范围）；外观ID是否为有效数值（避免填写0或负数导致NPC不显示）；脚本路径是否正确，确保Envir目录下存在对应脚本文件，路径分隔符需使用“\”。
2.验证NPC脚本绑定与语法
找到NPC配置行中指定的脚本文件（如NewbieGuide.txt），打开后检查脚本语法是否正确。脚本首行需有“#IF”“#ACT”等指令开头，避免空行或无效字符；确认脚本中无缺失的闭合符号（如引号、括号），这类错误会导致引擎无法解析脚本，进而隐藏NPC。
脚本测试方法：将目标NPC脚本替换为简单测试脚本（如“#ACTMESSAGEBOX测试NPC脚本正常”），保存后重启服务端。若NPC仍不显示，说明问题在配置文件而非脚本；若能显示但无弹窗，需逐行排查原脚本语法错误。
3.检查地图文件与NPC关联
打开服务端Map文件夹，找到目标NPC所在地图的.map文件（如3.map对应比奇城），用地图编辑器打开。确认地图文件未损坏，可正常加载；在地图编辑器中查看对应坐标，是否存在障碍物或其他NPC重叠，重叠会导致目标NPC被遮挡。
地图权限设置：检查Envir\MapInfo.txt文件，确认目标地图未被设置为“隐藏NPC”权限。该文件中若存在“MapID=3HideNPC=1”字段，需将“HideNPC=1”改为“HideNPC=0”，保存后重启服务端生效。
4.清理客户端缓存与资源校验
PAK读取成功不代表客户端缓存无异常，删除客户端Data目录下的Cache文件夹（缓存文件会导致旧资源覆盖新配置），重新启动客户端登录测试。若NPC仍不显示，检查客户端PAK文件是否完整，重新解压完整PAK包至客户端Data目录，覆盖原有文件。
二、自定义按钮不显示问题排查与解决
1.检查按钮核心配置文件启用状态
进入服务端Mir200\Envir\UiConfig文件夹，找到FloatingButton.ini（悬浮按钮）、CustomButton.ini（自定义按钮）文件。打开后确认首行“Enable=1”（1为启用，0为禁用），若为0则改为1；找到宠物、回收、世界BOSS等对应按钮的配置段，检查“Show=1”是否启用，“IconPath”是否指向正确的图标路径（如Data\Ui\Btn\Pet.png）。
按钮坐标与层级设置：确认“PosX”“PosY”参数未超出屏幕分辨率范围（如1080P分辨率下，PosX建议不超过1920，PosY不超过1080）；“Layer”字段（显示层级）数值需大于0，避免被其他界面元素遮挡。
2.核查按钮显示条件与权限设置
自定义按钮常设置显示条件，需检查配置文件中“ShowCondition”字段：0为所有玩家可见，1为指定等级可见，2为指定职业可见，3为指定权限可见。若设置为非0，需补充对应参数，如“Level=30”（30级以上可见）、“Job=1”（战士职业可见），避免因条件不符导致普通玩家看不到。
引擎配置器按钮设置：启动GOM引擎配置器，切换至“UI设置-自定义按钮”选项卡，核对宠物、回收等按钮是否勾选“启用”；检查按钮“显示范围”设置，若选择“特定地图可见”，需确保当前所在地图在允许范围内。
3.验证按钮脚本绑定与路径
打开按钮配置文件中指定的脚本路径（如QuestDiary\Button\PetBtn.txt），检查脚本是否存在语法错误，确保“#ACT”“#CALL”等指令正确。例如宠物按钮脚本需包含召唤宠物的核心指令，缺失指令会导致按钮不显示或点击无响应。
脚本路径关联：确认按钮配置文件中“ScriptPath”字段路径正确，无中文路径或拼写错误。例如正确路径为“QuestDiary\Button\RecycleBtn.txt”，避免写成“QuestDiary/Button/RecycleBtn.txt”（路径分隔符错误）或遗漏文件夹层级。
4.引擎版本与按钮配置兼容性检查
不同版本GOM引擎对自定义按钮配置格式要求不同，若使用旧版本引擎加载新版本配置文件，会出现解析失败。确认当前GOM引擎版本与按钮配置文件格式匹配，例如旧版本引擎不支持“ShowCondition=3”（权限条件），需改用“ShowCondition=0”或升级引擎版本。
三、通用排查步骤（适用于两类问题）
1.服务端核心程序重启与日志核查
修改任何配置后，需完全关闭Mir200.exe、LoginSrv.exe等核心程序，重新启动服务端（仅刷新配置无效）。打开服务端Log文件夹下的ErrorLog.txt文件，查看是否有“NPC脚本解析失败”“按钮配置错误”等报错，报错信息会明确指向问题文件与行号。
2.引擎参数与版本适配校验
启动GOM引擎配置器，切换至“基本设置”选项卡，核对“版本号”“客户端类型”与当前版本匹配；切换至“资源设置”选项卡，确认“PAK加载路径”指向客户端Data目录，勾选“自动加载所有PAK文件”。若引擎版本与传奇版本不兼容，会出现资源读取成功但功能无法显示的异常。
3.测试账号与角色状态验证
使用新建测试账号登录，避免原有角色数据异常导致显示问题；切换不同职业、等级的角色测试，排除按钮或NPC按职业/等级显示的条件限制。若新账号能正常显示，说明原有角色数据存在异常，可通过数据库管理工具重置角色数据。
四、常见问题总结与规避要点
1.配置文件常见错误：路径使用中文或错误分隔符、关键参数缺失（如NPC坐标、按钮启用状态）、语法错误（脚本引号未闭合、字段拼写错误），需逐行核对配置文件，避免低级错误。
2.缓存与资源问题：客户端缓存未清理、PAK文件解压不完整，需养成修改配置后清理缓存、校验PAK完整性的习惯。
3.版本适配问题：GOM引擎版本与配置文件格式、传奇版本不匹配，需提前确认引擎版本需求，避免跨版本使用配置文件。
1.核查NPC配置文件完整性与参数
打开服务端Mir200\Envir文件夹，找到NPC.txt文件（部分版本为NPCConfig.txt），用文本编辑器打开。确认目标NPC的配置行完整，核心参数无缺失或错误：需包含NPC名称、地图ID、坐标（XY）、外观ID、脚本路径等信息。例如正确格式为“新手向导3320320101QuestDiary\NPC\NewbieGuide.txt”。
重点检查项：地图ID是否与实际地图匹配（如比奇城地图ID通常为3），坐标是否超出地图边界（可通过地图编辑器打开对应.map文件核对有效坐标范围）；外观ID是否为有效数值（避免填写0或负数导致NPC不显示）；脚本路径是否正确，确保Envir目录下存在对应脚本文件，路径分隔符需使用“\”。
2.验证NPC脚本绑定与语法
找到NPC配置行中指定的脚本文件（如NewbieGuide.txt），打开后检查脚本语法是否正确。脚本首行需有“#IF”“#ACT”等指令开头，避免空行或无效字符；确认脚本中无缺失的闭合符号（如引号、括号），这类错误会导致引擎无法解析脚本，进而隐藏NPC。
脚本测试方法：将目标NPC脚本替换为简单测试脚本（如“#ACTMESSAGEBOX测试NPC脚本正常”），保存后重启服务端。若NPC仍不显示，说明问题在配置文件而非脚本；若能显示但无弹窗，需逐行排查原脚本语法错误。
3.检查地图文件与NPC关联
打开服务端Map文件夹，找到目标NPC所在地图的.map文件（如3.map对应比奇城），用地图编辑器打开。确认地图文件未损坏，可正常加载；在地图编辑器中查看对应坐标，是否存在障碍物或其他NPC重叠，重叠会导致目标NPC被遮挡。
地图权限设置：检查Envir\MapInfo.txt文件，确认目标地图未被设置为“隐藏NPC”权限。该文件中若存在“MapID=3HideNPC=1”字段，需将“HideNPC=1”改为“HideNPC=0”，保存后重启服务端生效。
4.清理客户端缓存与资源校验
PAK读取成功不代表客户端缓存无异常，删除客户端Data目录下的Cache文件夹（缓存文件会导致旧资源覆盖新配置），重新启动客户端登录测试。若NPC仍不显示，检查客户端PAK文件是否完整，重新解压完整PAK包至客户端Data目录，覆盖原有文件。
二、自定义按钮不显示问题排查与解决
1.检查按钮核心配置文件启用状态
进入服务端Mir200\Envir\UiConfig文件夹，找到FloatingButton.ini（悬浮按钮）、CustomButton.ini（自定义按钮）文件。打开后确认首行“Enable=1”（1为启用，0为禁用），若为0则改为1；找到宠物、回收、世界BOSS等对应按钮的配置段，检查“Show=1”是否启用，“IconPath”是否指向正确的图标路径（如Data\Ui\Btn\Pet.png）。
按钮坐标与层级设置：确认“PosX”“PosY”参数未超出屏幕分辨率范围（如1080P分辨率下，PosX建议不超过1920，PosY不超过1080）；“Layer”字段（显示层级）数值需大于0，避免被其他界面元素遮挡。
2.核查按钮显示条件与权限设置
自定义按钮常设置显示条件，需检查配置文件中“ShowCondition”字段：0为所有玩家可见，1为指定等级可见，2为指定职业可见，3为指定权限可见。若设置为非0，需补充对应参数，如“Level=30”（30级以上可见）、“Job=1”（战士职业可见），避免因条件不符导致普通玩家看不到。
引擎配置器按钮设置：启动GOM引擎配置器，切换至“UI设置-自定义按钮”选项卡，核对宠物、回收等按钮是否勾选“启用”；检查按钮“显示范围”设置，若选择“特定地图可见”，需确保当前所在地图在允许范围内。
3.验证按钮脚本绑定与路径
打开按钮配置文件中指定的脚本路径（如QuestDiary\Button\PetBtn.txt），检查脚本是否存在语法错误，确保“#ACT”“#CALL”等指令正确。例如宠物按钮脚本需包含召唤宠物的核心指令，缺失指令会导致按钮不显示或点击无响应。
脚本路径关联：确认按钮配置文件中“ScriptPath”字段路径正确，无中文路径或拼写错误。例如正确路径为“QuestDiary\Button\RecycleBtn.txt”，避免写成“QuestDiary/Button/RecycleBtn.txt”（路径分隔符错误）或遗漏文件夹层级。
4.引擎版本与按钮配置兼容性检查
不同版本GOM引擎对自定义按钮配置格式要求不同，若使用旧版本引擎加载新版本配置文件，会出现解析失败。确认当前GOM引擎版本与按钮配置文件格式匹配，例如旧版本引擎不支持“ShowCondition=3”（权限条件），需改用“ShowCondition=0”或升级引擎版本。
三、通用排查步骤（适用于两类问题）
1.服务端核心程序重启与日志核查
修改任何配置后，需完全关闭Mir200.exe、LoginSrv.exe等核心程序，重新启动服务端（仅刷新配置无效）。打开服务端Log文件夹下的ErrorLog.txt文件，查看是否有“NPC脚本解析失败”“按钮配置错误”等报错，报错信息会明确指向问题文件与行号。
2.引擎参数与版本适配校验
启动GOM引擎配置器，切换至“基本设置”选项卡，核对“版本号”“客户端类型”与当前版本匹配；切换至“资源设置”选项卡，确认“PAK加载路径”指向客户端Data目录，勾选“自动加载所有PAK文件”。若引擎版本与传奇版本不兼容，会出现资源读取成功但功能无法显示的异常。
3.测试账号与角色状态验证
使用新建测试账号登录，避免原有角色数据异常导致显示问题；切换不同职业、等级的角色测试，排除按钮或NPC按职业/等级显示的条件限制。若新账号能正常显示，说明原有角色数据存在异常，可通过数据库管理工具重置角色数据。
四、常见问题总结与规避要点
1.配置文件常见错误：路径使用中文或错误分隔符、关键参数缺失（如NPC坐标、按钮启用状态）、语法错误（脚本引号未闭合、字段拼写错误），需逐行核对配置文件，避免低级错误。
2.缓存与资源问题：客户端缓存未清理、PAK文件解压不完整，需养成修改配置后清理缓存、校验PAK完整性的习惯。
3.版本适配问题：GOM引擎版本与配置文件格式、传奇版本不匹配，需提前确认引擎版本需求，避免跨版本使用配置文件。