HGE引擎CheckItemStar脚本实操教程 - 装备鉴定星级检测配置方法

CheckItemStar是HGE引擎专属的装备检测脚本命令，核心作用是判定指定位置装备的鉴定星级数值，精准匹配设定星级条件，适配HGE引擎本地版本技术调试、脚本定制学习场景。

很多零基础脚本学习者在做装备星级玩法、装备属性判定调试时，常出现位置填写错误、符号适配失效、星级判定不准的问题，该脚本可完美解决这类问题，帮助学习者快速落地装备星级检测功能。

命令原理

CheckItemStar脚本命令的核心原理是调取HGE引擎内置的装备鉴定星级数据接口。

脚本运行时会精准读取指定物品位置的装备星级参数，再通过设定的对比符号完成数值匹配判定。

仅针对版本内已完成鉴定的装备生效，未鉴定装备默认判定为0星，可用于各类装备星级限制、星级奖励的调试场景。

命令格式

该命令拥有固定标准语法结构，零基础学习者可直接对照套用，无自定义修改空间。

标准命令格式：CheckItemStar 物品位置(0-28) (符号 < > =) 星级(0-5) hero

格式拆解说明：命令开头为核心脚本词，依次填写物品位置、对比符号、星级数值，末尾固定携带hero参数，缺一不可。

实操示例：CheckItemStar 7 = 5 hero

该示例含义为检测玩家7号物品位置装备，判定星级是否等于5星，满足条件则执行对应动作。

参数详解

本脚本共包含三大核心参数，各参数取值、释义及实操用法严格区分，具体如下：

拓展案例

初级入门案例（零基础基础套用）

实现检测玩家头盔位置装备是否为3星，满足条件弹出对应提示，新手可直接复制调试。

[@MAIN]
#if
CheckItemStar 0 = 3 hero
#act
SENDMSG 7 头盔装备鉴定星级为3星，符合基础标准
#ElseAct
SENDMSG 7 头盔装备星级未达到3星标准

中级优化案例（功能升级调试）

设置星级门槛判定，检测玩家武器装备星级是否大于等于4星，实现高阶装备筛选功能。

[@MAIN]
#if
CheckItemStar 1 >= 4 hero
#act
SENDMSG 7 武器装备星级达标，解锁高阶属性加成
#ElseAct
SENDMSG 7 武器星级不足4星，无法激活高阶属性

高阶定制案例（自定义玩法修改）

针对OK框选中物品做星级检测，判定是否为满5星，实现专属极品装备识别玩法定制。

[@MAIN]
#if
CheckItemStar -1 = 5 hero
#act
SENDMSG 7 选中物品为满星极品装备，可参与专属玩法
#ElseAct
SENDMSG 7 选中物品非满星装备，无专属玩法权限

实操步骤

第一步，打开HGE引擎本地测试版本脚本文件夹，找到自定义功能脚本路径，新建或打开已有功能脚本文件。

第二步，在脚本对应功能节点下，粘贴标准CheckItemStar命令格式，根据调试需求修改物品位置、对比符号和星级数值。

第三步，搭配#act、#ElseAct指令设置条件达成与未达成的提示内容，自定义文字信息。

第四步，保存脚本文件，返回HGE引擎版本管理面板，执行脚本重载操作，确保新脚本功能生效。

第五步，进入本地测试版本，对应位置放置不同星级装备，测试判定功能是否精准触发，完成调试。

避坑指南

其一，物品位置区间不可混用，0-28为身上常规装备位，-1为OK框物品，混用会导致检测失效。

其二，星级数值仅支持0-5，填写超出区间数值会直接判定失败，无任何报错提示，新手极易误操作。

其三，脚本末尾hero参数不可省略，缺失该参数会导致HGE引擎无法识别脚本指令，功能完全不生效。

其四，未鉴定装备统一判定为0星，若需筛选已鉴定装备，需提前增加0星排除判定条件。

报错修复

问题现象

脚本加载无报错，但装备星级匹配后不触发对应动作，判定功能完全失效。

核心成因

大概率是参数格式错误、位置区间不匹配或缺失hero后缀参数，导致引擎无法正常解析脚本逻辑。

分步排查步骤

首先排查命令格式，确认参数顺序为物品位置、符号、星级，无顺序颠倒问题。

其次核对物品位置数值，确认使用场景与区间对应，未出现跨区间填写错误。

最后检查脚本末尾，确认hero参数完整存在，无遗漏、无多余字符。

完整落地修复方案

统一重置为标准命令格式，补齐hero后缀，修正错误参数，保存后重载脚本，即可恢复正常判定功能。

FAQ问答

Q1：CheckItemStar脚本支持哪些对比符号？

仅支持等于、大于、小于三种基础符号，可自由组合实现大于等于、小于等于的星级判定逻辑。

Q2：物品位置填写-1代表什么场景？

-1代表检测玩家OK弹窗中选中的物品，区别于身上穿戴装备，适用于选中物品单独判定的玩法。

Q3：未鉴定的装备检测星级会判定为多少？

HGE引擎中未完成鉴定的装备，默认星级数值为0，脚本会按照0星标准进行条件判定。

Q4：脚本设置后完全不生效是什么原因？

多数是缺失末尾hero参数、参数顺序错误、位置区间不匹配三类问题，修正格式重载脚本即可解决。

Q5：自定义装备位该填写哪个数值区间？

自定义装备位统一使用51-70区间，29-50为系统预留装备位，不建议自定义调试使用。

Q6：星级数值可以设置6星及以上吗？

不可以，该脚本引擎适配星级区间固定为0-5，超出数值无法识别，判定结果永久失效。

全文总结

本文详细讲解了CheckItemStar装备鉴定星级检测脚本的全部实操内容，涵盖命令原理、格式参数、三阶案例、实操调试及报错修复。

该脚本适配HGE引擎本地版本学习调试场景，操作简单、判定精准，是实现装备星级筛选、专属玩法定制的核心脚本，零基础学习者可直接照搬落地调试。