传奇服务端脚本修改后游戏内无变化全流程排查指南

脚本改了但游戏里没反应，九成以上的原因集中在四个地方：引擎没有重载、文件编码不对、改错了文件、语法静默报错。按下面的顺序逐一排查，基本能定位到问题。

最容易被忽略也最常见的一步是引擎重载。传奇服务端的脚本文件在启动时会被加载到内存中运行，你用编辑器修改了硬盘上的txt文件，但内存里跑的仍然是旧代码，保存文件本身不会触发任何变化。修改NPC脚本后必须在M2控制台点击控制菜单下的重新加载，选择对应的脚本类型，NPC对话脚本选Market，功能脚本选QFunction，改完后角色小退重新登录测试。部分引擎支持在游戏内用管理员账号输入命令重载，@ReloadNpc重载NPC脚本，@ReloadQuest重载所有脚本文件，@ReloadManage重载登录脚本。如果修改的是QManage.txt里的登录脚本或核心触发段，单纯重载NPC可能无效，需要完全关闭M2Server再重启。重启顺序是关M2Server、关DBServer、关LoginSrv，然后按DBServer、M2Server的顺序重新启动。

第二步检查文件编码。Windows记事本默认保存为UTF-8格式，而大多数传奇引擎基于ANSI编码开发。脚本存成UTF-8后，服务端读取时会出现乱码或无法识别指令头，脚本加载失败但M2控制台不一定报错，表现出来就是改了跟没改一样。用Notepad++或UltraEdit打开脚本文件，在编码菜单里把文件转为ANSI格式再保存。同时确认文件扩展名没有被系统隐藏后缀搞成.txt.txt，这会导致引擎根本找不到文件。

第三步确认改对了文件。传奇脚本存在大量包含调用，主脚本通过#INCLUDE指令引入子脚本。如果你改了被包含的子文件，但主脚本没有重新加载，变更不会生效。NPC脚本必须放在Mir200\Envir\Market_Def目录下，文件名要与Merchant.txt里的配置对应；功能脚本放在Mir200\Envir\MapQuest_def目录下。改之前先在Merchant.txt里搜一下目标NPC实际引用的脚本文件名，确认你打开的就是正在被调用的那个。另外检查脚本文件属性有没有勾选只读，只读状态下编辑器的保存操作可能被静默拦截。

第四步排查语法静默错误。脚本里一个全角标点或漏掉的闭合符号就可能导致整段代码被引擎跳过执行，而且M2控制台不一定弹出红色报错。重点检查#IF和#ACT必须顶格写且中间不能有空格，标点符号必须是英文半角，中文输入法下打出的逗号、括号、引号服务端无法识别。变量名的大小写要保持一致，部分引擎对变量名大小写敏感。检查#IF后面的条件是否过于苛刻，比如检测一个当前角色根本不可能达到的等级或持有物品，条件永远不满足，脚本逻辑再对也不会触发。改完保存后看M2控制台的输出窗口，有红色日志就按提示的行号去修。

第五步处理客户端缓存。如果脚本涉及物品属性修改，服务端改了之后还需要在M2控制台执行@ReloadItem重载物品数据，同时玩家必须小退重新登录才能刷新客户端的物品缓存。改地图配置如MapInfo.txt通常需要重启M2Server，因为地图数据在引擎初始化时加载，运行时很难动态刷新。任务脚本改完后，客户端可能缓存任务进度，用GM命令清除任务缓存或删除客户端Cache文件夹再测试。

如果上面五步都走了还是没变化，回到最基础的检查：脚本文件到底保存了没有。用记事本或Notepad++打开脚本后按Ctrl+S保存，再关闭编辑器，重新打开确认修改内容确实写入了文件。有时候编辑器的保存操作因为权限问题被系统拦截，文件时间戳变了但内容没变。用文件管理器的详细信息视图看一下脚本文件的修改时间，确认最后一次修改就是你刚才操作的时间。

还有一个容易忽略的点是脚本触发段的标识。物品类脚本的触发段[@StdModeFuncX]中的X必须与物品数据库里该物品的AniCount字段严格对应，写错了段号脚本永远不会被触发。NPC脚本的[@Main]段是主入口，如果脚本里没有[@Main]或者拼写错误，玩家点击NPC不会有任何反应。

按顺序走一遍：确认文件保存且编码为ANSI，确认改的是Merchant.txt里实际引用的文件名，确认脚本放在正确的目录且没有只读属性，在M2控制台执行对应类型的重载，检查控制台有无红色报错，修改物品或地图后补做客户端缓存刷新。这六个环节全部过一遍，脚本必然生效。