一、商业脚本核心运行目录(通用路径)
传奇服务端商业脚本需放置在指定目录下,由引擎自动加载运行,核心路径集中在服务端MirServer文件夹内,不同功能脚本对应目录不同,无需额外设置加载路径,放置正确即可生效。
核心通用目录为MirServer\Mir200\Scripts,绝大多数商业脚本(含合成、任务、活动、NPC交互脚本)均放置于此。该目录为引擎默认脚本读取目录,支持.txt格式脚本文件,命名无强制要求,建议按功能标注(如“商业合成脚本.txt”“活动任务脚本.txt”),便于后续维护。
辅助运行目录为MirServer\Mir200\Envir,下属子文件夹对应专项脚本:MapQuest_def文件夹存放地图任务、定时触发类商业脚本(如泡点、攻城前置任务脚本),其中QManage.txt为核心触发脚本,可关联各类商业脚本的启动条件;Market_Def文件夹存放商铺、交易类商业脚本,控制道具售卖、回收等商业逻辑。
二、不同类型商业脚本的具体运行位置
商业脚本按功能分类,运行位置及加载逻辑略有差异,需针对性放置,避免功能失效。
1.合成/锻造类商业脚本:直接放入MirServer\Mir200\Scripts目录,常见文件名如ComboItem.txt、BusinessCombo.txt,脚本内通过“#ACT”“@合成”等命令定义商业合成规则,引擎启动时自动读取该目录下所有同类脚本,无需额外关联配置。
2.NPC交互类商业脚本:分为独立脚本与关联脚本。独立脚本放置于Scripts目录,通过脚本内定义NPC名称及对话逻辑,实现交易、任务接取等功能;关联脚本需在Envir\Market_Def文件夹内的NPC脚本中添加调用命令,指向Scripts目录下的目标商业脚本,实现NPC触发脚本运行。
3.活动/定时类商业脚本:核心脚本放置于Scripts目录,触发逻辑需写入Envir\MapQuest_def\QManage.txt脚本,通过添加定时器命令(如定时启动活动、刷新奖励),控制商业脚本按设定时间运行,部分脚本需标注对应地图编号,限定活动运行范围。
4.回收/兑换类商业脚本:放置于Scripts目录,同时在Envir\Market_Def文件夹内配置对应回收NPC脚本,通过NPC对话选项关联回收脚本,玩家触发NPC功能时,引擎调用对应商业脚本执行回收兑换逻辑。
三、主流引擎商业脚本运行适配要点
不同引擎对商业脚本的运行目录、加载规则有细微差异,需按引擎类型调整,确保脚本正常运行。
HERO引擎:核心商业脚本仍放置于Scripts目录,部分高级商业脚本需额外配置MirServer\Mir200\Envir\Function.txt文件,添加脚本调用权限。定时类商业脚本需在QManage.txt中明确标注触发时间格式,否则无法正常启动,修改脚本后需重启引擎主程序生效。
GOM引擎:商业脚本目录新增MirServer\Mir200\GomConfig\Script文件夹,部分专属商业脚本(如引擎自带活动脚本)需放置于此,普通商业脚本仍可放在Scripts目录。GOM引擎支持脚本实时加载,部分简单脚本修改后无需重启服务端,刷新游戏即可生效,但复杂商业脚本建议重启引擎确保稳定性。
BLUE引擎:商业脚本分散存放,基础脚本放Scripts目录,高级商业脚本需按功能放入Envir下属对应子文件夹,同时需在引擎控制台中勾选“脚本自动加载”选项。BLUE引擎对脚本命令格式要求严格,需确保脚本内“#”“@”等命令标识正确,否则脚本无法运行且无报错提示。
四、商业脚本运行的基础条件与操作步骤
商业脚本需满足加载条件并按规范操作,才能正常运行,核心步骤如下。
第一步确认脚本格式:商业脚本需保存为UTF-8或ANSI编码的.txt文件,避免因编码错误导致引擎无法读取。脚本内命令需符合对应引擎规范,语句命令以“#”开头,交互命令以“@”开头,格式错误会导致脚本部分功能失效或完全无法运行。
第二步放置脚本文件:根据脚本功能,将其放入对应运行目录,确保文件名无特殊字符(如空格、符号),建议使用英文或中文简体命名,避免引擎识别异常。若脚本需关联NPC或地图,需同步修改对应配置文件,添加调用路径。
第三步启动服务端加载脚本:放置完成后,启动传奇服务端,引擎会自动扫描对应目录下的商业脚本并加载。启动过程中可查看引擎日志,若日志显示“脚本加载成功”则说明正常;若提示“脚本不存在”或“命令错误”,需排查文件路径及脚本格式。
第四步测试脚本运行:进入游戏后,通过对应触发方式(如NPC对话、定时触发、地图进入)测试脚本功能,检查商业逻辑是否正常执行,奖励发放、规则判定是否准确,若存在异常需修改脚本后重启引擎,再次测试直至功能正常。
五、常见运行故障排查
1.脚本无法加载:排查脚本文件是否放置在对应目录,编码格式是否正确,文件名是否含特殊字符;部分引擎需开启脚本加载权限,可在引擎配置文件中确认权限设置。
2.脚本功能异常:多为命令格式错误或参数缺失,检查脚本内命令标识、数值参数是否正确,关联的NPC、地图编号是否匹配;同时排查是否与其他脚本冲突,可暂时移除其他脚本,单独测试目标商业脚本。
3.定时脚本不触发:核对QManage.txt中触发时间格式是否符合引擎要求,确认脚本已正确关联定时命令;部分引擎需在配置文件中设置时区,避免时间偏差导致脚本不触发。
4.重启服务端后脚本失效:多为脚本放置路径错误,或引擎缓存未清除,可删除MirServer\Mir200\Envir\Cache文件夹,重启服务端重新加载脚本;同时确认脚本文件未被误删或移动。
六、商业脚本运行的通用注意事项
运行商业脚本前,需备份对应目录下的原有脚本及配置文件,避免新脚本覆盖或冲突导致原有功能异常。建议单次仅添加或修改一个商业脚本,测试正常后再添加其他脚本,便于定位故障根源。
商业脚本需与服务端引擎版本适配,不同版本引擎支持的脚本命令不同,适配异常会导致脚本无法运行。若找不到对应引擎的脚本运行路径,可查看服务端自带的说明文档,或通过正规技术社区获仍应版本的脚本配置模板。
运行过程中定期查看引擎日志,及时发现脚本运行异常,避免因脚本错误导致服务端卡顿或崩溃。若脚本涉及大量数据交互(如全服活动脚本),建议在非高峰时段测试运行,确保服务端稳定性。
传奇服务端商业脚本需放置在指定目录下,由引擎自动加载运行,核心路径集中在服务端MirServer文件夹内,不同功能脚本对应目录不同,无需额外设置加载路径,放置正确即可生效。
核心通用目录为MirServer\Mir200\Scripts,绝大多数商业脚本(含合成、任务、活动、NPC交互脚本)均放置于此。该目录为引擎默认脚本读取目录,支持.txt格式脚本文件,命名无强制要求,建议按功能标注(如“商业合成脚本.txt”“活动任务脚本.txt”),便于后续维护。
辅助运行目录为MirServer\Mir200\Envir,下属子文件夹对应专项脚本:MapQuest_def文件夹存放地图任务、定时触发类商业脚本(如泡点、攻城前置任务脚本),其中QManage.txt为核心触发脚本,可关联各类商业脚本的启动条件;Market_Def文件夹存放商铺、交易类商业脚本,控制道具售卖、回收等商业逻辑。
二、不同类型商业脚本的具体运行位置
商业脚本按功能分类,运行位置及加载逻辑略有差异,需针对性放置,避免功能失效。
1.合成/锻造类商业脚本:直接放入MirServer\Mir200\Scripts目录,常见文件名如ComboItem.txt、BusinessCombo.txt,脚本内通过“#ACT”“@合成”等命令定义商业合成规则,引擎启动时自动读取该目录下所有同类脚本,无需额外关联配置。
2.NPC交互类商业脚本:分为独立脚本与关联脚本。独立脚本放置于Scripts目录,通过脚本内定义NPC名称及对话逻辑,实现交易、任务接取等功能;关联脚本需在Envir\Market_Def文件夹内的NPC脚本中添加调用命令,指向Scripts目录下的目标商业脚本,实现NPC触发脚本运行。
3.活动/定时类商业脚本:核心脚本放置于Scripts目录,触发逻辑需写入Envir\MapQuest_def\QManage.txt脚本,通过添加定时器命令(如定时启动活动、刷新奖励),控制商业脚本按设定时间运行,部分脚本需标注对应地图编号,限定活动运行范围。
4.回收/兑换类商业脚本:放置于Scripts目录,同时在Envir\Market_Def文件夹内配置对应回收NPC脚本,通过NPC对话选项关联回收脚本,玩家触发NPC功能时,引擎调用对应商业脚本执行回收兑换逻辑。
三、主流引擎商业脚本运行适配要点
不同引擎对商业脚本的运行目录、加载规则有细微差异,需按引擎类型调整,确保脚本正常运行。
HERO引擎:核心商业脚本仍放置于Scripts目录,部分高级商业脚本需额外配置MirServer\Mir200\Envir\Function.txt文件,添加脚本调用权限。定时类商业脚本需在QManage.txt中明确标注触发时间格式,否则无法正常启动,修改脚本后需重启引擎主程序生效。
GOM引擎:商业脚本目录新增MirServer\Mir200\GomConfig\Script文件夹,部分专属商业脚本(如引擎自带活动脚本)需放置于此,普通商业脚本仍可放在Scripts目录。GOM引擎支持脚本实时加载,部分简单脚本修改后无需重启服务端,刷新游戏即可生效,但复杂商业脚本建议重启引擎确保稳定性。
BLUE引擎:商业脚本分散存放,基础脚本放Scripts目录,高级商业脚本需按功能放入Envir下属对应子文件夹,同时需在引擎控制台中勾选“脚本自动加载”选项。BLUE引擎对脚本命令格式要求严格,需确保脚本内“#”“@”等命令标识正确,否则脚本无法运行且无报错提示。
四、商业脚本运行的基础条件与操作步骤
商业脚本需满足加载条件并按规范操作,才能正常运行,核心步骤如下。
第一步确认脚本格式:商业脚本需保存为UTF-8或ANSI编码的.txt文件,避免因编码错误导致引擎无法读取。脚本内命令需符合对应引擎规范,语句命令以“#”开头,交互命令以“@”开头,格式错误会导致脚本部分功能失效或完全无法运行。
第二步放置脚本文件:根据脚本功能,将其放入对应运行目录,确保文件名无特殊字符(如空格、符号),建议使用英文或中文简体命名,避免引擎识别异常。若脚本需关联NPC或地图,需同步修改对应配置文件,添加调用路径。
第三步启动服务端加载脚本:放置完成后,启动传奇服务端,引擎会自动扫描对应目录下的商业脚本并加载。启动过程中可查看引擎日志,若日志显示“脚本加载成功”则说明正常;若提示“脚本不存在”或“命令错误”,需排查文件路径及脚本格式。
第四步测试脚本运行:进入游戏后,通过对应触发方式(如NPC对话、定时触发、地图进入)测试脚本功能,检查商业逻辑是否正常执行,奖励发放、规则判定是否准确,若存在异常需修改脚本后重启引擎,再次测试直至功能正常。
五、常见运行故障排查
1.脚本无法加载:排查脚本文件是否放置在对应目录,编码格式是否正确,文件名是否含特殊字符;部分引擎需开启脚本加载权限,可在引擎配置文件中确认权限设置。
2.脚本功能异常:多为命令格式错误或参数缺失,检查脚本内命令标识、数值参数是否正确,关联的NPC、地图编号是否匹配;同时排查是否与其他脚本冲突,可暂时移除其他脚本,单独测试目标商业脚本。
3.定时脚本不触发:核对QManage.txt中触发时间格式是否符合引擎要求,确认脚本已正确关联定时命令;部分引擎需在配置文件中设置时区,避免时间偏差导致脚本不触发。
4.重启服务端后脚本失效:多为脚本放置路径错误,或引擎缓存未清除,可删除MirServer\Mir200\Envir\Cache文件夹,重启服务端重新加载脚本;同时确认脚本文件未被误删或移动。
六、商业脚本运行的通用注意事项
运行商业脚本前,需备份对应目录下的原有脚本及配置文件,避免新脚本覆盖或冲突导致原有功能异常。建议单次仅添加或修改一个商业脚本,测试正常后再添加其他脚本,便于定位故障根源。
商业脚本需与服务端引擎版本适配,不同版本引擎支持的脚本命令不同,适配异常会导致脚本无法运行。若找不到对应引擎的脚本运行路径,可查看服务端自带的说明文档,或通过正规技术社区获仍应版本的脚本配置模板。
运行过程中定期查看引擎日志,及时发现脚本运行异常,避免因脚本错误导致服务端卡顿或崩溃。若脚本涉及大量数据交互(如全服活动脚本),建议在非高峰时段测试运行,确保服务端稳定性。

