传奇人物装备检测脚本全套命令用法与属性配置教程

admin15小时前1

在传奇版本搭建与脚本开发过程中，人物装备检测、装备属性校验、装备升级功能是自定义玩法、装备进阶、属性限制的核心基础功能。熟练掌握各类装备检测脚本命令，能够快速实现穿戴校验、装备识别、属性判定、装备升级等个性化功能，助力传奇版本定制开发。本文将完整详解传奇装备检测全套脚本命令、使用格式、实操案例以及全…

在传奇版本搭建与脚本开发过程中，人物装备检测、装备属性校验、装备升级功能是自定义玩法、装备进阶、属性限制的核心基础功能。熟练掌握各类装备检测脚本命令，能够快速实现穿戴校验、装备识别、属性判定、装备升级等个性化功能，助力传奇版本定制开发。本文将完整详解传奇装备检测全套脚本命令、使用格式、实操案例以及全装备属性位置对照表，适配各类传奇版本开发场景。

一、传奇核心装备检测基础命令大全

传奇装备检测脚本包含多款核心命令，分别适配人物穿戴装备检测、放入装备识别、属性数值校验、属性获取、装备升级等不同场景，各命令功能、格式与使用要求如下，所有命令均适配常规传奇脚本引擎，可直接套用。

1.1 CHECKUSEITEM 穿戴装备检测命令

该命令主要用于检测人物身上已穿戴的装备类型，物品位置取值范围为0-16，不同装备位置对应不同附加属性区间，是穿戴状态校验的基础命令。

适用场景：检测玩家是否穿戴指定部位装备、判断人物装备佩戴状态、解锁对应功能权限。

1.2 CHECKDLGITEMNAME 装备全称检测命令

专门检测对话框内放入装备的完整名称，精准匹配指定装备，可用于限定专属装备进阶、装备兑换、装备校验等玩法，仅识别全称完全一致的装备。

使用要求：需搭配QUERYITEMDLG命令使用，适配放入式装备检测场景。

1.3 CHECKPOSDLGITEMNAME 装备特征字符检测命令

区别于全称检测，该命令支持模糊匹配装备特征字符，无需输入完整装备名称，可匹配同系列、同前缀的套装装备，适配套装批量校验玩法。

1.4 CHECKDLGITEMTYPE 装备类型检测命令

用于识别放入装备的品类类型，可精准区分衣服、武器、项链、头盔、手镯等十余类装备，是分类处理装备升级、装备回收的核心命令。

1.5 CHECKITEMADDVALUE 穿戴装备属性检测命令

针对人物已穿戴的装备，检测指定属性位置的数值，支持大于、小于、等于、区间判断，属性位置取值0-30，检测数值范围0-255，常用于限制装备属性上限、判定极品装备。

1.6 CHECKDLGITEMADDVALUE 放入装备属性检测命令

专门检测对话框内放入装备的指定属性数值，属性位置0-16，支持数值大小对比判断，必须配合QUERYITEMDLG命令生效，多用于升级前装备属性校验。

1.7 GETDLGITEMVALUE 装备属性数值获取命令

可将放入装备的指定属性数值读取至M0-M99变量中，属性位置取值0-31，为后续属性判断、装备升级数值计算提供数据支撑，搭配QUERYITEMDLG命令使用。

配套变量：放入装备名称变量【<$DLGITEMNAME>】、装备删除命令【TAKEDLGITEM】

1.8 QUERYITEMDLG 装备弹窗查询命令

所有放入装备检测功能的核心适配命令，支持自定义文字描述、跳转指定脚本标签，可设置是否检测后删除装备（0=忽略不删除，1=检测后删除）。

1.9 UPGRADEDLGITEM 弹窗装备升级命令

针对对话框内放入的装备进行属性升级，可自定义升级属性位置、成功概率、点数随机范围、装备破碎还原规则，支持隐藏升级提示信息，适配自定义装备进阶玩法。

1.10 UPGRADEITEMEX 穿戴装备升级命令

仅针对人物已穿戴的装备生效，区别于弹窗升级命令，其第七参数设置为1时，可固定升级点数，取消随机数值，精准控制装备升级属性数值。

二、传奇装备检测脚本完整实操案例

以下为可直接复制使用的完整脚本案例，包含穿戴检测、装备名称校验、特征匹配、类型识别、属性升级全功能，适配传奇各类自定义玩法开发。

[@CHECKUSEITEM]

#IF

CHECKUSEITEM 0

#SAY

您身上穿了衣服：<$DRESS>、武器：<$WEAPON>、

#elsesay

您还没穿衣服和武器呢！

;===============================================

;功能：检查放入装备的名称全名

;格式：CHECKDLGITEMNAME 名称

;===============================================

[@CHECKDLGITEMNAME]

#ACT

DELAYCALL 10 @DELAY_UPGRADEDLGITEM1

