Hero传奇引擎迁移LEGEND引擎完整替换步骤 数据库脚本配置文件转换注意事项

Hero引擎更换为LEGEND引擎，不是简单替换主程序文件，需要依次处理数据库、脚本、NPC、地图、登录器配置等多类资源，两类引擎语法存在不少差异，直接替换M2会直接引发报错、NPC失效、指令无法执行，按照顺序迁移可以减少大量调试工作量。

迁移前先做好完整备份，将整个Mir200文件夹、客户端补丁、DB数据库全部复制留存，一旦转换出现异常，可以直接恢复原始文件。优先准备好LEGEND引擎全套文件，包含M2、网关、DBServer、LogServer等配套程序，版本号尽量选用稳定发行版本，测试机先行部署，确认基础功能正常之后再转移到正式环境。

数据库部分是首要转换环节。Hero使用DB2000数据库，LEGEND引擎同样支持DB数据库，但是字段定义存在细微差别。使用配套数据库转换工具打开人物DB、怪物DB、物品DB，读取Hero库数据，导出适配LEGEND引擎的数据库文件。转换完成之后，打开数据库核对字段，物品的特殊属性、怪物AI参数、人物基础属性，部分Hero专属字段在LEGEND引擎无法识别，这类多余字段需要删除，否则DBServer启动时报错。怪物DB里面的Hero专属攻击模式、召唤参数，导入后会失效，需要对照LEGEND引擎说明重新填写。转换完毕启动DBServer，查看日志，确认没有数据库加载错误，再继续下一步操作。

接下来处理Mir200内基础配置文件。替换M2之前，复制原Hero版本的MapInfo.txt、MapQuestDef.txt、MerChant.txt、UnbindList.txt等基础文本，逐一对照LEGEND引擎格式修改。MapInfo地图文件大部分内容可以直接沿用，但部分Hero独有的地图标记参数需要删除，保留地图编号、路径、地图名称、安全区标记即可。MerChant NPC配置文件，NPC坐标、地图编号、名称大多可以保留，但是NPC触发标记、访问参数有区别，部分Hero的NPC标识LEGEND无法识别，会出现NPC不刷新或者点击无反应。批量打开MerChant，清理掉引擎专属标记，只保留基础调用参数，保存后再加载。

脚本转换是工作量最大的环节，Hero和LEGEND的内置命令、条件判断语法不完全通用。Hero部分脚本指令在LEGEND引擎中不存在，执行时直接提示未知命令。常见差异集中在人物变量、拾取触发、击杀触发、检测物品、传送跳转、对话框弹窗。例如部分人物状态检测、定时任务、人物标记指令，写法需要改写。批量检索脚本文件，查找Hero专属指令，替换为LEGEND对应的等效命令。涉及到NPC对话脚本，@命令跳转、判断语句括号格式，都要调整。不要一次性全部替换，优先处理主城NPC、传送NPC、商店NPC，逐个加载测试，确认交互正常，再处理任务脚本、活动脚本。

触发器与QFunction脚本需要单独检查。QFunction-0.txt是全局触发脚本，Hero的登录触发、小退触发、拾取触发、死亡触发，部分事件标识在LEGEND引擎里名称不同，事件不会触发。打开文件逐条核对事件标签，修改事件标识，删除不支持的函数。部分Hero的全局变量、全局计时器，LEGEND引擎不支持，这类逻辑需要重写实现方式，或者直接移除相关功能。测试登录、小退、死亡、捡物动作，观察M2日志是否输出脚本报错。

地图资源不用改动，map地图文件格式两者通用，直接沿用原有地图文件即可。但是地图内的动态对象，比如动态刷怪、地图事件脚本，绑定的Hero指令需要修改。刷怪文件MonGen.txt基础格式基本兼容，怪物编号、坐标、数量可以直接读取，Hero独有的延时刷怪、条件刷怪参数，LEGEND无法识别，需要删除或者改用引擎自带刷怪方式实现。

登录器与网关配置需要同步更换。LEGEND引擎配套网关和Hero网关不能混用，替换全部网关程序，修改网关配置文件内的端口、连接密码，和M2保持一致。登录器列表文件，更新网关地址与端口，使用LEGEND配套登录器生成工具制作登录器，旧Hero登录器无法连接LEGEND引擎网关。客户端补丁、pak资源一般可以继续使用，不需要重新制作，仅核对登录器pak配置，保证资源可以正常加载。

M2选项参数重新配置，不能直接导入Hero的M2配置。打开LEGEND M2，手动重新设置游戏参数，包括爆率、经验倍数、死亡掉落、交易限制、安全区规则、技能权限等。两类引擎参数面板项目不一样，直接导入旧配置会造成大量参数丢失或者错乱。技能配置文件Skill.txt，基础技能信息可以沿用，Hero专属技能特效、被动触发参数，LEGEND不识别，需要重新调整技能触发条件。

分阶段测试，全部文件替换完成之后，先启动DBServer、LogServer，再启动M2，查看M2启动日志，将日志内的报错逐条修复。先创建账号进入游戏，测试基础移动、聊天、商店买卖、传送功能。基础功能正常后，测试打怪、爆物、技能释放、NPC对话。最后测试任务、活动、拾取触发、死亡触发这类脚本功能。遇到NPC不显示，优先检查MerChant格式；点击NPC无反应，多为脚本命令不兼容；怪物不刷，检查MonGen与怪物DB。

常见问题处理，转换完成后人物存档读取异常，多是数据库多余字段没有清理，重新打开DB删除无效字段。技能释放没有效果，查看Skill.txt里Hero专属触发参数，移除不兼容标记。部分脚本执行无反馈，打开M2日志定位报错行，修改对应指令。转换后刷怪异常，检查MonGen里面附加条件参数，只保留基础刷怪信息。

转换过程中尽量分步操作，不要一次性替换全部文件。可以先迁移数据库和基础配置，启动确认数据库正常，再导入NPC文件，调试NPC，最后处理各类脚本。每完成一类文件修改，就启动服务端做一次验证，避免一次性堆积大量问题，难以定位故障点。正式切换前，在本地测试环境完整跑一遍全部核心玩法，确认没有重大功能缺失，再进行正式环境的引擎替换。