以下是传奇脚本编写中一些常用的函数及其说明：
### 一、基本功能函数
1. **Say 函数**：
- **功能**：用于向玩家显示信息。
- **示例**：
```
Say "欢迎来到传奇世界！";
```
- 这个函数通常用于在游戏中向玩家输出消息，如 NPC 对话、系统提示、任务说明等，让玩家了解当前的游戏情况或操作结果。
2. **GOTO 函数**：
- **功能**：用于跳转到其他脚本段。
- **示例**：
```
GOTO @AnotherScriptSegment;
```
- 可以引导玩家在不同的脚本段之间跳转，实现不同的游戏流程，例如从一个 NPC 的对话选项跳转到对应的任务处理脚本段，或者从任务完成的脚本段跳转到奖励发放的脚本段。
### 二、变量操作函数
1. **VAR 函数**：
- **功能**：用于声明和定义变量。
- **示例**：
```
VAR integer PlayerLevel = 1;
VAR string PlayerName = "Player1";
```
- 可声明不同数据类型的变量，如整数、字符串等，方便存储和操作游戏中的各种信息，像玩家的等级、名称、物品数量等。
2. **SET 函数**：
- **功能**：给变量赋值。
- **示例**：
```
SET PlayerLevel = 10;
```
- 可以在游戏过程中修改已声明变量的值，比如玩家升级时修改玩家等级变量的值，或更新任务进度时修改任务进度变量的值。
### 三、条件判断函数
1. **IF-ELSE 函数**：
- **功能**：根据条件进行不同的操作。
- **示例**：
```
IF PlayerLevel >= 10 THEN
Say "你已经是高级玩家啦！";
ELSE
Say "继续努力升级哦！";
ENDIF
```
- 该函数用于根据不同的条件执行不同的游戏逻辑，比如根据玩家等级发放不同的任务，或者根据玩家的物品拥有情况提供不同的购买选项。
2. **CHECKVAR 函数**：
- **功能**：检查变量的值。
- **示例**：
```
IF CHECKVAR PlayerLevel >= 10 THEN
Say "你的等级满足要求。";
ENDIF
```
- 可检查变量是否满足一定条件，常用于判断玩家是否达到任务条件、是否拥有足够的物品或资源等。
### 四、任务系统函数
1. **SetTaskValue 函数**：
- **功能**：设置玩家的任务进度或任务相关属性。
- **示例**：
```
SetTaskValue <$USERNAME> "Task1" 0 5;
```
- 此函数可用于为玩家分配任务，并设置任务的初始进度或其他任务属性，例如设置玩家的杀怪任务要杀死 5 只怪物。
2. **ADDTASKVALUE 函数**：
- **功能**：增加玩家的任务进度值。
- **示例**：
```
ADDTASKVALUE <$USERNAME> "Task1" 0 1;
```
- 当玩家完成部分任务时，使用该函数可以更新任务进度，如玩家杀死一只怪物后，任务进度加 1。
3. **GETTASKVALUE 函数**：
- **功能**：获取玩家的任务进度值。
- **示例**：
```
VAR TaskProgress = GETTASKVALUE <$USERNAME> "Task1" 0;
Say "你的任务进度是：" + TaskProgress;
```
- 用于获取玩家当前的任务进度，以便向玩家显示任务进度，或判断玩家是否完成任务。
### 五、物品系统函数
1. **GiveItem 函数**：
- **功能**：给玩家提供物品。
- **示例**：
```
GiveItem <$USERNAME> 1001 1;
```
- 可以在玩家完成任务、杀死怪物或达成某种成就时，给玩家发放物品，如给予玩家一个物品 ID 为 1001 的物品，数量为 1。
2. **TakeItem 函数**：
- **功能**：从玩家处拿走物品。
- **示例**：
```
TakeItem <$USERNAME> 1001 1;
```
- 当玩家使用物品进行升级、交易或支付时，可使用该函数扣除相应的物品，如玩家使用 1 个物品 ID 为 1001 的物品作为升级材料。
### 六、玩家信息函数
1. **CHECKUSER 函数**：
- **功能**：检查玩家是否存在。
- **示例**：
```
IF CHECKUSER <$USERNAME> THEN
Say "玩家存在。";
ELSE
Say "玩家不存在。";
ENDIF
```
- 常用于玩家登录、组队邀请等场景，确保操作的玩家是存在的，避免因玩家不存在而引发的错误。
2. **CHECKUSERLEVEL 函数**：
- **功能**：检查玩家的等级。
- **示例**：
```
IF CHECKUSERLEVEL <$USERNAME> >= 10 THEN
Say "你可以进入这个区域。";
ELSE
Say "你的等级不够，无法进入。";
ENDIF
```
- 可以根据玩家等级来控制玩家进入不同的区域、接受不同的任务或使用不同的功能。
### 七、NPC 相关函数
1. **CHECKNPC 函数**：
- **功能**：检查 NPC 是否存在。
- **示例**：
```
IF CHECKNPC "Shopkeeper" THEN
Say "欢迎来到商店，有什么需要的吗？";
ELSE
Say "商店老板不在哦。";
ENDIF
```
- 确保玩家与 NPC 交互时，所涉及的 NPC 是存在的，避免因 NPC 不存在而导致的异常情况。
### 八、数据库操作函数（如果引擎支持）
1. **QueryDatabase 函数**：
- **功能**：查询数据库信息。
- **示例**：
```
VAR PlayerInfo = QueryDatabase("SELECT * FROM Players WHERE PlayerID = 'Player1'");
```
- 可以获取玩家的各种信息，如玩家的属性、物品、任务等，用于实现数据的持久化存储和读取。
2. **UpdateDatabase 函数**：
- **功能**：更新数据库信息。
- **示例**：
```
UpdateDatabase("UPDATE Players SET Level = 10 WHERE PlayerID = 'Player1'");
```
- 用于更新玩家的信息，如玩家升级后更新玩家等级、完成任务后更新任务状态等，保证数据库中的数据与游戏内玩家状态一致。
这些函数是传奇脚本编写中常用的基本函数，不同的引擎可能会有一些细微的差别，在实际使用时需要根据你所使用的光芒引擎的具体规则和语法进行调整。通过灵活运用这些函数，可以实现丰富多样的游戏功能，如任务系统、物品系统、玩家互动、NPC 对话等，为玩家提供更好的游戏体验。同时，在编写脚本时，注意函数的调用顺序和逻辑关系，避免出现错误和逻辑混乱。
