不允许宝石升级详解 - GOM引擎升级失败拦截配置

版本里想做不允许宝石升级的拦截，场景通常是这样的：装备强化有条件限制，金币不够就不能点升级，或者特定装备干脆不让用宝石升，这些需求都落在同一个脚本段里处理。

玩家点升级时系统会先走一遍条件判断，条件不满足就由脚本主动叫停，这个叫停动作就是SetUpgradeFail命令干的事，帮助文档里它的功能说明原文只有一句：当前宝石升级装备失败。

下面按GOM引擎帮助文档原文，把SetUpgradeFail的命令格式、执行位置、官方示例和宝石升级系统的关联机制完整梳理一遍，再给出NPC脚本里的配置步骤与新手易错点。

SetUpgradeFail命令详解

帮助文档对这条命令的记载，格式与说明原文如下：

功能: 当前宝石升级装备失败
格式: SetUpgradeFail
说明: 此命令只能在QFunction中的@ItemUpgrade下执行.

SetUpgradeFail是无参数命令，本身不接收任何数值，作用就是让当前这次宝石升级直接判定失败。它只在@ItemUpgrade段里有效，这个段是宝石升级系统在玩家点升级时固定执行的前置脚本段，命令放错地方就不会生效。

宝石升级系统的执行顺序在游戏功能详解里有完整说明：打开人物背包点右下角的升级按钮进行升级，也可使用OpenUpgradeDialog命令打开界面，放好物品点升级时先执行QFunction中的@ItemUpgrade脚本段，执行完脚本功能后，升级成功时执行@UpgradeOKX，升级失败时执行@UpgradeFailX，属性被清除时执行@UpgradeClearX，其中X代表装备位置，例如衣服=0、武器=1。

参数要点

命令没有参数可配，实际要配的是它所在的判断逻辑：在@ItemUpgrade段里用#IF写条件，条件满足放行，条件不满足走#ELSEACT执行SetUpgradeFail把这次升级拦下来。

实战案例帮助文档给的标准示例整块引用如下，放在QFunction中的@ItemUpgrade段：

[@ItemUpgrade]
#IF
CheckGold 5000
#ACT
Take 金币 5000
#ELSESAY
升级装备需要5000金币.
#ELSEACT
SetUpgradeFail
Break

这段逻辑是：升级前先检查金币是否够5000，够就从背包扣走5000放行升级，不够就弹提示并执行SetUpgradeFail，让这次升级直接失败，Break结束当前判断。

初级场景直接套这个示例，把CheckGold后面的数字换成你的条件即可。中级场景可以叠加装备位置判断，在#IF里用检测命令确认当前升级的是哪个位置的装备，不同位置走不同的条件分支。高级场景配合物品标识，给特定装备打标记后，升级前先检测标识，带标记的装备一律SetUpgradeFail拦截，实现指定装备禁升宝石。

宝石升级系统里还有一个配套命令ClearStoneUpgrade，功能是清除使用宝石升级的装备属性，格式为ClearStoneUpgrade位置(0-14)，注意此命令不区分极品和普通装备，清除时所有属性都将消失，用途是清属性而不是拦升级，和SetUpgradeFail要区分开。这条QF脚本里的拦截逻辑，实际调试时先在段内加提示确认走到再谈参数。

脚本配置步骤

第一步，打开QFunction脚本文件，找到或新建[@ItemUpgrade]段，这个段名和方括号写法都不能改，系统点升级时只认这个段名。

第二步，在段内写#IF条件判断，检测升级前必须满足的条件，比如CheckGold检查金币、检测命令检查装备位置或物品标识。

第三步，条件满足分支写#ACT和放行逻辑，需要扣材料就写Take命令扣走对应物品，然后自然进入升级流程。

第四步，条件不满足分支写#ELSESAY弹提示，提示内容写清楚缺什么条件，方便本地调试时玩家知道为什么升不了。

第五步，提示下面写#ELSEACT和SetUpgradeFail，把这次升级判定为失败，再写Break结束整段判断。

第六步，保存QFunction后重载生效，本地GOM引擎环境里打开背包点升级按钮实测，条件不足时确认升级被拦截且提示正常输出。

设置误区

第一个易错点是段名写错。命令只能在@ItemUpgrade段执行，段名少写一个字母或者大小写混排都会导致命令不被走到，本地调试时先在段内加SENDMSG确认段被执行。

第二个易错点是条件分支顺序颠倒。SetUpgradeFail要放在#ELSEACT下面表示条件不满足时拦截，放错到#ACT下面就会变成条件满足时也拦截，逻辑完全反了。

第三个易错点是忽略失败后的后续触发。升级失败后会执行@UpgradeFailX段，X按装备位置区分，如果想在失败后给提示或做补偿，要另外建对应的失败段，光靠SetUpgradeFail本身不会给玩家任何提示。

常见问题

1. 不允许宝石升级的需求一般怎么做？

在@ItemUpgrade段里写条件判断，条件不满足就执行SetUpgradeFail让升级失败，常见做法是检查金币数量、装备位置或物品标识，条件分支清晰后拦截逻辑就一目了然。

2. SetUpgradeFail为什么只能在@ItemUpgrade下执行？

因为宝石升级流程里系统只在点升级时固定执行这个前置段，命令的判定时机和这个段绑定，放到其他段里没有升级事件驱动，命令自然不生效，这是帮助文档明确写死的执行范围。

3. 升级失败后装备的属性会怎样？

取决于宝石的Need字段配置，该值等于1到100时失败后装备附加属性全部清零，等于101到200时失败后装备消失，等于201到300时失败后装备当前属性不变，配置宝石前先按需求定好这个字段。

4. 怎么让指定装备不能被宝石升级？

给目标装备用SetItemFlag打上物品标识，升级前在#IF里用CheckItemFlag检测，带标识的装备走#ELSEACT执行SetUpgradeFail，不带标识的装备正常放行，就能实现指定装备禁升。整理自百度知道真实提问：传奇饰品升级脚本，2017-12。

5. 升级武器时提示脚本问题怎么排查？

先确认升级脚本本身没写错，再检查配置文件里的名称是否统一，比如黑铁矿石这类材料，setup.txt配置的名称和物品数据库名称不一致会直接导致材料检测不到，名称对齐后问题就解开了。整理自百度知道真实提问：传奇升级武器脚本问题，2014-03。

6. 传奇世界H5的宝石升级在哪操作？

H5端的宝石升级在打造界面里操作，找到宝石标签进入宝石专属操作页面就能执行升级，流程和端游版不一致，脚本侧仍是同一套@ItemUpgrade拦截逻辑。整理自百度知道真实提问：传奇世界H5怎么给宝石升级，2025-12。

7. OpenUpgradeDialog命令是做什么的？

它是帮助文档里提到的另一个入口命令，作用是把人物背包的升级界面直接打开，和玩家手动点右下角升级按钮效果一致，脚本里想主动引导玩家升级时可以调用它。

最后总结

不允许宝石升级的脚本核心就是SetUpgradeFail这个拦截开关，配合@ItemUpgrade段的条件判断，就能实现金币门槛、指定装备禁升这类需求，配置时记住段名不能错、命令放#ELSEACT下、失败段要单独建这三条就够了。

SetUpgradeFail的拦截验证在本地GOM引擎环境里完成，金币不足时升级会被拦下；命令面向GOM引擎开发，跨引擎场景请自行测试。本稿仅供本地调试参考。