一、引擎选型与版本边界判定
HERO/M2系（HeroM2、BLUE、LEGEND、3K）走DBC2000+HeroDB，老版本脚本兼容好、插件多，适合复古单职业、合击；GOM/GEE系内置数据库环境或走SQLite/MySQL，原生吃PAK/Resources分层补丁、微端机制完整，适合新界面、单文件大补丁、外网分发；GOM与GEE的Pak.txt、ResInfo.txt、登录器配置器格式不互通，版本包别混用，混用直接黑屏或M2报非法资源。云服务器优先选WindowsServer2012R2以上，家庭宽带需确认WAN口是否为真公网IP（ip138查到的IP必须等于路由器WAN口，10.x/100.64.x开头是大内网，必须找运营商换公网或走穿透）。
二、目录规范与DBC/HeroDB绑定
服务端解压到磁盘根目录全英文路径（D:\Mirserver），禁中文、禁空格、禁过长嵌套。HERO系装DBC2000→控制面板BDEAdministrator→Object→New→别名HeroDB（必须大写此拼写）→路径指D:\Mirserver\Mud2\DB→保存。路径错、别名拼错、PDOXUSRS.NET被占用都会让M2启动报DatabaseError。GOM/GEE新版一键端大多已集成库环境，但仍要核对Mir200\Mud2\DB是否存在StdItems.db、Magic.db、Monster.db，缺失则角色/物品/怪物全空。
三、公网IP、动态IP与网关绑定规则
引擎配置向导里：外网IP填公网IP；若是家庭动态IP必须勾“动态IP模式”；网关绑定地址填0.0.0.0（不允许只绑内网，否则外网握手失败）。BLUE/HERO老引擎改!Setup.txt、LoginGate.ini、!ServerInfo.txt、DBServer\!AddrTable.txt，格式：
测试一区192.168.1.100113.x.x.x:7100
!ServerInfo.txt：127.0.0.1192.168.1.100113.x.x.x:7100
漏改AddrTable典型症状：能出登录器、输账号后卡“正在进入游戏”或直接回登录界面。
四、端口矩阵与映射/安全组放行
核心端口清单（必须内外一致）：
•7000LoginGate登录端口
•7100SelGate/角色选择网关
•7200/7201/7202GameGate游戏网关
-8000/8008微端网关与UpdateServer
•443/80列表文件HTTP托管（可选）
路由器→虚拟服务器/端口转发→外部端口=内部端口=上述值，内部IP填服务端内网IP，协议TCP（微端可补UDP）。云服务器还要在控制台安全组加入站规则7000-7300、8000-8010放行0.0.0.0/0，只开系统防火墙不放安全组一样不通。CMD用netstat-ano|findstr:7000查占用，PID杀重复M2/网关进程。
五、启动顺序与进程联动
严格顺序：DBC2000服务→LoginGate→SelGate→GameGate→DBServer→LoginSrv→M2Server→（外网带微端）UpdateServer→MirUpdateGate。M2日志无红色报错、GameGate显示“连接到M2成功”、UpdateGate亮灯才算链路通。先起M2后起网关会触发IP不匹配、角色网关读不到在线列表。
六、微端与Pak.txt路径对齐（外网黑屏头号原因）
UpdateServer基本设置：客户端路径=配套客户端根目录（E:\Legendofmir）；Resources目录名=补丁文件夹名（Resources/Patch），必须和登录器配置器、Pak.txt内写法完全一致。Pak.txt里所有本地路径全文替换成客户端绝对路径（如E:\Legendofmir\Data），拷贝进UpdateServer目录；明文密码填版本PAK密码，密文自动生成，登录器配置器里更新密码必须同值。Resources分层结构：客户端根\Resources\Data\*.pak对应服务端补丁，缺一层就黑屏。微端网关配置：微端地址填UpdateServer所在IP，端口填UpdateServer端口，线路列表必须含“默认”。
七、登录器与列表文件发布
列表文件（123.txt/ServerList.txt）格式：
测试一区113.x.x.x70000
或GEE格式：服务器名113.x.x.x:7000
113.x.x.x:8000
上传到可公网访问的HTTP空间，浏览器直接打开能看到文本；登录器配置器填列表URL，勾纯微端模式时删掉“客户端搜索条件”里的检测目录/文件。生成GameLogin.exe给玩家，玩家本地客户端版本必须与服务端匹配（如1.76配16周年客户端），否则进图花屏。
八、脚本调试与M2报错定位
进游戏后NPC不对话、任务不触发、拾取无反应→看M2控制台红色ScriptError，定位Mir200\Envir\MapQuest_def\或QuestDiary\对应行号：
-“Undefinedvariable”→变量未声明（A..Z/G..前缀用错）
•“Scriptdeadloop”→死循环（#IF后无#ACT/#ELSEACT，或WHILE无限）
-“Cannotfindlabel@xxx”→[@xxx]标签拼错或脚本未重载
•“Itemnotfound”→CheckItem/GiveItem物品名与StdItems.DB不一致
改完脚本点M2→控制→重新加载→重新加载脚本，不必重启全服。MapInfo.txt地图号与Mir200\Map\*.map文件名不一致会导致进图直接掉线回城。
九、外网典型故障速查表
-登录器列表空白：列表URL不通、HTTP头非text/plain、域名DNS未生效
•输账号回登录界面：AddrTable.txt/!ServerInfo.txt未填公网IP、7100未映射
-进游戏黑屏能跑：Resources目录名错、Pak.txt路径未改、PAK密码错、微端未起
•卡“正在连接服务器”：7000未放行、网关绑了127.0.0.1、云安全组没开
•M2闪退：VC++运行库缺、HeroDB指向错、Mir200授权文件缺失、路径含中文
-外网能进内网不能进或反之：网关绑定0.0.0.0没勾、动态IP模式未开导致回包发向内网
•攻城/沙城逻辑错：CastleMapList.txt地图号与MapInfo不一致、SabukW.txt未重载
-跨运营商卡顿：单线宽带无BGP，换云BGP机房或让玩家走加速节点
十、家用动态IP与DDNS处理
光猫重启后公网IP变化，登录器列表写死IP次日失效。处理方式：路由器挂DDNS（花生壳/阿里云解析），登录器列表填域名；或引擎勾动态IP模式+列表地址走HTTP动态生成；纯好友联机可用ZeroTier/内网穿透替代端口映射，但延迟随节点波动。DMZ主机方案仅限临时测试，长期开着等于裸奔全部端口给公网。
整套外网链路串起来就是：选引擎→根目录英文+HeroDB/DBC→配公网IP与0.0.0.0绑定→映射7000/7100/7200/8000并放安全组→按顺序起网关与M2→UpdateServer载Pak.txt+Resources→登录器列表走HTTP→玩家端版本匹配。任意一层IP、端口、路径、密码四要素不一致，表现层就是黑屏、回登录、卡连接三种表象，反查按网关日志→M2日志→Pak.txt→列表文件顺序走一遍即可定位。
HERO/M2系（HeroM2、BLUE、LEGEND、3K）走DBC2000+HeroDB，老版本脚本兼容好、插件多，适合复古单职业、合击；GOM/GEE系内置数据库环境或走SQLite/MySQL，原生吃PAK/Resources分层补丁、微端机制完整，适合新界面、单文件大补丁、外网分发；GOM与GEE的Pak.txt、ResInfo.txt、登录器配置器格式不互通，版本包别混用，混用直接黑屏或M2报非法资源。云服务器优先选WindowsServer2012R2以上，家庭宽带需确认WAN口是否为真公网IP（ip138查到的IP必须等于路由器WAN口，10.x/100.64.x开头是大内网，必须找运营商换公网或走穿透）。
二、目录规范与DBC/HeroDB绑定
服务端解压到磁盘根目录全英文路径（D:\Mirserver），禁中文、禁空格、禁过长嵌套。HERO系装DBC2000→控制面板BDEAdministrator→Object→New→别名HeroDB（必须大写此拼写）→路径指D:\Mirserver\Mud2\DB→保存。路径错、别名拼错、PDOXUSRS.NET被占用都会让M2启动报DatabaseError。GOM/GEE新版一键端大多已集成库环境，但仍要核对Mir200\Mud2\DB是否存在StdItems.db、Magic.db、Monster.db，缺失则角色/物品/怪物全空。
三、公网IP、动态IP与网关绑定规则
引擎配置向导里：外网IP填公网IP；若是家庭动态IP必须勾“动态IP模式”；网关绑定地址填0.0.0.0（不允许只绑内网，否则外网握手失败）。BLUE/HERO老引擎改!Setup.txt、LoginGate.ini、!ServerInfo.txt、DBServer\!AddrTable.txt，格式：
测试一区192.168.1.100113.x.x.x:7100
!ServerInfo.txt：127.0.0.1192.168.1.100113.x.x.x:7100
漏改AddrTable典型症状：能出登录器、输账号后卡“正在进入游戏”或直接回登录界面。
四、端口矩阵与映射/安全组放行
核心端口清单（必须内外一致）：
•7000LoginGate登录端口
•7100SelGate/角色选择网关
•7200/7201/7202GameGate游戏网关
-8000/8008微端网关与UpdateServer
•443/80列表文件HTTP托管（可选）
路由器→虚拟服务器/端口转发→外部端口=内部端口=上述值，内部IP填服务端内网IP，协议TCP（微端可补UDP）。云服务器还要在控制台安全组加入站规则7000-7300、8000-8010放行0.0.0.0/0，只开系统防火墙不放安全组一样不通。CMD用netstat-ano|findstr:7000查占用，PID杀重复M2/网关进程。
五、启动顺序与进程联动
严格顺序：DBC2000服务→LoginGate→SelGate→GameGate→DBServer→LoginSrv→M2Server→（外网带微端）UpdateServer→MirUpdateGate。M2日志无红色报错、GameGate显示“连接到M2成功”、UpdateGate亮灯才算链路通。先起M2后起网关会触发IP不匹配、角色网关读不到在线列表。
六、微端与Pak.txt路径对齐（外网黑屏头号原因）
UpdateServer基本设置：客户端路径=配套客户端根目录（E:\Legendofmir）；Resources目录名=补丁文件夹名（Resources/Patch），必须和登录器配置器、Pak.txt内写法完全一致。Pak.txt里所有本地路径全文替换成客户端绝对路径（如E:\Legendofmir\Data），拷贝进UpdateServer目录；明文密码填版本PAK密码，密文自动生成，登录器配置器里更新密码必须同值。Resources分层结构：客户端根\Resources\Data\*.pak对应服务端补丁，缺一层就黑屏。微端网关配置：微端地址填UpdateServer所在IP，端口填UpdateServer端口，线路列表必须含“默认”。
七、登录器与列表文件发布
列表文件（123.txt/ServerList.txt）格式：
测试一区113.x.x.x70000
或GEE格式：服务器名113.x.x.x:7000
113.x.x.x:8000
上传到可公网访问的HTTP空间，浏览器直接打开能看到文本；登录器配置器填列表URL，勾纯微端模式时删掉“客户端搜索条件”里的检测目录/文件。生成GameLogin.exe给玩家，玩家本地客户端版本必须与服务端匹配（如1.76配16周年客户端），否则进图花屏。
八、脚本调试与M2报错定位
进游戏后NPC不对话、任务不触发、拾取无反应→看M2控制台红色ScriptError，定位Mir200\Envir\MapQuest_def\或QuestDiary\对应行号：
-“Undefinedvariable”→变量未声明（A..Z/G..前缀用错）
•“Scriptdeadloop”→死循环（#IF后无#ACT/#ELSEACT，或WHILE无限）
-“Cannotfindlabel@xxx”→[@xxx]标签拼错或脚本未重载
•“Itemnotfound”→CheckItem/GiveItem物品名与StdItems.DB不一致
改完脚本点M2→控制→重新加载→重新加载脚本，不必重启全服。MapInfo.txt地图号与Mir200\Map\*.map文件名不一致会导致进图直接掉线回城。
九、外网典型故障速查表
-登录器列表空白：列表URL不通、HTTP头非text/plain、域名DNS未生效
•输账号回登录界面：AddrTable.txt/!ServerInfo.txt未填公网IP、7100未映射
-进游戏黑屏能跑：Resources目录名错、Pak.txt路径未改、PAK密码错、微端未起
•卡“正在连接服务器”：7000未放行、网关绑了127.0.0.1、云安全组没开
•M2闪退：VC++运行库缺、HeroDB指向错、Mir200授权文件缺失、路径含中文
-外网能进内网不能进或反之：网关绑定0.0.0.0没勾、动态IP模式未开导致回包发向内网
•攻城/沙城逻辑错：CastleMapList.txt地图号与MapInfo不一致、SabukW.txt未重载
-跨运营商卡顿：单线宽带无BGP，换云BGP机房或让玩家走加速节点
十、家用动态IP与DDNS处理
光猫重启后公网IP变化，登录器列表写死IP次日失效。处理方式：路由器挂DDNS（花生壳/阿里云解析），登录器列表填域名；或引擎勾动态IP模式+列表地址走HTTP动态生成；纯好友联机可用ZeroTier/内网穿透替代端口映射，但延迟随节点波动。DMZ主机方案仅限临时测试，长期开着等于裸奔全部端口给公网。
整套外网链路串起来就是：选引擎→根目录英文+HeroDB/DBC→配公网IP与0.0.0.0绑定→映射7000/7100/7200/8000并放安全组→按顺序起网关与M2→UpdateServer载Pak.txt+Resources→登录器列表走HTTP→玩家端版本匹配。任意一层IP、端口、路径、密码四要素不一致，表现层就是黑屏、回登录、卡连接三种表象，反查按网关日志→M2日志→Pak.txt→列表文件顺序走一遍即可定位。