PC 完整客户端
优先用和版本匹配的完整客户端，别在广告位、群文件、网盘分享里随便点。下载前看文件体积、MD5 校验值、安装器有没有捆绑选项。几 MB 的 exe 基本不是真客户端。
常用搭配：
GOM 系常用十六周年完整端
GEE 系常用十七周年完整端
1.76 复古可用十周年/十三周年纯净端
高版本官方客户端硬套老引擎，资源索引容易错乱，进图黑屏
安装注意：
路径用纯英文，例如 D:\Mir2Client，别用桌面、中文目录、带空格路径
取消不必要的开机启动和附加组件
首次启动卡更新，手动放增量补丁到 Patch 目录再重启
Win10/Win11 没反应，补 DirectX 9.0c、Visual C++ 2015-2022 运行库，右键兼容 Win7 管理员运行
客户端根目录应有的东西
mir.exe 或对应登录器
Data
Map
Graphics
Sound
Pak
Patch
登录器配置、列表文件、PAK 配置按版本包要求放置
登录器必须放客户端根目录，和主程序同级。放桌面、放子文件夹、放压缩包里，都会读不到资源。
微端客户端
微端不是独立客户端，是轻量壳加后台拉资源。第一次进图边玩边下地图贴图，常驻地图缓存后就顺。
微端坑点：
缓存盘用 SSD，机械盘剩余空间低于 15G 会卡资源
没配微端服务器却勾了自动更新，会一直等下载超时，表现就是黑屏转圈
客户端 Cache 目录要可写，权限不够会加载失败
H5 与三端客户端
浏览器端不用下完整客户端，但底层还是要拉 WebGL 资源。手机端要对应架构包，iOS 必须签名。
安卓 APK：
开“允许安装未知来源”
ARM64 选 64 位包，架构不对直接闪退
装之前杀软加白名单，避免拦截登录器组件
iOS IPA：
TestFlight 分发最稳
企业签名要在设置-通用-VPN与设备管理里信任
掉签后角色数据还在，重装签名包重新信任即可
补丁覆盖正确姿势
版本补丁分三类：地图补丁、UI 补丁、物品/特效 PAK。
解压别套多层：
服务端给的是“补丁”文件夹，解压出来应该是：
D:\Mir2Client\Data\xxx
不是：
D:\Mir2Client\补丁\补丁\Data\xxx
覆盖顺序：
先覆盖 Data
再覆盖 Map
再覆盖 Graphics/Pak
最后放登录器、列表文件、PAK 配置
关键文件：
NewopUI.pak：登录界面核心，缺了中间出小砖块黑屏
UI.pak
Login.pak
Prguse.wil 系列
Hum.wil、MonXX.wil 等模型和特效文件
覆盖后删 Data\Cache 和客户端 Cache 再进。
PAK 密码与微端对齐
GOM/GEE 的 PAK 是加密包，密码不对全黑。
处理流程：
打开登录器目录的 Pak.txt
把里面旧客户端路径批量替换成你实际客户端路径
打开登录器配置器，进 PAK 管理，逐行看状态
绿色对勾才对，红色就是密码错或路径错
Pak.txt 要在三处保持一致：登录器配置器目录、微端 UpdateServer 目录、客户端根目录
微端 Resources 目录名、更新密码、PAK 密码三处一致
常见默认密码只能参考，实际以原包说明为准：不同引擎分支密码不一样，别硬猜。
黑屏分场景排查
登录界面黑屏、中间砖块
缺 NewopUI.pak 或 UI 补丁，重新覆盖 Data 文件。
能建角色但进图全黑
按这个顺序查：
Map 文件缺失或 0KB
微端没起
PAK 密码红
客户端版本和服端版本不匹配
补丁解压嵌套太深
选区后卡 100% 黑屏
看六个进程是否都在：
DBServer
LoginSrv
LoginGate
SelGate
RunGate
M2Server
少一个就卡加载。再看 M2 黑窗有没有红字。
提示“客户端版本不正确”
混用过不同引擎登录器。卸了重下完整客户端，别用绿色覆盖包修。
闪退/没反应
杀软隔离了登录器，恢复并加白名单
缺 VC++ 运行库
DirectX 异常
登录器放错目录
进图黑块、装备问号
PAK 密码错，或补丁没覆盖全。用资源工具核对密码，客户端 Data 按原结构覆盖。
端口与防火墙
本机测试全绑 127.0.0.1，外网必须改公网 IP 或 0.0.0.0。
常见端口按实际版本配置放行：
7000 登录网关
7100 选角网关
7200 游戏网关
8000 或 8008 微端
9000 WebSocket，H5 用
80/443/8080 Web 与 HTTPS
cmd 执行：
netstat -ano | findstr :7000
没看到 LISTENING，就是端口被占或网关没起。云服务器安全组和系统防火墙两层都要开。
客户端配置检查清单
路径纯英文无空格
登录器在根目录
Data/Map/Pak 覆盖无多层嵌套
Pak.txt 路径和实际客户端一致
PAK 密码全绿
微端没配就关自动更新
hosts 文件没被塞奇怪域名
Cache 已清理
杀软已加白名单
运行库齐全
开服方给玩家发客户端的干净做法
打一个基础完整客户端，预装运行库
按正确目录结构覆盖版本补丁
生成登录器放根目录，Pak.txt 密码全绿
微端资源走 CDN，首屏控制在 10MB 内
提供完整端直链、微端壳、安卓 APK、iOS 分发链接
每个包附 MD5
更新时只发增量补丁和版本号
玩家端自检最短路径
下完先算 MD5
杀软扫一遍
看目录结构是否完整
进图黑屏先清 Cache
再查 PAK 密码和微端地址
最后查网关和端口
客户端这一层出问题，九成不是网络，是资源：补丁没盖全、PAK 密码错、微端地址不对、登录器放错目录。先按资源路径查一遍，再查网关端口，别一上来重装系统。
版本内容改 Mir200\Envir 下脚本，客户端只负责把资源正确加载出来。客户端稳了，打怪、切图、攻沙才不会在表现层翻车。
