一、核心指令：UPGRADEITEMEX参数解析
装备加星本质是修改装备的“升级次数”属性。最常用的指令是UPGRADEITEMEX，其参数决定成败。
指令格式：UPGRADEITEMEX物品位置属性位置成功率点数失败处理
•物品位置：0盔甲、1武器、3项链、4头盔、5右手镯、6左手镯、7右戒指、8左戒指、10腰带、11鞋子。
-属性位置：通常填0（代表防御）或对应属性字段。部分引擎用特定数值代表“星星数”。
-成功率（关键）：第三个参数。填3表示3%成功率，填80表示80%成功率。
-点数：成功时增加的星星数量，通常填1（升1星）。
•失败处理：第五个参数。0=失败无惩罚；1=失败装备破碎消失；2=失败还原（星星数减少）。
示例脚本（消耗声望升靴子防御，即星星）：
#IF
CHECKCREDITPOINT>7
#ACT
CREDITPOINT-8
UPGRADEITEMEX1105012
这段脚本含义：检测声望>7，扣除8点声望，对鞋子（位置11）进行升星操作，成功率50%，成功+1星，失败则星星数还原（掉星）。
二、星星数量检测与专用命令
现代引擎（GEE/GOM/996）通常有专用的星星检测命令，用于限制最大星数。
1.检测当前星数：
◦GEE引擎：CheckUpgradeCount物品位置(<>=)星星数量
◦示例：#IFCheckUpgradeCount1>5表示检测武器星星是否大于5星。
2.设置星星数量：
◦996引擎：ChangeItemUpgradeCount物品位置次数。例如ChangeItemUpgradeCount1+1给武器直接加1星。
3.获取星数变量：
◦GetItemWhereStars1N10：将武器星星数量存入变量N10，便于显示或计算。
三、完整加星脚本逻辑（带材料消耗）
一个完整的加星NPC脚本需包含：材料检测、星数上限、概率执行。
[@Main]
#IF
CheckItem升星石5
CheckUpgradeCount1<9
#ACT
Take升星石5
UPGRADEITEMEX106011
#ELSESAY
升星失败！请确保：\\
1.背包有5个升星石\\
2.武器星星数未满9星
参数调整技巧：
•改成功率：直接修改UPGRADEITEMEX的第三个数字（如60改为80）。
•改失败惩罚：将第五个参数1（破碎）改为2（还原掉星）或0（仅失败无损失）。
•防爆保护：可在条件中加入CheckItem防爆符1，失败时扣除防爆符而不碎装备。
四、常见报错与脚本无效排查
1.M2报错变量无效：HERO引擎自定义变量需先在!Setup.txt中定义，或改用通用变量（如N开头的数字变量）。
2.星星不显示：星星是客户端补丁效果，需确保补丁文件（Items.wil或StateItem.wil）包含对应星标素材。
3.脚本不执行：检查NPC脚本文件编码是否为ANSI，且UPGRADEITEMEX参数数量是否正确（老引擎仅支持5-6个参数，新引擎支持更多）。
4.位置错误：确认装备佩戴在正确位置，UPGRADEITEMEX只能操作身上或OK框内的装备。
提示：修改脚本后必须重启M2Server使配置生效，仅重读脚本可能无法刷新指令缓存。
装备加星本质是修改装备的“升级次数”属性。最常用的指令是UPGRADEITEMEX，其参数决定成败。
指令格式：UPGRADEITEMEX物品位置属性位置成功率点数失败处理
•物品位置：0盔甲、1武器、3项链、4头盔、5右手镯、6左手镯、7右戒指、8左戒指、10腰带、11鞋子。
-属性位置：通常填0（代表防御）或对应属性字段。部分引擎用特定数值代表“星星数”。
-成功率（关键）：第三个参数。填3表示3%成功率，填80表示80%成功率。
-点数：成功时增加的星星数量，通常填1（升1星）。
•失败处理：第五个参数。0=失败无惩罚；1=失败装备破碎消失；2=失败还原（星星数减少）。
示例脚本（消耗声望升靴子防御，即星星）：
#IF
CHECKCREDITPOINT>7
#ACT
CREDITPOINT-8
UPGRADEITEMEX1105012
这段脚本含义：检测声望>7，扣除8点声望，对鞋子（位置11）进行升星操作，成功率50%，成功+1星，失败则星星数还原（掉星）。
二、星星数量检测与专用命令
现代引擎（GEE/GOM/996）通常有专用的星星检测命令，用于限制最大星数。
1.检测当前星数：
◦GEE引擎：CheckUpgradeCount物品位置(<>=)星星数量
◦示例：#IFCheckUpgradeCount1>5表示检测武器星星是否大于5星。
2.设置星星数量：
◦996引擎：ChangeItemUpgradeCount物品位置次数。例如ChangeItemUpgradeCount1+1给武器直接加1星。
3.获取星数变量：
◦GetItemWhereStars1N10：将武器星星数量存入变量N10，便于显示或计算。
三、完整加星脚本逻辑（带材料消耗）
一个完整的加星NPC脚本需包含：材料检测、星数上限、概率执行。
[@Main]
#IF
CheckItem升星石5
CheckUpgradeCount1<9
#ACT
Take升星石5
UPGRADEITEMEX106011
#ELSESAY
升星失败！请确保：\\
1.背包有5个升星石\\
2.武器星星数未满9星
参数调整技巧：
•改成功率：直接修改UPGRADEITEMEX的第三个数字（如60改为80）。
•改失败惩罚：将第五个参数1（破碎）改为2（还原掉星）或0（仅失败无损失）。
•防爆保护：可在条件中加入CheckItem防爆符1，失败时扣除防爆符而不碎装备。
四、常见报错与脚本无效排查
1.M2报错变量无效：HERO引擎自定义变量需先在!Setup.txt中定义，或改用通用变量（如N开头的数字变量）。
2.星星不显示：星星是客户端补丁效果，需确保补丁文件（Items.wil或StateItem.wil）包含对应星标素材。
3.脚本不执行：检查NPC脚本文件编码是否为ANSI，且UPGRADEITEMEX参数数量是否正确（老引擎仅支持5-6个参数，新引擎支持更多）。
4.位置错误：确认装备佩戴在正确位置，UPGRADEITEMEX只能操作身上或OK框内的装备。
提示：修改脚本后必须重启M2Server使配置生效，仅重读脚本可能无法刷新指令缓存。