[@DELAY_UPGRADEDLGITEM1]

#ACT

QUERYITEMDLG 查询装备特征字符 @CHECKDLGITEMNAME1 0

[@CHECKDLGITEMNAME1]

#IF

CHECKDLGITEMNAME 星王项链(战)

#SAY

你放入的<$DLGITEMNAME>，正是我需要的装备系列！

#ELSESAY

你提交的是什么物品？我要的可是星王项链(战)啊！\

;===============================================

;功能：检查放入装备的名称特征字符

;格式：CHECKPOSDLGITEMNAME 特征字符

;===============================================

[@CHECKPOSDLGITEMNAME]

#ACT

DELAYCALL 10 @DELAY_UPGRADEDLGITEM2

[@DELAY_UPGRADEDLGITEM2]

#ACT

QUERYITEMDLG 查询装备特征字符 @CHECKPOSDLGITEMNAME1 0

[@CHECKPOSDLGITEMNAME2]

#IF

CHECKPOSDLGITEMNAME 星王

#SAY

你放入的<$DLGITEMNAME>，正是我需要的装备系列！

#ELSESAY

你提交的是什么物品？我要的可是星王套装啊！\

;===============================================

;功能：检查放入装备的类型

;===============================================

;可检测装备类型参数

;DRESS 衣服

;WEAPON 武器

;MEDAL 勋章

;NECKLACE 项链

;HELMET 头盔

;ARMRING 手镯

;RING 戒指

;BOOTS 靴子

;BELT 腰带

;BUJUK 宝石

;DRUM 军鼓

;HORSE 马牌

;格式：CHECKDLGITEMTYPE 类型需配合QUERYITEMDLG命令

;===============================================

[@CHECKDLGITEMTYPE]

#ACT

DELAYCALL 10 @DELAY_UPGRADEDLGITEM3

[@DELAY_UPGRADEDLGITEM3]

#ACT

QUERYITEMDLG 查询装备特征字符 @CHECKDLGITEMTYPE1 0

[@CHECKDLGITEMTYPE1]

#IF

CHECKDLGITEMNAME WEAPON

#SAY

你放入的<$DLGITEMNAME>，正是我需要的装备系列！

#ELSESAY

你提交的是什么物品？我要的可是武器啊！\

;===============================================

;功能：检查指定类型装备的属性点

;格式：CHECKITEMADDVALUE 指定类型属性位置(0-16) < = > ? 检查数值(0-255)

;===============================================

;检查装备指定属性幸运点是否等于5或大于5

[@CHECKITEMADDVALUE]

#IF

CHECKITEMADDVALUE 1 3 ? 5

#SAY

超级祝福油只能提升5点幸运以下的武器！\

目前你的武器幸运已经达到5点或5点以上\

超级祝福油将无效。\

#ACT

BREAK

#IF

CHECKUSEITEM 1

#ACT

UPGRADEITEMEX 1 0 1 1 2 0

UPGRADEITEMEX 1 1 1 1 2 0

UPGRADEITEMEX 1 2 1 1 2 0

UPGRADEITEMEX 1 3 1 1 2 0

UPGRADEITEMEX 1 4 1 1 2 0

UPGRADEITEMEX 1 5 1 1 2 0

UPGRADEITEMEX 1 6 1 11 2 0

UPGRADEITEMEX 1 7 1 1 2 0

UPGRADEITEMEX 1 8 1 1 2 0

UPGRADEITEMEX 1 9 1 1 2 0

UPGRADEITEMEX 1 14 1 1 2 0

UPGRADEITEMEX 1 15 1 1 2 0

UPGRADEITEMEX 1 16 1 1 2 0

UPGRADEITEMEX 1 17 1 1 2 0

UPGRADEITEMEX 1 18 1 1 2 0

UPGRADEITEMEX 1 19 1 1 2 0

UPGRADEITEMEX 1 20 1 1 2 0

UPGRADEITEMEX 1 21 1 1 2 0

UPGRADEITEMEX 1 22 1 1 2 0

UPGRADEITEMEX 1 23 1 1 2 0

#ELSEACT

messagebox 请把武器带在身上！否则无法升级！

;===============================================

;功能：检查放入装备指定的属性点

;格式：CHECKDLGITEMADDVALUE 属性位置(0-16) ><= 检查数值(0-255) 配合QUERYITEMDLG命令

;===============================================

[@WEAPON]

这里提供武器幸运升级，请放上你的需要升级的武器。\

<返回/@main> <关闭/@exit>

#ACT

DELAYCALL 10 @WEAPON_UPGRADEDLGITEM1

[@WEAPON_UPGRADEDLGITEM1]

#ACT

QUERYITEMDLG 升级幸运 @WEAPON1 0

[@WEAPON1]

#IF

!CHECKDLGITEMTYPE WEAPON

#ACT

MESSAGEBOX 您放入道具：【<$DLGITEMNAME>】、不属于武器类！

