GOM引擎传奇架设常见故障排查M2黑屏端口占用修复

GOM引擎架设故障集中在环境、启动、连接、显示、脚本五块，按现象对号入座修，别从头重装。

DBC与数据库连不上
老GOM依赖DBC2000，控制面板开BDE Administrator，新建STANDARD型数据库改名HeroDB（大小写随意但要一致），PATH指向D:\MirServer\Mud2\DB，右键Apply保存。 M2报“Borland Database Engine初始化失败”删C盘根目录PDOXUSRS.NET，注册表搜SHAREDMEMLOCATION改0x5BDE重启。 Win10/11开BDE用兼容模式跑，管理员身份起引擎控制器。

M2启动闪退与卡加载
路径含中文或空格（如D:\传奇\MirServer）直接闪退，必须纯英文无空格。 杀软把M2Server.exe、Key.lic、网关exe隔离了，加白名单恢复。 缺msvcp/msvcr dll装VC++ 2005-2022运行库和.NET 4.5+。 卡“加载地图”是Map目录.map缺失或!Setup.txt里MapFileDir指错；卡“加载物品”是DBServer\DB里Hero.mdb/StdItems.DB损坏，从原包补。 加载脚本报错查Mir200\Envir下Market_Def和NpcDef，缺break、#if嵌套错、多余空格都会卡死。

端口占用与网关连不上
默认7000登录网关、7100角色、7200游戏网关，被酷狗/迅雷/另一个端占用就报“端口已被占用”。CMD跑netstat -ano | findstr 7000查PID，taskkill -f -pid 结束，或在!Setup.txt和LoginGate.ini把7000改7001并同步登录器。 外网要在路由器转发这三端口、云服务器安全组放行；单机把Windows防火墙关了或加LoginGate.exe、GameGate.exe入站允许。 启动顺序错也连不上，按DBServer→LoginSrv→LoginGate→M2Server→GameGate起，M2控制台看“网关已连接”才算通。

登录器不开门与KEY验证失败
单机架设IP全填127.0.0.1，区名带空格会导致验证不匹配。 Key.lic必须Mir200目录和登录器配置器目录是同一套，混用不同来源KEY报“密钥验证失败”“M2验证失败黑屏无确定键”。 列表地址用ANSI编码txt，内容写127.0.0.1:7000，浏览器能直接打开才算生效。 登录器配置器补丁路径选客户端根目录，别选到Data子目录。

进游戏黑屏与补丁错位
纯黑屏先想客户端：GOM要13-17周年纯净客户端，新官方客户端不兼容，重装老客户端。 服务端NewopUI.pak没进客户端Data会界面黑；地图全黑是Map补丁没覆盖或微端没起。 PAK密码错表现装备/地形粉块或透明，登录器配置器里pak.txt密码要和补丁实际密码逐条对上，不对就重配重生成登录器。 微端黑屏查UpdateGate：qqwry.dat拷贝进UpdateGate目录，serverinfo.txt改127.0.0.1，UpdateServer里客户端路径、PAK.txt路径、Resources目录名全部对齐，端口默认8000。 高分辨率拉伸界面按钮歪，登录器配置器取消1024x768强制800x600窗口。

NPC不显示与插件冲突
NPC没头像是NpcDef里外观ID错或坐标踩墙；对话无响应是老引擎喂了新版XML脚本，转回TXT格式。 PlugList.txt里.dll在PlugClient目录找不到就报Code:0，不用那插件就清空该行，换插件（如XF换星盾）必须服务端和登录器两侧PlugList一起改再重启。 引擎控制器必须管理员身份起，否则插件加载失败。

外网动态IP与列表
单机127.0.0.1不勾动态IP；外网在配置向导勾动态IP填公网IP，列表用HTTP明文或HTTPS（HTTPS要XF插件支持），域名解析A记录指服务器IP，开区前telnet ip 7000测通不通。

排查顺序固定：路径纯英文→DBC指向Mud2\DB→端口没占用→Key配套→补丁进客户端Data→微端IP对齐→管理员起M2。哪步前正常就在那步停手，别全套重来。