一、传奇脚本核心执行顺序（通用逻辑）
1. 基础执行原则：自上而下逐行解析
传奇脚本执行遵循“自上而下、逐行读取”的核心原则，无特殊跳转命令时，脚本会从第一行开始依次解析执行，直至脚本末尾或遇到终止命令。例如包含条件判断的脚本，会先读取#IF条件行，再依次执行后续#SAY、#ACT等命令，若条件不满足则跳转至ELSEACT/ELSESAY分支，分支执行完毕后继续向下读取剩余脚本内容。
需注意：脚本执行过程中，一行命令解析失败不会导致整个脚本终止，会跳过错误行继续执行下一行，但错误命令对应的功能会失效。例如参数错误的刷怪命令，会被系统忽略，后续正常命令仍可正常执行。
2. 条件判断执行顺序：先检测再执行
包含条件判断的脚本，执行顺序为“条件检测→分支执行→后续执行”，核心逻辑如下：
1. 优先执行#IF后的检测命令，支持多条件叠加，多条件需同时满足方可触发对应分支（即“与”逻辑，无特殊标识时不支持“或”逻辑）。例如#IF checkgold 1000 checklevel 10，需同时满足金币≥1000且等级≥10，才会执行#ACT分支。
2. 条件满足时，执行#ACT后的执行命令（如刷怪、传送到指定地点、增减道具等），执行完成后读取后续脚本；条件不满足时，直接跳转至ELSEACT/ELSESAY分支，执行对应内容后再继续向下解析。
3. 多组条件判断并列时，按脚本中排列顺序依次检测，首个满足条件的分支会被执行，后续条件判断会被跳过。例如先检测#IF checkitem 传送卷轴 1，再检测#IF checkgold 5000，若玩家携带传送卷轴，会优先执行第一组条件的#ACT命令，第二组条件不再检测。
3. 事件触发类脚本：先绑定再执行
事件触发型脚本（如攻击触发、对话触发）需先完成事件绑定，再等待触发条件满足后执行，执行顺序为“脚本加载→事件监听→条件触发→命令执行”：
1. 服务端启动或脚本重载时，加载脚本并完成事件绑定，例如将(@Attack)标签绑定至攻击事件，将(@Talk)标签绑定至NPC对话事件。
2. 游戏内触发对应事件（如玩家攻击怪物、点击NPC），系统会快速匹配绑定该事件的脚本标签，调用对应脚本进行解析。
3. 脚本按“条件检测→分支执行”逻辑运行，执行完成后返回事件响应结果（如攻击触发脚本执行完毕后，返回技能触发反馈），随后释放脚本占用的系统资源。
典型示例：攻击触发金币奖励脚本，绑定(@Attack)标签后，玩家每次攻击都会触发脚本检测，若满足攻击怪物条件，执行#ACT addgold 10命令，给玩家增加10金币，攻击结束后脚本执行完毕。
4. 脚本跳转与终止：特殊命令改变执行顺序
部分特殊命令可改变默认执行顺序，核心包括跳转命令与终止命令：
1. 跳转命令（如goto、@标签）：执行后直接跳转至指定标签位置，从标签所在行开始继续解析，可实现脚本内循环或跨段执行。例如脚本中添加“goto Start”，执行后会跳转至(@Start)标签行，重复执行标签后的内容。
2. 终止命令（如break、end）：执行后直接终止当前脚本，后续内容不再解析。例如在#ACT分支末尾添加break命令，分支执行完毕后立即终止脚本，避免执行后续多余命令。
二、传奇世界脚本运行机制（从加载到执行全流程）
1. 脚本加载：启动时同步加载，重载时实时更新
传奇世界脚本分为服务端脚本与客户端辅助脚本，加载机制存在差异，但核心均为“启动加载+重载更新”：
1. 服务端核心脚本（NPC脚本、事件脚本、刷怪脚本）：服务端启动时，会自动扫描指定目录（如NPCScript、MonGen文件夹），加载所有脚本文件并解析核心配置，建立事件与脚本的绑定关系，加载完成后显示“脚本加载成功”提示，未加载成功的脚本会在日志中标注错误原因（如格式错误、路径错误）。
2. 客户端辅助脚本（自动战斗、技能释放脚本）：客户端启动时，加载本地辅助脚本文件，需与当前游戏版本适配，适配失败会导致脚本无法启动。部分辅助脚本支持实时重载，修改后点击“应用”即可生效，无需重启客户端。
3. 脚本重载：服务端脚本可通过GM命令（如@reloadnpc all、@reloadscript）实时重载，重载时会覆盖原有脚本配置，无需重启服务端；客户端辅助脚本重载需在辅助工具界面操作，部分脚本重载后需重新启动辅助工具。
2. 核心运行流程：触发→解析→执行→反馈
传奇世界脚本运行遵循“触发→解析→执行→反馈”四步流程，以常见的NPC对话脚本为例，完整流程如下：
1. 触发阶段：玩家点击NPC，触发对话事件，系统根据NPC编号匹配对应的脚本文件，调用脚本进行执行。
2. 解析阶段：脚本解析器逐行读取脚本内容，识别命令类型（如对话命令#SAY、条件命令#IF、执行命令#ACT），并校验命令参数的有效性（如道具ID、坐标是否正确）。
3. 执行阶段：按解析结果执行对应命令，对话命令会在游戏界面显示文字内容，执行命令会同步修改游戏数据（如增减道具、修改角色属性），执行过程中会实时与服务端数据库同步数据。
4. 反馈阶段：执行完成后，向玩家反馈执行结果（如弹窗提示“领取奖励成功”“条件不足”），同时将执行日志写入服务端日志文件，便于后续排查问题。
3. 不同类型脚本的运行差异
传奇世界脚本按功能可分为NPC脚本、战斗脚本、刷怪脚本等，运行机制存在细微差异，核心区别如下：
1. NPC脚本：以对话触发为主，支持多轮对话交互，运行时会保持对话状态，直至玩家关闭对话界面或执行跳转命令。例如包含多选项的NPC脚本，玩家选择不同选项会触发不同分支，分支执行完毕后仍可返回主对话界面。
2. 战斗脚本（自动战斗、技能触发脚本）：实时监听战斗事件（攻击、被攻击、技能冷却结束），触发后快速执行预设命令，执行优先级高于手动操作。例如自动释放技能脚本，会实时检测技能冷却状态与目标距离，满足条件时自动释放技能，无需玩家手动点击。
3. 刷怪脚本：按预设时间间隔循环执行，服务端启动后自动运行，无需手动触发。脚本会按配置的坐标、数量、间隔执行刷怪命令，刷怪失败时会在日志中报错，同时尝试下一次刷怪（如坐标无效会导致刷怪失败，下一个间隔仍会尝试刷怪）。
4. 任务脚本：与任务进度绑定，运行时会读取玩家任务数据，检测任务完成条件（如道具收集、怪物击杀数量），满足条件时更新任务进度并执行奖励命令，任务完成后自动终止脚本。
三、脚本运行的核心依赖与生效条件
1. 依赖组件：引擎、数据库与配置文件
传奇世界脚本运行需依赖三大核心组件，缺失或异常会导致脚本无法运行：
1. 游戏引擎：不同引擎（如GOM、翎风、996引擎）对脚本语法的支持存在差异，脚本需与引擎版本适配，否则会出现解析失败。例如996引擎支持Lua脚本语法，而GOM引擎以QM脚本语法为主，跨引擎使用脚本会导致运行异常。
2. 数据库：脚本执行过程中会读取/修改数据库数据（如角色属性、道具数量、任务进度），数据库连接异常或权限不足，会导致脚本执行失败（如无法读取玩家金币数量、无法发放奖励道具）。
3. 配置文件：脚本运行需依赖地图配置（MapInfo.txt）、怪物配置（Monster.DB）等文件，配置文件缺失或参数错误，会导致脚本命令失效（如传送命令因地图编号错误无法执行，刷怪命令因怪物ID错误无法刷出怪物）。
2. 生效条件：语法正确与权限匹配
脚本需满足两大生效条件，否则会导致运行异常或功能失效：
1. 语法格式正确：脚本命令需严格遵循语法规范，命令关键字、参数顺序、符号使用均需正确。例如#IF条件后需紧跟检测命令，#SAY后需添加对话内容（无内容会导致对话界面空白），参数之间需用空格分隔（缺少空格会导致参数识别错误）。
2. 权限等级匹配：部分高级脚本（如修改角色属性、刷取稀有道具）需对应权限等级方可运行，普通玩家账号执行会被系统拦截，仅管理员账号（GM账号）可执行。例如#ACT setlevel 99命令，需GM账号执行，普通账号执行会无响应。
四、常见脚本运行问题排查（避坑指南）
1. 脚本不执行：触发条件与加载问题
核心原因：触发条件未满足、脚本未加载或事件未绑定，排查步骤如下：
1. 检查触发条件：确认触发事件是否正确（如对话脚本需点击对应NPC，攻击触发脚本需攻击目标），同时核实#IF条件是否满足（如金币数量、等级、道具是否符合要求）。
2. 验证脚本加载：查看服务端日志，确认脚本是否加载成功，加载失败时会标注错误原因（如格式错误、路径错误），需修改后重新重载脚本。
3. 核对事件绑定：确认脚本标签与事件是否正确绑定（如攻击触发脚本需绑定(@Attack)标签，对话脚本需绑定(@Talk)标签），标签错误会导致事件无法触发脚本。
2. 脚本执行异常：语法与参数错误
表现为脚本部分命令失效或执行结果异常，排查步骤：
1. 校验语法格式：逐行检查脚本命令，确认关键字无错别字（如将#ACT误写为#ATC）、参数顺序正确（如传送到指定地点命令mapmove 地图编号 X坐标 Y坐标，参数顺序错误会导致传送异常）。
2. 核实参数有效性：确认道具ID、怪物ID、地图编号等参数正确，可通过数据库或配置文件查询对应参数（如魔龙怪物ID可在Monster.DB中查询，避免ID错误导致刷怪失败）。
3. 检查条件逻辑：多条件叠加时，确认是否满足“同时满足”要求，若需实现“或”逻辑，需添加对应标识（如部分引擎支持#IF or checkgold 1000 checkitem 传送卷轴 1，满足任一条件即可触发）。
3. 战斗脚本触发失效：事件与协议问题
攻击触发、技能触发等战斗脚本失效，多为事件绑定或协议不一致导致，排查方法：
1. 确认事件监听：检查脚本是否正确绑定战斗事件（如OnAttack、OnHit），未绑定事件会导致脚本无法监听攻击动作，需重新绑定事件标签。
2. 检测状态同步：查看脚本是否包含实时检测逻辑（如MP是否充足、技能冷却是否结束），缺失检测会导致技能误触发或静默失败（如MP不足时触发技能释放脚本，会因条件不满足而失效）。
3. 校验协议版本：确认客户端与服务端协议版本一致，协议不匹配会导致技能触发指令被丢弃，需更新客户端或服务端至对应版本，确保协议同步。
4. 脚本执行延迟：资源占用与间隔设置
脚本执行延迟多为系统资源占用过高或间隔设置不合理导致，解决方法：
1. 优化系统资源：关闭服务端冗余进程，降低同时运行的脚本数量（如减少高频刷怪脚本的数量），避免资源占用过高导致脚本执行延迟。
2. 调整执行间隔：刷怪脚本、奖励发放脚本可适当延长执行间隔，避免间隔过短导致系统压力过大（如将刷怪间隔从10秒调整为30秒，降低执行频率）。
五、实用技巧（提升脚本运行稳定性）
1. 脚本编写时添加注释：用//标注脚本功能、条件说明，便于后续修改与排查，例如//攻击触发金币奖励脚本，每次攻击怪物奖励10金币，提升可读性。
2. 多条件判断拆分编写：将复杂多条件拆分为多个单条件判断，逐一检测，避免因单个条件错误导致整个分支失效，同时便于定位问题条件。
3. 定期备份脚本与配置文件：修改脚本前备份原始文件，若修改出错可快速恢复，避免影响游戏正常运行。
4. 启用脚本运行日志：开启服务端脚本日志功能，实时记录脚本执行情况，脚本异常时可通过日志快速定位错误行与原因。
5. 脚本测试分阶段进行：编写完成后先在测试服测试，验证执行顺序、条件触发、功能效果是否正常，无异常后再应用到正式服。
6. 适配引擎版本：编写脚本前确认引擎类型与版本，参考对应引擎的脚本语法手册，避免使用跨引擎不兼容的命令。
7. 简化脚本逻辑：避免冗余命令与复杂循环，简化脚本结构，降低解析难度，提升执行效率（如重复执行的命令可通过循环实现，减少代码量）。
