一、脚本编写基础：格式与规范
传奇脚本核心为.txt文本格式，可通过记事本、Notepad等文本编辑器编写，保存后直接放入对应目录即可被引擎识别。脚本命令分两类，语句命令以“#”开头，触发命令以“@”开头，语法格式严格，多余空格、符号错误会导致执行失败。
核心基础命令需熟练掌握：#IF为条件判断命令，用于校验等级、职业、金币等前提；#ACT为执行命令，触发跳转、传送到地图、增减经验等动作；#SAY用于显示文字提示，无需额外定界符；@开头命令为触发标识，如@start、@泡点，用于指定脚本执行入口。编写时需遵循“条件-动作”逻辑，无条件直接执行动作时可省略#IF语句。
二、脚本文件分类与部署路径
脚本需按功能分类存放至服务端对应目录，不同路径对应不同触发场景，错放路径会导致脚本无法被调用。核心部署路径如下：NPC对话脚本放Mir200\Envir\NpcDef，文件名与NPC编号一致，触发方式为点击NPC触发；全局触发脚本放Mir200\Envir\MapQuest_def\QManage.txt，支持登录、定时器、地图进入等全局触发。
专项功能脚本按场景存放：任务脚本放MapQuest_def文件夹下，按任务类型分文件编写；物品使用脚本关联物品属性，在物品编辑器中绑定对应@命令，脚本内容写入QFunction.txt；地图专属脚本放Envir\MapInfo.txt，配置地图进入、怪物死亡等触发事件。部署后需重启引擎，确保脚本被加载。
三、脚本触发方式：四大核心场景
NPC触发是最常用场景，编写时以“(@触发标识)”作为脚本开头，绑定NPC后，玩家点击NPC即可触发对应逻辑。例如泡点NPC脚本，以(@收费泡点)为入口，通过#IF校验会员身份、元宝数量，#ACT执行传送地图、开启定时器动作，同时用SENDMSG命令发送提示信息。
定时器触发适用于周期性动作，需在QManage.txt中编写@OnTimer+数字标识的脚本，通过SetScTimer命令设置执行间隔。如每1秒增加泡点经验，脚本标识为@OnTimer3，设置SetScTimer31后，引擎会按1秒频率循环执行脚本内动作，结束时用KillScTimer命令关闭定时器。
物品触发需先在物品编辑器中勾选“可使用”，绑定对应@命令，脚本内容写入QFunction系列文件。玩家双击物品时，引擎调用绑定脚本，执行校验条件、触发效果等动作。地图触发通过MapInfo.txt配置，支持玩家进入地图、怪物死亡、物品掉落等事件，绑定脚本后满足对应条件自动执行。
命令触发需玩家在游戏内输入指定@命令触发，适用于GM操作、隐藏功能激活等场景。脚本编写时以对应@命令为入口，无需额外绑定，玩家输入命令后，引擎校验权限及条件，符合要求则执行对应动作。
四、引擎加载与执行流程
脚本部署完成后，需重启引擎完成加载，加载顺序为配置文件→脚本文件→素材文件。引擎启动时会扫描对应脚本目录，校验脚本语法，语法错误会记录至引擎日志，无错误则纳入执行队列，等待触发条件。
触发后执行流程分三步：首先校验#IF条件，满足则执行#ACT动作，不满足则执行#ELSEACT动作（无此语句则终止）；动作执行时按脚本顺序依次完成，涉及数据修改（增减经验、元宝）会同步写入数据库；执行完成后返回触发状态，定时器脚本会持续循环，直至触发终止条件。
不同引擎加载逻辑略有差异：Hero引擎加载脚本速度快，对语法容错率低；Blue引擎支持可视化脚本加载，可实时查看加载状态；3K引擎侧重执行效率，大规模脚本需分文件编写，避免加载卡顿。
五、常见执行故障及排查方法
脚本无响应多为路径错误或语法问题。先核查脚本存放路径是否正确，文件名是否与配置要求一致；再逐行检查命令格式，重点排查#IF、#ACT是否配对，@命令是否正确，参数是否完整（如地图名、数值需准确）。
条件校验失效需检查命令参数，如checklevel、checkgold命令数值设置是否合理，职业校验checkjob参数是否为Warr、Wizard、Taos对应值。动作执行不全可能是脚本存在逻辑冲突，需拆分脚本分步测试，定位冲突语句并删除或修改。
引擎日志是核心排查工具，启动引擎后查看日志文件，语法错误、路径错误、参数错误均会明确标注。数据库同步失败导致动作无效果时，需检查引擎与数据库连接状态，确保数据写入权限正常，必要时修复数据表结构。
六、实操注意要点
编写脚本前备份原有文件，每次修改后单独测试，避免批量修改导致全局故障。脚本路径及文件名需使用纯英文，禁止含中文、特殊符号，否则引擎无法识别加载。涉及定时器、全局触发的脚本，需控制执行频率，避免占用过多引擎资源导致卡顿。
不同引擎脚本兼容性有差异，跨引擎迁移脚本时需修改对应命令，如Blue引擎支持的可视化命令在Hero引擎中需替换为基础语法。测试脚本时创建专用测试角色，模拟不同场景触发，确保脚本在各类条件下均能正常执行。
传奇脚本核心为.txt文本格式，可通过记事本、Notepad等文本编辑器编写，保存后直接放入对应目录即可被引擎识别。脚本命令分两类，语句命令以“#”开头，触发命令以“@”开头，语法格式严格，多余空格、符号错误会导致执行失败。
核心基础命令需熟练掌握：#IF为条件判断命令，用于校验等级、职业、金币等前提；#ACT为执行命令，触发跳转、传送到地图、增减经验等动作；#SAY用于显示文字提示，无需额外定界符；@开头命令为触发标识，如@start、@泡点，用于指定脚本执行入口。编写时需遵循“条件-动作”逻辑，无条件直接执行动作时可省略#IF语句。
二、脚本文件分类与部署路径
脚本需按功能分类存放至服务端对应目录，不同路径对应不同触发场景，错放路径会导致脚本无法被调用。核心部署路径如下：NPC对话脚本放Mir200\Envir\NpcDef，文件名与NPC编号一致，触发方式为点击NPC触发；全局触发脚本放Mir200\Envir\MapQuest_def\QManage.txt，支持登录、定时器、地图进入等全局触发。
专项功能脚本按场景存放：任务脚本放MapQuest_def文件夹下，按任务类型分文件编写；物品使用脚本关联物品属性，在物品编辑器中绑定对应@命令，脚本内容写入QFunction.txt；地图专属脚本放Envir\MapInfo.txt，配置地图进入、怪物死亡等触发事件。部署后需重启引擎，确保脚本被加载。
三、脚本触发方式：四大核心场景
NPC触发是最常用场景，编写时以“(@触发标识)”作为脚本开头，绑定NPC后，玩家点击NPC即可触发对应逻辑。例如泡点NPC脚本，以(@收费泡点)为入口，通过#IF校验会员身份、元宝数量，#ACT执行传送地图、开启定时器动作，同时用SENDMSG命令发送提示信息。
定时器触发适用于周期性动作，需在QManage.txt中编写@OnTimer+数字标识的脚本，通过SetScTimer命令设置执行间隔。如每1秒增加泡点经验，脚本标识为@OnTimer3，设置SetScTimer31后，引擎会按1秒频率循环执行脚本内动作，结束时用KillScTimer命令关闭定时器。
物品触发需先在物品编辑器中勾选“可使用”，绑定对应@命令，脚本内容写入QFunction系列文件。玩家双击物品时，引擎调用绑定脚本，执行校验条件、触发效果等动作。地图触发通过MapInfo.txt配置，支持玩家进入地图、怪物死亡、物品掉落等事件，绑定脚本后满足对应条件自动执行。
命令触发需玩家在游戏内输入指定@命令触发，适用于GM操作、隐藏功能激活等场景。脚本编写时以对应@命令为入口，无需额外绑定，玩家输入命令后，引擎校验权限及条件，符合要求则执行对应动作。
四、引擎加载与执行流程
脚本部署完成后，需重启引擎完成加载，加载顺序为配置文件→脚本文件→素材文件。引擎启动时会扫描对应脚本目录，校验脚本语法，语法错误会记录至引擎日志，无错误则纳入执行队列，等待触发条件。
触发后执行流程分三步：首先校验#IF条件，满足则执行#ACT动作，不满足则执行#ELSEACT动作（无此语句则终止）；动作执行时按脚本顺序依次完成，涉及数据修改（增减经验、元宝）会同步写入数据库；执行完成后返回触发状态，定时器脚本会持续循环，直至触发终止条件。
不同引擎加载逻辑略有差异：Hero引擎加载脚本速度快，对语法容错率低；Blue引擎支持可视化脚本加载，可实时查看加载状态；3K引擎侧重执行效率，大规模脚本需分文件编写，避免加载卡顿。
五、常见执行故障及排查方法
脚本无响应多为路径错误或语法问题。先核查脚本存放路径是否正确，文件名是否与配置要求一致；再逐行检查命令格式，重点排查#IF、#ACT是否配对，@命令是否正确，参数是否完整（如地图名、数值需准确）。
条件校验失效需检查命令参数，如checklevel、checkgold命令数值设置是否合理，职业校验checkjob参数是否为Warr、Wizard、Taos对应值。动作执行不全可能是脚本存在逻辑冲突，需拆分脚本分步测试，定位冲突语句并删除或修改。
引擎日志是核心排查工具，启动引擎后查看日志文件，语法错误、路径错误、参数错误均会明确标注。数据库同步失败导致动作无效果时，需检查引擎与数据库连接状态，确保数据写入权限正常，必要时修复数据表结构。
六、实操注意要点
编写脚本前备份原有文件，每次修改后单独测试，避免批量修改导致全局故障。脚本路径及文件名需使用纯英文，禁止含中文、特殊符号，否则引擎无法识别加载。涉及定时器、全局触发的脚本，需控制执行频率，避免占用过多引擎资源导致卡顿。
不同引擎脚本兼容性有差异，跨引擎迁移脚本时需修改对应命令，如Blue引擎支持的可视化命令在Hero引擎中需替换为基础语法。测试脚本时创建专用测试角色，模拟不同场景触发，确保脚本在各类条件下均能正常执行。