GOM引擎编写装备升级脚本时，很多人会直接使用UPGRADEITEM、upgradeitemex、checkitemaddvalue这几条指令，执行脚本后提示错误的命令语，核心原因是引擎版本差异、内置指令变更，还有部分指令只在特定插件中生效，原生M2并不识别。脚本运行提示错误的命令语: UPGRADEITEMEX，代表当前使用的GOM主程序没有内置这条指令，不是脚本书写格式问题。
UPGRADEITEM是早期老版本GOM的装备升级指令，新版本GOM已经移除，直接写入脚本会出现指令无法识别。upgradeitemex属于扩展升级指令，这条指令并不是GOM原生内置命令，依赖第三方功能插件，只在搭载对应插件的环境才能正常解析，纯净版GOM引擎读取脚本时，就会判定为无效命令，抛出命令语报错。checkitemaddvalue是读取装备附加属性值的检测指令，作用是判断装备当前的附加属性等级，本身不负责执行升级，很多开发者误把它当成升级执行指令，运行脚本自然不会触发装备升级效果。
在装备升级流程里，需要区分两个需求，一是给装备增加附加属性，二是升级失败后恢复装备原本的默认属性。重置装备默认属性，原生GOM引擎使用RESTOREITEM命令，这条指令可以清除装备所有额外附加属性，还原装备基础属性，不需要额外加载插件。RESTOREITEM基础参数写法为RESTOREITEM 装备位置 保留标识，装备位置参数：0代表身上武器位，1代表项链，2头盔，3手镯左，4手镯右，5戒指左，6戒指右，7戒指右，8衣服，9腰带，10靴子。保留标识填0时，清除全部附加属性，恢复装备原始属性；填1时保留装备持久、强化次数这类标记，只清除额外增加的攻击魔法道术属性。示例写法：RESTOREITEM 0 0，放在[@武器]升级失败分支，执行后身上武器直接恢复原始属性。
如果主程序提示RESTOREITEM未定义，说明引擎版本过于老旧，原生指令缺失，有两种添加方案。第一种方案，使用插件扩展指令，在引擎插件配置文件中加载属性扩展插件，插件内自带装备属性重置相关指令，加载完成重启M2后即可识别新增命令。插件加载路径在Mir200下的PlugList.txt，按照格式写入插件dll文件名称，保存文件，关闭M2进程重新启动引擎，加载插件后新增指令生效。第二种方案，采用物品模板替换思路，不依靠重置指令。脚本逻辑为先获取当前装备名称，删除身上这件装备，再从物品DB读取原始模板，给予一件同名无附加属性的全新装备，适合低版本没有属性重置指令的环境。这个方案要注意装备持久、特殊标记的丢失问题，适合简单的武器升级场景。
接下来针对你贴出的脚本分段调整，原脚本[@武器]区块里直接注释的三条升级指令都无法在纯净GOM使用。GOM新版本原生实现装备附加属性提升，推荐使用SETITEMADDVALUE指令，这条指令是原生支持，不需要额外插件。SETITEMADDVALUE参数格式 SETITEMADDVALUE 装备位置 属性类型 属性数值。属性类型参数说明，1攻击，2魔法，3道术，4防御，5魔御。例如SETITEMADDVALUE 0 1 1，代表给身上武器位置的装备增加1点攻击。
完整可测试脚本示例：
[@main-1]
装备升级系统
〖<升级武器/@武器>〗
[@武器]
#if
checkgold > 99999
#act
take 金币 100000
RANDOM 2
#IF
EQUAL RANDOM 0
#ACT
SETITEMADDVALUE 0 1 1
SENDMSG 6 武器升级成功，攻击力提升！
#ELSEACT
RESTOREITEM 0 0
SENDMSG 6 武器升级失败，武器属性恢复原样！
脚本调试需要注意几个关键点，报错信息显示line:74错误命令，定位到upgradeitemex这一行，直接删除这一行代码即可消除该报错。编写脚本时，每一条指令都需要确认是否为当前GOM引擎原生命令，第三方插件指令要先确认插件已经加载成功。装备位置参数不要混淆，武器固定为0，读取装备属性检测可以使用GETITEMADDVALUE，将装备附加属性读取到变量，用于判断装备当前已经升级多少次，防止无限叠加属性。
变量控制升级次数示例，先定义全局变量，每次升级前读取武器当前附加攻击值，达到上限后禁止继续升级。
[@武器]
#if
checkgold > 99999
GETITEMADDVALUE 0 1 < 5
#act
take 金币 100000
RANDOM 2
#IF
EQUAL RANDOM 0
#ACT
SETITEMADDVALUE 0 1 1
SENDMSG 6 武器升级成功，当前附加攻击+<$GETITEMADDVALUE(0,1)>
#ELSEACT
RESTOREITEM 0 0
SENDMSG 6 武器升级失败，武器附加属性清零。
GETITEMADDVALUE用来读取装备对应属性的附加数值，这条指令用于条件判断，不能用来修改属性。SETITEMADDVALUE负责写入附加属性，RESTOREITEM负责回退原始属性。三个指令搭配使用，就能完成整套装备升级逻辑，不再依赖UPGRADEITEM和upgradeitemex这类失效指令。
如果使用SETITEMADDVALUE依旧提示命令不存在，说明引擎版本过低，有两个解决办法。更换新版GOM引擎程序，替换Mir200文件夹下M2主程序，更新前务必备份全部脚本、物品数据库。或者改用插件方案，在PlugList.txt加载属性扩展插件，使用插件提供的装备修改指令，插件指令需要对照插件配套文档填写参数，不同插件参数格式会有差异。
脚本测试步骤，先保存Market_Def目录下的脚本文件，关闭M2引擎，重新启动M2加载脚本，不要只重进游戏。打开M2控制台查看脚本加载日志，确认没有语法报错。进入游戏对话NPC，测试升级，观察M2日志窗口输出信息，查看金币扣除、指令执行记录。如果出现装备位置识别错误，检查人物身上装备是否对应指令填写的位置编号。升级失败重置属性时，测试装备基础属性是否正常还原，确认不会把装备基础攻击清除，RESTOREITEM指令只会清除附加属性，不会改动物品DB定义的基础属性。
编写装备升级脚本常见坑点，一是混淆原生指令和插件指令，网上很多旧教程的upgradeitemex等指令，仅适配多年前的定制插件，纯净版GOM无法识别。二是装备位置参数写错，武器位是0，很多人误写为1导致修改到项链属性。三是升级次数没有限制，没有用GETITEMADDVALUE做上限判断，装备属性可以无限叠加。四是脚本修改完成没有重启M2，脚本文件改动之后M2不会自动重载，修改后必须重启引擎。五是缺少金币检测、装备存在检测，玩家身上没有装备的时候执行SETITEMADDVALUE会产生无效指令日志。增加checkitemw 0的条件判断，确认身上武器位存在装备，再执行升级逻辑，防止空位置执行指令产生异常日志。
