传奇单机版改了装备属性怎么不刷新？排查一下午终于找到原因

a6232173

最近在调传奇单机版的装备鉴定系统，写了个脚本，功能是鉴定装备后随机给1-3条附加属性。脚本写完跑了一下，M2日志显示属性确实写进去了，SetItemBind、CHANGECUSTOMITEMVALUE这些命令执行都没报错——但你猜怎么着？打开背包一看，装备上还是原来的属性，一条都没变。

我当时以为是自己眼花了，关了背包重新打开，还是不显示。换个地图、小退再进、甚至大退重登——属性刷出来了。

这就奇怪了。M2那边明明已经生效，客户端就是没刷新。我花了整整一个下午排查这个问题，最后发现原因真的让人想摔键盘。

问题复现

先把我出问题的脚本片段贴出来，给大家看看坑在哪：

1. [@鉴定装备]
2. #ACT
3.     Lock**Item boxitem0
4.     ; ... 随机属性计算逻辑 ...
5.     SetCustomItemAbil boxitem0 0 1 0 250
6.     SetCustomItemAbil boxitem0 0 1 1 3
7.     SetCustomItemAbil boxitem0 0 1 2 2
8.     ReturnBoxItem 0
9.     SENDMSG 7 鉴定成功！

复制代码

逻辑看着没毛病对吧？锁定装备→写属性→归还到背包。但属性就是不刷新。

排查过程

第一步我以为是属性写失败了。用M2自带的物品查询功能查了一下被鉴定装备的数据，发现自定义属性确实已经写入了数据库，值也对。排除"没写入"这个可能性。

第二步怀疑是客户端缓存问题。把传奇单机版客户端完全退出，删除Data目录下的缓存文件，重新登录——属性刷出来了。但这显然不是正常玩法需要的效果，总不能每次鉴定完让玩家大退吧。

第三步查翎风引擎文档。看到这么一句话："关联类的脚本命令，例如SetCustomItemAbil、SetItemBind等，每条属性设置后建议配合UpdateItem命令刷新客户端显示。" 关键词是"每条属性设置后"——我的脚本一口气写了3条属性，但只在最后调了一次ReturnBoxItem，中间没有调用任何更新命令。

关键发现：Lock**Item 才是罪魁祸首

其实ReturnBoxItem理论上应该触发客户端刷新——物品从OK框归还到背包，客户端会重新加载该物品的数据。但为什么我的脚本里它不干活呢？

我去翎风论坛搜了一下类似问题，发现有版主直接回了一句："Lock**Item boxitem0 删掉，不要乱用。"

原来Lock**Item这个命令在锁定物品的同时，会阻塞客户端对该物品的更新通知。你后面写属性、归还物品，客户端这边是"收不到更新信号"的。所以必须把Lock**Item删掉，然后在每条属性设置后加上UpdateItem。

修复后的脚本

1. [@鉴定装备]
2. #ACT
3.     ; 不再 Lock 物品，改为逐条属性写入后立即刷新
4.     SetCustomItemAbil boxitem0 0 1 0 250
5.     UpdateItem boxitem0
6.     SetCustomItemAbil boxitem0 0 1 1 3
7.     UpdateItem boxitem0
8.     SetCustomItemAbil boxitem0 0 1 2 2
9.     UpdateItem boxitem0
10.     ReturnBoxItem 0
11.     SENDMSG 7 鉴定成功！

复制代码

三条属性，每条后面跟一个UpdateItem，最后再ReturnBoxItem。这样客户端会收到三次更新信号，最终显示的属性就是最新的。

实测跑了一下，鉴定完打开背包，属性秒刷新，再也不用大退重登了。

总结：传奇单机版属性不刷新的三种情况

这个排查过程让我总结出属性不刷新的三种常见原因：

第一种，Lock**Item滥用。新手写装备操作脚本，自然而然地觉得"先锁定再修改"比较安全，殊不知这个命令会阻塞客户端更新。除非你真的需要防止多人同时操作这件装备（单机版基本不存在这需求），否则不建议用。

第二种，多条属性写入缺少多次UpdateItem。SetCustomItemAbil每调用一次，客户端不会自动刷新——需要主动调UpdateItem通知客户端"这个物品变了，重新加载一下"。写几条属性就调几次UpdateItem。

第三种，ReturnBoxItem之后再写属性。有些人先ReturnBoxItem把物品还回去，然后再用SetCustomItemAbil修改。这时候物品已经不在OK框了，修改操作作用于一个不存在的引用，自然无效。顺序必须是：写属性→UpdateItem→归还。

额外彩蛋：装备扔地上捡起来就刷新了，这印证了什么？

如果你遇到属性不刷新的问题，把装备扔地上再捡起来就能看到——这说明属性数据本身是写正确了的，问题纯粹出在客户端刷新环节。地上捡起的物品相当于重新从数据库加载了一次，所以属性完整显示。

所以遇到类似问题不用慌，排查方向就是：数据写没写进去→客户端有没有收到更新通知→有没有Lock阻塞了更新。按这个顺序检查，十分钟内肯定能找到原因。

玩传奇单机版改端就是这样，有时候不是引擎不行，是被自己写的代码坑了一下午。有类似问题的留言讨论，看到就回。