GOTO @WEAPON

BREAK

#IF

CHECKDLGITEMTYPE WEAPON

CHECKDLGITEMADDVALUE 3 < 8

#ACT

//获取武器幸运位置=3

GETDLGITEMVALUE M3 3

DELAYCALL 10 @WEAPON_UPGRADEDLGITEM

[@WEAPON_UPGRADEDLGITEM]

#IF

SMALL M3 7

#ACT

UPGRADEDLGITEM 3 100 1 2

GOTO @WEAPON

#ELSEACT

MESSAGEBOX 当前武器幸运只能升级7点。

[@DRESS]

这里提供衣服持久升级，请放上你的需要升级的装备。\

<返回/@main> <关闭/@exit>

#ACT

DELAYCALL 10 @DRESS_0

[@DRESS_0]

#ACT

QUERYITEMDLG 升级装备持久 @DRESS0 0

[@DRESS0]

#IF

!CHECKDLGITEMTYPE DRESS

#ACT

MESSAGEBOX 您放入道具：【<$DLGITEMNAME>】、不属于服饰类！

GOTO @DRESS

BREAK

#IF

//获取衣服持久下限=14

CHECKDLGITEMTYPE DRESS

CHECKDLGITEMADDVALUE 14 < 25

#ACT

//获取物品位置14的属性点到M0

GETDLGITEMVALUE M0 14

DELAYCALL 10 @DRESS_UPGRADEDLGITEM0

[@DRESS_UPGRADEDLGITEM0]

#IF

SMALL M0 25

#ACT

UPGRADEDLGITEM 14 50 1 2

GOTO @DRESS

#ELSEACT

MESSAGEBOX 当前装备只能升级25点。

三、传奇物品极品属性核心详解

传奇中项链、手镯、戒指的极品属性升级效果，由DB数据库内装备SHAPE数值决定，不同SHAPE值对应不同属性位置的属性类型，部分特殊属性升级1点等同于10%效果，是极品装备定制的核心依据。

3.1 项链极品属性对应规则

SHAPE值19：0位置=魔法躲避，1位置=幸运

SHAPE值20：0位置=准确，1位置=敏捷

SHAPE值21：0位置=体力恢复，1位置=魔法恢复（1点属性=10%恢复效果）

3.2 手镯极品属性对应规则

SHAPE值24：0位置=准确，1位置=敏捷

SHAPE值26：0位置=防御上限，1位置=魔御上限

3.3 戒指极品属性对应规则

SHAPE值22：0位置=防御上限，1位置=魔御上限

SHAPE值23：0位置=毒物躲避，1位置=中毒恢复（1点属性=10%效果）

四、传奇全装备属性位置对照表

传奇各类装备的属性位置固定，不同部位装备对应专属属性区间，精准对照可避免脚本属性检测、升级出错，覆盖游戏内全部可穿戴装备品类。

4.1 衣服属性位置（位置=0）

0=防御，1=魔御，2=攻击，3=魔法，4=道术，5=衣服翅膀（Anicount值），6=未知，7=强度无效，8=暴击，9=PK目标爆率，10=未知，11-13=暂未开放，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.2 武器属性位置（位置=1）

0=攻击，1=魔法，2=道术，3=幸运，4=诅咒，5=准确，6=攻击速度，7=强度，8=暴击，9=PK目标爆率，10=需要开封，11-13=暂未开放，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.3 勋章属性位置（位置=2）

0=防御，1=魔御，2=攻击，3=魔法，4=道术，5=佩带需求，6=佩带级别，7=无效果，8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.4 项链属性位置（位置=3）

0=AC2，1=MAC2，2=DC2，3=MC2，4=SC2，6=佩带需求，7=佩带级别，8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.5 头盔属性位置（位置=4）

0=防御，1=魔御，2=攻击，3=魔法，4=道术，5=佩带需求，6=佩带级别，7=锁定头盔（数字锁定无法取下），8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.6 手镯属性位置（右手镯=5、左手镯=6）

0=AC2，1=MAC2，2=DC2，3=MC2，4=SC2，5=佩带需求，6=佩带级别，7=锁定手镯（数字锁定无法取下），8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.7 戒指属性位置（右戒指=7、左戒指=8）

0=AC2，1=MAC2，2=DC2，3=MC2，4=SC2，5=佩带需求，6=佩带级别，7=锁定戒指（数字锁定无法取下），8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光

4.8 腰带属性位置（位置=10）

0=AC2，1=MAC2，2=DC2，3=MC2，4=SC2，5=佩带需求，6=佩带级别，7=未知，8=暴击，9=PK目标爆率，10-13=无效果，14=持久下限，15=持久上限，16=防爆，17=忽视目标防御，18=增加伤害，19=伤害反射，20=物理伤害减少，21=魔法伤害减少，22=经验吸收增加，23=发光