传奇3K引擎终极冒险岛活动脚本编写与配置方法

终极冒险岛属于分层挑战型地图活动，玩家通过入口NPC进入冒险岛地图，逐层击杀怪物推进关卡，每层有独立的怪物配置和通关条件，最终层设有终极BOSS。整个脚本围绕地图进入检测、分层传送、怪物死亡判定和通关奖励四个模块展开。3K引擎的脚本语法与Hero引擎基本一致，但在变量作用域和部分命令细节上存在差异。以下从完整脚本范例入手，逐段拆解终极冒险岛活动的编写方法。

## 入口NPC脚本范例

在Market_Def目录下新建NPC脚本文件，写入以下内容：

```
[@main]
<$USERNAME>，欢迎来到终极冒险岛。
当前层数：<$STR(N$冒险层)>层
<进入冒险岛/@进入检测> <通关奖励/@领奖> <离开/@exit>

[@进入检测]
#IF
CHECKLEVELEX > 99
CHECKGAMEGOLD > 999
#ACT
GAMEGOLD - 1000
MOV N$冒险层 1
MAPMOVE xr001 50 50
SENDMSG 0 玩家[%s]进入终极冒险岛，开始挑战第一层！
SENDMSG 6 你已进入冒险岛第一层，每层怪物全部清空后自动传送下一层。
#ELSESAY
对不起，等级不足100级或元宝不足1000，无法进入终极冒险岛。
```

这段脚本的逻辑链条分两层：[@main]展示当前层数和操作选项，[@进入检测]执行进入判断。CHECKLEVELEX > 99检测等级是否超过99级，CHECKGAMEGOLD > 999检测元宝是否超过999。两项条件同时满足才扣除1000元宝、设置变量N$冒险层为1并通过MAPMOVE传送到地图xr001的坐标50,50。3K引擎中的MAPMOVE命令格式为“MAPMOVE 地图名 X坐标 Y坐标”，部分引擎版本要求地图名使用地图编号。

MOV N$冒险层 1中，N$前缀表示数值型变量，与字符串型变量S$区分。3K引擎对变量作用域较为敏感，N$变量在同一次对话中有效，跨地图触发时需要配合SAVEVAR持久化存储。

## 分层传送与怪物清空检测

终极冒险岛的核心机制是逐层推进。每层地图配置独立怪物，怪物全部被击杀后自动触发传送脚本进入下一层。在MapQuest.txt中为每层地图配置死亡触发：

```
xr001 [000] 0 冒险层1 * 冒险层1怪 1:@冒险层1通关
xr002 [001] 0 冒险层2 * 冒险层2怪 1:@冒险层2通关
xr003 [002] 0 冒险层3 * 冒险层3怪 1:@冒险层3通关
```

MapQuest.txt的格式依次为：地图号、触发编号、条件、怪物名称、是否广播、脚本段。最后一段“1:@冒险层1通关”表示怪物死亡后跳转到QFunction-0.txt中的@冒险层1通关标签执行。

在QFunction-0.txt中添加各层的通关处理脚本：

```
[@冒险层1通关]
#IF
CHECKMAPMOBCOUNT xr001 冒险层1怪 > 0
#ACT
BREAK
#IF
CHECKMAPMOBCOUNT xr001 冒险层1怪 = 0
#ACT
MOV N$冒险层 2
MAPMOVE xr002 50 50
SENDMSG 6 恭喜通过第一层！你已进入第二层。
SENDMSG 0 玩家[%s]通过了终极冒险岛第一层！
BREAK

[@冒险层2通关]
#IF
CHECKMAPMOBCOUNT xr002 冒险层2怪 > 0
#ACT
BREAK
#IF
CHECKMAPMOBCOUNT xr002 冒险层2怪 = 0
#ACT
MOV N$冒险层 3
MAPMOVE xr003 50 50
SENDMSG 6 恭喜通过第二层！你已进入第三层。
SENDMSG 0 玩家[%s]通过了终极冒险岛第二层！
BREAK
```

CHECKMAPMOBCOUNT用于检测指定地图上指定怪物的剩余数量，格式为“CHECKMAPMOBCOUNT 地图号 怪物名称 比较符 数量”。这是3K引擎的怪物数量检测命令，与Hero引擎的CheckRangeMonCount功能类似但参数格式不同。检测条件写“> 0”表示还有怪物存活时直接BREAK结束，不执行传送；写“= 0”表示怪物全部清空时执行传送。

每个通关标签的第一段检测是必要的。MapQuest的死亡触发在每只怪物死亡时都会执行一次，如果不加怪物数量检测，击杀第一只怪物就会触发传送，导致玩家在怪物未清空的情况下提前进入下一层。

## 终极BOSS层与通关奖励

在最后一层设置终极BOSS，击杀后发放通关奖励。在QFunction-0.txt中添加最终层通关脚本：

