1.76传奇架设四格不显示 补丁代码添加后失效排查流程

先区分客户端和服务端的逻辑，四格面板能不能正常显示，优先是客户端资源问题，服务端代码只负责控制四格功能开关，单纯添加服务端脚本，缺少对应客户端素材，面板依旧不会加载出来。很多人只照着网上的内容添加脚本，忽略补丁文件，这是加完代码依旧不显示的主要原因。

首先核对补丁文件，四格对应的素材文件包含UI界面图、物品图标、界面配置文本，需要放到客户端对应的目录。常见的四格补丁文件，stateitem、Items、DnItems这组图片文件，还有UI文件夹里的四格界面配置文件，没有放到正确路径，游戏内不会渲染面板。放完补丁之后，要确认客户端没有pak加密校验，部分登录器会校验补丁文件，外部补丁直接放进去会被拦截，文件加载失败，界面就无法调出。

接着查看UI配置文件，很多旧的四格扩展，需要在UI文本里注册四格窗口，网上流传的代码大多只是服务端的功能开启脚本，没有配套的UI注册段。如果UI配置里没有定义四格窗口ID、窗口坐标、素材引用，就算服务端开启四格权限，客户端没有对应的界面定义，点击按钮没有反应，面板空白或者直接不弹出。核对UI配置的时候，注意窗口编号不要和其他界面冲突，编号重复会造成界面互相覆盖。

然后检查M2引擎功能选项，打开引擎控制器，找到界面扩展、装备栏扩展相关设置，查看四格扩展选项是否勾选。部分引擎自带四格开关，脚本代码只是辅助，引擎面板没有开启对应扩展，脚本指令不会生效。不同引擎的设置位置不一样，有的在功能参数，有的在界面设置分类，修改引擎选项之后，需要完全关闭引擎和登录器，重新启动服务端再登录测试，热重载一般不会刷新UI扩展。

再核对NPC命令或者面板调用按钮，四格界面需要有触发入口，常见是在装备面板增加按钮，或者通过NPC命令打开。如果只是开启了四格功能，没有添加打开四格的按钮，玩家找不到入口，会误以为四格没有加载。网上的代码有的只开启属性生效，没有附带调用面板的触发脚本，这种情况四格的属性加成后台正常生效，但是界面看不到。可以在聊天框输入对应的测试命令调用窗口，测试命令能否调出界面，命令能调出，就是按钮配置缺失。

素材版本匹配问题也很常见，1.76原版客户端界面分辨率和扩展四格素材分辨率不统一，素材尺寸不对，引擎识别不到图片，直接跳过加载。下载补丁的时候，确认素材适配当前引擎对应的客户端版本，高分辨率素材放在老版客户端，会出现加载失败。替换素材之后，最好清理客户端缓存，缓存残留旧界面配置，会覆盖新补丁内容。

还要检查物品数据库，四格位置的装备，需要在DB数据库里面设置对应的装备位置字段，字段数值对应四格栏位编号。数据库字段不对，就算界面出来，装备放不进去，也容易被当成四格没显示。部分网上的脚本只开启面板，没有同步修改DB的装备位置参数，装备无法佩戴，栏位是空的。

如果补丁和UI都放好，引擎选项勾选，脚本也添加完成，依旧无法显示，排查登录器配置。登录器列表里面的补丁加载顺序有要求，四格补丁要排在基础补丁之后，补丁顺序颠倒，资源加载顺序错乱，界面渲染失败。加密pak模式下，需要把四格素材打包进pak文件，并且在登录器配置文件内添加pak路径和密码，直接散放补丁文件不会被读取。

还有一种情况是脚本冲突，服务端里面其他界面扩展脚本、背包扩展脚本，和四格窗口脚本占用同一个钩子，脚本互相冲突，导致四格初始化失败。可以把新增的四格脚本单独放到一个空白测试端，只保留基础1.76内容，测试能不能正常显示，测试端正常，说明原版本内其他扩展脚本冲突，需要逐个注释排查冲突脚本。

全部配置完成之后，测试步骤要规范，完全关闭引擎，重新启动服务端，退出客户端，重新打开登录器进入游戏，不要用在线重载M2的方式测试UI扩展。进入游戏先看基础装备栏，再尝试调用四格面板，观察是完全没有窗口，还是窗口黑屏。黑屏代表素材缺失或者路径错误，完全不弹出代表窗口没有注册、引擎扩展未开启或者调用命令无效。