传奇GEE引擎微端资源分发配置流程与资源索引制作以及加载异常排查教程

准备工作先整理好资源目录，GEE引擎微端分为服务端微端组件、资源列表文件、pak资源包、客户端基础文件，全部路径使用英文命名，不要加入中文和特殊符号，文件夹层级不要太深。确认引擎版本配套，低版本GEE引擎自带微端模块功能有限，优先使用支持微端自动分片的程序包，把微端服务程序放到引擎主目录下，和M2程序放在同一目录，同时准备好pak密码清单，所有pak包的密码要提前记录，后续资源列表需要填写对应密码，密码错误会导致资源无法读取。

打开GEE引擎自带的微端配置工具，先填写微端服务监听端口，端口不要和网关、登录器端口冲突，单机测试选用空闲端口，填写本机回环地址。资源根目录指向存放pak补丁的文件夹，工具会自动读取目录下的pak文件，也可以手动添加资源包，每一行填写pak文件名、pak密码、资源版本号。版本号用来做资源校验，每次更新补丁之后修改版本号，客户端会识别变动，自动拉取新资源，版本号不改动，客户端不会重新下载改动后的文件。全部pak添加完成之后生成资源索引文件，索引文件默认生成在微端程序目录，这个索引文件是客户端用来比对本地资源和服务端资源差异的核心文件。

接下来配置M2引擎内微端相关选项，打开M2，找到微端设置标签页，开启微端支持开关，填写微端服务地址和前面设置好的端口，勾选资源校验选项，资源校验开启之后客户端会比对文件md5值，文件不一致就自动下载。如果不需要严格校验可以关闭md5校验，只依靠版本号判断更新，关闭校验之后加载速度更快，修改补丁的时候不用重新生成md5，但是容易出现客户端资源错乱。里面还有分片大小设置，分片数值根据单文件大小调整，数值太小会拆分大量碎片，下载请求变多，数值太大单文件加载超时，常规设置选用默认分片参数即可。

配置登录器，打开登录器配置工具，找到微端选项卡，开启微端模式，填入微端服务地址和端口，同时导入刚才生成的资源索引文件。登录器里面还有基础客户端设置，设置基础客户端最小文件，基础客户端只保留主程序和少量核心文件，不需要打包全部补丁，缺失的资源会在登录进入游戏的时候从微端服务自动下载。设置下载线程数量，线程数量过高会占用较多带宽，单机测试线程数调低，稳定之后再调整。下载缓存目录由登录器自动管理，客户端本地缓存文件不要随意删除，反复删除缓存会每次进游戏都重新拉取全部资源。

启动顺序需要注意，先启动数据库和M2主引擎，M2完全启动完成之后，再启动微端服务程序，查看微端程序窗口日志，确认所有pak包加载成功，没有提示pak打开失败、密码错误。日志出现pak打开失败，回到微端配置工具核对pak文件名以及密码，文件名大小写也要保持一致。微端服务启动正常之后再启动网关，生成登录器，把登录器和精简客户端打包交给测试使用。

登录测试的时候打开登录器，登录器会先读取资源索引，对比本地缓存，缺失或者版本不一致的资源自动开始下载。进入游戏之后依次测试地图、装备外观、技能特效、UI素材，确认资源加载正常。常见问题有登录器一直卡在资源下载，先检查微端程序是否正常运行，端口是否被占用，防火墙拦截连接请求也会导致下载无进度。资源下载完成进游戏依旧花屏、装备不显示，大多是pak路径填写错误，或者资源索引没有重新生成，修改补丁之后没有更新版本号，客户端不会拉取新文件。部分素材加载缓慢，是资源包过大没有拆分，可以把高频使用的素材单独分到独立pak包，优先加载。

还有一种情况是微端下载完成，但是M2提示资源不匹配，这是md5校验开启之后，pak内部文件改动，md5值和索引记录不一致，两种处理方式，重新生成索引文件更新md5，或者在M2微端设置关闭md5校验。微端日志大量出现404提示，代表索引里面记录的pak文件在微端资源目录找不到，核对文件名称和存放位置。

补丁更新流程固定，替换或者新增pak资源之后，打开微端配置工具重新读取资源，修改版本号，重新生成索引文件，替换登录器里面的索引文件，重启微端服务程序，客户端再次登录就会识别更新。不要直接替换pak而不更新索引，客户端不会感知资源变动。所有配置调试完成，备份微端配置、资源索引文件以及整套pak资源，后续新增素材沿用这套配置流程，改动之后及时复测下载和外显效果。