能登录能看见人，就是走不出安全区：地图进不去的排查顺序

开区前最怕遇到这种反馈：玩家能登录、能建号、安全区里还能看见别人跑动，可一走到传送点就没反应，或者进去之后一片黑，只剩人物和血条。有人说是客户端坏了，有人说是服务端卡了，其实绝大多数情况是地图这条链路的某一环没配齐。

一、先把现象分清楚

第一种，点传送没反应。NPC 对话正常弹出，点"传送"之后什么也不发生。问题在脚本或权限判断，地图本身通常是好的。

第二种，走到地图门口卡住。人物停在地图边界，走不进去也退不出来。多半是目标地图没有加载，引擎拒绝了这次切换。

第三种，进去全黑，只看得见人。地形、建筑、NPC 全没有。这是客户端缺地图文件，服务端没问题。

第四种，进去一秒被弹回。能进，但立刻回到上一张图。这是地图参数或回城点配置冲突。

把这四种分开，排查范围立刻小一半。下面按链路顺序走。

二、地图是怎么被加载的

一条完整的地图链路有四段，缺任何一段都会出问题：

1. Envir\MapInfo.txt：地图注册表。引擎启动时读它，没有登记的编号等于不存在。

2. 服务端 Map 目录下的 .map 文件：地形数据，文件缺失或大小为 0，引擎加载失败。

3. 客户端 Data\Map 目录下的同名文件：玩家本地渲染用，缺了就是黑屏。

4. 微端补丁列表：如果用了微端，只有列表里登记过的文件才会下发，没登记的地图玩家永远拉不到。

三、按这五步查，别跳步

第一步，确认地图在服务端存在。用 GM 命令直接传送过去，命令名各引擎不同，常见的是 @map 或 @move 加地图号坐标。提示"地图不存在"就往下查第二步；能传过去说明服务端没问题，直接跳到第四步查客户端。这一步能直接把问题切成服务端和客户端两半，省掉大量猜测。

第二步，看 MapInfo.txt。搜目标地图号，正常一行长这样：

; 地图号	地图文件	地图名	参数
0	0	比奇省
3	3	盟重省

三个常见错误：地图号重复（两行写了同一个编号，后一行覆盖前一行）；地图文件名和 Map 目录里的实际文件名大小写不一致；复制别人的配置时把参数一并带过来，比如限制了战斗或者禁止随机移动，玩家进去就被弹回。

第三步，看服务端 Map 目录。确认有对应的 .map 文件，并且大小正常。0 字节的文件比没有文件更坑，因为文件名对得上，日志里却只报一句加载失败，很容易被忽略。

第四步，看客户端补丁。打开客户端 Data\Map，找同名文件。没有就说明补丁没打全，让玩家重新下完整客户端或者单独补这张图。

第五步，微端用户单独确认。微端不是"客户端有什么就有什么"，它只下发列表里登记的文件。补丁目录里有、列表里没有，玩家照样黑屏。列表改完之后玩家重启登录器才会重新拉取，所以改完别马上开区，留一次完整重启的时间。

四、能进但立刻被弹回，看这两处

地图参数里的限制是最容易被忽略的一项。有的版本在 MapInfo 里给地图加了进入条件，比如需要等级、需要特定物品、限制行会，条件不满足时引擎会把人送回上一张图，玩家看到的就是"闪一下又回来了"。

另一处是回城点。回城坐标为空或者落在不可行走的格子上，小退、随机传送、死亡复活都会出现位置异常，表现很像"地图坏了"。改完配置记得把回城点也核对一遍。

五、传送脚本本身也可能是元凶

如果只有某个 NPC 的传送失效，其它入口正常，那问题就在脚本里。下面这段是最小可用的写法：

[@main]
#SAY
要去盟重吗？\ \
<传送过去/@go>    <离开/@exit>

[@go]
#IF
CHECKLEVELEX > 21
#ACT
MAPMOVE 3 330 330
#ELSESAY
等级不够，22 级以后再来。

排查时重点看三处：地图号写的是不是 MapInfo 里登记过的编号；目标坐标是不是落在可站立的地面（落在墙里、水里，人物会卡住不动，看起来像地图加载失败）；#IF 的条件是不是永远不成立，条件不成立又没写 #ELSESAY，玩家点下去就是"毫无反应"。

六、日志里搜什么

M2 启动完成后不要急着开区，先在日志里搜三个关键词：地图、Map、加载失败。正常的引擎会把每张地图的加载结果打出来，加载失败的会单独列一行，文件名、编号都能看到。日志里没有这张图，说明 MapInfo 根本没登记；日志里有但后面跟着失败，说明是 map 文件本身的问题。

还有一个容易忽略的限制：部分老引擎对地图编号有范围要求，编号超出上限的地图不会加载，也不会报明显错误。从新版本往老引擎搬地图时，这一点经常踩。

七、给开区前的自检清单

开区前一天，把主城、练级图、BOSS 图、活动图各走一遍：从 NPC 传送进、从地图门走进、随机传送进，三种方式都试。再用一个没打过补丁的干净客户端登录一次，确认不会黑屏。

这套流程花不了二十分钟，但能挡掉开区当晚最常见的一类投诉。换版本之后建议重跑一遍，地图编号、补丁内容都可能变，旧的清单不作数。地图问题不怕难，怕的是玩家说"进不去"，GM 回一句"我这边好的"，然后两边对着耗。