剑侠传奇引擎检测装备已强化和可强化次数脚本完整写法与NPC配置详解

剑侠引擎检测装备强化状态的核心命令是CHECKITEMSTRENGTHENCOUNT，通过装备位置和检测类型两个参数区分是查询已强化次数还是查询剩余可强化次数。命令的第二个参数决定了检测方向，填0检测已经强化了多少次，填1检测还能强化多少次。下面是命令参数、脚本写法、实战NPC配置、数据库联动和常见错误的完整拆解。

## CHECKITEMSTRENGTHENCOUNT命令格式与参数

命令格式为CHECKITEMSTRENGTHENCOUNT 装备位置(0..15) 检测类型(0检测已强化，1检测可强化) (>,<,=,?) 数量。

第一个参数是装备位置，取值0到15，对应关系为：0盔甲，1武器，2照明物，3项链，4头盔，5右手镯，6左手镯，7右戒指，8左戒指，9护身符位置，10腰带，11鞋子，12宝石，13斗笠，14军鼓，15马牌。

第二个参数决定检测方向。填0时检测该装备已经强化了多少次，填1时检测该装备还可以强化多少次。这两个检测方向共用同一个命令，通过参数值区分，写脚本时容易搞混。

第三个参数是操作符，支持>、<、=、?四种。>检测大于，<检测小于，=检测等于，?在部分引擎版本中用于检测不等于或未强化状态。最常用的是>和<。

第四个参数是数量，取值范围0到255，表示要对比的强化次数。

命令必须写在#IF段落中作为条件判断，不能写在#ACT中执行。

## 基础检测脚本写法

检测左手镯已经强化次数是否超过8次：

```
[@main]
#IF
CHECKITEMSTRENGTHENCOUNT 5 0 > 8
#ACT
SENDMSG 5 检测到你的左手镯已强化次数超过了8次
```

命令中的5是装备位置，对应右手镯。0表示检测已强化次数，> 8表示超过8次。条件成立时执行SENDMSG 5发送提示消息。

检测左手镯还可以强化8次以上：

```
[@main_2]
#IF
CHECKITEMSTRENGTHENCOUNT 5 1 > 8
#ACT
SENDMSG 5 检测到你的左手镯还可以强化8次以上
```

同一位置5，第二个参数从0改成1，检测方向从已强化次数变为可强化次数。参数1表示查询剩余可强化空间，> 8表示剩余空间超过8次。

两个脚本段落可以合并在同一个NPC中，用不同的对话选项分别触发：

```
[@main]
你想查询装备的哪个强化状态？\
<查询已强化次数/@已强化>\
<查询可强化次数/@可强化>\

[@已强化]
#IF
CHECKITEMSTRENGTHENCOUNT 5 0 > 8
#ACT
SENDMSG 5 你的右手镯已强化次数超过8次
#ELSESAY
你的右手镯已强化次数不超过8次。

[@可强化]
#IF
CHECKITEMSTRENGTHENCOUNT 5 1 > 8
#ACT
SENDMSG 5 你的右手镯还可以强化8次以上
#ELSESAY
你的右手镯剩余可强化次数不足8次。
```

## 多位置批量检测脚本

实际版本中，玩家通常希望一次性查看全身装备的强化状态。把每个位置的检测段落并列写出：

```
[@全身检测]
#IF
CHECKITEMSTRENGTHENCOUNT 0 0 > 0
#ACT
SENDMSG 5 盔甲已强化：是
#IF
CHECKITEMSTRENGTHENCOUNT 1 0 > 0
#ACT
SENDMSG 5 武器已强化：是
#IF
CHECKITEMSTRENGTHENCOUNT 4 0 > 0
#ACT
SENDMSG 5 头盔已强化：是
#IF
CHECKITEMSTRENGTHENCOUNT 10 0 > 0
#ACT
SENDMSG 5 腰带已强化：是
#IF
CHECKITEMSTRENGTHENCOUNT 11 0 > 0
#ACT
SENDMSG 5 鞋子已强化：是
```

每个位置单独一段#IF检测，已强化次数> 0表示该位置装备有过强化操作。这种批量检测的缺点是脚本较长，每条检测都会输出一条消息，玩家需要逐条阅读。优化方式是只在装备确实强化过时才输出，没有强化的位置不加提示。

如果要在检测到强化次数后把数值保存到变量中供后续使用，可以结合CheckItemupgradeCount命令。该命令用于检测通过宝石升级装备的次数，格式为CheckItemupgradeCount 方式(0,1) 位置(0-12) 操作符(> = <) 次数(0-255)。方式=0时检测正在升级的装备，方式=1时检测人物身上的装备。它与CHECKITEMSTRENGTHENCOUNT的区别在于前者面向宝石升级系统的计数，后者面向强化系统的次数记录。实际使用时先确认当前版本的强化功能是基于哪套系统实现的。

