GeeM2引擎属于GEE分支体系，单职业版本普遍采用PAK加密补丁承载高清装备、怪物、地图、技能特效，登录器必须与当前服务端PAK密码、路径、微端参数一一配套，不存在跨版本通用登录器。整套配置发生在MirServer\登录器目录与热血传奇客户端之间，核心文件为MakeGameLogin.exe、自定义UI升级工具(白屏修复).exe、Pak.txt、Map.txt、Wil.txt、Wzl.txt、Wav.txt、NewUI目录及服务端列表文件。下面按真实架设顺序拆开。
一、基础环境与文件清点
准备完整MirServer服务端一套，建议使用官方16周年或17周年纯净热血传奇客户端，解压到D:\LegendClient之类短路径，禁止嵌套多层中文目录。进入MirServer\登录器目录，确认存在以下文件：
-MakeGameLogin.exe（登录器生成器，缺则更新GeeM2引擎包）
•自定义UI升级工具(白屏修复).exe
•Pak.txt/Map.txt/Wil.txt/Wzl.txt/Wav.txt/Data.txt
-NewUI文件夹（内含大量.bak时必须先升级UI）
客户端根目录保留Data、Map、Sound、Wav、Patch等原始结构，未覆盖其他版本补丁，避免素材冲突。
二、补丁覆盖与PAK文件机制
单职业版本配套补丁包解压，覆盖进热血传奇客户端根目录，Data、Map、Sound等同名目录选择“覆盖”。PAK文件本质为加密真彩资源包，突破传统WIL/WZL的256色限制，支持透明通道与多资源合并，头部标记一般为GeeM2PakFile，加密后记事本打开为乱码，解密钥匙即版本作者设定的PAK密码。
常见PAK分包命名：
Data\items.pak（物品/装备）
Data\chars.pak（角色/怪物）
Data\map.pak（地图块）
Data\effect.pak（特效）
Data\sound.pak（音效）
密码写在版本发布说明、pakkey.txt或作者备注里，找不到密码则后续登录器必报“PAK密码错误”。
三、UI升级与白屏修复
登录器目录内若NewUI存在且里面大量.bak备份文件，必须先运行自定义UI升级工具(白屏修复).exe，点升级，必须看到“升级成功”。跳过此步进游戏全屏白屏、按钮消失、背包不渲染。升级完不要手工改NewUI内文件名，否则UI层级错位。
四、改写资源读取规则文件
逐个编辑登录器目录下的文本规则，把路径指向实际客户端根目录。以Pak.txt为例，原始写法可能是：
.\Data\items.pak00
或带密码：
.\Data\items.pak密码0
改成绝对路径示例：
D:\LegendClient\Data\items.pak1234560
（123456为PAK密码，最后一个0代表校验模式，具体依版本说明）
Map.txt指向D:\LegendClient\Map；Wil.txt指向老WIL补丁；Wzl.txt指向13周年以上客户端WZL；Wav.txt指向Sound。路径分隔用反斜杠，结尾别多空格，编码ANSI。
改完把Pak.txt复制一份留桌面备份，GEE引擎在客户端自动读取时会清洗Pak.txt密码，需回写备份版。
五、微端资源处理（可选但单职业推荐）
单职业素材常超10G，做纯微端需把冷门地图、高阶装备特效打包为data1.pak、data2.pak放入客户端Patch目录。运行UpdateServer_X64（微端网关），基本配置填：
-客户端目录：D:\LegendClient
•资源目录：D:\LegendClient\Patch
•更新密码：GEEM2（须与登录器一致）
•端口：默认8008，避与其他网关冲突
菜单“查看→查看文件→PAK”，载入Pak.txt，提示密码正确即可缓存资源；密码错回到第四步核对。
六、MakeGameLogin登录器生成实战
打开MakeGameLogin.exe，依次填：
1.分区名称：单机架设填“GeeM2单机测试区”，外网填版本名
2.IP地址：单机127.0.0.1，外网填服务器公网IP或域名
3.端口：7000（须与M2Server网关端口一致）
4.客户端路径：浏览选中D:\LegendClient
5.资源读取规则→PAK：导入改好的Pak.txt，状态栏显示“密码正确”才能继续，显示“密码错误”回去查密码与路径
6.登录器选项：删掉多余检测目录；做纯微端勾“纯微端登录器”，填微端IP与端口（如127.0.0.1:8008）；非微端取消该勾，走本地全量补丁
7.列表地址：单机可留空或写本地txt；外网传ftp/http的serverlist.txt，模板：
标题分区标题区名127.0.0.170001127.0.0.180080
0
8.点“保存配置→生成登录器”，生成的.exe放进D:\LegendClient根目录，禁止放桌面或其他盘，否则读不到Data/Map。
七、服务端启动与联调顺序
1.启动DBServer→LoginGate→M2Server→GameGate
2.若用微端，先起UpdateServer_X64，确认“微端连接成功”
3.双击生成的登录器，列表展开、选区、进游戏
正常表现：登录界面加载NewUI、角色选择无白屏、进比奇装备怪物显示真彩、地图无透明块。异常对照：
•黑屏/透明装备：Pak.txt路径错或密码错
•全屏白屏：未升NewUI或UI升级失败
-地图缺失黑块：Map.txt路径错或未覆盖Map补丁
•列表读不到：serverlist.txt格式错或FTP权限问题
•微端不停下载：Resources目录名与登录器内补丁名不一致
八、单机与外网差异点
单机：IP全127.0.0.1，端口默认，不做微端也能跑，PAK全量放客户端。外网：必须微端或玩家预下完整补丁；列表文件传HTTP可访问地址；防火墙放行7000（M2）、8008（微端）、FTP端口；登录器生成时微端IP填公网IP，UpdateServer绑定0.0.0.0对应端口；PAK密码别外泄，避免素材被扒。
九、常见排错速查
•提示“PAK密码错误”：Pak.txt密码错、路径错、PAK文件损坏、GEE清洗密码未回写
•登录器闪退：客户端路径含空格或中文层级过深、MakeGameLogin版本过旧
-进游戏红问号：PAK未加载、StdItems与补丁Idx不匹配
•说话/音效缺失：Wav.txt未指Sound目录
•老地图花屏：Wil.txt/Wzl.txt路径未改，混用10周年与13周年客户端素材
照上述顺序：清文件→覆盖补丁→升UI→改五件txt→配微端→MakeGameLogin生成→起服务→进游戏，GeeM2单职业登录器与PAK链路全部打通，生成的登录器放客户端根目录直接双击即用。
一、基础环境与文件清点
准备完整MirServer服务端一套，建议使用官方16周年或17周年纯净热血传奇客户端，解压到D:\LegendClient之类短路径，禁止嵌套多层中文目录。进入MirServer\登录器目录，确认存在以下文件：
-MakeGameLogin.exe（登录器生成器，缺则更新GeeM2引擎包）
•自定义UI升级工具(白屏修复).exe
•Pak.txt/Map.txt/Wil.txt/Wzl.txt/Wav.txt/Data.txt
-NewUI文件夹（内含大量.bak时必须先升级UI）
客户端根目录保留Data、Map、Sound、Wav、Patch等原始结构，未覆盖其他版本补丁，避免素材冲突。
二、补丁覆盖与PAK文件机制
单职业版本配套补丁包解压，覆盖进热血传奇客户端根目录，Data、Map、Sound等同名目录选择“覆盖”。PAK文件本质为加密真彩资源包，突破传统WIL/WZL的256色限制，支持透明通道与多资源合并，头部标记一般为GeeM2PakFile，加密后记事本打开为乱码，解密钥匙即版本作者设定的PAK密码。
常见PAK分包命名：
Data\items.pak（物品/装备）
Data\chars.pak（角色/怪物）
Data\map.pak（地图块）
Data\effect.pak（特效）
Data\sound.pak（音效）
密码写在版本发布说明、pakkey.txt或作者备注里，找不到密码则后续登录器必报“PAK密码错误”。
三、UI升级与白屏修复
登录器目录内若NewUI存在且里面大量.bak备份文件，必须先运行自定义UI升级工具(白屏修复).exe，点升级，必须看到“升级成功”。跳过此步进游戏全屏白屏、按钮消失、背包不渲染。升级完不要手工改NewUI内文件名，否则UI层级错位。
四、改写资源读取规则文件
逐个编辑登录器目录下的文本规则，把路径指向实际客户端根目录。以Pak.txt为例，原始写法可能是：
.\Data\items.pak00
或带密码：
.\Data\items.pak密码0
改成绝对路径示例：
D:\LegendClient\Data\items.pak1234560
（123456为PAK密码，最后一个0代表校验模式，具体依版本说明）
Map.txt指向D:\LegendClient\Map；Wil.txt指向老WIL补丁；Wzl.txt指向13周年以上客户端WZL；Wav.txt指向Sound。路径分隔用反斜杠，结尾别多空格，编码ANSI。
改完把Pak.txt复制一份留桌面备份，GEE引擎在客户端自动读取时会清洗Pak.txt密码，需回写备份版。
五、微端资源处理（可选但单职业推荐）
单职业素材常超10G，做纯微端需把冷门地图、高阶装备特效打包为data1.pak、data2.pak放入客户端Patch目录。运行UpdateServer_X64（微端网关），基本配置填：
-客户端目录：D:\LegendClient
•资源目录：D:\LegendClient\Patch
•更新密码：GEEM2（须与登录器一致）
•端口：默认8008，避与其他网关冲突
菜单“查看→查看文件→PAK”，载入Pak.txt，提示密码正确即可缓存资源；密码错回到第四步核对。
六、MakeGameLogin登录器生成实战
打开MakeGameLogin.exe，依次填：
1.分区名称：单机架设填“GeeM2单机测试区”，外网填版本名
2.IP地址：单机127.0.0.1，外网填服务器公网IP或域名
3.端口：7000（须与M2Server网关端口一致）
4.客户端路径：浏览选中D:\LegendClient
5.资源读取规则→PAK：导入改好的Pak.txt，状态栏显示“密码正确”才能继续，显示“密码错误”回去查密码与路径
6.登录器选项：删掉多余检测目录；做纯微端勾“纯微端登录器”，填微端IP与端口（如127.0.0.1:8008）；非微端取消该勾，走本地全量补丁
7.列表地址：单机可留空或写本地txt；外网传ftp/http的serverlist.txt，模板：
标题分区标题区名127.0.0.170001127.0.0.180080
0
8.点“保存配置→生成登录器”，生成的.exe放进D:\LegendClient根目录，禁止放桌面或其他盘，否则读不到Data/Map。
七、服务端启动与联调顺序
1.启动DBServer→LoginGate→M2Server→GameGate
2.若用微端，先起UpdateServer_X64，确认“微端连接成功”
3.双击生成的登录器，列表展开、选区、进游戏
正常表现：登录界面加载NewUI、角色选择无白屏、进比奇装备怪物显示真彩、地图无透明块。异常对照：
•黑屏/透明装备：Pak.txt路径错或密码错
•全屏白屏：未升NewUI或UI升级失败
-地图缺失黑块：Map.txt路径错或未覆盖Map补丁
•列表读不到：serverlist.txt格式错或FTP权限问题
•微端不停下载：Resources目录名与登录器内补丁名不一致
八、单机与外网差异点
单机：IP全127.0.0.1，端口默认，不做微端也能跑，PAK全量放客户端。外网：必须微端或玩家预下完整补丁；列表文件传HTTP可访问地址；防火墙放行7000（M2）、8008（微端）、FTP端口；登录器生成时微端IP填公网IP，UpdateServer绑定0.0.0.0对应端口；PAK密码别外泄，避免素材被扒。
九、常见排错速查
•提示“PAK密码错误”：Pak.txt密码错、路径错、PAK文件损坏、GEE清洗密码未回写
•登录器闪退：客户端路径含空格或中文层级过深、MakeGameLogin版本过旧
-进游戏红问号：PAK未加载、StdItems与补丁Idx不匹配
•说话/音效缺失：Wav.txt未指Sound目录
•老地图花屏：Wil.txt/Wzl.txt路径未改，混用10周年与13周年客户端素材
照上述顺序：清文件→覆盖补丁→升UI→改五件txt→配微端→MakeGameLogin生成→起服务→进游戏，GeeM2单职业登录器与PAK链路全部打通，生成的登录器放客户端根目录直接双击即用。