传奇引擎物品星星数量读取脚本教程 装备星级获取指令用法
一、前言：传奇版本星级脚本应用场景在传奇单机、合击、复古等各类版本开发中，物品星星星级是装备鉴定、属性加成、进阶强化的核心判定依据。很多版本制作者在编写装备检测、星级排行、套装激活脚本时，常不清楚如何精准读取指定物品、人物穿戴装备的星星数量。本文详解传奇引擎两大专属星级读取脚本指令，覆盖唯一ID物品…
一、前言：传奇版本星级脚本应用场景
在传奇单机、合击、复古等各类版本开发中，物品星星星级是装备鉴定、属性加成、进阶强化的核心判定依据。很多版本制作者在编写装备检测、星级排行、套装激活脚本时，常不清楚如何精准读取指定物品、人物穿戴装备的星星数量。本文详解传奇引擎两大专属星级读取脚本指令，覆盖唯一ID物品、人物穿戴位置物品两种读取场景，脚本代码可直接复制导入版本使用。
二、获取唯一ID物品的星星数量（GetItemStars指令）
2.1 指令核心释义
该指令主要用于读取指定唯一ID物品的星级数据，适用于拾取物品、背包物品、单件指定物品的星星数量检测，是针对单体独立物品的读取指令。
2.2 基础脚本语法
指令格式：GetItemStars 唯一ID 变量
2.3 完整可运行脚本示例
[@获取星星数]
#IF
#ACT
;读取当前武器唯一ID对应的星星数量，存入临时变量n$星星数
GetItemStars <$WEAPONID> n$星星数
;向玩家客户端发送星级提示消息，7为消息弹窗通道
SENDMSG 7 <$str(n$星星数)>
2.4 脚本参数说明
唯一ID：传奇引擎中物品专属标识，常用内置标识包含<$WEAPONID>（当前武器ID）、<$ARMORID>（当前衣服ID）等；
变量：支持临时变量、自定义变量，用于存储读取到的星级数值，可后续用于数值判定、属性计算等逻辑。
三、获取人物指定位置物品星星数量（GetItemWhereStars指令）
3.1 指令核心释义
该指令针对性读取人物身上穿戴位置、OK框（弹窗框）内物品的星星数量，无需获取物品唯一ID，直接通过装备位置编号读取，更适配全身装备批量检测场景。
3.2 基础脚本语法
指令格式：GetItemWhereStars 装备位置 存入变量
装备位置参数范围：0~55代表人物身上对应穿戴位置，-1代表OK交互弹窗内的选中物品。
3.3 完整可运行脚本示例
[@main]
#IF
#ACT
;读取1号位置（武器栏）装备的星星数量，存入自定义变量N10
GetItemWhereStars 1 N10
;向玩家发送聊天栏提示消息，展示武器星级数值
SENDMSG 6 当前武器星星数量为：<$STR(N10)>
3.4 位置编号补充说明
传奇引擎标准穿戴位置中，1号固定为主手武器位置、2号为副手位置、3号为衣服位置，开发者可根据版本需求对应选取位置编号，快速读取全身任意部位装备星级。
四、两大指令区别与版本使用建议
1、适用场景区别：GetItemStars侧重单体唯一ID物品读取，适合背包单件、拾取物品判定；GetItemWhereStars侧重穿戴位置读取，适合全身装备星级统计、套装星级达标检测。
2、变量使用建议：读取星级时，临时变量适合单次弹窗提示，自定义变量适合跨脚本调用、星级累计计算，避免变量数据冲突。
3、全版本适配：上述两大指令适配GOM、GEE、BLUE等主流传奇引擎，复古、高爆、合击等版本均可直接套用，无需修改引擎内核参数。
五、常见问题排查
1、读取星级数值为空：检查物品是否配置星级数据库，未开启星级属性的装备无法读取数值；
2、位置读取错误：核对装备位置编号是否超出0~55范围，OK框物品必须使用-1参数；
3、消息不显示：确认SENDMSG通道参数，6为聊天栏消息、7为弹窗消息，根据展示需求调整。