## NPC强化NPC的完整脚本

把检测命令嵌入到强化NPC的逻辑中，在强化操作前先检测装备的当前强化状态和剩余可强化次数，防止玩家对已满强化装备浪费材料：

```
[@main]
欢迎来到装备强化使者处。\
<查看武器强化状态/@查看武器>\
<强化武器/@强化武器>\

[@查看武器]
#IF
CHECKITEMSTRENGTHENCOUNT 1 0 > 0
#ACT
CHECKITEMSTRENGTHENCOUNT 1 1 > 0
#ACT
SENDMSG 5 你的武器已经强化过，仍有可强化次数。
#ELSESAY
你的武器已强化但已达强化上限，无法继续强化。

[@强化武器]
#IF
CHECKITEMSTRENGTHENCOUNT 1 1 > 0
CHECKGAMEGOLD > 99999
#ACT
GAMEGOLD - 100000
UPGRADEITEMEX 1 0 0 1 0
SENDMSG 6 武器强化成功，攻击+1。
#ELSESAY
你的武器已达强化上限，或元宝不足。
```

先检测可强化次数是否大于0，大于0说明还有强化空间，再检测元宝是否足够，两个条件同时成立才执行扣费和升级操作。如果可强化次数为0，直接跳转到#ELSESAY提示已达上限。

## 强化上限与数据库联动

CHECKITEMSTRENGTHENCOUNT检测出的可强化次数上限不是脚本中硬编码的，由装备数据库中的字段决定。打开DBC2000数据库编辑器，进入HeroDB，找到StdItems.DB表，定位目标装备的记录，查看AniCount字段的值。

AniCount字段控制该装备的最大可强化次数。例如AniCount设置为10，表示该装备最多可以被强化10次。10次用完后，CHECKITEMSTRENGTHENCOUNT 位置 1 > 0的检测条件不再成立，脚本进入失败分支。

升级宝石的AniCount字段同样控制宝石的适用范围。AniCount=10的宝石只能用于升级强化次数小于10的装备，对已经强化满10次的装备使用该宝石不会产生效果。这个机制与CHECKITEMSTRENGTHENCOUNT的检测结果直接对应，脚本中检测到的可强化次数本质上就是AniCount减去已强化次数的差值。

## 引擎兼容性与替代命令

CHECKITEMSTRENGTHENCOUNT在剑侠引擎、铁血引擎、AppleM2引擎中均有支持，命令名称和参数格式一致。部分引擎版本中该命令被写作CHECKITEMSTRENGTHENCOUNT，全部大写；另一些版本支持大小写混合写法CheckItemStrengthenCount。建议统一使用全大写格式，兼容性最广。

如果当前引擎版本不支持CHECKITEMSTRENGTHENCOUNT，可以用CheckItemupgradeCount作为替代。两者的参数格式不同，CheckItemupgradeCount需要指定检测方式（0或1）来区分是检测升级框内的装备还是人物身上的装备，而CHECKITEMSTRENGTHENCOUNT直接按装备位置检测人物身上的装备。

在QFunction.txt的@ItemUpgrade触发段中，CheckItemupgradeCount的典型用法是：

```
[@ItemUpgrade]
#IF
CheckItemUpgradeCount 0 1 > 10
#SAY
你的武器已经升级了10次以上。
```

方式参数写0时检测升级框内正在操作的装备，适合在宝石升级界面中使用。

## 常见错误与排查

检测结果始终不成立，先确认装备位置的编号是否写对。检测武器用位置1，检测盔甲用位置0，检测头盔用位置4，写错位置会导致检测的是其他装备甚至空栏位。空栏位上的检测结果始终为不成立。

第二个参数写反是高频错误。0是检测已强化次数，1是检测可强化次数。脚本中检测“能不能继续强化”应该用参数1，检测“已经强化了多少”应该用参数0。两个参数搞反后，检测逻辑完全颠倒。

操作符使用?号在部分引擎版本中不被支持。如果服务端引擎不支持?操作符，改用=检测等于0的方式判断未强化状态。

脚本文件必须保存为ANSI编码。用记事本另存为时在编码下拉菜单中选ANSI，选UTF-8会导致中文提示乱码，虽然英文命令CHECKITEMSTRENGTHENCOUNT本身不受影响，但脚本中的中文内容解析错误可能导致整段脚本执行中断。

修改脚本后重启M2Server，或在控制台执行@ReloadManage重新加载Market_Def目录下的NPC脚本。修改StdItems.DB中的AniCount字段后，需要在M2控制台重载物品数据库才能让新的强化上限生效。