针对升级脚本中UPGRADEITEM、UPGRADEITEMEX、CHECKITEMADDVALUE命令失效问题，结合开头+5+6属性设定，提供可用替代脚本写法，同时解答属性重置函数及主程序未定义函数的解决办法，适配主流M2引擎，附错误排查方案。
一、失效命令替代：可用装备升级脚本写法
原有命令失效多因引擎不兼容或参数错误，推荐采用ADDATTLIST命令实现装备属性升级（支持+5+6预设），搭配金币扣除、成功率判定，脚本适配你提供的[@main-1]、[@武器]框架，放入对应脚本文件（s001-3.txt）即可。
1. 基础版：武器+5+6属性升级脚本（无成功率）
### 完整脚本代码
[@main-1]
装备升级系统\
〖<升级武器/@武器>〗 // 保留原有交互入口
[@武器]
#IF
CHECKGOLD >= 100000 // 校验金币是否充足，去除注释生效
CHECKITEMW 1 // 检测是否佩戴武器
#ACT
TAKEGOLD 100000 // 扣除10万金币，与校验金额一致
// 升级至+5属性（以攻击属性为例，可替换为魔法、道术）
ADDATTLIST 攻击 5 // 基础属性+5
// 升级至+6属性，需先完成+5升级，可叠加执行
ADDATTLIST 攻击 1 // 在+5基础上+1，最终+6
SENDMSG 5 武器升级成功！当前攻击属性+6，消耗金币10万枚。
#ELSEACT
MESSAGEBOX 金币不足10万枚或未佩戴武器，无法升级！
2. 进阶版：带成功率的+5+6升级脚本
添加Random命令设置成功率，避免必成导致属性失衡，脚本如下：
[@武器]
#IF
CHECKGOLD >= 100000
CHECKITEMW 1
#ACT
TAKEGOLD 100000
Random 3 // 约33%成功率，数值越大成功率越低
#ACT
ADDATTLIST 攻击 6 // 直接升级至+6
SENDMSG 5 恭喜！武器成功升级至+6，攻击属性大幅提升！
#ELSEACT
SENDMSG 5 武器升级失败，金币已消耗，再接再厉！
#ELSEACT
MESSAGEBOX 升级条件不满足，无法尝试升级！
### 脚本说明
1. 属性调整：将“攻击”替换为“魔法”“道术”，适配对应职业武器；数值可直接修改，实现+5+6及更高阶属性设定。
2. 兼容性：ADDATTLIST为通用命令，适配多数引擎，无UPGRADEITEM系列命令的兼容问题，可直接替代失效命令。
二、升级中回复默认属性：函数及参数用法
回复装备默认属性（清除升级附加属性，恢复基础值），核心使用DELATTLIST命令，无需复杂函数，参数适配不同重置需求，直接嵌入脚本即可。
1. 核心命令及参数
- 命令格式：DELATTLIST [属性名称] // 无属性名称则清除所有附加属性
- 基础重置（恢复全默认属性）：DELATTLIST // 清除通过ADDATTLIST添加的所有附加属性，回归装备基础值
- 精准重置（仅清除攻击属性）：DELATTLIST 攻击 // 保留其他附加属性，仅重置攻击属性至默认
2. 嵌入升级脚本示例
在升级失败或手动重置时添加，脚本如下：
[@重置武器属性]
#IF
CHECKITEMW 1
#ACT
DELATTLIST // 恢复武器默认属性，清除所有+5+6附加属性
SENDMSG 5 武器属性已重置为默认值，可重新升级。
#ELSEACT
MESSAGEBOX 未佩戴武器，无法重置属性！
三、主程序未定义函数：添加方法及路径
出现“主程序未定义函数”提示，本质是命令不被引擎识别（如UPGRADEITEMEX），需通过替换通用命令或添加引擎支持文件解决，无需手动定义函数。
1. 优先方案：替换为通用命令
如前文所述，用ADDATTLIST（升级）、DELATTLIST（重置）、TAKEGOLD（扣金币）等通用命令替代失效命令，此类命令为引擎原生支持，无需额外添加，直接修改脚本即可解决“未定义”问题。
2. 补充方案：添加引擎支持文件
若需使用特定命令，需添加对应引擎模块文件，步骤如下：
1. 下载适配引擎版本的命令支持模块（如EngineModule.dll），从引擎官方渠道获取，确保与引擎版本一致。
2. 将模块文件放入服务端根目录\MirServer\GameServer\Plugins文件夹下，若无Plugins文件夹可手动创建。
3. 打开引擎配置文件（Game.ini，路径：MirServer\GameServer\Config），添加一行“LoadModule=EngineModule.dll”，保存文件。
4. 重启M2引擎，加载模块文件，未定义的命令即可被识别，脚本可正常执行。
四、常见错误排查（含UPGRADEITEMEX命令报错）
1. 错误提示：UPGRADEITEMEX 0 2 0 1 0 line:74 报错
### 报错原因
1. 参数错误：UPGRADEITEMEX命令参数格式为“UPGRADEITEMEX 装备位置 属性类型 属性值 成功率 保护符”，参数数量或数值超出范围导致报错。
2. 引擎不兼容：部分老版本引擎不支持UPGRADEITEMEX命令，仅支持基础版UPGRADEITEM，或完全不支持该系列命令。
### 解决方法
1. 直接删除该命令，替换为前文ADDATTLIST升级脚本，彻底规避兼容问题。
2. 若坚持使用，核对参数格式，示例正确格式：UPGRADEITEMEX 1 0 1 50 0（1=武器位置，0=攻击属性，1=属性值，50=50%成功率，0=无需保护符）。
2. 其他常见问题
1. 脚本无响应：检查脚本路径是否正确（D:\mirserver\Mir200\Envir\Market_Def\s001-3.txt），重启M2引擎加载脚本，排除缓存问题。
2. 金币扣除异常：确保CHECKGOLD与TAKEGOLD数值一致，避免校验金额与扣除金额不匹配，导致逻辑冲突。
3. 属性不生效：确认装备无“不可升级”属性（在物品数据库StdItems.DB中检查），此类属性会屏蔽ADDATTLIST命令效果。
五、脚本优化及通用规范
1. 注释清理：删除脚本中无效注释（如;random 2），避免引擎误解析注释内容，引发语法错误。
2. 多属性升级：如需同时升级攻击、魔法属性，可叠加ADDATTLIST命令，示例：ADDATTLIST 攻击 3 ADDATTLIST 魔法 3。
3. 备份留存：修改脚本前备份s001-3.txt文件，若修改后报错可快速回滚，避免影响服务端运行。
