传奇3K引擎装备互换脚本完整教程 从基础结构到检测命令与变量配置及常见报错详解

3K引擎的装备互换脚本核心逻辑就三行命令，CHECKITEM检测背包是否有原装备，TAKE扣除原装备，GIVE发放目标装备。脚本结构简单，但写的时候有几个细节不注意会导致互换失败或装备被吞，下面按脚本文件路径、基础脚本写法、性别与职业转换、检测命令、变量与费用控制、装备改名保护、常见报错七个方面拆解。

## 脚本文件存放路径与NPC配置

装备互换脚本放在 `MirServer\Mir200\Envir\Market_Def\` 目录下，文件名与NPC名称一致，后缀中的数字代表地图编号。比如NPC放在盟重省（地图编号3），文件名写“装备互换员-3.txt”，MerChant.txt中注册的地图编号同步写3。文件保存为ANSI编码，用记事本另存为时在编码下拉菜单中选ANSI，选UTF-8会导致中文字符串乱码。

MerChant.txt中追加NPC注册行的格式为：NPC名称 地图编号 X坐标 Y坐标 外观编号 朝向。比如“装备互换员 3 330 330 102 0”，表示在盟重省坐标(330,330)位置创建一个外观编号为102的NPC。

## 基础装备互换脚本写法

以龙泉神甲和龙泉神袍互换为例，脚本主界面列出互换选项，每个选项跳转到独立的处理段落：

```
[@main]
<装备互换不收取任何费用，我可以为你免费服务>\
<高级衣服互换/@高级衣服互换>\

[@高级衣服互换]
<龙泉神甲 换 龙泉神袍/@换衣51>\
<龙泉神袍 换 龙泉神甲/@换衣52>\

[@换衣51]
#IF
CHECKITEM 龙泉神甲 1
#ACT
TAKE 龙泉神甲 1
GIVE 龙泉神袍 1
MESSAGEBOX 您的装备互换成功！
GOTO @高级衣服互换
#ELSEACT
CLOSE
MESSAGEBOX 你没有相应的衣服，无法兑换。
```

每个互换段落的结构固定。#IF中CHECKITEM检测玩家背包中是否有至少1个龙泉神甲，条件成立时#ACT中TAKE扣除龙泉神甲，GIVE发放龙泉神袍，MESSAGEBOX弹出提示框，GOTO跳回互换页面让玩家继续操作。条件不成立时走#ELSEACT分支，CLOSE关闭对话框并弹出失败提示。

TAKE后面的数量必须与CHECKITEM中的数量一致。CHECKITEM检测1个，TAKE就扣1个。检测和扣除的数量不一致会出现装备被吞或互换后背包里原装备还在的异常。

## 性别转换与职业转换的装备互换

3K引擎的装备互换脚本最常见的应用场景是性别转换和职业转换。以下是将金牛圣衣（女）换成金牛圣衣（男）的脚本写法：

```
[@aCaa9]
#IF
CHECKITEM 金牛圣衣(女) 1
CHECKGAMEGOLD > 30000
#ACT
GAMEGOLD - 30000
TAKE 金牛圣衣(女) 1
GIVE 金牛圣衣(男) 1
GOTO @兑换44a
BREAK
#IF
#ACT
MESSAGEBOX [谬误信息]:你没有换金牛圣衣(男)的物品或元宝无余！
BREAK
```

这段脚本同时检测了物品和元宝两个条件。CHECKITEM 金牛圣衣(女) 1 检测背包中是否有该装备，CHECKGAMEGOLD > 30000 检测元宝是否足够。两个条件同时成立才执行扣费和互换。物品名称中的括号必须使用英文半角，中文全角括号会导致CHECKITEM检测失败。

职业转换类互换的脚本结构完全相同，只需要把物品名称改为对应职业的装备名称，比如王者之杖（法师）换成王者之刃（战士）：

```
[@aaa11abb]
#IF
CHECKITEM 王者之杖 1
CHECKGAMEGOLD > 1000
#ACT
GAMEGOLD - 1000
TAKE 王者之杖 1
GIVE 王者之刃 1
GOTO @MAIN
BREAK
#IF
#ACT
MESSAGEBOX [谬误信息]:你没有换王者之刃的物品或元宝无余！
BREAK
```

## 核心检测命令详解

CHECKITEM命令用于检测玩家背包中是否有指定物品，格式为CHECKITEM 物品名称 数量。数量填1表示至少有一个，填2表示至少有两个。该命令只能写在#IF段落中作为条件判断，不能写在#ACT中执行。

CHECKITEMW命令用于检测玩家身上是否佩带着指定物品，格式为CHECKITEMW 物品名称 数量。区别在于CHECKITEM检测的是背包，CHECKITEMW检测的是身上穿戴的装备栏。装备互换场景中通常使用CHECKITEM，因为玩家互换的装备是放在背包里的。

CHECKGAMEGOLD命令检测元宝数量，格式为CHECKGAMEGOLD > 数值。与CHECKITEM配合使用时，两个条件写在同一个#IF段落中，每个条件独占一行，不需要用AND连接，多个条件同时成立才会执行#ACT。

TAKE命令从玩家身上扣除物品，格式为TAKE 物品名称 数量。TAKE不会自动判断物品是否存在，如果CHECKITEM检测没有通过而TAKE仍然执行，会出现扣除空气的情况。所有TAKE命令必须放在CHECKITEM条件成立的#ACT段落中。

GIVE命令给玩家发放物品，格式为GIVE 物品名称 数量。与TAKE成对出现，一个互换脚本段落中TAKE和GIVE的数量必须对应，TAKE扣了原装备，GIVE就要发放目标装备，不能只扣不给。

## 变量与费用控制

元宝扣除使用GAMEGOLD - 数值，元宝增加使用GAMEGOLD + 数值。检测条件写CHECKGAMEGOLD > 数值减1，比如扣除1000元宝，检测条件写CHECKGAMEGOLD > 999，这样元宝恰好等于1000时也能通过检测。

如果需要用金币作为互换费用，用CHECKGOLD检测金币数量，GOLD - 数值扣除金币。其他货币类型中，CHECKGAMEPOINT检测游戏点数，CHECKGAMEPOINT > 99表示点数大于99。

部分版本中装备互换需要消耗特定道具作为费用，脚本中增加CHECKITEM检测道具，通过后TAKE扣除道具：

```
[@互换]
#IF
CHECKITEM 龙泉神甲 1
CHECKITEM 互换凭证 1
#ACT
TAKE 龙泉神甲 1
TAKE 互换凭证 1
GIVE 龙泉神袍 1
MESSAGEBOX 互换成功！
BREAK
```

## 装备改名保护与漏洞防范

装备互换脚本存在一个常见漏洞，玩家将原装备改名后仍可通过CHECKITEM检测，互换后获得一件全新名称的目标装备。3K引擎的TAKE命令支持第三个参数用于控制是否检测装备改名，格式为TAKE 物品名称 数量 是否检测改名。第三个参数填0或留空表示不检测改名，填1表示检测装备改名。互换场景中建议填1，防止玩家通过改名绕过限制。

另一个漏洞是GIVE和TAKE不成对导致的复制问题。排查方法是使用脚本变量编辑器全局搜索所有GIVE和TAKE命令，确认每对GIVE和TAKE的数量一致，TAKE一个龙泉神甲就GIVE一个龙泉神袍，数量不对应会导致装备复制。

BREAK命令在每个互换段落末尾必须添加，用于跳出当前脚本段落，防止脚本继续往下执行触发其他不相关的互换逻辑。遗漏BREAK会导致玩家点击一个互换选项后，脚本继续执行后面的互换段落，出现连锁互换的异常。

## 多档位互换页面布局

装备互换NPC通常需要管理几十种装备的互换关系，所有互换选项挤在一页会导致脚本难以维护。建议按装备类型分页，主界面列出分类入口，每个分类页面列出该类别下的所有互换选项：

```
[@main]
<高级衣服互换/@高级衣服互换>\
<高级特戒互换/@高级特戒互换>\
<武器互换/@武器互换>\

