一、脚本执行前提：基础准备与环境校验
传奇脚本执行需满足环境适配、路径合规、文件完整三大前提，缺一不可。服务端路径必须为纯英文，无中文、空格或特殊字符，例如D:\MirServer，路径异常会直接导致脚本无法读取，需先迁移服务端至合规目录。
脚本文件需保持完整且编码正确，优先使用Notepad++打开，确认编码为UTF-8或ANSI格式，避免系统记事本编辑导致的乱码。同时校验脚本关联文件（如数据文件、配置文件）是否齐全，缺失配套文件会引发执行中断，需从同版本服务端提取补充。
确保M2引擎、网关等服务端组件正常启动，无报错运行，组件未启动会导致脚本无法被调用，需按“数据库→网关→M2引擎”顺序重启服务端，待控制台无异常提示后再执行脚本操作。
二、核心执行方式：按脚本类型分类操作
（一）NPC功能脚本：自动执行与重载生效
NPC脚本（存放于Mir200\Envir\Market_def目录）默认随服务端启动自动执行，无需手动触发，核心用于实现NPC对话、交易、任务引导等功能。脚本命名需符合规范（如XXX.txt），关联NPC编号与脚本内容一致，否则无法触发对应逻辑。
修改NPC脚本后无需重启服务端，通过M2引擎控制台输入命令“@reloadnpc all”，即可重载所有NPC脚本，使修改生效。若仅修改单个脚本，可精准重载对应文件，避免影响其他NPC功能正常运行。
部分复杂NPC脚本需关联QuestDiary目录下的数据文件，执行时需确保数据文件路径正确，脚本内调用命令与数据文件字段匹配，否则会出现NPC无响应、对话错乱等问题。
（二）功能触发脚本：事件关联与手动调用
功能触发脚本（如QFunction.txt、QManage.txt，存放于Mir200\Envir\QuestDiary目录）通过特定事件触发执行，常见触发条件包括角色登录、等级提升、物品使用、地图切换等。脚本内需通过对应命令绑定事件，例如登录触发需写入“OnLogin”关联语法。
修改触发脚本后，输入M2命令“@reloadqf”重载功能脚本，或“@reloadqm”重载全局管理脚本，重启触发机制。若需手动测试脚本逻辑，可在游戏内通过GM命令直接调用对应脚本片段，快速验证执行效果。
这类脚本支持嵌套调用，可通过命令关联其他脚本文件，执行时需确保关联路径准确，避免因路径错误导致脚本调用失败，建议使用相对路径编写关联命令。
（三）机器人脚本：定时执行与规则配置
机器人脚本（存放于Mir200\Envir\Robot_def目录）主要实现自动挂机、定时广播、怪物刷新等功能，执行方式分为定时触发和条件触发两类。脚本需在RobotManage.txt中配置执行规则，明确触发时间、频率及范围。
启动服务端时，机器人脚本随M2引擎自动加载执行，修改脚本后需输入命令“@reloadrobot”重载，或重启M2引擎使配置生效。定时脚本需严格遵循时间格式编写，例如每日固定时间执行需标注具体时段，避免语法错误导致执行异常。
（四）临时脚本：手动执行与一次性生效
临时脚本（如批量修改数据、手动触发任务的脚本）无需放入服务端目录，可通过M2引擎“脚本命令执行”功能手动运行。打开M2引擎，找到对应功能入口，粘贴脚本内容或选择脚本文件，点击执行即可完成操作，执行后效果即时生效。
这类脚本多用于临时调试、数据修正，执行前需备份核心数据，避免脚本逻辑错误导致数据异常，执行完成后建议关闭手动执行入口，防止误操作。
三、脚本执行命令：常用指令与用法
1. 脚本重载指令：@reloadnpc all（重载所有NPC脚本）、@reloadqf（重载功能触发脚本）、@reloadqm（重载全局管理脚本）、@reloadrobot（重载机器人脚本），输入后控制台会提示“重载成功”，确认生效。
2. 手动执行指令：@execute 脚本路径（如@execute D:\MirServer\Mir200\Envir\Test.txt），用于手动运行临时脚本，路径需为完整英文路径，否则无法识别文件。
3. 调试指令：@debug 脚本名称，开启脚本调试模式，执行时会在控制台输出详细日志，便于定位语法错误、路径异常等问题，调试完成后需关闭调试模式，避免占用资源。
四、执行故障排查：常见问题与解决方法
1. 脚本无响应，无任何执行效果。核心为路径错误或编码乱码，检查脚本存放路径是否合规，重新用Notepad++转换编码格式，确保与服务端适配，同时校验脚本内调用的文件路径是否正确。
2. 控制台提示脚本语法错误。多为命令拼写错误、格式错乱导致，对照传奇脚本语法手册，检查关键字、符号是否正确，例如括号不闭合、命令缺失后缀等，修正后重载脚本即可。
3. 部分脚本执行正常，部分失效。可能是脚本冲突或关联文件损坏，排查近期修改的脚本，还原冲突文件，或替换损坏的关联数据文件，重载对应脚本后测试。
4. 重载脚本后仍无效果。需重启整个服务端，清除服务端Temp目录下的缓存文件，避免残留缓存阻碍配置生效，重启后按正确顺序重载脚本。
五、脚本执行优化：实操要点与避坑指南
1. 执行前备份原始脚本，修改或新增脚本后先在测试环境验证效果，无异常再应用到正式环境，避免影响游戏正常运行。
2. 复杂脚本建议分段编写、分段测试，逐步完善逻辑，避免一次性编写大量内容导致错误难以定位，提升执行稳定性。
3. 避免脚本嵌套层级过多，层级过深会导致执行延迟、卡顿，简化嵌套逻辑，必要时拆分脚本为多个独立文件，分别调用执行。
4. 定期清理无效脚本、冗余命令，减少服务端加载压力，确保脚本执行效率，同时保持脚本文件命名规范、目录分类清晰，便于后续维护。
六、特殊场景：脚本热更新与动态执行
部分传奇版本支持脚本热更新，无需重启服务端即可加载新脚本，通过服务端后台上传脚本文件，执行对应重载命令，即可实现动态更新，适用于在线调试、紧急修复等场景。
动态执行脚本需确保脚本语法严谨，无逻辑漏洞，避免热更新时引发服务端卡顿、崩溃，建议更新前关闭非必要功能，更新后持续监控控制台日志，确认无异常执行信息。
