在传奇中，NPC（非玩家角色）脚本文件是实现各种游戏交互功能的核心，它定义了 NPC 与玩家之间的对话、任务发布、物品交易等行为。以下将详细介绍传奇 NPC 脚本文件的基本结构。
## 一、标签系统
### （一）标签的定义与作用
标签是 NPC 脚本文件的基本组织单位，用于划分不同的功能模块和对话场景。每个标签以 `[@标签名]` 的形式开头，它标识了一段特定功能代码的起始位置。标签名可以根据其功能进行自定义，例如 `[@main]` 通常作为主对话标签，是玩家与 NPC 交互时首先显示的内容；`[@任务领取]` 可用于处理玩家领取任务的相关逻辑。
### （二）常见标签示例
- **[@main]**
这是最常用的标签之一，用于定义 NPC 的初始对话内容。当玩家与 NPC 对话时，首先会显示 `[@main]` 标签下的文本信息。例如：
```plaintext
[@main]
欢迎来到新手村！我这里有一些任务可以交给你，<领取任务/@任务领取>
```
在这个例子中，玩家点击“领取任务”选项后，会触发 `[@任务领取]` 标签下的内容。
- **[@对话选项跳转标签]**
用于处理玩家在对话中选择某个选项后的逻辑。如上述例子中的 `[@任务领取]`，当玩家选择“领取任务”时，脚本会跳转到该标签执行相应的代码。
```plaintext
[@任务领取]
#IF
CheckItem 破旧的信件 1
#ACT
TakeItem 破旧的信件 1
Give 新手剑 1
SendMsg 6 你已成功领取新手剑作为任务奖励！
```
## 二、条件判断部分（#IF）
### （一）条件判断的作用
`#IF` 部分用于设置执行后续操作的前提条件。只有当 `#IF` 中的条件都满足时，才会执行 `#ACT` 部分的命令。这使得 NPC 的行为可以根据玩家的不同状态（如等级、物品持有情况、任务完成进度等）进行动态调整。
### （二）常见条件判断语句
- **CheckLevelGreater [等级]**
用于检查玩家的等级是否大于指定的等级。例如 `CheckLevelGreater 10` 表示检查玩家等级是否大于 10 级。
- **CheckItem [物品名称] [数量]**
检查玩家背包中是否持有指定数量的某种物品。如 `CheckItem 金币 100` 表示检查玩家背包中是否有 100 个金币。
- **CheckQuest [任务名称] [任务状态]**
检查玩家的某个任务是否处于指定的状态，任务状态通常有 0（未接受）、1（已接受未完成）、2（已完成）等。例如 `CheckQuest 新手任务 1` 表示检查玩家是否已接受但未完成“新手任务”。
## 三、执行命令部分（#ACT）
### （一）执行命令的功能
`#ACT` 部分包含了在 `#IF` 条件满足时需要执行的具体操作。这些操作可以是给予玩家物品、扣除物品、打开商店界面、发送消息等。
### （二）常见执行命令语句
- **Give [物品名称] [数量]**
给予玩家指定数量的某种物品。例如 `Give 魔法药水 5` 表示给予玩家 5 瓶魔法药水。
- **TakeItem [物品名称] [数量]**
从玩家背包中扣除指定数量的某种物品。如 `TakeItem 矿石 2` 表示从玩家背包中扣除 2 个矿石。
- **OpenShop [商店编号]**
打开指定编号的商店界面，让玩家可以进行物品交易。例如 `OpenShop 1` 表示打开编号为 1 的商店。
- **SendMsg [消息类型] [消息内容]**
向玩家发送消息。消息类型通常用数字表示，如 6 表示系统消息，会以醒目的方式显示在玩家界面上。例如 `SendMsg 6 你已成功完成任务！`
## 四、注释部分
### （一）注释的作用
注释用于对脚本代码进行解释说明，方便开发者理解和维护脚本。注释内容不会被游戏服务器执行，只是为了提高代码的可读性。
### （二）注释的写法
在脚本文件中，以 `;` 开头的行表示注释。例如：
```plaintext
; 这是一个注释，说明下面的代码用于处理玩家领取任务的逻辑
[@任务领取]
#IF
CheckItem 破旧的信件 1
#ACT
TakeItem 破旧的信件 1
Give 新手剑 1
SendMsg 6 你已成功领取新手剑作为任务奖励！
```
通过以上几个部分的组合，传奇 NPC 脚本文件可以实现复杂多样的交互功能，为玩家带来丰富的游戏体验。不同的传奇版本可能会在脚本语法和支持的命令上存在一些差异，但基本的结构和原理是相似的。
## 一、标签系统
### （一）标签的定义与作用
标签是 NPC 脚本文件的基本组织单位，用于划分不同的功能模块和对话场景。每个标签以 `[@标签名]` 的形式开头，它标识了一段特定功能代码的起始位置。标签名可以根据其功能进行自定义，例如 `[@main]` 通常作为主对话标签，是玩家与 NPC 交互时首先显示的内容；`[@任务领取]` 可用于处理玩家领取任务的相关逻辑。
### （二）常见标签示例
- **[@main]**
这是最常用的标签之一，用于定义 NPC 的初始对话内容。当玩家与 NPC 对话时，首先会显示 `[@main]` 标签下的文本信息。例如：
```plaintext
[@main]
欢迎来到新手村！我这里有一些任务可以交给你，<领取任务/@任务领取>
```
在这个例子中，玩家点击“领取任务”选项后，会触发 `[@任务领取]` 标签下的内容。
- **[@对话选项跳转标签]**
用于处理玩家在对话中选择某个选项后的逻辑。如上述例子中的 `[@任务领取]`，当玩家选择“领取任务”时，脚本会跳转到该标签执行相应的代码。
```plaintext
[@任务领取]
#IF
CheckItem 破旧的信件 1
#ACT
TakeItem 破旧的信件 1
Give 新手剑 1
SendMsg 6 你已成功领取新手剑作为任务奖励！
```
## 二、条件判断部分（#IF）
### （一）条件判断的作用
`#IF` 部分用于设置执行后续操作的前提条件。只有当 `#IF` 中的条件都满足时，才会执行 `#ACT` 部分的命令。这使得 NPC 的行为可以根据玩家的不同状态（如等级、物品持有情况、任务完成进度等）进行动态调整。
### （二）常见条件判断语句
- **CheckLevelGreater [等级]**
用于检查玩家的等级是否大于指定的等级。例如 `CheckLevelGreater 10` 表示检查玩家等级是否大于 10 级。
- **CheckItem [物品名称] [数量]**
检查玩家背包中是否持有指定数量的某种物品。如 `CheckItem 金币 100` 表示检查玩家背包中是否有 100 个金币。
- **CheckQuest [任务名称] [任务状态]**
检查玩家的某个任务是否处于指定的状态，任务状态通常有 0（未接受）、1（已接受未完成）、2（已完成）等。例如 `CheckQuest 新手任务 1` 表示检查玩家是否已接受但未完成“新手任务”。
## 三、执行命令部分（#ACT）
### （一）执行命令的功能
`#ACT` 部分包含了在 `#IF` 条件满足时需要执行的具体操作。这些操作可以是给予玩家物品、扣除物品、打开商店界面、发送消息等。
### （二）常见执行命令语句
- **Give [物品名称] [数量]**
给予玩家指定数量的某种物品。例如 `Give 魔法药水 5` 表示给予玩家 5 瓶魔法药水。
- **TakeItem [物品名称] [数量]**
从玩家背包中扣除指定数量的某种物品。如 `TakeItem 矿石 2` 表示从玩家背包中扣除 2 个矿石。
- **OpenShop [商店编号]**
打开指定编号的商店界面，让玩家可以进行物品交易。例如 `OpenShop 1` 表示打开编号为 1 的商店。
- **SendMsg [消息类型] [消息内容]**
向玩家发送消息。消息类型通常用数字表示，如 6 表示系统消息，会以醒目的方式显示在玩家界面上。例如 `SendMsg 6 你已成功完成任务！`
## 四、注释部分
### （一）注释的作用
注释用于对脚本代码进行解释说明，方便开发者理解和维护脚本。注释内容不会被游戏服务器执行，只是为了提高代码的可读性。
### （二）注释的写法
在脚本文件中，以 `;` 开头的行表示注释。例如：
```plaintext
; 这是一个注释，说明下面的代码用于处理玩家领取任务的逻辑
[@任务领取]
#IF
CheckItem 破旧的信件 1
#ACT
TakeItem 破旧的信件 1
Give 新手剑 1
SendMsg 6 你已成功领取新手剑作为任务奖励！
```
通过以上几个部分的组合，传奇 NPC 脚本文件可以实现复杂多样的交互功能，为玩家带来丰富的游戏体验。不同的传奇版本可能会在脚本语法和支持的命令上存在一些差异，但基本的结构和原理是相似的。