Hero 的补丁链路：地图、装备、怪物外观三处最易漏

Hero 引擎本身不复杂，麻烦的是补丁。版本里新加了地图、新加了装备、换了怪物外观，服务端能跑，客户端一进去却是黑屏、白图、或者只显示一个方框。这类问题九成不是引擎的错，是补丁链路断在了某一层。

一、补丁不是把文件塞进去

一条补丁要同时在三个地方存在：客户端目录里的资源文件、服务端里的配置和编号、以及登录器或微端的分发列表。三处对不上，客户端就渲染不出来。

很多人只做了第一步，把文件复制进 Data 目录，然后进游戏发现没变化。原因通常是编号没改，或者微端列表里没有这个文件，客户端根本不加载。

所以补丁这件事要按“资源、编号、分发”三层来检查，一层一层过，不要凭感觉。

二、地图：地图文件、小地图、传送点

一张新地图至少涉及三个文件：地图本体、小地图、以及地图上的传送点和刷怪配置。

地图本体放进客户端的 Map 目录，小地图通常是单独的图，放在指定目录，命名规则按引擎要求来。少了小地图，玩家按 Tab 看到的是黑块，会以为地图没装。

还有一点容易漏：地图编号。服务端里写的是编号，客户端加载的是按编号命名的文件。编号写错一位，进去就是黑屏，而且服务端不会报错，因为它认为地图存在。

检查方法很简单：把服务端配置里的地图编号抄下来，去客户端目录里找同名文件。找不到，就是编号对不上。

三、装备：外观代码与物品表对齐

装备显示靠的是外观代码。物品表里写着这件装备用哪个外观，客户端按这个外观去资源里找贴图。代码写错，就是白图或者一个方框。

常见错误有三个：外观代码超出了客户端资源的最大编号、两件装备用了同一个代码、以及新增装备忘了同步到微端列表。

第二个错误最隐蔽。两件装备用同一个外观，客户端不报错，玩家只会觉得“这两件装备长得一样”，很难联想到是配置问题。所以新增装备时要把外观代码记在一张表里，避免重复。

还有一个细节：装备的地面显示和穿戴显示可能用不同代码。只改了一个，会出现“地上看着正常，穿上就变框”的情况。

四、怪物：外观、动作、声音

怪物比装备多一层：动作。一个怪物外观通常包含站立、行走、攻击、死亡几组图，少一组，怪物就会卡在某个动作上不动。

表现出来是：怪物能看见，但打它不动，或者它一直站在原地。玩家会以为是卡怪，其实是动作资源缺失。

声音也是同理。声音文件缺失不会导致黑屏，但会让打怪毫无反馈，体验差很多。补怪物的时候顺手把声音一起补上，成本很低。

如果用的是现成的怪物资源包，注意它的编号区间有没有和你已有的冲突。冲突之后表现是怪物变成另一个样子，很难查。

五、三层对齐的检查顺序

顺序是：先资源、再编号、最后分发。

资源层：客户端目录里有没有这个文件，文件名对不对，大小是不是明显偏小（偏小说明复制不完整）。

编号层：服务端配置里的编号，和资源文件名是否一致；物品表、怪物表、地图配置三处是否互相引用正确。

分发层：微端或登录器的文件列表里有没有这一项，版本号有没有加一。列表没更新，客户端永远拿不到新文件。

三层都过还出问题，再去看客户端本身是不是旧版。有些玩家用的是很久以前的客户端，缺的文件太多，只能重装。

六、微端和完整客户端的差别

完整客户端是把所有资源放在本地，微端是按需下载。微端的好处是玩家进服快，坏处是任何一个文件没进分发列表，玩家就永远看不到。

所以用微端时，补丁流程要多一步：把新文件加进分发列表，并且确认版本号变了。版本号不变，客户端不会去比对文件，等于白传。

还有一个坑是缓存。客户端本地有旧文件时，可能优先用缓存。测试时最好用一台干净的机器，把客户端缓存清掉再看，否则你看到的是旧效果。

七、三个症状对应三处漏

进图黑屏。地图资源缺失或者编号不对，先查 Map 目录。

装备显示成方框。外观代码超出范围或者资源没进客户端，先查物品表的外观字段。

怪物站着不动。动作资源缺失，先查怪物外观包是否完整。

三个症状对应三个层，按这个对应关系查，比漫无目的地重装客户端快得多。

八、上线前的验收

验收不要只看自己的机器。找一台没装过这个版本的干净电脑，完整走一遍：装客户端、进游戏、进新图、穿新装备、打新怪。

五项都正常，再让几个玩家试。玩家机器上的分辨率、系统版本、杀毒软件都可能影响加载，这些问题只有真实环境才暴露得出来。

补丁链路理顺一次，后面加内容就快了。真正费时间的不是加，是每次都在同一个地方漏。