传奇脚本入门教程：从看懂第一行到写出第一个 NPC

传奇服务端的”灵魂”不是引擎，是脚本。NPC 对话、任务、充值返利、活动开关，全靠脚本驱动。本文面向零基础，带你从看懂第一行脚本到写出第一个 NPC。脚本语法在 BLUE/HERO/GOM 各系间大体同源，细节方言差异以你所用引擎手册为准（选引擎看这篇）。

一、脚本是长什么样的

打开服务端目录里的脚本文件夹（通常按地图或 NPC 组织），随便开一个文件，你会看到这样的结构：

; 这是注释，分号开头
[@main]          ; 主对话入口
#IF
CHECKLEVEL 10    ; 条件：等级大于等于10
#SAY
你好勇士，要传送去矿区吗？ 
<我要去矿区/@qukuang>   <算了/@exit>

[@qukuang]       ; 子标签：点击"我要去矿区"跳这里
#IF
CHECKGOLD 1000
#ACT
TAKEGOLD 1000
MAPMOVE 3 333 333
#ELSESAY
金币不够，需要1000金币。

核心逻辑就四个字：检查→执行。#IF 下写条件（CHECK 族指令），#ACT/#SAY 下写结果（给东西/传送/说话）。玩家点 <文字/@标签> 就跳到对应标签继续跑——这就是传奇脚本的全部骨架。

二、新手必背的高频指令

这十几个指令能覆盖 80% 的日常需求。完整指令表翻你引擎的脚本手册，各系都有几百条，但常用的就这些。

三、学习路径：拆版本是最快的

1. 第一步：从 版本库下一个带脚本说明的版本，把 NPC 文件逐行读，读不懂的指令查手册；
2. 第二步：改参数练手——把”1000 金币传送”改成”500 金币”，进游戏验证，建立”改哪生效哪”的手感；
3. 第三步：仿写——照着现有 NPC 写一个自己的任务 NPC（对话→检查物品→给奖励）；
4. 第四步：上手计时器类脚本（活动定时开关）和变量，进入中级玩法。

改脚本前先备份文件、改完重载脚本（或重启 M2），出问题看 M2 窗口报错的行号回滚重改——这套习惯从第一天就要养，能少走无数弯路（参见报错速查表）。

四、新手最常犯的五个错

• 标签名写错：@qukuang 和 @qukang 拼错一个字母，点击就没反应——标签名纯英文数字，别用中文；
• 少写 #ACT/#SAY：条件后面直接写指令，引擎不认；
• 中文标点：逗号引号用了全角，报错行号指不出来，肉眼最难点——写完全角转半角查一遍；
• 改完没重载：以为改了没生效是 bug，其实脚本没重载；
• 没备份就大改：改崩了回不去，只能重下版本。

常见问题 FAQ

Q1：传奇脚本好学吗？要编程基础吗？

不需要编程基础。传奇脚本是”标签 + 条件 + 动作”的简化语言，逻辑上更像填表。每天摸一两个小时，一周能改，一个月能写。

Q2：不同引擎的脚本通用吗？

骨架通用，细节有方言差异（个别指令名和参数不同）。跨引擎迁移脚本要小改，最好直接下对应引擎的版本学习，站内按 BLUE / HERO / GOM 分好类了。

Q3：脚本报错怎么看？

M2 窗口和日志会给出错文件与行号，打开文件数到那一行，九成是拼写、中文标点或缺 #段头。系统排查思路见报错速查表。

Q4：在哪系统找脚本学习资料？

脚本技术栏目沉淀了大量实例脚本与讲解帖，配合本文学，效率最高。

本文由 7U 游戏社区整理。转载请注明出处。