一、服务端启动报错：数据库与端口
1. Borland Database Engine 初始化失败
启动 M2Server 时提示“An error occurred while attempting to initialize the Borland Database Engine”。
- 解决方案：删除 C 盘根目录下的 PDOXUSRS.NET 文件，重启电脑。若无效，打开注册表编辑器（regedit），查找 SHAREDMEMLOCATION 键值，将其修改为 0x5BDE（十六进制），重启生效。
2. 端口被占用导致网关启动失败
LoginGate、RunGate 等网关启动失败，或提示端口已被占用。
- 解决方案：在控制器配置向导中修改默认端口（7000、7100、7200）。使用命令 netstat -aon | findstr "端口号" 查询占用进程，通过任务管理器结束冲突进程。
二、客户端黑屏与显示异常
1. 登录游戏黑屏（UI/地图不显示）
• 原因A：补丁路径错误。登录器未放置在正确的客户端根目录。
- 排查：右键登录器快捷方式“打开文件所在位置”，确认路径是否为你的热血传奇客户端（如 D:\17周年客户端）。若跳转到其他目录，说明登录器配置了错误的搜索条件，需重新配置登录器或移动登录器文件。
- 原因B：必备补丁缺失。NewopUI.pak 文件丢失或版本不匹配。
◦ 解决：从服务端 登录器生成器 文件夹或原版引擎包中复制正确的 NewopUI.pak 到客户端根目录覆盖。
- 原因C：客户端版本过旧。GOM引擎通常需要13周年以上客户端，推荐使用16/17周年完整版。
2. 地图花屏或土城地砖黑色
• 解决方案：将服务端 MirServer\Mir200\Map 下的所有 .map 文件，复制到客户端 Map 文件夹及补丁目录的 Map 文件夹内（如有 Resources\Map 也需覆盖），小退重进。
3. 角色/怪物血条不显示
• 原因：UI配置错误或插件冲突。
◦ 解决：检查 M2Server 目录与登录器配置器目录下的 PlugClient 文件夹是否配套；确认使用的是原版GOM必备补丁，避免混用第三方UI导致资源错位。
三、PAK密码错误与补丁读取
1. 登录器配置器显示“密码错误”
在配置登录器读取 PAK.txt 时，列表中出现红色“密码错误”提示。
- 原因A：路径不匹配。PAK.txt 第一行定义的客户端路径与实际路径不符。
- 解决：用记事本打开 PAK.txt，将开头的路径（如 D:\热血传奇\Resources）修改为你当前客户端的真实绝对路径。
- 原因B：密码错误。版本自带的 PAK.txt 密码被修改。
◦ 解决：使用 WIL编辑器 或 PAK查看器 尝试常用密码（如 gameofmir），验证后修改 PAK.txt 中的对应密码。
2. 微端更新失败（地图装备不显示）
• 排查：确认微端服务器 UpdateServer 目录下的 PAK.txt 路径与密码和登录器配置完全一致；检查 UpdateGate 网关端口是否与列表设置一致，防火墙是否放行。
四、登录器配置与网络连接
1. 登录器列表无法显示（一片空白）
• 原因：列表地址配置错误或网络环境问题。
- 解决：在登录器配置器中，列表地址需填写可直接访问的 .txt 文件URL（如 http://你的域名/list.txt）。单机测试可将列表文件放在本地，地址填 file://D:/list.txt。若使用HTTPS列表，需加载对应的XF插件。
2. 连接服务器失败（输入账号密码无反应）
• 原因A：IP地址未修改。单机架设时，控制器配置向导中的“服务器外网IP地址”应填 127.0.0.1；若开外网让朋友玩，需填写你的公网IP或域名，并确保路由器映射了7000、7100、7200端口。
- 原因B：Key文件不配套。M2Server 目录下的 Key.lic 与登录器配置器使用的Key不匹配。
- 解决：使用配套的Key文件覆盖服务端与登录器配置器目录。
五、脚本报错与插件冲突
1. M2启动时脚本报错
• 原因：QuestDiary 文件夹下的脚本文件语法错误，或变量未定义。
- 解决：打开 M2Server 控制台，查看报错的具体行号，检查对应脚本的语法（如缺少引号、括号不匹配）。
2. 插件加载失败或功能异常
• 原因：Mir200\PlugList.txt 中定义的插件路径错误，或插件DLL文件被杀毒软件误删。
- 解决：关闭杀毒软件，重新解压插件文件到 PlugClient 目录，确保 PlugList.txt 中的路径指向正确的 .dll 文件。
操作建议：架设前务必关闭所有杀毒软件（包括Windows Defender），防止引擎组件被误删。建议使用纯净的Windows Server系统或关闭UAC权限。
