传奇脚本是适配游戏服务端的专属逻辑代码，主流分为GOM、GEE、翎风等引擎专属脚本体系，所有游戏内NPC交互、装备升级、道具兑换、任务系统、属性判定等自定义功能，均依靠脚本编写实现。传奇脚本无需复杂编程基础，拥有固定语法结构、专属指令和逻辑规则，新手按照规范步骤即可独立完成基础功能编写。本文全程采用实操模式，讲解从环境准备、基础语法、核心指令、案例编写到调试排错的全套流程。
一、编写前必备环境与文件认知
传奇脚本全部运行在服务端目录中，客户端无脚本编辑权限，所有编写、修改操作均需在服务端MirServer文件夹内完成，新手首先要熟记核心脚本目录分工，避免文件放错导致功能失效。
核心脚本目录明细：
1. Market_Def：存放所有NPC对话交互脚本，游戏内点击NPC触发的功能全部在此目录，文件后缀为txt，每个NPC对应独立脚本文件。
2. QuestDiary：存放任务、全局事件、定时脚本、登录触发脚本，适合编写长期循环、任务流程、上线奖励等功能。
3. MapQuest：地图触发脚本，用于编写进入地图提示、地图禁止PK、地图自动刷怪等区域专属逻辑。
4. UserCmd：玩家自定义命令脚本，可设置游戏内输入指定指令触发对应功能。
编写工具禁止使用系统自带记事本，容易出现编码错乱、换行异常，推荐使用Notepad++，统一保存为UTF-8无BOM格式，避免中文乱码、脚本不加载的问题。同时需提前确认自身引擎版本，GOM与GEE大部分基础语法通用，少数专属指令不互通，编写前以引擎说明书为准。
二、传奇脚本固定基础语法结构
所有传奇脚本都遵循统一逻辑框架，核心由标签、条件判断、执行指令、弹窗文本四部分组成，不存在复杂语法，新手只需熟记固定格式即可上手。
1. 脚本标签规则
标签是脚本的触发入口，固定格式为[@自定义名称]，所有功能代码必须包裹在对应标签内，常用核心标签：[@main]为NPC默认主界面标签，点击NPC优先读取该标签内容；[@触发名]为自定义分支标签，用于跳转不同功能模块。标签名称禁止中文、特殊符号，仅支持字母、数字、下划线。
2. 核心逻辑句式
固定判断执行结构：#if为条件判断开头，填写触发条件；#act为满足条件后执行的操作；#elseact为条件不满足时执行的操作；#say为游戏内弹窗显示的文字内容。所有脚本功能均由这四句组合实现，无例外。
3. 注释与格式规范
脚本中分号开头的内容为注释内容，引擎不会读取执行，仅用于作者备注说明，新手编写代码时可自由添加注释方便后期修改。代码必须严格换行书写，禁止多条指令同行，参数之间仅保留单个英文空格，中文符号、多余空格都会导致脚本报错失效。
三、新手必学核心基础指令
掌握基础指令即可编写90%的基础功能，以下为通用高频指令，适配绝大多数主流引擎，参数格式统一、无版本壁垒。
1. 道具与金币操作指令
give 物品名 数量：给予玩家指定道具或金币，示例give 金币 100000、give 裁决之杖 1；take 物品名 数量：扣除玩家背包指定道具或金币；checkitem 物品名 数量：检测玩家背包是否拥有对应道具，用于条件判断；checkgold 数值：检测玩家金币是否大于设定数值。
2. 提示与弹窗指令
#say 文本：NPC界面显示文字，支持换行排版；SENDMSG 6 文本：系统公屏提示，6为提示颜色代码，通用白色提示；SENDMSG 1 文本：红色醒目提示，用于失败、警告提示。
3. 跳转与循环指令
#goto @标签名：脚本内部跳转，执行完当前代码后跳转至指定标签继续运行；#call 脚本路径\标签名：调用外部脚本子程序，适合复用公共功能代码；RANDOM 数值：随机概率判定，RANDOM 2代表50%成功、50%失败。
4. 装备与属性基础指令
SETITEMADDVALUE 位置 属性 数值：给装备增加附加属性；RESTOREITEM 位置 0：重置装备所有附加属性；CheckItemAddValue 位置 属性 符号 数值：检测装备附加属性数值，用于装备升级上限判断。
四、零基础实战：编写第一个完整NPC脚本
以新手最常用的金币兑换奖励功能为例，手把手完成完整脚本编写，包含条件判断、道具扣除、奖励发放、失败提示全套逻辑。
功能需求：玩家拥有10万金币，可免费兑换随机基础材料，50%概率成功兑换，失败不返还金币，金币不足弹出对应提示。
完整可直接使用脚本代码：
[@main]
#say 欢迎使用新手福利兑换系统\n
#say 〖<点击兑换材料/@dl>〗消耗10万金币随机兑换基础材料\n
[@dl]
#if
checkgold > 99999
#act
take 金币 100000
RANDOM 2
#IF
EQUAL RANDOM 0
#ACT
give 黑铁矿 5
SENDMSG 6 兑换成功，获得5块黑铁矿！
#ELSEACT
SENDMSG 1 兑换失败，运气不佳，金币已扣除！
#ELSEACT
SENDMSG 1 金币不足10万，无法参与兑换！
脚本编写完成后，保存为txt格式放入Market_Def目录，对应绑定NPC编号，重启M2引擎即可在游戏内触发功能。
五、进阶功能编写思路（装备升级、任务、称号）
