传奇服务端商业脚本运行位置及全流程运行指南

一、商业脚本核心运行目录（通用路径）

传奇服务端商业脚本需放置在指定目录，由引擎自动扫描加载，核心路径集中在MirServer文件夹内，不同功能脚本对应专属目录，无需额外配置加载路径，放置正确即可生效。

核心主目录为MirServer\Mir200\Scripts，绝大多数商业脚本均在此运行，包括装备合成、道具回收、活动触发、NPC交互等类型脚本。该目录为引擎默认脚本读取路径，仅支持.txt格式文件，建议按功能命名（如“商业合成脚本.txt”“全服活动脚本.txt”），便于后续查找维护。

辅助运行目录为MirServer\Mir200\Envir，下属子文件夹对应专项脚本：Market_Def文件夹存放商人NPC类商业脚本，与Merchant.txt文件联动控制NPC功能；MapQuest_def文件夹存放地图触发、定时任务类商业脚本，QManage.txt为核心触发文件，可关联各类脚本启动条件；QuestDiary文件夹存放被调用类商业脚本，供主脚本通过命令调用执行。

二、不同类型商业脚本的具体运行位置与逻辑

商业脚本按功能分类，运行位置及加载关联逻辑不同，需针对性放置，避免功能失效，具体如下。

1. 合成/回收类商业脚本：直接放入Scripts目录，常见文件名如ComboItem.txt、BusinessRecycle.txt。脚本内通过#IF、#ACT、#SAY等命令定义合成规则、回收比例，引擎启动时自动读取该目录下所有同类脚本，无需额外关联，仅需确保命令格式符合引擎规范。

2. NPC交互类商业脚本：分为主脚本与关联脚本。主脚本放置于Market_Def文件夹，文件名需与Merchant.txt中NPC配置对应，例如Merchant.txt中“传送员 3 330 330 盟重传送员 0 15 0 0 0”，对应Market_Def目录下“传送员-3.txt”脚本。关联脚本可放入QuestDiary文件夹，主脚本通过#Call命令调用，实现复杂交互逻辑。

3. 定时/活动类商业脚本：核心脚本放置于Scripts目录，触发逻辑需写入MapQuest_def\QManage.txt文件，通过添加定时命令、地图进入触发命令，控制脚本按设定条件运行。例如全服泡点活动脚本，需在QManage.txt中设置开启时间，关联Scripts目录下的泡点脚本及对应地图。

4. 任务类商业脚本：主线、支线任务商业脚本多放置于QuestDiary文件夹，按任务章节分类创建子目录存放，通过主脚本调用执行。部分简单任务脚本可直接写入Market_Def文件夹的NPC脚本中，玩家触发NPC对话时启动任务逻辑。

三、主流引擎商业脚本运行适配要点

不同引擎对商业脚本的运行目录、命令格式要求略有差异，需按引擎类型调整，确保脚本正常加载运行。

HERO引擎：核心商业脚本仍放置于Scripts目录，部分高级脚本需在Function.txt文件中开启调用权限。Market_Def文件夹下的NPC脚本修改后，需通过@reloadnpc all命令刷新加载，无需重启服务端；定时类脚本需严格遵循QManage.txt文件的时间格式，否则无法触发。

GOM引擎：新增MirServer\Mir200\GomConfig\Script专属目录，部分引擎自带商业脚本需放置于此，普通商业脚本仍可存于Scripts目录。支持脚本实时加载，简单脚本修改后刷新游戏即可生效，复杂脚本建议重启引擎。NPC脚本关联需同步核对GomConfig中的NPC配置参数，确保路径匹配。

BLUE引擎：商业脚本分散存放，基础脚本放Scripts目录，管理类NPC脚本放Npc_Def文件夹（与Npc.txt对应）。该引擎对脚本命令格式要求严格，需确保#、@等标识正确，且文件夹路径无层级错误，否则脚本无法运行且无报错提示，需逐行核对命令。

四、商业脚本运行的基础条件与操作步骤

商业脚本需满足格式、路径、权限等基础条件，按规范操作即可正常运行，核心步骤如下。

第一步确认脚本格式：商业脚本需保存为UTF-8或ANSI编码的.txt文件，避免编码错误导致引擎无法读取。脚本内命令需符合对应引擎规范，条件判断用#IF，对话显示用#SAY，执行操作用#ACT，语句结尾无需额外符号，格式错误会导致脚本部分功能失效。

第二步放置脚本文件：根据脚本功能放入对应目录，确保文件名无特殊字符（空格、符号），建议使用中文简体或英文命名。若为关联脚本，需在主脚本中正确填写调用路径，例如#Call (//QuestDiary/活动脚本/泡点.txt) @启动泡点，确保路径与实际存放位置一致。

第三步配置关联文件：NPC类脚本需在Merchant.txt中添加对应配置，填写脚本文件名、地图编号、坐标、NPC名称等参数，确保NPC在游戏中正常显示且关联目标脚本。定时类脚本需在QManage.txt中添加触发条件，明确启动时间、适用地图及关联脚本。

第四步加载测试：放置及配置完成后，启动服务端，通过引擎日志查看脚本加载状态，显示“脚本加载成功”则说明正常。进入游戏后，通过对应触发方式（NPC对话、地图进入、时间触发）测试功能，检查逻辑执行、奖励发放是否准确，异常则修改脚本后重启引擎重新测试。

五、常见运行故障排查

1. 脚本无法加载：排查脚本是否放对目录、编码格式是否正确，文件名是否含特殊字符；HERO引擎需检查Function.txt是否开启调用权限，GOM引擎核对GomConfig中脚本路径配置。

2. NPC无法触发脚本：Merchant.txt中NPC配置参数错误，或脚本文件名与配置不匹配，需逐一核对文件名、地图编号、坐标，确保与脚本文件对应，同时检查脚本内是否有(@main)起始标识。

3. 定时脚本不触发：QManage.txt中时间格式错误，或未关联对应脚本路径；部分引擎需设置时区参数，避免时间偏差，可先将触发时间设为当前时间附近，快速验证脚本是否有效。

4. 脚本执行异常：命令格式错误或参数缺失，检查#IF、#ACT等命令是否遗漏，数值参数、地图名称是否正确；同时排查是否与其他脚本冲突，可暂时移除其他脚本，单独测试目标商业脚本。

六、通用注意事项

运行商业脚本前，需备份对应目录下的原有脚本及关联配置文件，避免新脚本覆盖或冲突导致原有功能异常。单次仅添加或修改一个商业脚本，测试正常后再添加其他脚本，便于定位故障根源。

商业脚本需与服务端引擎版本适配，不同版本引擎支持的命令不同，适配异常会导致脚本无法运行。可通过服务端自带说明文档，或正规技术社区获取对应引擎的脚本命令手册，确保命令格式正确。

运行过程中定期查看引擎日志，及时发现脚本运行异常，避免因脚本错误导致服务端卡顿。涉及全服数据交互的脚本（如全服活动），建议在非高峰时段测试，确保运行稳定。