传奇脚本语法是实现游戏内各类交互、逻辑控制、功能触发的核心基础，贯穿NPC对话、任务执行、地图操作、物品处理等所有游戏场景，掌握其基础规则和常用指令，就能完成各类基础及复杂脚本的编写。脚本语法整体遵循“简洁易懂、逻辑清晰”的原则，无需复杂编程基础，重点掌握指令格式、变量使用、逻辑判断三大核心，即可快速上手。
传奇脚本的基础格式分为脚本头部、主体内容、结束标识三部分，整体无复杂嵌套，所有指令均区分大小写，且每一条指令需单独成行，末尾无需添加标点符号，空格使用需规范，多余空格会导致脚本无法正常执行。脚本头部主要用于定义脚本触发方式，常见触发方式包括NPC点击触发、物品使用触发、地图进入触发、时间触发四种，不同触发方式对应不同的头部标识。
NPC点击触发是最常用的脚本触发方式，头部标识为“{图像类别 图像定位}”，其中图像类别用于说明NPC或动物的图像类型，图像定位用于指定具体的图像编号，两者之间用空格分隔。例如“{NPC 1001}”代表触发脚本的NPC图像编号为1001，玩家点击该NPC即可触发后续脚本内容。头部标识下方需添加“(@段)”，其中“段”用英文或数字表示，用于定义脚本的起始段落，后续脚本内容均围绕该段落展开，也可通过跳转指令切换至其他段落。
物品使用触发的头部标识为“#USEITEM 物品名称”，无需添加图像相关配置，只要玩家使用指定名称的物品，即可触发脚本。例如“#USEITEM 疗伤药”，玩家使用疗伤药时，会自动执行该脚本的后续逻辑。地图进入触发的头部标识为“#MAPENTER 地图名称”，玩家进入指定地图时触发脚本，例如“#MAPENTER 比奇城”，玩家踏入比奇城地图的瞬间，脚本自动启动。时间触发的头部标识为“#TIME 时间参数”，时间参数可设置为具体时间点或时间间隔，例如“#TIME 08:00”代表每天8点触发脚本，“#TIME 120”代表每120秒触发一次脚本。
脚本主体是语法的核心部分，主要由变量、指令、逻辑判断三部分组成，三者结合可实现各类游戏逻辑。变量用于存储游戏中的各类数据，包括玩家信息、物品数量、地图状态等，不同类型的变量对应不同的使用场景，且变量名称有严格规范，仅能使用指定字符组合，不可随意命名。
传奇脚本中的变量分为字符型变量、数字型变量、服务器共享变量三类，每类变量有固定的命名前缀，便于区分和使用。字符型变量用于存储文本类数据，例如玩家名称、物品描述等，前缀包括A0-A9、B0-B9，例如A0可用于存储玩家姓名，B1可用于存储任务描述，赋值格式为“mov 变量 字符”，例如“mov A0 玩家1”，表示将“玩家1”这个文本赋值给A0变量。
数字型变量用于存储数值类数据，例如玩家等级、金币数量、物品数量等，前缀包括D0-D9、P0-P9、S0-S9，赋值格式为“mov 变量 数值”，例如“mov D0 30”表示将30这个数值赋值给D0变量，可用于存储玩家等级；“mov P0 1000”表示将1000赋值给P0变量，可用于存储玩家金币数量。数字型变量支持多种运算操作，包括递增、递减、求和、随机赋值等，满足各类数值计算需求。
递增操作使用“inc 变量 数值”指令，例如“inc D0 5”表示将D0变量的数值增加5，若D0原本为30，执行该指令后变为35；递减操作使用“dec 变量 数值”指令，例如“dec P0 200”表示将P0变量的数值减少200，若P0原本为1000，执行后变为800。求和操作需结合赋值指令使用，先将求和结果变量初始化为0，再依次添加需要求和的变量，例如“mov D1 0”“sum D0 D2”“sum D3”，表示将D0、D2、D3三个变量的数值求和，结果存储在D1变量中，单独使用sum指令无意义，必须配合初始赋值指令。
随机赋值操作使用“movr 变量 数值”指令，例如“movr D0 6”表示给D0变量随机赋值0到6之间的整数，常用于抽奖、骰子等随机场景；“random 数值”指令可用于触发随机事件，当随机生成的数字与指定数值一致时，返回1，否则返回0，例如“random 3”，当随机数为3时触发后续逻辑，否则不触发。
服务器共享变量用于存储全服通用的数据，例如全服活动状态、公共任务进度等，前缀包括N0-N9（数字型）、B1-B9（字符型），可通过“#Define 变量 {标识} 变量”指令定义，例如“#Define N0 {START} N0”表示将N0变量定义为全服共享的起始状态变量，所有玩家触发的脚本均可读取和修改该变量，实现全服数据同步。
变量的显示需使用“$str(变量)”指令，通常配合对话指令使用，将变量数值或文本显示在游戏对话框中，例如“#SAY 你的当前等级为$str(D0)级”，若D0变量为30，玩家触发脚本后会看到“你的当前等级为30级”的对话内容。变量使用时需注意，不可重复定义同一变量的类型，且未赋值的变量默认值为0（数字型）或空文本（字符型），避免因变量未赋值导致脚本逻辑出错。
指令是脚本执行具体操作的核心，分为跳转指令、对话指令、执行指令、检测指令四类，每类指令有固定格式，需严格按照规范编写，否则会导致脚本无法执行或执行异常。跳转指令用于实现脚本段落之间的切换，常用指令包括goto、选择项目、Delaygoto三种。
goto指令格式为“goto @段”，用于直接跳转到指定段落，例如“goto @main”表示跳转到标识为main的段落，执行该段落的脚本内容，常用于脚本流程的跳转和循环。选择项目指令格式为“选择项目 @段”，相当于多分支跳转，玩家点击对话框中的选择项后，跳转到对应的段落，例如“选择项目 @task1 @task2”，玩家点击第一个选择项跳转到task1段落，点击第二个跳转到task2段落，常用于NPC对话中的选项分支。
Delaygoto指令格式为“Delaygoto (Grobal) 时间 @段”，其中时间单位为秒，Grobal可省略，用于延迟指定时间后跳转到指定段落，例如“Delaygoto 120 @end”表示120秒后跳转到end段落，常用于倒计时、延迟触发等场景。
对话指令用于在游戏中显示文本内容，与玩家进行交互，常用指令包括#SAY、#ELSESAY两种。#SAY指令格式为“#SAY 文本内容”，文本内容无需添加任何定界符，可直接输入，支持换行显示，换行需使用专用换行指令，例如“#SAY 欢迎来到传奇世界\n请选择你要进行的操作”，玩家触发后会看到两行对话，第一行为欢迎语，第二行为操作提示。
#ELSESAY指令需配合逻辑判断指令使用，当逻辑判断不成立时，显示#ELSESAY后的文本内容，例如逻辑判断玩家拥有指定物品，若没有则显示#ELSESAY后的提示，格式与#SAY一致，无需额外添加其他参数。对话指令中可插入变量显示，结合$str(变量)指令，实现动态文本显示，增强脚本的交互性。
执行指令用于执行具体的游戏操作，包括物品发放、金币增减、地图移动、状态修改等，常用指令有take、give、mapmove、monclear、close、@exit等。take指令用于拿走玩家背包中的物品或金币，格式为“take 物品名称 数量”“take gold 数量”，例如“take 钢玉石 1”表示拿走玩家背包中的1个钢玉石，“take gold 10000”表示拿走玩家10000金币；若未指定数量，默认拿走1个物品或1金币。
give指令用于给玩家发放物品或金币，格式与take指令一致，例如“give 疗伤药 5”表示给玩家发放5个疗伤药，“give gold 5000”表示给玩家发放5000金币。mapmove指令用于将玩家移动到指定地图的指定坐标，格式为“mapmove 地图名称 坐标A 坐标B”，例如“mapmove 比奇城 320 280”表示将玩家移动到比奇城坐标（320,280）的位置；若仅需移动到指定地图，无需指定坐标，格式为“map 地图名称”。
monclear指令用于清除指定地图中的所有怪物，格式为“monclear 地图名称”，例如“monclear 蜈蚣洞”表示清除蜈蚣洞地图中的所有怪物，常用于活动结束后清理地图。close和@exit指令均用于关闭对话框，close指令由程序自动执行，@exit指令需手动触发，两者功能一致，可根据脚本需求选择使用；break指令用于中断当前脚本流程，停止执行后续指令，常用于逻辑判断后的流程终止。
检测指令用于判断玩家状态、物品数量、地图信息等条件，是逻辑判断的核心，常用指令包括checkjob、checklevel、checkgold、checkitem、checkbaggage等，所有检测指令均需配合逻辑判断框架使用，不可单独执行。
逻辑判断框架的基础格式为“#IF + 检测条件 + #ACT + 执行指令 + #ELSEACT + 执行指令 + #ELSESAY + 对话文本”，其中#IF用于开始逻辑判断，后面紧跟检测条件；#ACT用于指定检测条件成立时执行的指令；#ELSEACT用于指定检测条件不成立时执行的指令，可省略；#ELSESAY用于指定检测条件不成立时显示的对话文本，可省略。
checkjob指令用于检测玩家职业，格式为“checkjob warr(wizard、taos)”，其中warr代表战士，wizard代表法师，taos代表道士，例如“#IF checkjob warr #ACT give 裁决 1”表示检测玩家是否为战士，若是则发放1把裁决。checklevel指令用于检测玩家等级，格式为“checklevel 数值”，例如“#IF checklevel 30 #ACT mapmove 沃玛寺庙 220 180”表示检测玩家等级是否达到30级，若是则移动到沃玛寺庙指定坐标。
checkgold指令用于检测玩家拥有的金币数量，格式为“checkgold 数值”，例如“#IF checkgold 10000 #ACT take gold 10000 give 烈火剑法 1”表示检测玩家是否拥有10000金币，若是则拿走10000金币并发放1本烈火剑法。checkitem指令用于检测玩家背包中的物品及数量，格式为“checkitem 物品名称 数量”，例如“#IF checkitem 疗伤药 3 #ACT take 疗伤药 3 give 强效疗伤药 1”表示检测玩家背包中是否有3个疗伤药，若是则拿走3个疗伤药并发放1个强效疗伤药。
checkbaggage指令用于检测玩家背包是否已满，格式为“checkbaggage”，例如“#IF checkbaggage #SAY 你的背包已满，请清理后再试 #ELSEACT give 金币 1000”表示检测玩家背包是否已满，若是则显示提示文本，若否则发放1000金币。除上述常用检测指令外，还有多种专项检测指令，满足不同场景需求。
checkpkpoint指令用于检测玩家的PK值，格式为“checkpkpoint 数值”，例如“#IF checkpkpoint 10 #SAY 你的PK值过高，无法进入安全区域”表示检测玩家PK值是否达到10，若是则显示提示；checkluckypoint指令用于检测玩家幸运值，格式为“checkluckypoint 数值”，例如“#IF checkluckypoint 7 #ACT give 祝福油 1”表示检测玩家幸运值是否达到7，若是则发放1瓶祝福油。
checkmagic指令用于检测玩家是否修炼了指定技能，格式为“checkmagic 技能名称”，例如“#IF checkmagic 烈火剑法 #SAY 你已掌握烈火剑法”；chkmagiclevel指令用于检测玩家的技能等级，格式为“chkmagiclevel 技能名称 等级”，例如“#IF chkmagiclevel 烈火剑法 3 #ACT give 技能石 1”表示检测玩家烈火剑法是否达到3级，若是则发放1个技能石。
checkduraeva指令用于检测物品的品质，常用于矿物、装备等物品，格式为“checkduraeva 物品名称 数值”，例如“#IF checkduraeva 钢玉矿石 10 #ACT take 钢玉矿石 1 give 钢玉石 1”表示检测钢玉矿石品质是否达到10，若是则兑换为1个钢玉石。checkhum指令用于检测指定地图的人数，格式为“checkhum 地图名称 数值”，例如“#IF checkhum 沙巴克 50 #SAY 沙巴克当前人数已满”表示检测沙巴克地图人数是否达到50，若是则显示提示。
checkmonmap指令用于检测指定地图的怪物数量，格式为“checkmonmap 地图名称 数值”，例如“#IF checkmonmap 猪洞七层 20 #ACT monclear 猪洞七层”表示检测猪洞七层怪物数量是否达到20，若是则清除该地图所有怪物。此外，gender指令用于检测玩家性别，格式为“gender man”表示检测玩家是否为男性，若是则返回1，否则返回0；checkmonrecall指令用于检测玩家是否有宠物，checkhorse指令用于检测玩家是否有马，checkweaponlevel指令用于检测玩家手持武器的等级，均可根据脚本需求灵活使用。
逻辑判断中可使用not、and、or三个逻辑运算符，实现复杂条件判断。not用于取反，例如“#IF not CheckItem 钢玉石 1”表示检测玩家背包中是否没有1个钢玉石；and用于同时满足多个条件，例如“#IF checklevel 30 and checkjob warr”表示检测玩家等级达到30级且职业为战士；or用于满足任意一个条件，例如“#IF not CheckItem 钢玉石 1 or not CheckGold 10000”表示玩家没有1个钢玉石或没有10000金币，任意一个条件满足即可触发后续逻辑。
除上述核心语法外，传奇脚本还有一些常用的特殊功能指令，用于实现更丰富的游戏逻辑。addnamelist、checknamelist、delnamelist三个指令用于玩家名单的管理，addnamelist用于将玩家名称添加到指定文本文件中，checknamelist用于检测玩家名称是否在指定文本文件中，delnamelist用于将玩家名称从指定文本文件中删除，例如“#ACT addnamelist 活动参与名单.txt”表示将当前玩家名称添加到活动参与名单.txt中。
playdice指令用于实现骰子功能，格式为“playdice 骰子数 @段”，例如“playdice 1 @cube”表示玩家掷1个骰子，之后跳转到cube段落，常用于抽奖、随机任务等场景。TimeRecall指令用于设置时间限制，格式为“TimeRecall 时间值”，BreakTimeRecall指令用于中断时间限制，例如“#ACT TimeRecall 300”表示设置300秒的时间限制，“#ACT BreakTimeRecall”表示中断当前时间限制。
ExchangeMap指令用于实现玩家与指定地图玩家的位置交换，格式为“ExchangeMap 地图名称”，例如“#ACT ExchangeMap 比奇城”表示将当前玩家与比奇城地图中的任意一名玩家交换位置；daytime指令用于设置游戏内的时间，格式为“daytime sunset”表示将游戏内时间设置为黄昏，可用于营造特定游戏场景。
实战案例是掌握传奇脚本语法的关键，结合具体场景编写脚本，能更好地理解语法规则和指令使用方法。以下为三个常见场景的实战脚本，涵盖NPC对话、任务执行、随机事件三大核心场景，可直接参考使用，也可根据需求修改参数。
案例一：NPC对话及物品兑换脚本。该脚本实现玩家点击NPC后，可使用钢玉石兑换钢玉石，检测玩家物品数量，满足条件则执行兑换，不满足则提示。脚本内容如下：{NPC 1002} (@main) #SAY 欢迎来到物品兑换处\n我可以帮你将钢玉矿石兑换成钢玉石\n需要兑换请点击下方按钮 <兑换/@exchange> (@exchange) #IF checkduraeva 钢玉矿石 10 #ACT take 钢玉矿石 1 give 钢玉石 1 #SAY 兑换成功！你获得了1个钢玉石 <返回/@main> #ELSESAY 你的钢玉矿石品质不足10，无法兑换 <返回/@main>。
案例二：等级任务脚本。该脚本实现玩家等级达到30级后，可在NPC处领取任务奖励，检测玩家等级和任务状态，未领取则发放奖励，已领取则提示。脚本内容如下：{NPC 1003} (@task) #IF checklevel 30 and check (1) 0 #ACT give gold 5000 give 疗伤药 10 set (1) 1 #SAY 恭喜你达到30级，获得等级奖励！ <结束/@exit> #ELSESAY 你已领取过该等级奖励，请勿重复领取 <结束/@exit>。
案例三：随机抽奖脚本。该脚本实现玩家使用筹码参与抽奖，随机获得不同奖励，涵盖变量随机赋值、骰子功能、多条件判断。脚本内容如下：{NPC 1004} (@lottery) #SAY 欢迎参与抽奖活动\n消耗1个筹码即可参与，有机会获得稀有装备 <参与抽奖/@start> (@start) #IF checkitem 筹码 1 #ACT take 筹码 1 movr d0 6 inc d0 1 playdice 1 @reward #SAY 正在抽奖，请稍候... <查看结果/@reward> #ELSESAY 你没有筹码，无法参与抽奖 <返回/@lottery> (@reward) #IF equal d0 1 #ACT give 金币 1000 #SAY 恭喜你抽中1000金币！ <返回/@lottery> #IF equal d0 2 #ACT give 疗伤药 8 #SAY 恭喜你抽中8个疗伤药！ <返回/@lottery> #IF equal d0 3 #ACT give 强效疗伤药 3 #SAY 恭喜你抽中3个强效疗伤药！ <返回/@lottery> #IF equal d0 4 #ACT give 祝福油 1 #SAY 恭喜你抽中1瓶祝福油！ <返回/@lottery> #IF equal d0 5 #ACT give 裁决 1 #SAY 恭喜你抽中稀有装备裁决！ <返回/@lottery> #IF equal d0 6 #ACT give 屠龙 1 #SAY 恭喜你抽中终极装备屠龙！ <返回/@lottery>。
编写传奇脚本时，需注意几个核心要点，避免脚本执行异常。首先，所有指令必须严格遵循格式要求，区分大小写，不可遗漏指令关键字，例如“goto”不可写为“GOTO”，“#IF”不可写为“#if”；其次，变量命名需符合规范，不可使用前缀以外的字符，且不可重复定义同一变量的类型；再次，逻辑判断中，检测条件需明确，避免出现模糊条件，且not、and、or运算符的使用需规范，避免逻辑混乱；最后，脚本编写完成后，需进行测试，排查指令错误、变量未赋值、空格多余等问题，确保脚本能够正常执行。
传奇脚本语法的核心是“指令+变量+逻辑判断”，三者相互配合，可实现各类游戏功能。无论是简单的NPC对话、物品兑换，还是复杂的全服活动、任务链，都离不开基础语法的支撑。掌握常用指令的格式和使用场景，灵活运用变量存储数据，合理设置逻辑判断条件，就能逐步熟练编写各类传奇脚本，满足游戏内的各类功能需求。同时，脚本编写过程中，可结合官方模板脚本，拆解其中的语法逻辑，积累实战经验，逐步提升脚本编写能力。
