传奇GOM与GEE引擎架设黑屏及个别装备地图不显示根因排查与修复手册

一、全局黑屏（进游戏全黑、无血条无UI、登录框都不出）
1. 客户端版本不对：GOM/GEE要求13周年以上完整客户端，荐16/17周年纯净包；10周年以下、最新官方自动更新端、魔改高清端必黑屏。路径纯英文无空格无中文（D:\MirClient），不做套娃嵌套
2. NewopUI.pak 缺失或没进 Data：界面基底全在这文件里，服务端登录器目录/补丁包捞 NewopUI.pak 覆到 客户端\Data\ 下，登录器配置器勾“强制读取本地NewopUI”，重生登录器
3. 登录器不在客户端根目录：生成后的 .exe 必须拷到 D:\MirClient 根目录运行，放桌面/其他盘会被自动搜索到错误客户端导致黑屏
4. 勾了微端模式但没起微端：纯完整客户端必须取消“启用微端模式”；要微端就起 UpdateServer+UpdateGate 且端口密码对齐
5. 1024界面冲突：老客户端勾了“显示1024界面”→登录器配置器去勾重生成

二、地图黑屏（UI/NPC/血条正常，土城野外地砖全黑）
1. .map 文件没同步：服务端 D:\Mirserver\Mir200\Map\*.map 全选覆盖到 客户端\Map\ 以及自定义补丁目录（如 Resources\Map\）各一份，M2改了地图必须重配登录器
2. 贴图素材层缺失：地图除.map外还需 Data 内地面/建筑 WIL/WZL/PAK，补丁整体解压到客户端根，禁止“客户端\补丁\Data”多层嵌套
3. 自定义补丁目录名三方不一致：登录器配置器“Resources目录/Patch目录”名 = 客户端实际文件夹名 = pak.txt 内路径名，三者不同即黑屏
4. 客户端被多版本污染：重下16/17周年纯净端重打补丁，混杂端必丢图

三、个别装备/怪物/特效不显示（问号、粉块、透明、布衣替代新装）
1. PAK密码错或路径没改绝对路径：登录器生成器目录 pak.txt 每行格式 绝对路径|密码|标记，记事本 Ctrl+H 把模板盘符批量换成 D:\MirClient\Resources\，导入配置器 PAK 页校验全绿；红字“密码错误”找版本原密码，“文件不存在”查路径/文件名
2. StdItems.DB 的 Looks/Shape 值对不上补丁编号：GOM/GEE 自定义装备 Looks 从 10000 起，填 10000=PAK第0帧、10001=第1帧；HERO 填 WIL 内图片序号；怪物 Appr=(Mon文件号-1)×10+序号。对不上就显示问号/普通装
3. 补丁文件本身没放对目录：装备 PAK 进 客户端\Data 或 客户端\Resources\Graphics\Weapon|Human ，怪物 PAK 进 Resources\Monster ，NPC 进 Resources\Npc ；微端版还需把同款 PAK+密码同步进 UpdateServer 目录
4. 索引断裂/PAK损坏：WIL编辑器打开对应文件看帧图是否存在，坏包重新解压，关杀软防拦截
5. M2未重载：改完 DB/补丁后 M2控制台 → 重载物品数据库 / @ReloadItem / 重启 M2+DBServer

四、pak.txt 与登录器生成硬性对齐项
• 客户端绝对路径（无中文）

- 更新密码（GEE默认 GEEM2，GOM默认 gameofmir 或版本自定义，大小写敏感）
• Resources/Patch 目录名三方一致

• NewopUI.pak 在 Data

• 引擎类型选 GOM/GeeM2 不匹配登录器

- 生成登录器覆到客户端根

五、微端模式额外核查
UpdateServer 基本设置：客户端目录、资源目录名、更新密码、端口（如8008）与登录器配置器、列表文件 serverlist.txt 内微端端口三方一致；qqwry.dat 进 UpdateGate 目录；纯完整客户端别勾微端模式

六、速查顺序
换16/17周年纯净端 → 补丁平铺覆盖根目录 → NewopUI进Data → 服务端Map覆客户端Map → 改pak.txt绝对路径密码全绿 → 登录器配Resources名/引擎类型 → 取消误勾微端 → 生成登录器放客户端根 → 启DBC→引擎→微端→登录器。按这条走全局黑屏与单件装备地图不显示都能定位到具体断点。