一、传奇脚本基础认知与必备工具
传奇脚本是控制游戏内NPC对话、任务触发、装备操作、功能玩法的核心代码，分为NPC脚本、任务脚本、功能脚本三大类，全部为文本格式编写，无需高端编程基础，新手可快速上手。制作前需准备适配工具，保证脚本编写、读取、运行顺畅。
1.1 必备制作工具
记事本：系统自带记事本可直接编写基础脚本，适合简单功能，保存时注意编码格式；Notepad++：推荐首选工具，支持代码高亮、行数显示、编码切换，避免脚本乱码、报错；服务端路径查看器：快速定位传奇服务端脚本存放文件夹，方便后续放置、调试。
1.2 脚本存放路径与命名规则
传奇服务端脚本固定存放路径：D:\mirserver\Mir200\Envir\Market_Def\，NPC交互脚本放此文件夹；任务脚本、功能脚本存放路径：D:\mirserver\Mir200\Envir\QuestDiys\。命名规则：文件名用英文、数字、短横线，禁止中文、特殊符号，后缀统一为.txt，比如npc-upgrade.txt、task-daily.txt，方便查找管理。
二、传奇脚本核心语法与基础结构
传奇脚本语法固定，遵循固定结构编写，写错格式会直接报错，核心结构分为触发段、判断段、执行段、提示段，每段各司其职。
2.1 核心标签与语法规则
- [@main]：脚本主入口，NPC对话首页显示内容，每个脚本必带
- [@标签名]：自定义分支标签，用于跳转功能、子菜单，比如[@武器升级]、[@领取奖励]
- #if：判断条件开头，用于检测金币、物品、等级、状态，满足条件才执行后续操作
- #act：执行动作段，满足判断条件后，执行扣金币、给物品、发提示、改属性等操作
- #elsesay：条件不满足时的提示语，告诉玩家未达标原因
- sendmsg 1 内容：发送全屏/玩家提示信息，1代表仅触发玩家可见
- take 物品名称 数量：扣除玩家指定物品、金币
- give 物品名称 数量：给予玩家指定物品、奖励
2.2 脚本基础格式（必记）
;脚本注释，说明脚本用途，不影响运行
[@main]
这里写NPC首页对话文字\
〖<功能按钮/@分支标签>〗 〖<关闭/@exit>〗
[@分支标签]
#if
;判断条件，比如checkgold > 10000（金币大于1万）
#act
;执行操作，比如give 金币 10000
sendmsg 1 操作成功提示
#elsesay
;条件不满足时的提示文字
注意：语法标签必须顶格写，不能加空格；判断、执行段内代码用Tab缩进；每行代码结尾无需加分号；文字换行用\符号，按钮用<>包裹，跳转标签对应[@]内名称。
三、从零制作传奇脚本实操步骤
3.1 第一步：确定脚本功能与需求
制作前明确脚本用途，是做NPC升级、日常任务、礼包领取、装备回收还是其他功能，梳理所需条件（等级、金币、物品）、执行动作（扣资源、给奖励、触发玩法）、提示文案，避免编写时逻辑混乱。
3.2 第二步：新建脚本文件并编写内容
打开Notepad++，新建空白文档，先写脚本注释标注用途，再按基础格式编写主入口和分支标签。先写简单功能练手，比如每日礼包领取脚本，再逐步编写装备升级、任务触发等复杂脚本。编写时逐行核对语法，标签名称前后一致，判断条件、执行命令格式正确。
3.3 第三步：保存脚本并放置对应路径
编写完成后，点击另存为，编码选择ANSI（防止乱码），文件名用英文+txt后缀，保存至对应脚本文件夹（NPC脚本存Market_Def，功能脚本存QuestDiys）。保存后关闭文档，检查文件路径、文件名是否正确，无中文、无特殊字符。
3.4 第四步：绑定NPC并加载脚本
找到服务端NPC配置文件（路径：D:\mirserver\Mir200\Envir\Npc.txt），添加新NPC信息，设置NPC名称、坐标、绑定脚本文件名，格式为：NPC名称 地图 坐标 X Y 脚本文件名 显示头像。添加完成后保存，重启服务端M2程序，加载新脚本和NPC配置。
3.5 第五步：进游戏测试调试
登录游戏，找到对应NPC，点击功能按钮测试脚本：条件达标时，能否正常执行操作、发放奖励；条件不达标时，能否弹出对应提示。出现报错、无响应、功能异常时，返回脚本文件核对语法、标签、命令，修改后重启M2重新测试。
四、常用传奇脚本模板（直接复制修改）
4.1 每日礼包领取脚本
;每日礼包领取脚本
[@main]
欢迎领取每日礼包，每日限领一次\
〖<领取礼包/@领取>〗 〖<关闭/@exit>〗
[@领取]
#if
checkdaily 1 0 ;检测当日未领取
#act
take 金币 1000
give 经验丹 5
sendmsg 1 每日礼包领取成功
#elsesay
今日已领取，请明日再来
4.2 装备回收脚本
;装备回收脚本
[@main]
装备回收兑换金币\
〖<回收普通装备/@回收>〗 〖<关闭/@exit>〗
[@回收]
#if
checkitem 普通武器 1
#act
take 普通武器 1
give 金币 5000
sendmsg 1 回收成功，获得5000金币
#elsesay
背包内无普通武器可回收
五、脚本制作常见错误与解决方法
5.1 脚本乱码、不显示文字
原因：保存编码错误，解决方法：用Notepad++打开脚本，选择编码-转为ANSI编码，重新保存；避免用中文文件名、中文路径。
5.2 点击按钮无反应、报错
原因：标签名称不对应、语法顶格错误、命令拼写错误，解决方法：核对<按钮/@标签>名称一致；语法标签顶格写；检查命令拼写（比如checkgold、give、take），大小写不影响但字母不能错。
5.3 条件满足不执行操作
原因：判断条件格式错误、物品名称写错，解决方法：核对物品名称与游戏内一致；判断条件符号正确（大于>、小于<、等于=）；重启M2程序重新加载脚本。
5.4 NPC不显示、找不到脚本
原因：NPC配置路径错误、脚本存放位置错误，解决方法：核对Npc.txt内脚本文件名与实际文件名一致；脚本放入对应文件夹，重启服务端。
六、进阶脚本制作技巧
新手先从简单脚本练手，掌握基础语法后，再编写多分支、多条件的复杂脚本；编写时多写注释，方便后续修改、维护；借鉴现成脚本模板时，只改功能内容、不改核心语法，减少报错概率；每次修改脚本后，必须重启M2服务端，否则新脚本不生效。
脚本制作无捷径，多写多测、逐行核对，即可熟练制作各类传奇功能脚本。
