传奇脚本采用纯文本文件格式，文件扩展名为.txt。所有脚本文件均为无格式文本文件，可使用记事本、Notepad++等文本编辑器直接编辑修改。脚本文件不依赖特定编码格式，通常使用ANSI或UTF-8编码保存，确保中文字符正常显示。
脚本文件存放于服务端Mir200\Envir目录下的特定子文件夹中。Market_Def文件夹存放NPC交互脚本，每个NPC对应一个独立脚本文件。QuestDiary文件夹存放功能脚本，包括任务系统、活动脚本、变量存储等。MapQuest_Def文件夹存放地图触发脚本，QManage.txt为核心全局管理脚本。MonItems文件夹存放怪物爆率脚本，控制怪物掉落物品。
脚本基本语法以标签段落为单位组织。每个独立脚本文件必须以[@MAIN]标签开头，作为脚本入口点。标签格式为[@标签名]，标签名用于脚本跳转调用。标签下方编写具体脚本内容，按行顺序执行。脚本执行遵循自上而下顺序，引擎逐行解析执行命令。
脚本命令分为检测类型与执行类型两大类。检测类型命令以#IF关键字开头，用于条件判断，包括检查等级、检查物品、检查金币等。执行类型命令以#ACT关键字开头，用于执行具体操作，包括给予物品、传送地图、发送消息等。检测与执行必须成对出现，先检测后执行。
完整脚本结构包含标签、检测、执行、对话四个核心部分。示例结构：[@MAIN]#IF检测条件#ACT执行命令#SAY对话内容。检测条件可多个并列，所有条件满足才执行#ACT部分。对话内容使用#SAY关键字显示，支持换行符和功能按钮。
NPC脚本文件命名遵循特定规则。文件名格式通常为：地图名称_X坐标_Y坐标_NPC名称_标志.txt。例如：比奇省_330_330_老兵_0.txt。标志位控制NPC显示特性，0为普通NPC，1为沙巴克相关NPC。命名规则确保引擎能准确定位NPC脚本文件。
脚本变量使用VAR关键字定义。变量分为个人变量、全局变量、字符串变量等多种类型。个人变量格式为P0-P9，全局变量格式为G0-G999，字符串变量格式为S0-S99。变量用于存储临时数据，在不同脚本间传递信息。变量操作包括赋值、加减、比较等。
条件判断支持多种检测命令。CHECKLEVEL检测玩家等级，CHECKITEM检测背包物品，CHECKGOLD检测金币数量，CHECKPKPOINT检测PK值，CHECKJOB检测职业类型。检测命令可组合使用，通过AND、OR逻辑连接。检测失败时可使用#ELSEACT执行替代操作。
执行命令涵盖游戏操作各个方面。GIVE给予物品，TAKE拿走物品，MAPMOVE传送地图，CHANGEEXP增加经验，ADDPKPOINT增加PK值，CHANGELEVEL改变等级。执行命令可连续多个，按顺序依次执行。部分命令需要参数，如GIVE屠龙刀1表示给予1把屠龙刀。
对话系统使用#SAY关键字显示文本。对话内容可包含普通文本、变量显示、功能按钮。功能按钮格式为<按钮文字/@标签>，点击按钮跳转到对应标签段落。对话支持多行显示，使用\符号换行。颜色代码格式为{颜色代码文字}，控制文字显示颜色。
脚本跳转通过goto命令实现。格式为goto@标签名，跳转到脚本内指定标签段落。跨文件调用使用#CALL命令，格式为#CALL[路径\文件名]@标签名。跳转命令实现脚本流程控制，构建分支选择结构。
时间控制使用计时器功能。SETONTIMER启动计时器，格式为SETONTIMER编号间隔秒数。计时器触发对应标签，如[@OnTimer1]处理计时事件。KILLTIMER关闭计时器。计时器用于实现定时活动、状态持续等效果。
地图触发脚本位于MapQuest_Def文件夹。QManage.txt为全局管理脚本，处理玩家登录、离线、升级等事件。地图触发标签格式为[@地图编号_坐标]，如[@3_330_330]。地图触发实现自动事件，无需玩家点击NPC。
怪物爆率脚本位于MonItems文件夹。文件名对应怪物名称，如白野猪.txt。爆率格式为：物品名称爆率数量。爆率数值为1/X，X越小爆率越高。数量范围格式为最小-最大，如金币1000-5000。爆率脚本控制怪物掉落物品。
脚本注释使用分号开头。分号后内容为注释，引擎执行时忽略。注释用于说明脚本功能、记录修改信息、临时禁用代码。良好注释提高脚本可读性，便于后期维护修改。多行注释每行都需要分号开头。
脚本错误排查依据M2Server提示。脚本语法错误会在M2Server控制台显示红色错误信息，包括错误文件、行号、错误类型。常见错误包括标签未闭合、命令拼写错误、参数格式错误。根据提示信息定位错误位置修正。
脚本加密通过专用工具实现。部分版本使用加密脚本防止修改，加密后文件扩展名可能改变。加密脚本需对应解密工具才能编辑。普通.txt脚本可直接修改，加密脚本需要先解密再编辑。加密不影响引擎执行，只影响人工阅读。
脚本调试使用SENDMSG命令输出信息。SENDMSG格式为SENDMSG类型内容，类型5为绿色系统消息。调试时输出变量值、执行状态等信息，帮助定位问题。调试完成后移除输出命令，避免干扰玩家体验。
脚本优化遵循简洁高效原则。避免过多嵌套跳转，减少不必要的检测命令，合并相同功能代码段。复杂功能拆分为多个子脚本，通过#CALL调用。优化后脚本执行效率更高，减少服务器资源占用。
脚本兼容性考虑引擎差异。GOM引擎、GEE引擎、BLUE引擎脚本语法基本兼容，部分命令存在差异。编写脚本时参考对应引擎帮助文档，使用引擎支持的命令。跨引擎移植需要测试验证，修正不兼容命令。
脚本备份采用版本管理方式。修改前备份原始脚本，使用日期或版本号命名备份文件。重大修改分步骤进行，每步测试确保功能正常。备份文件集中存放，便于恢复原始版本。版本管理避免误操作导致脚本损坏。
脚本测试在本地环境进行。修改后重启服务端加载脚本，在游戏中测试所有功能分支。测试包括正常流程、异常情况、边界条件。多人同时测试验证并发处理能力。测试通过后再部署到正式环境。
脚本学习参考官方文档与实例。引擎帮助文档提供完整命令说明，实例脚本展示实际应用。从简单脚本开始学习，逐步尝试复杂功能。修改现有脚本比从头编写更容易入门。实践操作加深理解，掌握脚本编写技巧。
脚本文件存放于服务端Mir200\Envir目录下的特定子文件夹中。Market_Def文件夹存放NPC交互脚本，每个NPC对应一个独立脚本文件。QuestDiary文件夹存放功能脚本，包括任务系统、活动脚本、变量存储等。MapQuest_Def文件夹存放地图触发脚本，QManage.txt为核心全局管理脚本。MonItems文件夹存放怪物爆率脚本，控制怪物掉落物品。
脚本基本语法以标签段落为单位组织。每个独立脚本文件必须以[@MAIN]标签开头，作为脚本入口点。标签格式为[@标签名]，标签名用于脚本跳转调用。标签下方编写具体脚本内容，按行顺序执行。脚本执行遵循自上而下顺序，引擎逐行解析执行命令。
脚本命令分为检测类型与执行类型两大类。检测类型命令以#IF关键字开头，用于条件判断，包括检查等级、检查物品、检查金币等。执行类型命令以#ACT关键字开头，用于执行具体操作，包括给予物品、传送地图、发送消息等。检测与执行必须成对出现，先检测后执行。
完整脚本结构包含标签、检测、执行、对话四个核心部分。示例结构：[@MAIN]#IF检测条件#ACT执行命令#SAY对话内容。检测条件可多个并列，所有条件满足才执行#ACT部分。对话内容使用#SAY关键字显示，支持换行符和功能按钮。
NPC脚本文件命名遵循特定规则。文件名格式通常为：地图名称_X坐标_Y坐标_NPC名称_标志.txt。例如：比奇省_330_330_老兵_0.txt。标志位控制NPC显示特性，0为普通NPC，1为沙巴克相关NPC。命名规则确保引擎能准确定位NPC脚本文件。
脚本变量使用VAR关键字定义。变量分为个人变量、全局变量、字符串变量等多种类型。个人变量格式为P0-P9，全局变量格式为G0-G999，字符串变量格式为S0-S99。变量用于存储临时数据，在不同脚本间传递信息。变量操作包括赋值、加减、比较等。
条件判断支持多种检测命令。CHECKLEVEL检测玩家等级，CHECKITEM检测背包物品，CHECKGOLD检测金币数量，CHECKPKPOINT检测PK值，CHECKJOB检测职业类型。检测命令可组合使用，通过AND、OR逻辑连接。检测失败时可使用#ELSEACT执行替代操作。
执行命令涵盖游戏操作各个方面。GIVE给予物品，TAKE拿走物品，MAPMOVE传送地图，CHANGEEXP增加经验，ADDPKPOINT增加PK值，CHANGELEVEL改变等级。执行命令可连续多个，按顺序依次执行。部分命令需要参数，如GIVE屠龙刀1表示给予1把屠龙刀。
对话系统使用#SAY关键字显示文本。对话内容可包含普通文本、变量显示、功能按钮。功能按钮格式为<按钮文字/@标签>，点击按钮跳转到对应标签段落。对话支持多行显示，使用\符号换行。颜色代码格式为{颜色代码文字}，控制文字显示颜色。
脚本跳转通过goto命令实现。格式为goto@标签名，跳转到脚本内指定标签段落。跨文件调用使用#CALL命令，格式为#CALL[路径\文件名]@标签名。跳转命令实现脚本流程控制，构建分支选择结构。
时间控制使用计时器功能。SETONTIMER启动计时器，格式为SETONTIMER编号间隔秒数。计时器触发对应标签，如[@OnTimer1]处理计时事件。KILLTIMER关闭计时器。计时器用于实现定时活动、状态持续等效果。
地图触发脚本位于MapQuest_Def文件夹。QManage.txt为全局管理脚本，处理玩家登录、离线、升级等事件。地图触发标签格式为[@地图编号_坐标]，如[@3_330_330]。地图触发实现自动事件，无需玩家点击NPC。
怪物爆率脚本位于MonItems文件夹。文件名对应怪物名称，如白野猪.txt。爆率格式为：物品名称爆率数量。爆率数值为1/X，X越小爆率越高。数量范围格式为最小-最大，如金币1000-5000。爆率脚本控制怪物掉落物品。
脚本注释使用分号开头。分号后内容为注释，引擎执行时忽略。注释用于说明脚本功能、记录修改信息、临时禁用代码。良好注释提高脚本可读性，便于后期维护修改。多行注释每行都需要分号开头。
脚本错误排查依据M2Server提示。脚本语法错误会在M2Server控制台显示红色错误信息，包括错误文件、行号、错误类型。常见错误包括标签未闭合、命令拼写错误、参数格式错误。根据提示信息定位错误位置修正。
脚本加密通过专用工具实现。部分版本使用加密脚本防止修改，加密后文件扩展名可能改变。加密脚本需对应解密工具才能编辑。普通.txt脚本可直接修改，加密脚本需要先解密再编辑。加密不影响引擎执行，只影响人工阅读。
脚本调试使用SENDMSG命令输出信息。SENDMSG格式为SENDMSG类型内容，类型5为绿色系统消息。调试时输出变量值、执行状态等信息，帮助定位问题。调试完成后移除输出命令，避免干扰玩家体验。
脚本优化遵循简洁高效原则。避免过多嵌套跳转，减少不必要的检测命令，合并相同功能代码段。复杂功能拆分为多个子脚本，通过#CALL调用。优化后脚本执行效率更高，减少服务器资源占用。
脚本兼容性考虑引擎差异。GOM引擎、GEE引擎、BLUE引擎脚本语法基本兼容，部分命令存在差异。编写脚本时参考对应引擎帮助文档，使用引擎支持的命令。跨引擎移植需要测试验证，修正不兼容命令。
脚本备份采用版本管理方式。修改前备份原始脚本，使用日期或版本号命名备份文件。重大修改分步骤进行，每步测试确保功能正常。备份文件集中存放，便于恢复原始版本。版本管理避免误操作导致脚本损坏。
脚本测试在本地环境进行。修改后重启服务端加载脚本，在游戏中测试所有功能分支。测试包括正常流程、异常情况、边界条件。多人同时测试验证并发处理能力。测试通过后再部署到正式环境。
脚本学习参考官方文档与实例。引擎帮助文档提供完整命令说明，实例脚本展示实际应用。从简单脚本开始学习，逐步尝试复杂功能。修改现有脚本比从头编写更容易入门。实践操作加深理解，掌握脚本编写技巧。