一、首要修复：NewUI资源升级（高频原因）
GEE引擎白屏最常见的原因是UI资源文件不匹配。服务端更新了引擎程序（M2Server），但登录器配套的UI文件未同步更新。
1. 获取修复工具：下载与你当前引擎版本配套的GEE引擎包（通常服务端内自带或需从官网下载对应版本）。
2. 执行升级：解压引擎包，进入“登录器”文件夹，运行 “自定义UI升级工具.exe”（部分版本命名为“白屏修复工具”）。
3. 选择路径：工具中浏览选择你的服务端目录下的 MirServer\登录器\NewUI 文件夹，点击“升级”或“开始”。
4. 重新生成：升级完成后，必须重新打开登录器生成器，生成新的登录器放入客户端。直接使用旧登录器无效。
二、客户端与补丁路径排查
登录器无法读取正确的界面素材，也会导致渲染白屏。
- 客户端纯净度：使用完整版传奇客户端（如17周年、20周年）。避免使用被其他版本覆盖过的客户端或微端残端。
- 补丁读取顺序：检查登录器配置器中的“客户端搜索规则”。确保补丁目录（如 D:\热血传奇\Data）设置正确。若配置了自定义补丁文件夹（如 geem2），需确认该文件夹已正确放入客户端根目录，且登录器配置的“资源读取规则”指向正确。
三、登录器配置器参数检查
配置生成登录器时的设置错误是导致白屏的隐性原因。
1. 分辨率适配：在登录器配置器的“客户端选项”中，检查分辨率设置。部分老版本服务端不支持过高分辨率（如1920x1080），尝试修改为 800x600 或 1024x768 窗口模式测试。
2. UI版本锁定：若更新NewUI后出现按钮错位，需在配置器的“界面编辑”中，检查主界面控件的坐标是否适配当前分辨率，或回退使用服务端原版的UI文件。
四、PAK密码与资源完整性
若白屏伴随M2Server控制台报错（如“密码错误”），需检查资源文件。
- PAK文件验证：打开登录器生成器，找到“Pak.txt”或“资源读取规则”界面，点击“检查密码”。确保所有PAK文件的密码状态为“密码正确”。若有文件显示“文件不存在”或密码错误，需从完整服务端补丁中重新拷贝对应的PAK文件到客户端。
五、特殊场景：微端与网络白屏
• 微端连接失败：若使用微端模式，白屏可能是微端服务器未启动或连接失败，导致界面素材无法下载到本地。检查微端网关（GameGate）是否正常运行，以及客户端登录器列表中的微端IP是否配置正确。
- 缓存冲突：删除客户端目录下的 Cache（缓存）文件夹和 geem2.lic（许可文件），重新生成登录器运行。
修复优先级：优先执行 NewUI升级 + 重新生成登录器，此步骤解决80%以上的白屏问题；若无效，再按顺序排查客户端纯净度与PAK密码。
