升级装备属性 EX

命令用途

UpgradeItemEx 用于对指定装备位上的目标属性执行升级、改值或扩展属性处理。

它常见于装备强化、元素或幸运值进阶、神秘属性处理、宝石属性写入，以及对当前普通物品框提交装备直接改值的流程。

命令名

UpgradeItemEx 支持英雄 H.

调用格式

UpgradeItemEx <装备位置> <属性位置> <成功机率> <点数几率或批量改值> <是否破碎或还原> [不显示提示] [是否直接赋予点数] [普通鉴定属性|神秘鉴定属性|特殊属性|神技|几鉴]

参数说明

参数	必填	说明
`装备位置`	`是`	要操作的装备位编号，常见范围为 `0-12`。常用值如 `0=盔甲`、`1=武器`、`16=时装`。扩展值 `10000` 表示 `QueryItemDlg` 当前提交的 `DlgItem`，不属于 `ItemBox` 那套编号。常规槽位可参考装备位置。
`属性位置`	`是`	要升级或调整的属性位编号，常见范围为 `0-22`。默认按通用装备属性理解；当 `装备位置=1` 时，应按武器属性理解。完整编号可参考装备属性位置。
`成功机率`	`是`	升级成功率，常见范围为 `0-100`。注意这里的数字越大，成功机率越小。
`点数几率或批量改值`	`是`	普通用法是点数几率，常见范围 `0-255`；扩展写法可直接传入 `1=5,3=5` 这类“位置=数值”批量改值字符串，此时会直接按字符串修改普通属性、不会失败，且不再受参数 2、参数 3 控制。
`是否破碎或还原`	`是`	`0` 默认处理，`1` 失败时破碎，`2` 失败时还原，`99` 表示忽略普通属性升级，只处理扩展属性。
`不显示提示`	`否`	非空时可抑制默认成功/失败/破碎提示。
`是否直接赋予点数`	`否`	`1` 表示不走随机点数，直接赋予指定点数。
`普通鉴定属性\|神秘鉴定属性\|特殊属性\|神技\|几鉴`	`否`	第 8 参数，为鉴定属性等扩展内容。格式同 `Give` 命令的第 5 参数，留空则不起作用；可再接 `@` 开头的宝石参数。

返回或影响

这是执行型命令，会直接修改目标装备属性。
成功时会按参数规则提升或改写指定属性。
失败时的结果取决于第 5 参数，可能保持默认、破碎或还原。
当第 4 参数写成“位置=数值”批量格式时，会直接改值、不会失败，不受参数 2、参数 3 控制。
该命令不负责前置资格判断，实际业务里通常先配合 CheckUseItem、CheckItemAddValue 或材料检查命令做限制。

扩展属性参数

第 8 参数之后可再接 @ 开头的宝石参数，格式为 @1,4=3|2,9=4|...，最多支持 5 颗宝石。

示例

基础用法

#ACT
UpgradeItemEx 1 0 1 1 2 0
UpgradeItemEx 1 1 1 1 2 0
UpgradeItemEx 1 2 1 1 2 0

这段写法用于对同一件装备的多个普通属性位依次执行强化。适合最基础的连续加点流程。

批量改值

#ACT
UpgradeItemEx 10000 99 0 0 1=10,2=10,3=10,11=15

这段写法把第 4 参数写成“位置=数值”批量格式，会直接按字符串修改普通属性、不会失败，也不再受参数 2、参数 3 的控制。

常见变体

#IF
CheckUseItem 1
CheckItemAddValue 1 0 > 9
CheckItemAddValue 1 1 > 9
CheckItemAddValue 1 2 > 9
#ACT
GameGold - 10000
UpgradeItemEx 10000 99 0 0 1=10,2=10,3=10,11=15,|9=3,12=15,17=10,28=15|67|127|1@1,4=3|2,9=4|5,24=5

这类写法用于先校验装备和属性门槛，再直接对当前普通物品框提交装备执行扩展改值或扩展属性写入。

注意事项

UpgradeItemEx 是高风险执行命令，参数写错会直接改坏装备属性，因此前置判断必须写在同一流程里。
当 装备位置=1 时，属性位置要改按武器属性理解，不能继续套用通用装备属性编号。
第 3 参数“成功机率”数字越大机率越小，和 UpgradeDlgItem 的成功机率（数字越大机率越大）正好相反，不要混用。
第 4 参数既可能是点数几率，也可能是批量改值字符串；使用扩展格式时，会直接改值、不会失败，不要再按普通随机强化去理解它。
第 5 参数的 99 是扩展语义，不是普通失败处理选项；它用于跳过普通属性升级，转而处理扩展属性。
当第 7 参数为 1 时，点数不会随机，而是直接赋予指定值，适合做确定性写入而不是抽取式强化。

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