```
[@冒险层5通关]
#IF
CHECKMAPMOBCOUNT xr005 冒险岛终极BOSS > 0
#ACT
BREAK
#IF
CHECKMAPMOBCOUNT xr005 冒险岛终极BOSS = 0
#ACT
MOV N$冒险层 0
GIVE 冒险岛通关证明 1
GIVE 金刚石 50
GAMEGOLD + 5000
SENDMSG 0 玩家[%s]成功通关终极冒险岛，获得了终极奖励！
SENDMSG 6 恭喜通关终极冒险岛！获得冒险岛通关证明1个、金刚石50个、元宝5000。
MAPMOVE 3 330 330
BREAK
```

通关后N$冒险层重置为0，发放通关证明和元宝奖励，并通过MAPMOVE传回盟重土城。如果版本需要设置通关次数限制，可以在发放奖励前加入CHECKNAMELIST检测，确认玩家名字是否已在通关名单中，避免重复领取。

## 地图与怪物配置

在Envir目录下的MapInfo.txt中注册终极冒险岛的六层地图：

```
[xr001 冒险岛第一层] NOPOSITION
[xr002 冒险岛第二层] NOPOSITION
[xr003 冒险岛第三层] NOPOSITION
[xr004 冒险岛第四层] NOPOSITION
[xr005 冒险岛第五层] NOPOSITION
```

NOPOSITION参数表示该地图不允许使用随机传送和回城卷，强制玩家只能通过脚本传送进出。每层地图的怪物刷新通过MonGen.txt配置，格式为“地图号 坐标X 坐标Y 怪物名称 刷新范围 刷新数量 刷新间隔”，刷新间隔单位是分钟。

以冒险岛第一层的怪物配置为例：

```
xr001 50 50 冒险层1怪 30 40 10
```

这表示在xr001地图50,50坐标周围30格范围内刷新40只“冒险层1怪”，刷新间隔10分钟。3K引擎中MonGen的怪物名称必须与怪物数据库中的名称完全一致。

## 怪物爆率配置

在Mir200\Envir\MonItems目录下为每层怪物创建爆率文件，文件名与怪物名称一致。以“冒险层1怪.txt”为例：

```
1/1 金币 500
1/5 元宝 10
1/50 金刚石 1
1/200 冒险岛宝箱 1
```

爆率格式中斜杠左侧为分母，右侧为掉落数量。1/50表示50次击杀掉落1个金刚石。终极BOSS的爆率文件相应提高掉落品质：

```
1/1 金币 10000
1/2 元宝 500
1/3 金刚石 20
1/20 冒险岛通关证明 1
1/100 终极屠龙 1
```

## 3K引擎适配要点

3K引擎的脚本命令与Hero引擎存在几处关键差异。输入框处理方面，Hero引擎的输入完成后跳转到“[@CallInPutStringX]”标签，3K引擎直接跳转到“[@InPutStringX]”标签，没有Call前缀。如果脚本中使用了输入框功能，标签命名必须按引擎规范调整。

非法字符过滤方面，3K引擎需要开发者在Mir200\Config目录下的FilterMsg.txt中自行配置过滤列表，触发过滤后跳转到@IsInFilterList标签处理。如果版本使用了玩家名输入功能，必须确认该配置文件存在且格式正确，否则输入特殊字符可能导致脚本异常。

3K引擎支持CheckMonsterExist命令用于检测指定地图是否存在目标BOSS，与CheckMapMobCount配合使用可以实现更精细的BOSS存活状态查询。CheckMonsterExist检测BOSS是否存活，CheckMapMobCount检测普通怪物剩余数量，两者分工明确。

3K引擎的MAPMOVE命令在地图参数上对数字编号的兼容性更好。脚本中建议使用地图编号而非中文地图名，例如MAPMOVE 3代替MAPMOVE 盟重省，避免中文编码解析异常导致传送失败。

## 部署验证步骤

脚本文件放入对应目录后，在M2控制台执行重新加载所有NPC和重载MapQuest。用一个100级以上的测试角色与NPC对话，依次验证：等级或元宝不足时是否正确拦截、进入后是否正确传送到第一层并扣减元宝、击杀第一层全部怪物后是否自动传送到第二层、击杀最终BOSS后是否正确发放奖励并传回土城。

如果怪物清空后不触发传送，优先检查MapQuest.txt中触发编号和QFunction-0.txt中标签名的对应关系。3K引擎对MapQuest中的触发编号格式较为严格，编号必须用方括号包裹且与怪物名称之间用空格分隔，多一个空格或少一个括号都会导致触发失效。如果每层传送后变量N$冒险层没有更新，检查MOV命令的变量名是否拼写一致，3K引擎中N$前缀缺失会导致变量被当作字符串处理。