传奇361引擎装备开光脚本简单示例 从脚本头到开光完成触发的完整写法与NPC配置流程

361引擎的装备开光功能通过调用引擎内置的开光对话框来实现，脚本本身不需要编写复杂的属性计算逻辑，只需要在脚本头声明开光标签，在NPC对话中挂上按钮，再补充开光完成后的触发段落即可。下面按脚本头声明、NPC按钮配置、开光完成触发、数据库准备和常见错误五个部分拆解。

## 脚本头声明与标签格式

361引擎的装备开光脚本在NPC文件头部添加 `(@ArmUnseal)` 标签声明。脚本文件放在 `MirServer\Mir200\Envir\Market_Def\` 目录下，文件名与NPC名称一致。开头的写法：

```
(@ArmUnseal)
[@main]
有什么我可以帮你的。
<&装备开光/@ArmUnseal>
<&关闭/@exit>
```

`(@ArmUnseal)` 是361引擎识别开光功能的固定标签，必须写在脚本文件的最上方，不能在它前面添加其他内容。标签格式中的括号和@符号都不能省略，`Arm` 代表装备，`Unseal` 代表开光，这是引擎内部已经定义好的功能标识。

`<&装备开光/@ArmUnseal>` 是NPC对话中的按钮，点击后跳转到引擎内置的开光对话框。按钮文字可以自定义，比如改成“装备附魔”或“武器解封”，但 `@ArmUnseal` 这个跳转标识不能改，改了就调用不到引擎的开光界面。

如果版本中已经存在 `[@main]` 段落，把 `<&装备开光/@ArmUnseal>` 追加到已有对话选项列表中即可，不需要重建整个NPC脚本。

## 引擎内置开光对话框的工作方式

点击开光按钮后，361引擎会自动弹出一个独立的开光操作窗口，这个窗口不是脚本绘制的，而是引擎内置的UI界面。玩家在窗口中放入需要开光的装备，消耗指定的材料或货币，点击确认后由引擎自动完成开光流程。

引擎内部的开光逻辑包含三个判定环节。第一个环节检测放入的装备是否符合开光条件，通常在StdItems.DB的装备记录中有开光相关的字段标记。第二个环节扣除开光消耗品，消耗品的类型和数量由M2引擎的选项配置决定，不在脚本中硬编码。第三个环节随机生成开光属性，属性类型和数值范围由引擎内置的随机规则控制。

脚本层面能干预的只有入口和结果，中间的执行过程由引擎接管。这也是361引擎开光脚本比其他引擎手动计算属性的写法简洁的原因。

## 开光完成后的触发段落

装备开光成功后，引擎会自动触发当前NPC脚本中的 `[@ArmUnseal_OK]` 段落。这个段落用于在开光完成后给玩家发送提示或发放额外奖励。基本写法：

```
[@ArmUnseal_OK]
#ACT
SendMsg 5 装备开光成功！新的属性已附加到装备上。
Break
```

`SendMsg 5` 是发送聊天框提示，数字5代表消息颜色。`Break` 命令用于跳出当前脚本段落，防止脚本继续往下执行其他不相关的逻辑。

如果需要获取被开光装备的编号，用 `<$PARAM(0)>` 变量引用。这个变量在 `[@ArmUnseal_OK]` 段落中自动可用，返回的是装备的MakeIndex值。需要记录开光日志时，把 `<$PARAM(0)>` 写入文本文件：

```
[@ArmUnseal_OK]
#ACT
AddTextList <$USERNAME> 开光装备编号<$PARAM(0)> ..\QuestDiary\开光记录.txt
SendMsg 5 装备开光成功！
Break
```

## 开光消耗与条件配置

开光消耗的材料和货币在M2引擎的选项菜单中设置，不需要在脚本中写消耗扣除命令。启动M2Server后进入选项菜单，找到功能设置中的装备开光子项，在其中配置开光需要的物品名称、数量、金币消耗和成功率。

需要在开光前增加额外的条件限制，比如等级限制或前置任务检测，可以在 `[@main]` 段落中增加判断。按钮的跳转逻辑改为先进入条件检测段落，条件通过后再跳转到 `@ArmUnseal`：

```
[@main]
#IF
CHECKLEVEL > 49
#ACT
#SAY
有什么我可以帮你的。
<&装备开光/@ArmUnseal>
<&关闭/@exit>
#ELSESAY
你的等级不足50级，无法使用装备开光功能。
<&关闭/@exit>
```

`CHECKLEVEL > 49` 检测等级是否大于49。等级不足的玩家看到 `#ELSESAY` 中的提示，不会进入开光对话框。等级足够的玩家看到 `#SAY` 中的开光按钮，点击后正常调用引擎开光界面。

## 数据库层面的开光前提

装备本身需要在StdItems.DB中具备开光相关的字段标记。打开DBC2000数据库编辑器，进入HeroDB，找到StdItems.DB表，定位需要支持开光的装备记录，确认其Anicount字段的值。部分361引擎版本中，Anicount字段的值决定了装备是否可开光，具体取值需要参考当前引擎版本的文档说明。

另一种常见的做法是在M2引擎的装备开光配置中直接指定可开光的物品名称列表，引擎会按名称匹配，不依赖数据库字段。这种配置方式下，脚本层不需要做任何数据库改动，只需要在M2选项菜单中把允许开光的装备名称逐个勾选。

## 常见问题与排查

开光按钮点击后无反应，先检查脚本头部的 `(@ArmUnseal)` 标签是否写在了文件最上方，标签前面有空格或空行都可能导致引擎无法识别。再检查按钮的跳转标识是否写成了 `@ArmUnseal`，大小写错误或拼写错误都会导致跳转失败。

开光对话框弹出但放入装备后无法点击确认，通常是引擎的开光配置中没有启用该装备的开光权限。进入M2选项菜单，确认装备开光功能已开启，且放入的装备名称在允许开光的列表中。

开光完成后没有触发 `[@ArmUnseal_OK]` 段落中的提示，检查该段落是否写在了同一个NPC脚本文件中。触发位置是当前开光功能NPC的脚本中，写到其他NPC文件或QFunction-0.txt中都不会被触发。

脚本文件必须保存为ANSI编码。用记事本另存为时在编码下拉菜单中选ANSI，选UTF-8会导致中文提示乱码，虽然英文标签本身不受影响，但脚本中的中文内容解析错误可能导致脚本执行中断。

修改脚本后重启M2Server，或在控制台执行 `@ReloadManage` 重新加载Market_Def目录下的NPC脚本。`[@ArmUnseal_OK]` 段落修改后同样需要重新加载才能生效。