一、传奇脚本基础认知
1. 脚本核心作用与应用场景
传奇脚本是控制游戏内事件、NPC交互、任务流程、道具产出等功能的核心指令集合，通过编写脚本可实现自定义玩法，比如NPC售卖特殊道具、触发式剧情任务、地图专属事件、怪物掉落规则调整等，是单机架设与玩法定制的核心工具。
主流传奇引擎（Hero、LegM2、GEE等）脚本语法相通，仅部分指令存在差异，入门阶段可优先掌握通用语法，后续按需适配具体引擎。
2. 脚本文件类型与存放路径
传奇脚本主要分为NPC脚本、任务脚本、地图脚本三类，核心文件格式为.txt或.dat，存放路径因引擎略有不同：
1）NPC脚本：多存于服务端Mir200/NPC文件夹，以“NPC名称.txt”命名（如“药店老板.txt”），控制NPC对话、交易、任务触发等；2）任务脚本：部分引擎整合于NPC脚本，部分独立存于Mir200/Quest文件夹，按任务ID分类存放；3）地图脚本：存于Mir200/Envir/MapQuest文件夹，对应具体地图编号，控制地图内怪物刷新、触发事件等。
3. 脚本编辑工具与基础要求
无需专业编程工具，记事本、Notepad++等文本编辑器即可编写，推荐使用Notepad++（支持语法高亮，避免指令输入错误）。编辑时需注意：脚本指令区分大小写（部分引擎不区分，建议统一大写规范编写）、括号与符号需为英文半角、指令顺序影响执行逻辑，避免遗漏结尾符号。
二、传奇脚本核心语法（通用版）
1. 基础指令格式与核心规则
传奇脚本指令以“指令名 参数1 参数2 ...”格式编写，每行一条指令，通过特定标记区分不同逻辑块，核心规则如下：
1）注释指令：以“//”开头，注释内容不执行，用于标注脚本功能（例：//药店老板售卖强效太阳水），方便后续修改维护；2）条件判断标记：用“IF”开头，“ENDIF”结尾，实现满足特定条件才执行后续指令；3）对话标记：用“#SAY”开头，后续内容为NPC对话文本，支持换行（用“\”换行）；4）选择项标记：用“#ACT”开头，绑定选择项触发的操作（如交易、给予道具）。
2. 高频基础指令详解（附示例）
1）对话指令（#SAY）：用于NPC对话显示，示例：#SAY 欢迎来到传奇世界！\ 我这里有疗伤药，需要购买吗？（“\”实现换行，对话内容可自定义）。
2）交易指令（#SELL）：设置NPC售卖道具，示例：#SELL 强效太阳水 500 1（参数依次为：道具名称、售价、库存，库存填1为无限售）。
3）购买指令（#BUY）：设置NPC收购道具，示例：#BUY 金币 1 1000（参数依次为：道具名称、收购价、最大收购量）。
4）给予道具指令（#GIVE）：触发后给予玩家指定道具，示例：#GIVE 疗伤药 10（参数为：道具名称、数量），常用于任务奖励。
5）扣除道具指令（#TAKE）：触发后扣除玩家指定道具，示例：#TAKE 金币 1000（参数为：道具名称、数量），常用于任务提交或道具兑换。
6）条件判断指令（IF/ENDIF）：示例：IF 检查玩家等级 30 （判断玩家等级是否≥30级）#SAY 你已达到30级，可领取新手奖励！#ACT GIVE 新手装备 1 ELSE （否则，即等级＜30级）#SAY 你等级不足30级，无法领取奖励！ENDIF （结束条件判断）。
3. 脚本执行逻辑与常见标记
脚本按自上而下顺序执行，遇到条件判断时，满足条件则执行对应逻辑块，不满足则跳过（或执行ELSE块）；核心标记还包括：#DELAY（延迟执行，单位为毫秒，例：#DELAY 1000 即延迟1秒执行后续指令）、#MAPMOVE（传送玩家至指定地图，示例：#MAPMOVE 比奇城 300 300 即传送至比奇城坐标300,300）、#CLOSE（关闭NPC对话界面）。
三、零基础实操：编写第一个NPC脚本（以售卖药品为例）
1. 脚本编写步骤（通用版）
1）新建脚本文件：打开Notepad++，新建文本，保存至Mir200/NPC文件夹，命名为“新手药师.txt”，编码选择ANSI（避免中文乱码）。
2）编写基础对话与选择项：输入以下指令：//新手药师脚本（注释）#SAY 新手你好！我这里有平价疗伤药，快来看看吧！\ 1. 购买疗伤药（强效）\ 2. 购买疗伤药（普通）\ 3. 离开（选择项，数字为触发标识）。
3）绑定选择项操作：继续输入：#ACT （选择项1触发操作）SELL 强效太阳水 300 1 （售卖强效太阳水，单价300金币，无限售）#ACT （选择项2触发操作）SELL 疗伤药 100 1 （售卖普通疗伤药，单价100金币，无限售）#ACT （选择项3触发操作）CLOSE （关闭对话界面）。
4）保存脚本：点击保存，确保指令无拼写错误、符号为英文半角，完成脚本编写。
2. 脚本加载与效果验证
1）加载脚本：打开引擎控制器（如HeroM2），点击“NPC管理”，选择“刷新NPC列表”，等待加载完成；或直接重启服务端，确保脚本被读取。
2）游戏内验证：登录单机游戏，前往对应NPC刷新地点（新手村），找到“新手药师”NPC，点击对话，即可看到编写的对话内容与选择项，选择购买即可完成交易，验证脚本生效。
3. 常见错误排查（新手必看）
1）中文乱码：脚本编码未设为ANSI，重新保存文件，选择编码为ANSI即可；2）选择项无响应：指令拼写错误（如将#SELL写成#sell）或缺少#ACT标记，核对指令大小写与格式；3）NPC不显示：脚本文件名与NPC名称不一致，或存放路径错误，确认文件存于Mir200/NPC文件夹，文件名与脚本内NPC名称匹配。
四、进阶基础：简单任务脚本编写（触发式奖励）
1. 任务脚本核心逻辑（以等级达标奖励为例）
实现功能：玩家等级达到20级，与NPC对话可领取新手武器，每人限领1次；核心逻辑：判断玩家等级→判断是否已领取奖励→给予奖励→标记已领取。
2. 脚本编写示例
//20级新手奖励脚本#SAY 恭喜你达到20级！\ 我为你准备了新手武器，需要领取吗？（限领1次）#IF 检查玩家等级 20 （判断等级≥20级）#IF 检查玩家变量 新手奖励 0 （判断未领取奖励，变量初始为0）#ACT GIVE 新手剑 1 （给予新手剑1把）SET 玩家变量 新手奖励 1 （设置变量为1，标记已领取）#SAY 奖励已发放，请注意查收背包！#ELSE （已领取奖励）#SAY 你已领取过新手奖励，无法重复领取哦！#ELSE （等级不足20级）#SAY 你等级不足20级，无法领取奖励，加油升级吧！#ENDIF #ENDIF #ACT CLOSE。
3. 变量使用说明（新手重点）
变量用于记录玩家状态（如是否领取奖励、任务进度等），核心格式：SET 玩家变量 变量名 数值（设置变量）、检查玩家变量 变量名 数值（判断变量），变量值可自定义，完成任务后修改变量值，实现单次触发或进度记录。
五、不同引擎脚本差异（入门适配）
1. Hero引擎专属注意事项
Hero引擎支持更多自定义变量，部分指令需添加前缀，例：给予道具指令可使用#GIVEITEM（与#GIVE通用），条件判断支持更细致的参数（如检查玩家职业、背包空间等），脚本保存后无需手动刷新，重启服务端即可加载。
2. LegM2引擎专属注意事项
LegM2引擎NPC脚本需添加NPC编号，格式为“[NPC编号] 脚本内容”，例：[1001] #SAY 欢迎光临！，NPC编号需与服务端NPC列表内编号一致，否则无法显示。
3. 通用适配技巧
入门阶段优先使用通用指令，编写完成后若在某引擎内不生效，可查询对应引擎的脚本手册，替换专属指令（如部分引擎将#MAPMOVE改为#传送），避免一开始陷入引擎差异的细节中。
六、新手避坑指南与学习建议
1. 常见新手错误汇总
1）指令拼写错误：如将#ACT写成#ATC、#SELL写成#SEL，建议编写时开启语法高亮，逐行核对；2）符号使用错误：中文全角括号（）、逗号，导致脚本无法执行，需统一使用英文半角符号；3）逻辑顺序混乱：条件判断缺少ENDIF，导致后续指令失效，编写时按“IF→逻辑→ELSE→逻辑→ENDIF”规范排版；4）未设置变量标记：重复领取奖励等问题，需合理使用变量记录状态。
2. 高效学习技巧
1）模仿修改：先打开服务端自带脚本（如默认NPC脚本），模仿原有语法修改内容（如调整售价、添加选择项），快速熟悉指令用法；2）从小功能入手：先编写简单脚本（如售卖道具、给予奖励），逐步尝试复杂任务（如多步骤剧情任务）；3）查阅手册：遇到未知指令，查询对应引擎的官方脚本手册，获取详细参数与示例；4）测试验证：编写完成后立即在游戏内测试，出现问题逐行排查，记录错误原因与解决方法。
七、入门总结与后续学习方向
传奇脚本入门核心是掌握通用指令格式、条件判断逻辑与变量使用，通过编写简单NPC脚本、任务脚本积累经验，无需追求复杂语法，先实现基础功能再逐步进阶。后续可学习地图事件脚本、怪物掉落脚本、自定义技能脚本等，深入玩法定制；同时熟悉对应引擎的专属指令，提升脚本适配能力，满足不同架设需求。
