传奇服务端的脚本系统是整个游戏世界的骨架，从NPC的对话交互到复杂的任务逻辑，再到地图的规则设定，皆由脚本命令驱动。掌握这些命令不仅需要记忆语法，更需理解其背后的逻辑运算机制。脚本编写本质上是在构建一个状态机，通过检测玩家状态（等级、物品、职业），执行相应的数据变更（给予物品、移动坐标、修改变量）。以下将从基础交互、逻辑控制、变量运算及常用功能指令四个维度，对传奇脚本命令进行系统性拆解。
基础交互与流程控制指令
脚本的执行始于标签，终于关闭对话框。理解脚本的段落结构是编写任何功能的前提。
标签与跳转
脚本段落由[@标签名]定义，这是脚本的入口点。主标签通常为[@main]。当NPC被点击时，引擎默认寻找[@main]执行。若需跳转，使用goto@标签名。这相当于编程中的goto语句，用于在复杂的任务链中引导玩家进入不同的对话分支。例如，在任务完成后，使用goto@TaskComplete跳转到结束段落。
对话与动作
say与#act是脚本中最基础的指令前缀。#say后接的内容会显示在对话框中，供玩家阅读；#act后接的内容则是系统后台执行的操作，玩家不可见。例如，#say你好，勇士！会在屏幕上显示文字，而#actGIVE金币1000则会在后台给予玩家金币。
关闭对话框
close命令用于结束当前对话。在脚本执行完毕后，务必加上close，否则对话框会一直停留在屏幕上，导致玩家无法进行其他操作。在复杂的脚本中，每个分支的结尾通常都需要一个close，或者通过goto跳转到一个包含close的公共段落。
逻辑判断与条件检测体系
传奇脚本的核心在于“如果……那么……否则……”的逻辑判断。这一体系由#IF、#ACT和#ELSEACT构成。
条件检测指令
IF下方必须紧跟检测命令。只有当所有检测条件都满足时，才会执行#ACT下的命令；只要有一个条件不满足，就会跳转到#ELSEACT（如果存在）。
等级检测：checklevel数值。检测人物等级是否大于或等于指定数值。
职业检测：checkjob职业。职业参数通常为Warrior（战士）、Wizard（法师）、Taoist（道士）。
物品检测：checkitem物品名数量。检测背包中是否拥有指定数量的物品。checkitemw物品名数量则用于检测人物身上佩戴的物品。
金币检测：checkgold数值。检测人物拥有的金币数量是否达标。
地图检测：checkmap地图名。检测人物当前所在的地图。
逻辑变量
传奇脚本支持逻辑变量[n]（n为0-1024的整数）。通过SET[n]1将变量设为真，SET[n]0设为假。配合CHECK[n]1可以记录任务进度。例如，玩家接取任务后，设置[100]为1；完成任务时，检测[100]是否为1。这种方式可以有效防止任务物品的重复领取或任务流程的混乱。
变量运算与数据处理
为了实现动态的数据交互，脚本中广泛使用变量。传奇脚本主要支持P变量（个人变量，P0-P9）和D变量（全局变量，D0-D9），以及部分引擎支持的S变量（脚本临时变量）。
赋值与运算
赋值：MOV变量数值。例如MOVP010，将数值10赋值给P0。
自增：INC变量数值。例如INCP01，P0的数值加1。
随机数：MOVR变量数值。生成0到指定数值之间的随机数。例如MOVRP010，P0的值将在0-10之间随机。这在抽奖或随机传送功能中非常常用。
求和：SUM变量A变量B。将变量A和变量B的值相加，结果存入当前运算寄存器，通常配合MOV使用。
变量显示
在#say中显示变量内容需使用。例如，#say你当前的积分是：，玩家会看到具体的积分数字。
常用功能指令与地图控制
除了逻辑判断，脚本还负责具体的游戏功能实现，如物品交互、坐标移动和怪物控制。
物品与数据操作
给予物品：give物品名数量。这是最基础的奖励发放命令。
回收物品：take物品名数量。用于任务消耗品回收。部分引擎支持takeex进行批量回收。
技能操作：ADDSKILL技能名等级用于学习技能，DELSKILL技能名用于遗忘技能。
元宝/游戏币：GAMEGOLD(+-=)数值。用于调整玩家的元宝数量。
地图与坐标传送
随机传送：map地图名。将人物移动到指定地图的随机坐标。
定点传送：mapmove地图名X坐标Y坐标。将人物精确移动到指定坐标。若范围参数留空，则为定点；若设置范围，则在范围内随机。
时间限制：TimeRecall分钟数。设定玩家在地图内的停留时间，时间到自动传送回记录点。BreakTimeRecall用于中断此计时。
怪物控制
刷怪：MonGen怪物名数量时间。在指定地图或当前地图刷出怪物。
清怪：monclear地图名。清除指定地图上的所有怪物，常用于副本重置。
宝宝控制：RECALLMOB怪物名等级叛变时间。给予玩家指定怪物作为宝宝。
脚本调试与常见误区
在编写脚本时，格式错误是导致失效的主要原因。所有的命令、标签、参数都必须严格遵循引擎的语法规范。例如，#IF必须顶格写，其下方的检测命令必须换行且不能有空格（部分引擎允许缩进，但顶格最稳妥）。
此外，脚本文件的编码格式至关重要。传奇服务端通常只识别ANSI编码的文本文件。如果使用UTF-8编码，会导致中文乱码，甚至命令无法识别。在编辑脚本后，务必检查文件属性，确保编码正确。对于复杂的功能，建议采用模块化编写，将常用的功能（如转生、升级）封装成独立的脚本文件，通过#CALL指令调用，这样既便于管理，也能减少主脚本的冗余。
基础交互与流程控制指令
脚本的执行始于标签，终于关闭对话框。理解脚本的段落结构是编写任何功能的前提。
标签与跳转
脚本段落由[@标签名]定义，这是脚本的入口点。主标签通常为[@main]。当NPC被点击时，引擎默认寻找[@main]执行。若需跳转，使用goto@标签名。这相当于编程中的goto语句，用于在复杂的任务链中引导玩家进入不同的对话分支。例如，在任务完成后，使用goto@TaskComplete跳转到结束段落。
对话与动作
say与#act是脚本中最基础的指令前缀。#say后接的内容会显示在对话框中，供玩家阅读；#act后接的内容则是系统后台执行的操作，玩家不可见。例如，#say你好，勇士！会在屏幕上显示文字，而#actGIVE金币1000则会在后台给予玩家金币。
关闭对话框
close命令用于结束当前对话。在脚本执行完毕后，务必加上close，否则对话框会一直停留在屏幕上，导致玩家无法进行其他操作。在复杂的脚本中，每个分支的结尾通常都需要一个close，或者通过goto跳转到一个包含close的公共段落。
逻辑判断与条件检测体系
传奇脚本的核心在于“如果……那么……否则……”的逻辑判断。这一体系由#IF、#ACT和#ELSEACT构成。
条件检测指令
IF下方必须紧跟检测命令。只有当所有检测条件都满足时，才会执行#ACT下的命令；只要有一个条件不满足，就会跳转到#ELSEACT（如果存在）。
等级检测：checklevel数值。检测人物等级是否大于或等于指定数值。
职业检测：checkjob职业。职业参数通常为Warrior（战士）、Wizard（法师）、Taoist（道士）。
物品检测：checkitem物品名数量。检测背包中是否拥有指定数量的物品。checkitemw物品名数量则用于检测人物身上佩戴的物品。
金币检测：checkgold数值。检测人物拥有的金币数量是否达标。
地图检测：checkmap地图名。检测人物当前所在的地图。
逻辑变量
传奇脚本支持逻辑变量[n]（n为0-1024的整数）。通过SET[n]1将变量设为真，SET[n]0设为假。配合CHECK[n]1可以记录任务进度。例如，玩家接取任务后，设置[100]为1；完成任务时，检测[100]是否为1。这种方式可以有效防止任务物品的重复领取或任务流程的混乱。
变量运算与数据处理
为了实现动态的数据交互，脚本中广泛使用变量。传奇脚本主要支持P变量（个人变量，P0-P9）和D变量（全局变量，D0-D9），以及部分引擎支持的S变量（脚本临时变量）。
赋值与运算
赋值：MOV变量数值。例如MOVP010，将数值10赋值给P0。
自增：INC变量数值。例如INCP01，P0的数值加1。
随机数：MOVR变量数值。生成0到指定数值之间的随机数。例如MOVRP010，P0的值将在0-10之间随机。这在抽奖或随机传送功能中非常常用。
求和：SUM变量A变量B。将变量A和变量B的值相加，结果存入当前运算寄存器，通常配合MOV使用。
变量显示
在#say中显示变量内容需使用。例如，#say你当前的积分是：，玩家会看到具体的积分数字。
常用功能指令与地图控制
除了逻辑判断，脚本还负责具体的游戏功能实现，如物品交互、坐标移动和怪物控制。
物品与数据操作
给予物品：give物品名数量。这是最基础的奖励发放命令。
回收物品：take物品名数量。用于任务消耗品回收。部分引擎支持takeex进行批量回收。
技能操作：ADDSKILL技能名等级用于学习技能，DELSKILL技能名用于遗忘技能。
元宝/游戏币：GAMEGOLD(+-=)数值。用于调整玩家的元宝数量。
地图与坐标传送
随机传送：map地图名。将人物移动到指定地图的随机坐标。
定点传送：mapmove地图名X坐标Y坐标。将人物精确移动到指定坐标。若范围参数留空，则为定点；若设置范围，则在范围内随机。
时间限制：TimeRecall分钟数。设定玩家在地图内的停留时间，时间到自动传送回记录点。BreakTimeRecall用于中断此计时。
怪物控制
刷怪：MonGen怪物名数量时间。在指定地图或当前地图刷出怪物。
清怪：monclear地图名。清除指定地图上的所有怪物，常用于副本重置。
宝宝控制：RECALLMOB怪物名等级叛变时间。给予玩家指定怪物作为宝宝。
脚本调试与常见误区
在编写脚本时，格式错误是导致失效的主要原因。所有的命令、标签、参数都必须严格遵循引擎的语法规范。例如，#IF必须顶格写，其下方的检测命令必须换行且不能有空格（部分引擎允许缩进，但顶格最稳妥）。
此外，脚本文件的编码格式至关重要。传奇服务端通常只识别ANSI编码的文本文件。如果使用UTF-8编码，会导致中文乱码，甚至命令无法识别。在编辑脚本后，务必检查文件属性，确保编码正确。对于复杂的功能，建议采用模块化编写，将常用的功能（如转生、升级）封装成独立的脚本文件，通过#CALL指令调用，这样既便于管理，也能减少主脚本的冗余。