传奇原创武器升级不碎完整脚本实现方案

传奇武器升级系统中，破碎机制是玩家最关注的痛点。通过脚本层面的精确控制，可以实现武器升级失败不破碎的效果。以下是基于UPGRADEITEMEX命令的完整实现方案。

### 一、核心原理：UPGRADEITEMEX命令参数解析

武器升级不碎的实现核心在于UPGRADEITEMEX命令的第五个参数。该命令的完整格式为：UPGRADEITEMEX 物品位置(0-12) 属性位置(0-14) 成功机率(0-100) 点数机率(0-255) 是否破碎(0,1)

物品位置参数中，1代表武器，其余位置对应盔甲、项链、手镯、戒指等装备槽位。属性位置参数中，0代表攻击，1代表魔法，2代表道术，3代表幸运，4代表诅咒，5代表准确，14代表持久。

第五个参数“是否破碎”是关键控制点，数值为0时升级失败后装备不破碎，数值为1时失败后装备直接消失。部分引擎还支持参数值2，代表失败后还原为默认属性。

例如，要将武器攻击属性以100%成功率提升1点且失败不碎，命令写法为：UPGRADEITEMEX 1 0 100 1 0。要将武器幸运属性以100%成功率提升1点且失败不碎，写法为：UPGRADEITEMEX 1 3 0 1 0。

### 二、完整NPC脚本代码

以下是一个可直接使用的武器升级NPC脚本，放置在Market_Def文件夹下的对应NPC脚本文件中。脚本包含材料检测、升级执行、结果反馈三个完整模块。

```
[@main]
#IF
#ACT
OpenBigDialogBox -1
#SAY
武器升级大师为你服务。\
升级武器需要：\<黑铁矿 5块/@检查材料>\
\<职业首饰 2件/@检查材料>\
\<金币 100000/@检查材料>\
\
<我要升级武器/@开始升级>\
<离开/@exit>

[@开始升级]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
UPGRADEITEMEX 1 0 80 1 0
SENDMSG 6 升级完成，武器属性已提升。
BREAK
#ELSESAY
材料不足。需要黑铁矿5块、金币100000。

[@检查材料]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
SENDMSG 6 材料齐全，可以升级。
#ELSESAY
材料不足，请准备黑铁矿5块和金币100000。
```

脚本说明：CHECKITEM检测黑铁矿数量，CHECKGOLD检测金币数量，条件满足后TAKE扣除材料，UPGRADEITEMEX执行升级。参数1 0 80 1 0中，1代表武器，0代表攻击属性，80代表80%成功率，1代表每次增加1点，0代表失败不破碎。

### 三、带成功率衰减的进阶脚本

当武器升级次数增加时，需要动态调整成功率。以下脚本使用变量记录升级次数，每次成功后降低后续成功率。

```
[@main]
#IF
#ACT
MOV P0 0
#SAY
当前武器升级次数：<$STR(P0)>\
<升级武器/@do_upgrade>\
<离开/@exit>

[@do_upgrade]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
INC P0 1
#IF
EQUAL P0 1
#ACT
UPGRADEITEMEX 1 0 100 1 0
SENDMSG 6 第1次升级，成功率100%。
#IF
EQUAL P0 2
#ACT
UPGRADEITEMEX 1 0 85 1 0
SENDMSG 6 第2次升级，成功率85%。
#IF
EQUAL P0 3
#ACT
UPGRADEITEMEX 1 0 70 1 0
SENDMSG 6 第3次升级，成功率70%。
#IF
EQUAL P0 4
#ACT
UPGRADEITEMEX 1 0 55 1 0
SENDMSG 6 第4次升级，成功率55%。
#IF
EQUAL P0 5
#ACT
UPGRADEITEMEX 1 0 40 1 0
SENDMSG 6 第5次升级，成功率40%。
#IF
LARGE P0 5
#ACT
UPGRADEITEMEX 1 0 25 1 0
SENDMSG 6 第6次及以上升级，成功率25%。
BREAK
```

此脚本使用私人变量P0记录升级次数，每次升级后递增。成功率从100%逐步递减至25%，但所有升级操作的第五个参数均为0，确保失败时武器不会破碎。

### 四、多属性升级脚本

如需同时支持攻击、魔法、道术、幸运四种属性的升级，可分别设置不同的按钮和参数。

```
[@main]
#SAY
请选择升级属性：\
<升级攻击/@up_dc>\
<升级魔法/@up_mc>\
<升级道术/@up_sc>\
<升级幸运/@up_luck>\
<离开/@exit>

[@up_dc]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
UPGRADEITEMEX 1 0 80 1 0
SENDMSG 6 攻击属性升级完成。

[@up_mc]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
UPGRADEITEMEX 1 1 80 1 0
SENDMSG 6 魔法属性升级完成。

[@up_sc]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
UPGRADEITEMEX 1 2 80 1 0
SENDMSG 6 道术属性升级完成。

[@up_luck]
#IF
CHECKITEM 黑铁矿 5
CHECKGOLD 100000
#ACT
TAKE 黑铁矿 5
TAKE 金币 100000
UPGRADEITEMEX 1 3 100 1 0
SENDMSG 6 幸运属性升级完成。
```

各属性的位置参数分别为：攻击0、魔法1、道术2、幸运3。幸运属性升级成功率设为100%，因为幸运值上限通常为7点，超出后无意义，高成功率可减少玩家挫败感。

### 五、跨引擎适配要点

不同引擎对UPGRADEITEMEX命令的支持存在差异。

Legend引擎和Herom2引擎中，第五参数为0表示不破碎，1表示破碎。命令兼容性较好，可直接使用上述脚本。

GOM引擎需要在M2Server中额外确认一项设置：打开M2控制器，进入功能设置中的升级武器选项，勾选“武器升级失败不破碎”。即使脚本中第五参数设为0，部分GOM版本仍需在引擎配置中同步开启此选项才能生效。

GEE引擎和V8引擎对UPGRADEITEMEX命令的支持与Legend基本一致。需要注意脚本路径分隔符必须使用“..\”格式，与Hero引擎的“.\”格式不同。

Blue引擎的部分版本中，第五参数支持值2，即失败后还原装备的默认属性而非不破碎。使用前需查阅对应引擎版本的命令说明。

996引擎的适配方式较为特殊，需要在引擎自定义设置中启用“装备为0不破碎”选项，脚本层面的命令转换需要使用引擎自带的转换工具完成。

### 六、脚本部署与验证

将脚本内容写入Market_Def文件夹下对应的NPC脚本文件中。文件命名需与NPC在MerChant.txt中的脚本路径配置一致。

部署后进入游戏测试。在M2Server控制台执行“重新加载NPC”命令使脚本生效。与NPC对话，检查各个按钮的响应是否正常。提交材料后观察升级结果：成功时武器属性应增加，失败时武器应保留且不消失。若失败后武器消失，检查UPGRADEITEMEX命令的第五参数是否确为0，并确认引擎配置中是否有额外的破碎开关需要关闭。

测试完成后检查M2Server控制台是否有红色报错信息。常见报错包括变量未定义、命令参数数量不符等，根据控制台提示的行号和文件名定位问题并修正。