一、 核心指令：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
UPGRADEITEMEX 11 0 50 1 2
这段脚本含义：检测声望>7，扣除8点声望，对鞋子（位置11）进行升星操作，成功率50%，成功+1星，失败则星星数还原（掉星）。
二、 星星数量检测与专用命令
现代引擎（GEE/GOM/996）通常有专用的星星检测命令，用于限制最大星数。
1. 检测当前星数：
◦ GEE引擎：CheckUpgradeCount 物品位置 (<,>,=) 星星数量
◦ 示例：#IF CheckUpgradeCount 1 > 5 表示检测武器星星是否大于5星。
2. 设置星星数量：
◦ 996引擎：ChangeItemUpgradeCount 物品位置 次数。例如 ChangeItemUpgradeCount 1 + 1 给武器直接加1星。
3. 获取星数变量：
◦ GetItemWhereStars 1 N10：将武器星星数量存入变量N10，便于显示或计算。
三、 完整加星脚本逻辑（带材料消耗）
一个完整的加星NPC脚本需包含：材料检测、星数上限、概率执行。
[@Main]
#IF
CheckItem 升星石 5
CheckUpgradeCount 1 < 9
#ACT
Take 升星石 5
UPGRADEITEMEX 1 0 60 1 1
#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使配置生效，仅重读脚本可能无法刷新指令缓存。
