先确认单机版本已经可以正常登录游玩,注册、创建角色、地图传送、NPC功能全部没有异常,再开始配置微端,版本本身存在故障的情况下,微端调试会很难定位问题。准备配套的微端网关程序,GOM微端网关和登录网关、游戏网关是独立程序,不能混用其他引擎的微端组件,同时准备微端资源打包工具,用来生成微端资源包。
整理客户端资源目录,把需要微端分发的素材归类,data、map、wav等文件夹单独整理,不要放入无关文件。微端工具读取素材的时候,路径不能带有中文,全部使用英文路径,素材文件名不要有特殊符号。打开微端打包工具,选择客户端根目录,设置资源版本号,版本号每次更新素材之后都要递增,登录器会对比版本号判断是否需要下载新资源。打包完成之后生成微端资源文件夹,把这个文件夹放到微端网关指定读取目录,不要随意修改里面的文件结构。
找到微端网关配置文件,打开配置文本,首先设置监听IP,单机测试填写127.0.0.1,局域网给其他人使用,填写主机内网IP,外网环境填写外网IP。设置微端端口,端口避开登录网关、游戏网关已经占用的端口,记录好微端端口。配置里面填写微端资源读取路径,指向刚才打包好的资源目录,路径写法严格按照网关要求,路径写错会提示找不到资源,玩家登录之后无法下载素材。同时核对微端网关密钥,这个密钥后面要和登录器里面的微端密钥保持一致,密钥不一致会连接微端失败。保存配置文件,右键微端网关以管理员身份运行,观察网关控制台,显示监听成功代表网关启动正常,出现端口占用就更换端口。
打开GOM登录器配置工具,找到微端相关设置板块,勾选启用微端模式。填入微端网关IP、微端端口,粘贴和微端网关完全相同的密钥,填写资源版本号,版本号必须和打包工具设置的版本号一致。微端模式下可以选择两种方式,一种是纯微端,客户端只保留少量基础文件,其余素材登录后按需下载;另一种是微端加补丁,自带部分基础素材,缺失的再从微端拉取。不要同时开启无关的资源校验,部分校验功能会和微端下载冲突,导致下载中断。设置完成之后重新生成登录器,旧登录器没有微端配置,无法触发微端下载逻辑。
主机防火墙放行微端端口,新建TCP入站规则,填写微端网关使用的端口。局域网环境不用路由器映射,外网环境需要在路由器虚拟服务器或者安全组里面添加微端端口映射,否则外部玩家连接不上微端网关。防护软件把整个微端网关目录加入信任列表,防止网关进程被隔离,下载线程被拦截。
测试微端效果,准备一份精简客户端,只保留登录器和必要的基础文件,删掉map、data里面大部分素材。打开登录器,选择分区登录,进入游戏之后,切换地图、打开装备面板,微端网关控制台会出现下载日志,代表素材正在下发。切换地图的时候黑屏,但是网关没有下载日志,优先核对登录器微端IP、端口、密钥;网关有下载日志,但是下载很慢或者报错,检查资源路径、素材打包是否完整。
素材更新操作,修改装备外观、地图、特效之后,需要重新用打包工具打包素材,版本号往上加,替换微端网关里面的资源包,再重新生成登录器更新版本号。只替换素材不改动版本号,登录器识别不到资源变动,不会重新下载。
微端常见故障区分,登录器提示连接微端服务器失败,重点检查微端网关是否启动、监听IP端口、密钥、防火墙;能连上微端但是不下载素材,核对资源目录路径、打包工具输出目录;下载一半断开,检查网关连接数设置,调高最大下载线程,同时检查带宽。微端网关不要和M2、登录网关放在同一个进程,分开独立启动,微端网关崩溃不会影响游戏登录。
多分区使用微端,多个分区可以共用一套微端网关和资源包,只要版本素材一致,不用每个区单独搭建微端。素材不一样的分区,需要搭建独立微端网关,使用不同端口,登录器对应切换微端地址。
调试的时候优先单机测试,单机微端下载正常,再测试局域网,最后外网。每次修改微端网关配置、重新打包素材,都要关闭微端网关再重新启动,热加载不会刷新资源索引。微端网关日志是排查核心,所有下载请求、失败提示都会打印在控制台,根据日志定位素材缺失、路径错误、连接拒绝这类问题。
整理客户端资源目录,把需要微端分发的素材归类,data、map、wav等文件夹单独整理,不要放入无关文件。微端工具读取素材的时候,路径不能带有中文,全部使用英文路径,素材文件名不要有特殊符号。打开微端打包工具,选择客户端根目录,设置资源版本号,版本号每次更新素材之后都要递增,登录器会对比版本号判断是否需要下载新资源。打包完成之后生成微端资源文件夹,把这个文件夹放到微端网关指定读取目录,不要随意修改里面的文件结构。
找到微端网关配置文件,打开配置文本,首先设置监听IP,单机测试填写127.0.0.1,局域网给其他人使用,填写主机内网IP,外网环境填写外网IP。设置微端端口,端口避开登录网关、游戏网关已经占用的端口,记录好微端端口。配置里面填写微端资源读取路径,指向刚才打包好的资源目录,路径写法严格按照网关要求,路径写错会提示找不到资源,玩家登录之后无法下载素材。同时核对微端网关密钥,这个密钥后面要和登录器里面的微端密钥保持一致,密钥不一致会连接微端失败。保存配置文件,右键微端网关以管理员身份运行,观察网关控制台,显示监听成功代表网关启动正常,出现端口占用就更换端口。
打开GOM登录器配置工具,找到微端相关设置板块,勾选启用微端模式。填入微端网关IP、微端端口,粘贴和微端网关完全相同的密钥,填写资源版本号,版本号必须和打包工具设置的版本号一致。微端模式下可以选择两种方式,一种是纯微端,客户端只保留少量基础文件,其余素材登录后按需下载;另一种是微端加补丁,自带部分基础素材,缺失的再从微端拉取。不要同时开启无关的资源校验,部分校验功能会和微端下载冲突,导致下载中断。设置完成之后重新生成登录器,旧登录器没有微端配置,无法触发微端下载逻辑。
主机防火墙放行微端端口,新建TCP入站规则,填写微端网关使用的端口。局域网环境不用路由器映射,外网环境需要在路由器虚拟服务器或者安全组里面添加微端端口映射,否则外部玩家连接不上微端网关。防护软件把整个微端网关目录加入信任列表,防止网关进程被隔离,下载线程被拦截。
测试微端效果,准备一份精简客户端,只保留登录器和必要的基础文件,删掉map、data里面大部分素材。打开登录器,选择分区登录,进入游戏之后,切换地图、打开装备面板,微端网关控制台会出现下载日志,代表素材正在下发。切换地图的时候黑屏,但是网关没有下载日志,优先核对登录器微端IP、端口、密钥;网关有下载日志,但是下载很慢或者报错,检查资源路径、素材打包是否完整。
素材更新操作,修改装备外观、地图、特效之后,需要重新用打包工具打包素材,版本号往上加,替换微端网关里面的资源包,再重新生成登录器更新版本号。只替换素材不改动版本号,登录器识别不到资源变动,不会重新下载。
微端常见故障区分,登录器提示连接微端服务器失败,重点检查微端网关是否启动、监听IP端口、密钥、防火墙;能连上微端但是不下载素材,核对资源目录路径、打包工具输出目录;下载一半断开,检查网关连接数设置,调高最大下载线程,同时检查带宽。微端网关不要和M2、登录网关放在同一个进程,分开独立启动,微端网关崩溃不会影响游戏登录。
多分区使用微端,多个分区可以共用一套微端网关和资源包,只要版本素材一致,不用每个区单独搭建微端。素材不一样的分区,需要搭建独立微端网关,使用不同端口,登录器对应切换微端地址。
调试的时候优先单机测试,单机微端下载正常,再测试局域网,最后外网。每次修改微端网关配置、重新打包素材,都要关闭微端网关再重新启动,热加载不会刷新资源索引。微端网关日志是排查核心,所有下载请求、失败提示都会打印在控制台,根据日志定位素材缺失、路径错误、连接拒绝这类问题。

