完整客户端获取
优先走盛趣传奇归来官方入口，用官网通用客户端下载器，安装时选择传奇归来版本，让下载器自动拉完整资源。别在贴吧、QQ群、网盘分享、破解站下“整合版”，容易带捆绑登录器、劫持 hosts、塞木马。
完整包常见三种形式：
官方安装版：最稳，自动校验资源
绿色免安装完整包：解压即用，适合单机架设测试
分卷压缩包：必须把所有分卷下全，只解压第一个会损坏
下载后先做两件事：
核对文件大小，分卷包漏卷直接废
算 MD5，和发布方给的校验值比对，不一致重新下
客户端目录规范
安装路径用纯英文短路径，推荐：
D:\Games\MirReturn
D:\CQGL
D:\Mir2Client
别放：
C:\Program Files
C:\Program Files (x86)
桌面\传奇归来
D:\游戏\传奇归来客户端 2026
中文、空格、受系统保护的目录会导致补丁写不进、配置读不到、登录器闪退。
完整端目录该有的东西：
mir.exe 或登录器
Data（WIL/WZL/PAK 资源）
Map（地图索引）
Graphics
Sound
Pak
Patch
登录器配置、列表文件、PAK 配置按版本包要求放置
轻客户端与微端
轻客户端体积约 70-100MB，只含登录器和核心程序，进游戏后后台拉地图、模型、音效。适合急着进服，但首次进新图会短暂黑块或模型延迟。
轻端使用注意：
磁盘预留 5GB 以上缓存空间
首次进主城、魔龙、新地图时别强关，等后台拉完
模型透明方块是资源没下完，退出重进让登录器校验修复
WiFi 不稳定换有线，断流会索引损坏
微端模式对开服方来说，是服务端起 UpdateServer + UpdateGate，客户端只拉差异资源；对玩家来说，表现就是“边玩边下”。
登录器配置
登录器必须放客户端根目录，和 mir.exe 同级。放桌面、放子文件夹、放压缩包里都读不到资源。
单机架设：
列表地址填 http://127.0.0.1/list.txt
服务端 IP 改 127.0.0.1
网关绑 127.0.0.1
外网：
列表写公网 IP 或域名
登录器配置器里服务器 IP、微端 IP、ws 地址全改公网
0.0.0.0 只用在服务端监听，别写进玩家列表
登录器右键属性：
兼容模式 Win7 或 XP SP3
管理员身份运行
高 DPI 替代缩放选“应用程序”
禁用全屏优化
Win10/Win11 花屏、黑屏、界面错位的，先按这套兼容设置来，再查补丁。
补丁覆盖正确姿势
版本补丁分三类：地图补丁、UI 补丁、物品/特效 PAK。
解压别套多层。服务端给的是“补丁”文件夹，解压完应该是：
D:\Mir2Client\Data\xxx
D:\Mir2Client\Map\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.txt，把旧客户端路径批量替换成你实际客户端路径
打开登录器配置器，进 PAK 管理，逐行看状态
绿色对勾才对，红色就是密码错或文件不存在
NewopUI.pak 密码错也会整体黑屏，要把登录器目录里的 NewopUI.Pak 覆盖到客户端 Data
微端服务端、登录器、pak.txt 三处密码必须一致
常见坑：
登录器配置器点了“读取客户端”会把密码重置成默认，新手别点
GOM 和翎风补丁编辑工具不通用，用错会读出空补丁
补丁文件存在但 pak.txt 路径写错，报“文件不存在”
黑屏分场景排查
登录界面黑屏、中间砖块
缺 NewopUI.pak 或 UI 补丁，重新覆盖 Data 文件。
能建角色但进图全黑
按顺序查：
Map 里缺 Ml.map、Ml1.map 这类魔龙地图
Data 补丁没盖全
PAK 密码红
客户端版本和服务端版本不匹配
补丁解压嵌套太深
进图黑块、装备问号、怪物透明
PAK 密码错，或资源没下完。微端模式点“重新下载补丁+强制完整更新”。
选区后卡 100% 黑屏
看服务端进程是否全起：
DBServer
LoginSrv
LoginGate（7000）
SelGate（7100）
RunGate（7200）
M2Server
少一个就卡加载。M2 黑窗有红字先按红字修。
提示“客户端版本不正确”
混用不同引擎登录器。卸了重下完整客户端，别用绿色覆盖包硬修。
闪退/没反应
杀软隔离登录器，恢复并加白名单
缺 VC++ 运行库，补 x86+x64
DirectX 异常
登录器放错目录
分辨率没适配，老客户端默认 800x600，宽屏进设置开窗口化或全屏适配
端口与防火墙
本机测试全绑 127.0.0.1，外网改公网 IP 或 0.0.0.0。
常见端口：
7000 登录网关
7100 选角网关
7200 游戏网关
8000 微端（GEE 常见 8008）
9000 WebSocket，H5 用
80/443/8080 Web 与 HTTPS
cmd 执行：
netstat -ano | findstr :7000
没 LISTENING 就是端口被占或网关没起。被迅雷、酷狗、IIS 占用就结束进程，或在配置里改 7101/7201，列表同步改。
云服务器安全组 + 系统防火墙两层都要开。
list.txt 格式
单机：
http://127.0.0.1/list.txt
外网：
区名公网IP 7000 微端IP
8000
微端端口和游戏端口分开，别撞。
开服方给玩家发客户端的干净做法
打一个基础完整客户端，预装运行库
按正确目录结构覆盖版本补丁，不嵌套
生成登录器放根目录，pak.txt 密码全绿
NewopUI.pak 单独校验一次
微端资源走 CDN，首屏控制在 10MB 内
提供完整端直链、轻端壳、安卓包、iOS 分发链接
每个包附 MD5，更新只发增量补丁和版本号
玩家自检最短路径
下完算 MD5
杀软加白名单
路径纯英文无空格
登录器在根目录
Data/Map/Pak 覆盖无嵌套
pak.txt 路径和实际客户端一致
PAK 密码全绿
清 Cache 再进
黑屏先查补丁，再查网关端口
系统环境补齐
Win10/Win11 缺组件会闪退：
DirectX 9.0c
Visual C++ 2015-2022，x86 和 x64 都装
高 DPI 缩放替代为应用程序
显卡驱动别用太新，部分新驱动和老客户端花屏冲突，可回退稳定版
完整端和微端怎么选
完整端：
适合长期玩、攻沙、同屏人多、自己架设测试。资源全在本地，切图不依赖网络，晚高峰更稳。
微端/轻端：
适合试服、快速进新区、带宽小。首次加载慢，常驻地图缓存后体验接近完整端。
单机架设：
用十六周年左右完整端做底，覆盖版本补丁，登录器放根目录，IP 改 127.0.0.1，先本机跑通再改外网。
传奇归来的客户端问题，九成不是网络，是资源路径和 PAK 密码。先按“补丁平铺—登录器根目录—pak.txt 路径—密码全绿—清 Cache”走一遍，再查网关和端口，别一上来重装系统。
版本内容改 Mir200\Envir 下脚本，客户端只负责把资源正确渲染出来。客户端稳了，打怪、切图、攻沙才不会在表现层翻车。
