针对您遇到的UPGRADEITEM、UPGRADEITEMEX命令报错以及“主程序未定义”的问题，核心原因在于GOM（或GEE）引擎的装备升级机制并非通过单行脚本命令直接完成，而是必须配合M2Server引擎内部的“升级规则配置”以及特定的脚本流程。直接在脚本中调用这些参数而不经过引擎底层验证，必然导致“错误的命令语”或“未定义函数”报错。此外，恢复装备默认属性（清除升级次数）使用的是CHANGEITEMVAL命令而非检查命令。以下将直接提供正确的脚本架构、M2配置步骤及恢复属性的具体写法。
首先解决“主程序未定义”和命令报错问题。在GOM/GEE引擎中，UPGRADEITEM系列命令不是像CHECKITEM那样的通用查询命令，它们是动作命令，且对参数格式有极严格的限制。报错UPGRADEITEMEX 0 2 0 1 0通常是因为参数位置错误或引擎版本不支持该特定变体。最稳定且通用的升级触发方式是使用UPGRADEITEM标准格式，但前提是必须在M2Server的“功能设置”->“游戏选项”->“装备升级”中勾选“允许脚本控制升级”或类似选项（不同引擎版本名称略有差异）。若M2中未开启此权限，脚本中写任何升级命令都会报错。
正确的装备升级脚本逻辑不应直接执行升级，而应先将物品放入“升级专用NPC窗口”，由玩家确认后再触发引擎内置的升级流程。直接强制升级的脚本写法如下，请替换您原有的错误代码：
[@武器升级执行]
IF
CHECKITEM 武器 1
CHECKGOLD 100000
ACT
TAKE 金币 100000
; 参数说明：UPGRADEITEM 物品位置(0=背包,1=手中) 升级类型(0=普通) 成功率(0-100,0为读取M2配置)
; 注意：很多引擎版本要求物品必须在手中，即位置1，或者通过对话框放入特定容器
UPGRADEITEM 1 0 0
BREAK
若上述命令依然报“未定义”，说明您的引擎内核较老或使用了特殊的插件版，此时必须采用“假升级”模式：即脚本只负责扣除材料和金币，然后通过M2Server的自动检测机制或定时器在后台处理，或者使用CHANGEITEMVAL手动修改属性值（不推荐，容易坏档）。但在99%的GOM版本中，UPGRADEITEM 1 0 0是标准写法。报错中的0 2 0 1 0参数过多，标准格式通常只需3个参数：UPGRADEITEM 。
关于您询问的“恢复默认属性用哪个函数”，答案是CHANGEITEMVAL。CHECKITEMADDVALUE是检查命令，不能用于修改。要将一把+5或+6的武器重置为普通属性（即清除升级次数），需要使用CHANGEITEMVAL命令将物品的“强度”或“升级次数”字段改写为0。具体脚本如下：
[@恢复默认属性]
IF
CHECKITEM 武器 1
ACT
; 参数：CHANGEITEMVAL
; 字段索引：3代表升级次数（部分引擎为4，需测试，通常为3）
; 操作符：= 表示赋值
CHANGEITEMVAL 1 3 = 0
SENDMSG 6 您的武器已恢复至默认属性！
BREAK
如果CHANGEITEMVAL 1 3 = 0无效，尝试字段索引4。不同引擎对物品数据结构的定义略有不同，字段3通常对应“持久”，字段4对应“升级次数”或“强度”。您可以通过先给武器加一次属性测试哪个字段生效，再反向操作。例如先用CHANGEITEMVAL 1 3 + 1看是否升级，若是，则用= 0还原。
针对您提供的脚本片段，错误在于试图在#IF段或无条件的#ACT中直接堆砌多个升级命令且参数混乱。正确的完整NPC脚本结构应包含界面跳转、材料检查、执行升级、结果反馈四个步骤。以下是修正后的完整可用脚本示例，请直接复制到您的s001-3.txt文件中：
[@main]
欢迎来到武器升级中心\
当前可升级武器，每次消耗金币10万\
\
\
[@选择武器]
请将需要升级的武器拿在手中，然后点击确认。\
\
[@执行升级]
IF
CHECKITEMEFFECTIVE 1 ; 检查手中物品是否有效
CHECKGOLD 100000
ACT
TAKE 金币 100000
; 执行升级，位置1=手中，类型0=普通，概率0=使用M2默认配置
UPGRADEITEM 1 0 0
MOV S0 1
ELSEACT
SENDMSG 6 升级失败：请确保手中持有武器且金币充足！
MOVE S0 0
BREAK
[@升级结果检查]
; 此段落通常由引擎自动触发或通过定时器调用，若需立即反馈
IF
EQUAL S0 1
; 这里可以加入CHECKITEMADDVALUE来判断是否成功，但UPGRADEITEM命令本身会弹出系统提示
ACT
SENDMSG 6 升级请求已提交，请查看系统提示。
BREAK
[@恢复属性]
IF
CHECKITEM 武器 1
ACT
; 尝试清除升级次数，字段3或4视引擎而定
CHANGEITEMVAL 1 3 = 0
CHANGEITEMVAL 1 4 = 0
SENDMSG 6 武器属性已重置！
BREAK
关于“主程序未定义这个函数？在哪里添加”的疑问。UPGRADEITEM和CHANGEITEMVAL是引擎内置命令，不需要也不可以在脚本中“定义”或“添加”函数头。如果提示未定义，只有三种可能：1. 引擎版本过老不支持该命令（需更换引擎）；2. 命令拼写错误（如大小写敏感，必须全大写）；3. M2Server中未开启脚本控制权限。请打开M2Server控制台，点击“选项”->“参数设置”->“功能设置”，查找“允许脚本升级装备”或“启用扩展脚本命令”并勾选，保存重启M2即可。
对于UPGRADEITEMEX报错，该命令是某些特定引擎版本的扩展命令，用于更复杂的升级逻辑（如指定增加哪种属性）。如果您的引擎不支持，强行使用必报错。请坚持使用标准的UPGRADEITEM三参数格式。若标准命令无法满足需求（例如需要指定升级攻击还是道术），则必须通过CHANGEITEMVAL手动修改具体的属性字段（如最小攻击、最大攻击等），但这需要精确知道该物品在数据库中的字段偏移量，操作难度极大且易出错，不建议新手尝试。
最后，关于您提到的“已经在开头写了+5 +6”，这通常是指物品的当前状态。脚本无法直接读取“+5”这个文本显示，只能通过CHECKITEMADDVALUE 1 0 > 4（假设0代表升级次数）来判断。若要重置，就是利用CHANGEITEMVAL将该数值字段清零。请务必注意，CHANGEITEMVAL是高危命令，操作前建议在测试服验证字段索引，以免误删装备的其他重要属性（如持久度或随机属性）。
总结修复步骤：第一，检查M2Server设置，确保开启脚本升级权限；第二，将脚本中所有复杂的UPGRADEITEMEX和多参数命令替换为标准的UPGRADEITEM 1 0 0；第三，使用CHANGEITEMVAL 1 3 = 0或CHANGEITEMVAL 1 4 = 0来实现恢复默认属性功能；第四，确保物品在手中（位置1）再进行操作。按照此方案修改，即可解决黑屏、报错及功能失效问题。
