升级普通物品框装备

命令用途

UpgradeDlgItem 用于直接升级当前普通物品框中的装备。

这条命令必须配合 QueryItemDlg 使用，通常写在用户提交装备后的回调标签里，用来对当前提交装备继续做强化、改值或扩展属性处理。

命令名

UpgradeDlgItem

调用格式

UpgradeDlgItem <属性位置> <成功概率> <点数几率> [是否破碎或还原] [不显示提示] [普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴]

参数说明

参数	必填	说明
`属性位置`	`是`	要升级或调整的属性位编号。默认按通用装备属性理解；当当前普通物品框里放入的是武器时，应按武器属性理解。完整编号可参考装备属性位置。
`成功概率`	`是`	升级成功率，常见范围为 `0-100`。
`点数几率`	`是`	升级点数几率，常见范围为 `0-255`。
`是否破碎或还原`	`否`	`0` 表示默认处理，`1` 表示失败时破碎，`2` 表示失败时还原，`99` 表示忽略普通属性升级，只处理扩展属性。
`不显示提示`	`否`	非空时不显示成功、失败或破碎提示。留空时通常显示默认提示。
`普通鉴定属性\|神秘鉴定属性\|特殊属性\|神技\|几鉴`	`否`	扩展鉴定或特殊属性参数。需要同时处理普通属性之外的内容时再填写。

返回或影响

这是执行型命令，会直接修改当前普通物品框中的装备属性。
成功时会按参数规则提升或改写目标属性。
失败时的结果取决于“是否破碎或还原”参数，可能保持默认、破碎或还原。
该命令不负责前置资格判断，实际脚本里通常要先做类型、名称、属性门槛或材料检查。

示例

基础用法

[@OnUpgradeItem]
#IF
CheckDlgItemType WEAPON
#ACT
UpgradeDlgItem 3 100 1 2

这段写法用于在确认提交的是武器后，直接升级当前普通物品框装备的目标属性。

常见变体

[@OnUpgradeItem]
#IF
CheckDlgItemType WEAPON
CheckDlgItemAddValue 3 < 7
#ACT
GameGold - 10000
UpgradeDlgItem 3 100 1 2 0
#ELSEACT
MessageBox "当前装备不满足继续强化条件。"
Break

这类写法适合先校验提交装备的类型和属性门槛，符合条件后再对当前普通物品框装备继续强化。

注意事项

UpgradeDlgItem 必须放在 QueryItemDlg 的后续流程里执行，否则没有当前提交装备可供升级。
这条命令不是普通背包装备升级接口，它处理的是当前普通物品框中的那一件提交装备。
当当前普通物品框中放入的是武器时，属性位置应按武器属性理解；放入其他装备时，则按通用装备属性理解。
99 是扩展语义，不是普通失败处理选项；它用于跳过普通属性升级，转而处理扩展属性。
这条命令会直接改动当前提交装备，前置判断最好和升级动作写在同一流程里，避免误改。
如果脚本目标是打开客户端淬炼窗口、由材料与几率决定成败，应改用打开淬炼窗口，不要用本命令硬造淬炼流程。

蓝海数据库编辑器 — 重要操作自动备份，改数据更安心