[@高级衣服互换]
<龙泉神甲 换 龙泉神袍/@换衣51>\
<龙泉神袍 换 龙泉神甲/@换衣52>\
<天怒神甲 换 天怒神袍/@换衣21>\
<天怒神袍 换 天怒神甲/@换衣22>\
<返回主菜单/@main>\
```

每个分类页面底部加一个返回主菜单的按钮，玩家的操作流程不中断。装备数量较多时，每个分类页面内可以再加二级分类，比如武器按剑、刀、杖分为三个子页面。

## 常见报错与排查

CHECKITEM检测不通过但背包里确实有该装备，检查物品名称是否与StdItems.DB中的记录完全一致。打开DBC2000编辑器进入StdItems.DB表，核对装备名称的每一个字符，包括括号类型（英文半角还是中文全角）、空格位置和标点符号。数据库中的名称多一个空格或少一个括号，CHECKITEM检测就会失败。

互换后装备被吞，原装备被扣除了但目标装备没有发放。检查TAKE和GIVE是否在同一个#ACT段落中，两者之间不能插入条件判断或跳转命令。同时确认GIVE后面的物品名称是否与StdItems.DB中已有的物品名称完全一致，写了一个数据库中不存在的物品名称，GIVE命令执行后不会发放任何东西。

互换后元宝没有扣除，检查CHECKGAMEGOLD的检测条件和GAMEGOLD扣除数值是否匹配。检测写> 999扣除1000是正确的，检测写> 1000扣除1000会导致元宝恰好等于1000时检测不通过，玩家看到互换失败但元宝未被扣除。

脚本不执行或跳转失败，检查#IF和#ACT的书写是否完整，每个#IF后面必须有#ACT或#SAY。跳转标签的名称必须与#SAY中按钮的@跳转标识完全一致，大小写敏感，@换衣51和@换衣 51（含空格）会被视为不同的标识。

所有脚本文件必须保存为ANSI编码。用记事本另存为时在编码下拉菜单中选ANSI，选UTF-8会导致中文字符串乱码，虽然英文命令CHECKITEM、TAKE、GIVE本身不受影响，但脚本中的中文装备名称和提示文字如果出现乱码，会导致条件判断失败或跳转目标找不到。

修改脚本后重启M2Server，或在控制台执行@ReloadManage重新加载Market_Def目录下的NPC脚本。修改StdItems.DB后需要在M2控制台重载物品数据库才能让新的物品数据生效。