装备与物品
升级指定位置装备随机属性
对指定装备位执行基础随机属性升级，适用于穿戴装备强化、常规升点和不需要扩展控制参数的简单进阶流程。
命令用途
UpgradeItem 用于升级指定装备位上的随机属性。
它适合处理角色当前已穿戴装备的基础强化流程，常见于武器、衣服、首饰或时装的常规升点场景。相比 UpgradeItemEx，这条命令更偏基础写法，参数更少。
命令名
UpgradeItem 支持英雄 H.
调用格式
UpgradeItem <装备位置> <随机属性机率> <点数> [普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴] [升级类型]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
装备位置 | 是 | 要操作的装备位编号，常见范围为 0-12。常用值如 0=衣服、1=武器、16=时装。扩展值 10000 表示对当前非空的 DlgItemID 物品进行操作。完整位置可参考 装备位置。 |
随机属性机率 | 是 | 随机属性出现机率，常见范围为 0-100。这里的机率表示升级时“出现任何属性”的概率，而不是某条属性值提升多少。 |
点数 | 是 | 升级后得到的点数，常见范围为 0-255。 |
普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴 | 否 | 扩展鉴定、神秘属性、特殊属性或神技参数。格式同 Give 命令的第 5 参数，留空则不起作用；可再接 @ 开头的宝石参数。 |
升级类型 | 否 | 扩展值 99 表示忽略普通属性升级，只升级神秘属性和宝石属性。 |
返回或影响
- 这是执行型命令，会直接修改指定装备位上的当前装备属性。
- 成功时会按参数规则提升目标装备的随机属性或扩展属性。
- 如果目标装备位为空，通常不会得到你预期的升级结果，因此实际脚本里一般先配合
CheckUseItem做存在性检查。 - 这条命令不负责资格判断、材料扣除或货币消耗，实际业务里通常要先完成前置检查再执行。
扩展属性参数
第 4 参数的五个字段用 \| 分隔，顺序为“普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴”，与 Give 命令的第 5 参数一致。各字段取值规则、鉴定属性位置表（1~31）、特殊属性与神技代码相加规则，可参考 发放物品与装备 的「扩展属性参数」小节。
第 4 参数之后可再接 @ 开头的宝石参数，格式为 @1,4=3|2,9=4|...，最多支持 5 颗宝石。
示例
基础用法
#IF
CheckUseItem 1
#ACT
UpgradeItem 1 100 1
这段写法用于在确认角色已穿戴武器后，对武器执行一次随机属性升级。
扩展属性与宝石
#ACT
UpgradeItem 1 0 0 0|2|0|0|0@1,4=3|2,9=4|5,24=5
这段写法用于对武器位直接写入鉴定属性、特殊属性和宝石属性，不处理普通随机升级。
只处理神秘属性与宝石
#IF
CheckUseItem 16
CheckItemAddValue 16 0 < 7
#ACT
GameGold - 10000
UpgradeItem 16 0 0 1@1,4=3|2,9=4 99
#ELSEACT
MessageBox "当前装备不满足继续进阶条件。"
Break
这类写法适合先校验指定装备位和属性门槛，再用 99 跳过普通属性升级，只处理神秘属性或宝石属性。
注意事项
UpgradeItem面向指定装备位，不是普通物品框流程命令；如果当前流程来自QueryItemDlg，应优先改用UpgradeDlgItem或UpgradeItemEx 10000 ...。UpgradeItem和UpgradeItemEx都能处理指定装备位，但前者更适合基础随机升级，后者适合需要破碎、还原、直接赋值或批量改值的复杂流程。- 第 2 参数是“随机属性出现机率”，表示升级时出现任何属性的概率，不要把它理解成某条属性值的确切提升量。
- 第 4 参数和第 5 参数都属于扩展能力；只做普通随机升点时，通常写前三个参数即可。
- 当使用
99时，会跳过普通属性升级，只处理神秘属性和宝石属性，不应继续按普通强化结果理解。