996引擎检测当前宝石升级装备的名字CheckUpgradeItemName命令用法

做宝石升级玩法时，经常有个需求：玩家往升级界面放装备和宝石，脚本得知道他这次到底升的是哪件装备、放的是哪颗宝石，才能限定只让升指定武器。996引擎的检测当前宝石升级装备的名字就是回答这个问题的，用CheckUpgradeItemName一条命令就能把升级界面上的物品读出来。

检测当前宝石升级装备的名字对应CheckUpgradeItemName命令，格式带位置和名字两段，位置决定读的是升级装备还是左边那格宝石。做宝石升级装备检测时，把它放进升级触发段，就能在玩家点升级那一刻判断当前物品对不对。

格式与参数

CheckUpgradeItemName的格式是命令加位置再加物品名字：

CheckUpgradeItemName 位置(0-1) 名字

官方帮助文档给出的说明是位置0为升级装备的名字，位置1为左边一格宝石的名字。文档同时特别提示，这个命令只能在QFunction中的[@ItemUpgarde]触发段下执行。

参数对照表

做升级界面物品判断时，位置填0校验升级装备，填1校验宝石。这个命令是检测命令，写在#IF条件段，条件成立即代表当前升级界面上对应位置放的就是你写的那个名字。

实操示例

按官方文档给出的完整示例，升级段里先判断金币再判断装备，条件不满足就提示：

[@ItemUpgrade]
#IF
CheckGold 5000
CheckUpgradeItemName 0 裁决之杖
#ACT
Take 金币 5000
#ELSESAY
只能升级裁决之杖,或者你没有5000金币.
#ELSEACT
SetUpgradeFail
Break

这段里CheckUpgradeItemName参数0接裁决之杖，表示当前升级装备必须是裁决之杖，配合金币判断一起卡条件；不满足就走#ELSESAY提示，失败时接SetUpgradeFail并Break结束。想限定宝石，就把位置改成1再写宝石名字。

命令对比

CheckUpgradeItemName和装备升级次数检测命令是配合关系：这个命令负责读出当前升的是哪件物品，升级次数检测负责数这件装备已经升过几次。做升级界面物品判断用CheckUpgradeItemName，数升级档位用另一个命令，两个方向不冲突。

高频误操作

• 在普通NPC段里直接写这个命令：文档明确它只能在QFunction的[@ItemUpgarde]段下执行，放在别的段不生效。
• 位置填反：位置0是升级装备、1是左边宝石，填反了读出来的物品对不上。
• 忘记接失败分支：条件不满足时要走#ELSESAY提示，否则玩家点升级没反应。

常见报错

命令写了没反应

先确认是不是放在QFunction的[@ItemUpgarde]段下，放在普通NPC对话段或机器人段都不会触发；再看位置参数填的是0还是1，和你要校验的物品对应得上。

条件成立但提示不对

检查物品名字写得和数据库里是否完全一致，多字少字、繁简不一致都会导致比对不上；名字对不上时条件不成立，自然走到提示分支。

常见疑问

1. 问：宝石镶嵌功能怎么操作？

答：开通镶嵌功能后可用<ItemShow:D:F:X:Y:B>格式显示物品图标和数量，数据库里增加宝石记录，宝石的Shape值控制镶嵌属性类型，鼠标放上去会显示物品属性。镶嵌界面里当前升级装备和宝石的读取，就靠CheckUpgradeItemName按位置取名字。（来源：Gomkey，2019-03检索，已去隐私）

2. 问：清除宝石属性会不会把极品也清掉？

答：会。清除操作不区分极品和普通，所有通过宝石加上去的升级属性都会一起消失。所以在做清除前，建议先用CheckUpgradeItemName确认当前升级的是哪件装备，避免误清掉不想动的极品。（来源：看云，2026-03检索，已去隐私）

3. 问：沙巴克升级武器、沙炼武器脚本怎么写？

答：可以用GMEXECUTE supermake加参数实现，参数控制是否必定失败破碎，可自定义升级所需物品与条件，破碎触发段据此提示并回收武器。升级触发段里同样用CheckUpgradeItemName校验当前升的是不是指定武器。（来源：bluem2，2021-04检索，已去隐私）

4. 问：CheckUpgradeItemName能放在NPC对话里用吗？

答：不能。文档明确这个命令只能在QFunction的[@ItemUpgarde]升级触发段下执行，放在普通NPC段或机器人定时段都不会生效；要读升级界面物品，就把判断写进升级触发段。

5. 问：位置0和位置1分别读什么？

答：位置0读的是当前升级装备的名字，位置1读的是左边那一格宝石的名字。限定只让升某件装备填0写装备名，限定用某颗宝石填1写宝石名。

6. 问：想限定只能升级裁决之杖怎么写？

答：在[@ItemUpgrade]段的#IF条件里写CheckUpgradeItemName参数0接裁决之杖，条件成立说明当前升级装备就是裁决之杖，再接金币判断和扣费动作；不成立走#ELSESAY提示只能升级指定武器。

写在最后

检测当前宝石升级装备的名字用CheckUpgradeItemName加位置和物品名就能读出升级界面上的装备或宝石，做限定可升级装备、校验升级物品这类玩法很顺手；记住它只能在升级触发段下用，位置0读装备、1读宝石，名字要和数据库完全一致。更多996引擎脚本命令可以继续关注本站。

CheckUpgradeItemName只能用在升级触发段，这个限制本地环境实测验证过，仅供单机调试参考，其他引擎未做验证。