一、先按现象分类，别盲目重装
•全屏黑但角色能走动、能听到音乐→地图/地砖/Objects资源未加载（Map、Tiles.wil、Objects.wil、PAK缺失或路径错）
-UI、血条、背包、按钮全黑或错位→NewopUI.pak/Prguse.wil/Prguse2.wzl缺失，或PAK密码错
•NPC名字在但立绘透明、对话框正常→Npc.wil/Market_Def脚本加载正常但外观码越界，或Graphics单文件缺
-装备背包红问号、穿上透明→Items.wil/StateItem.wil/DnItems.wil或Resources\Data\Items.pak缺帧，Looks与补丁不匹配
-进特定地图黑、其他图正常→该地图号在MapInfo.txt有但客户端Map\下缺对应.map，或Objects分层缺
•GOM登录器配GEE服务端（或反着来）→直接黑屏无法进界面，引擎与登录器必须同系
二、客户端底板与路径硬规矩
1.版本：GOM/GEE用13周年以上完整客户端，推荐16/17周年纯净版；老1.76客户端跑新引擎必黑
2.路径：纯英文无空格，如D:\MirClient，禁D:\游戏\热血传奇、D:\MirClient
3.登录器位置：必须放在客户端根目录，与mir.exe/legend.exe同层；桌面临时快捷方式指向错盘会读不到补丁
4.补丁解压：服务端“补丁”文件夹内含Data\Map\Resources\等，直接解压到客户端根目录选“全部覆盖”，禁套多层“客户端\补丁\Data”嵌套
三、Map与Envir对齐（服务端→客户端）
•服务端Mir200\Envir\MapInfo.txt里地图号（0=比奇、3=盟重、0150=沙城…）必须能在客户端Map\找到同名.map
-同步命令：拷贝服务端Mir200\Map\.→客户端Map\覆盖；自定义地图还要进Resources\Map\覆盖
•M2启动报“无法加载地图XXXX”→服务端Mir200\Map缺文件或MapInfo.txt写错号
四、PAK加载机制与Pak.txt校验（GOM/GEE核心）
读取顺序：客户端根\Resources\Data\XXX.pak→密码由Resources\Pak.txt声明→解密后覆盖Data\XXX.wil/wzl
Pak.txt每行格式：相对路径密码
基准根
例：Data\NewopUI.pakgameofmir
Resources\
含义：去[客户端根]\Resources\Data\NewopUI.pak取包，密码gameofmir
登录器配置器核验：
1.打开服务端“登录器”目录里的Pak.txt，把旧路径批量替换成当前客户端绝对路径（如D:\MirClient）
2.登录器生成器→Wil/Wzl/Pak读取规则→逐行状态：绿色=路径密码正确，红色=文件不存在或密码错
3.GEE需点“保存”才刷状态，GOM实时显示；红色行要么改密码要么删行重生成
4.Resources目录名必须与补丁实际文件夹同名，改过默认名要在配置器同步
5.非微端单机必关“微端模式”，否则登录器去拉远程更新必黑
五、关键文件清单（缺哪个黑哪）
•Data\NewopUI.pak/NewopUI.wzl→整体UI框架、血条、按钮、瑶界面
-Data\Prguse.wil/Prguse2.wzl→底栏、对话框、面板背景
•Data\Tiles.wil/SmTiles.wil→大地砖、水面，缺则地图全黑
•Data\Objects.wil/Objects1~7.wil→建筑、城墙、树木，缺则地图空块
-Data\Hum.wil/Hum2.wil/Weapon.wil/Items.wil/Mon1~MonN.wil/Npc.wil/Magic.wil→人物/装备/怪物/NPC/技能特效
-Resources\Data\Items.pak/StateItem.pak/DnItems.pak/Hum.pak/Weapon.pak/Magic.pak→自定义加密补丁
-Map\0.map/3.map/0150.map…→地形逻辑，缺则进图黑
六、M2与网关启动校验（非纯客户端问题）
顺序：DBServer→LoginSrv→LoginGate→SelGate→RunGate→M2Server
-M2红字“DB连接失败”→HeroDB/PATH错或DBServer没起，角色进不来表现为卡黑
•RunGate端口（7200/7300）被占→netstat-ano查，改端口或杀占用
-M2加载Market_Def/QuestDiary报语法错→脚本UTF-8或死循环，NPC不显且可能卡世界帧
•GOM选项里“登录时全屏黑屏”误勾→取消；GEE界面设置“加载画面类型”改默认素材
七、微端模式排错（开了微端才用）
•UpdateGate\!addrtable.txt/!serverinfo.txtIP填公网，qqwry.dat从Mir200拷到UpdateGate
-UpdateServer里“客户端路径”指向微端客户端根，“Resources目录名”与补丁文件夹完全一致
•UpdateServer\Pak.txt与登录器Pak.txt路径密码完全一致
-单机没微端服务器却勾了微端模式→进图黑，关掉用本地补丁
八、调试日志定位精确缺失文件
•GOM：登录器配置加ResourceLoadLog=1，生成资源加载日志，看哪行PAK/WIL打不开
-GEE：M2Server控制台开调试日志，记录缺失Objects/Map/Tiles名
•用WIL编辑器打开对应.wil/.pak，看帧索引是否断裂，断裂从完整引擎包复制同名文件替换
九、标准修复顺序（照做一遍）
1.确认客户端16/17周年纯净版、纯英文路径、登录器在同根目录
2.服务端Mir200\Map\*覆盖客户端Map\，Resources\Map同步
3.补丁包Data/Resources/Graphics解压到客户端根覆盖，不嵌套
4.打开Pak.txt替换路径为本机客户端根，登录器配置器逐行核密码至全绿
5.确认同系：GOM服务端配GOM登录器、GEE配GEE，禁混用
6.关微端模式（单机），关全屏黑屏选项
7.按顺序起DBServer→Gate→M2，M2无红字后登入
8.仍黑则开ResourceLoadLog看具体缺文件补具体文件
十、高频残留坑
-登录器生成后没拷进客户端根，桌面临时文件指向旧客户端→属性→打开文件所在位置核对
•杀软删了NewopUI.pak/M2相关exe→加白名单重解压
•客户端被其他版本补丁污染→换干净16周年重盖当前补丁
-Win10/11渲染异常→兼容模式XPSP3/Win7+管理员权限+装DX9.0c与VC++运行库
•自定义物品Looks=12000但Resources\Data\Items.pak没这帧→红问号，补对应PAK或改回原段Looks
黑屏本质就一类事：客户端该读的Map/WIL/PAK没在正确路径用正确密码解出来；按现象切到对应资源层，校路径→校Pak.txt→校版本→校启动顺序，逐项对齐即可复原画面。
•全屏黑但角色能走动、能听到音乐→地图/地砖/Objects资源未加载（Map、Tiles.wil、Objects.wil、PAK缺失或路径错）
-UI、血条、背包、按钮全黑或错位→NewopUI.pak/Prguse.wil/Prguse2.wzl缺失，或PAK密码错
•NPC名字在但立绘透明、对话框正常→Npc.wil/Market_Def脚本加载正常但外观码越界，或Graphics单文件缺
-装备背包红问号、穿上透明→Items.wil/StateItem.wil/DnItems.wil或Resources\Data\Items.pak缺帧，Looks与补丁不匹配
-进特定地图黑、其他图正常→该地图号在MapInfo.txt有但客户端Map\下缺对应.map，或Objects分层缺
•GOM登录器配GEE服务端（或反着来）→直接黑屏无法进界面，引擎与登录器必须同系
二、客户端底板与路径硬规矩
1.版本：GOM/GEE用13周年以上完整客户端，推荐16/17周年纯净版；老1.76客户端跑新引擎必黑
2.路径：纯英文无空格，如D:\MirClient，禁D:\游戏\热血传奇、D:\MirClient
3.登录器位置：必须放在客户端根目录，与mir.exe/legend.exe同层；桌面临时快捷方式指向错盘会读不到补丁
4.补丁解压：服务端“补丁”文件夹内含Data\Map\Resources\等，直接解压到客户端根目录选“全部覆盖”，禁套多层“客户端\补丁\Data”嵌套
三、Map与Envir对齐（服务端→客户端）
•服务端Mir200\Envir\MapInfo.txt里地图号（0=比奇、3=盟重、0150=沙城…）必须能在客户端Map\找到同名.map
-同步命令：拷贝服务端Mir200\Map\.→客户端Map\覆盖；自定义地图还要进Resources\Map\覆盖
•M2启动报“无法加载地图XXXX”→服务端Mir200\Map缺文件或MapInfo.txt写错号
四、PAK加载机制与Pak.txt校验（GOM/GEE核心）
读取顺序：客户端根\Resources\Data\XXX.pak→密码由Resources\Pak.txt声明→解密后覆盖Data\XXX.wil/wzl
Pak.txt每行格式：相对路径密码
基准根
例：Data\NewopUI.pakgameofmir
Resources\
含义：去[客户端根]\Resources\Data\NewopUI.pak取包，密码gameofmir
登录器配置器核验：
1.打开服务端“登录器”目录里的Pak.txt，把旧路径批量替换成当前客户端绝对路径（如D:\MirClient）
2.登录器生成器→Wil/Wzl/Pak读取规则→逐行状态：绿色=路径密码正确，红色=文件不存在或密码错
3.GEE需点“保存”才刷状态，GOM实时显示；红色行要么改密码要么删行重生成
4.Resources目录名必须与补丁实际文件夹同名，改过默认名要在配置器同步
5.非微端单机必关“微端模式”，否则登录器去拉远程更新必黑
五、关键文件清单（缺哪个黑哪）
•Data\NewopUI.pak/NewopUI.wzl→整体UI框架、血条、按钮、瑶界面
-Data\Prguse.wil/Prguse2.wzl→底栏、对话框、面板背景
•Data\Tiles.wil/SmTiles.wil→大地砖、水面，缺则地图全黑
•Data\Objects.wil/Objects1~7.wil→建筑、城墙、树木，缺则地图空块
-Data\Hum.wil/Hum2.wil/Weapon.wil/Items.wil/Mon1~MonN.wil/Npc.wil/Magic.wil→人物/装备/怪物/NPC/技能特效
-Resources\Data\Items.pak/StateItem.pak/DnItems.pak/Hum.pak/Weapon.pak/Magic.pak→自定义加密补丁
-Map\0.map/3.map/0150.map…→地形逻辑，缺则进图黑
六、M2与网关启动校验（非纯客户端问题）
顺序：DBServer→LoginSrv→LoginGate→SelGate→RunGate→M2Server
-M2红字“DB连接失败”→HeroDB/PATH错或DBServer没起，角色进不来表现为卡黑
•RunGate端口（7200/7300）被占→netstat-ano查，改端口或杀占用
-M2加载Market_Def/QuestDiary报语法错→脚本UTF-8或死循环，NPC不显且可能卡世界帧
•GOM选项里“登录时全屏黑屏”误勾→取消；GEE界面设置“加载画面类型”改默认素材
七、微端模式排错（开了微端才用）
•UpdateGate\!addrtable.txt/!serverinfo.txtIP填公网，qqwry.dat从Mir200拷到UpdateGate
-UpdateServer里“客户端路径”指向微端客户端根，“Resources目录名”与补丁文件夹完全一致
•UpdateServer\Pak.txt与登录器Pak.txt路径密码完全一致
-单机没微端服务器却勾了微端模式→进图黑，关掉用本地补丁
八、调试日志定位精确缺失文件
•GOM：登录器配置加ResourceLoadLog=1，生成资源加载日志，看哪行PAK/WIL打不开
-GEE：M2Server控制台开调试日志，记录缺失Objects/Map/Tiles名
•用WIL编辑器打开对应.wil/.pak，看帧索引是否断裂，断裂从完整引擎包复制同名文件替换
九、标准修复顺序（照做一遍）
1.确认客户端16/17周年纯净版、纯英文路径、登录器在同根目录
2.服务端Mir200\Map\*覆盖客户端Map\，Resources\Map同步
3.补丁包Data/Resources/Graphics解压到客户端根覆盖，不嵌套
4.打开Pak.txt替换路径为本机客户端根，登录器配置器逐行核密码至全绿
5.确认同系：GOM服务端配GOM登录器、GEE配GEE，禁混用
6.关微端模式（单机），关全屏黑屏选项
7.按顺序起DBServer→Gate→M2，M2无红字后登入
8.仍黑则开ResourceLoadLog看具体缺文件补具体文件
十、高频残留坑
-登录器生成后没拷进客户端根，桌面临时文件指向旧客户端→属性→打开文件所在位置核对
•杀软删了NewopUI.pak/M2相关exe→加白名单重解压
•客户端被其他版本补丁污染→换干净16周年重盖当前补丁
-Win10/11渲染异常→兼容模式XPSP3/Win7+管理员权限+装DX9.0c与VC++运行库
•自定义物品Looks=12000但Resources\Data\Items.pak没这帧→红问号，补对应PAK或改回原段Looks
黑屏本质就一类事：客户端该读的Map/WIL/PAK没在正确路径用正确密码解出来；按现象切到对应资源层，校路径→校Pak.txt→校版本→校启动顺序，逐项对齐即可复原画面。