传奇服务器统计宝石升级装备次数脚本写法 记录升级次数变量读取与校验方案

传奇使用宝石升级装备场景，想要统计玩家利用宝石升级装备的总次数，可以依靠人物变量记录，搭配升级NPC脚本完成计数，每次成功升级后自动累加次数，还可以增加查询、次数上限限制功能，整套逻辑在NPC对话脚本内编写，配合全局变量可做排行统计，修改脚本前备份Mir200脚本文件，防止语法错误造成M2加载异常。

升级NPC核心逻辑，玩家点击升级选项，首先执行物品检测，判断背包内是否存在对应升级宝石，同时检测装备是否在身上或者背包。宝石数量不足直接弹出提示，终止后续流程。宝石条件满足后，执行扣除宝石操作，接着执行装备升级指令。升级分为成功和失败两种分支，计数规则可以按需设定，仅升级成功才累加次数，或是无论成败都计入总尝试次数，两种方案的判断位置不一样。

只统计升级成功次数，将计数累加代码放在升级成功的标签内。升级成功之后，读取人物自定义变量，变量原有数值加一，再把新数值回写到变量内。变量选用人物私有变量，每个玩家独立存储，小退不会清空，服务器重启之后数据依旧保留，适合长期累计升级次数。变量初始值默认为0，玩家第一次完成升级，数值变为1，后续每次成功持续叠加。

如果需要统计包含失败在内的全部尝试次数，累加代码放在扣除宝石之后，升级判定之前，只要消耗宝石进行一次升级操作，无论装备是否升级成功，次数都会增加。这种方式适合统计玩家消耗宝石的总量，用来做累计消耗类奖励。

增加次数查询功能，在NPC对话面板增加查询选项，点击后读取存储升级次数的人物变量，将数值输出到游戏消息窗口，玩家可以随时查看自己累计的宝石升级装备次数。还可以增加次数上限控制，设置最大升级次数，执行升级前先读取变量，当次数已经达到设定上限，直接提示玩家已达到本轮升级上限，不再允许使用宝石升级，不扣除背包内宝石。

扩展功能可增加按装备类型分别计数，区分武器升级、首饰升级、衣服升级，使用多组独立变量，武器升级成功只累加武器计数变量，首饰升级单独累加首饰计数。需要在脚本内增加装备类型检测，读取待升级装备的物品类型，匹配对应分支再执行变量累加。

跨角色统计需要用到全局变量，全局变量记录全服所有玩家宝石升级总次数，每次任意玩家升级成功，全局变量同步加一。全局变量保存在服务端，适合制作全服进度、全服累计目标，全局变量在服务器重启后会重置，长期统计不建议单独使用全局变量，人物私有变量稳定性更高。

读取次数用于奖励发放，在NPC内增加领取奖励分支，读取升级次数变量，判断数值是否达到奖励门槛，满足条件即可领取对应道具，领取完成后可以选择保留次数继续累计，或是清零变量开启新一轮统计。领取奖励时增加标记变量，防止重复领取同一档位奖励。

调试阶段，在脚本内添加消息输出，每次升级完成打印当前累计次数，测试升级成功、失败两种场景，核对变量数值变化是否符合预期。测试完成后删除调试输出语句，避免大量日志写入，减轻服务端压力。重载M2脚本即可生效，无需重启整套服务程序。

常见故障排查，升级完成次数不增加，优先检查累加代码放置位置，成功计数的代码写在失败分支就不会生效。小退之后次数归零，说明使用了临时变量，需要更换持久型人物私有变量。部分玩家计数异常，检查变量初始值，异常数值可以通过GM指令直接修改人物变量，修正错误计数。多人同时升级出现计数错乱，多为误用全局变量记录单人数据，单人记录必须使用人物私有变量。

区分宝石升级和普通黑铁矿石升级，两套升级流程独立，不要共用同一套计数变量。如果玩家使用不同类型宝石升级，想要分开统计，增加物品名称检测，识别宝石种类，不同宝石对应不同计数变量。

数据查看方式，除游戏内NPC查询，也可以直接读取人物变量存储文件，在服务端后台查看所有玩家的宝石升级次数，方便核对数据。批量清理计数，可以编写GM脚本命令，一键将指定玩家或者全体玩家的升级次数变量重置为0，用于开启新一轮活动。

编写脚本时做好分支判断，扣除宝石的代码放在升级判定之前，防止升级失败宝石被扣除。变量累加代码放在升级成功指令之后，保证只有真正生效的升级才计入统计。做好逻辑顺序，避免出现扣宝石不计数，或者计数成功装备没有升级的异常情况。