传奇单机搭建游戏各类常见bug分类梳理与对应修复处理完整教程

架设传奇过程中会遇到大量游戏内功能异常问题，各类bug大多来自数据库字段错误、脚本编写疏漏、素材不匹配、引擎校验规则差异、刷怪配置出错，按照物品、技能、怪物地图、角色交易、客户端显示、服务端逻辑几个大类整理故障现象和修复办法，方便逐一排查。

物品相关bug是出现频率最高的一类。常见现象包括拾取物品提示无法捡起、装备穿戴属性不生效、物品名称乱码、物品图标方框空白、双击道具无反应、新增物品加载报错。多数情况是物品数据库字段填写异常，重量、持久、外观代码、物品类型参数填写越界。物品名称和脚本内调用名称字符不一致，也会造成双击功能失效。修复方式，打开物品数据库核对对应条目，清除字段内隐藏空格与中文标点，外观代码和客户端素材编号一一对应。如果是道具双击执行脚本，检查QFunction脚本内物品触发段，确认物品名称完全匹配，脚本保存编码选择ANSI，修改脚本前关闭主服务程序。部分版本存在物品叠加异常，可堆叠物品数量设置错误，需要在数据库调整堆叠上限数值。还有一类比较隐蔽的问题，装备属性重复叠加，多次穿戴取下不断累加属性，根源是脚本没有做属性重置，需要在穿戴、脱卸脚本中增加属性清除逻辑。

技能相关bug，包含等级达标无法学习技能书、技能释放没有伤害、技能动画不显示、技能持续效果无法清除、群体技能只对单个目标生效、召唤物消失或者无限召唤。技能数据库内技能编号、职业、学习等级填写错误，技能书物品名称和技能脚本名称不匹配，就会出现无法学习。技能动画缺失属于客户端素材问题，需要检查客户端技能补丁是否完整解压。技能伤害异常，核对M2内技能基础参数，攻击系数、范围、冷却时间设置。召唤类技能出现无限召唤，是脚本没有判断召唤生物数量上限，每次释放没有清理旧召唤单位，增加数量判断条件即可修复。

怪物与地图bug，主要表现为地图不刷怪、怪物刷新之后原地不动、怪物不会主动攻击玩家、怪物击杀后反复刷新重复爆物品、怪物卡地形无法移动，部分地图门点点击无反应无法跳转。刷怪配置文件Mongen.txt存放于mir200/envir目录，检查地图编号、坐标、刷新数量、刷新间隔参数，地图编号写错会完全不刷怪。怪物AI失效，查看怪物数据库，确认怪物攻击模式、移动速度参数，部分怪物设置为被动模式就不会主动追击。怪物死后重复刷新掉落，是脚本内死亡触发逻辑没有标记怪物死亡状态，每次击杀都会执行一次爆率脚本，增加死亡判定标记。地图门点失效，检查MapInfo地图配置文件，门点坐标、目标地图编号填写是否准确，地图文件缺失会造成进入地图黑屏或者直接闪退。地图内玩家卡坐标，可在M2地图参数中开启坐标校验，或者修改地图障碍物素材。

角色与交易类bug，常见新建角色失败、角色数据保存异常、背包物品丢失、交易时金币数量异常、人物属性下线重置。角色数据相关故障，优先查看DBServer人物数据库目录，检查人物存档文件是否损坏，文件夹取消只读属性。交易异常大多是脚本没有做金币数量边界校验，填写金额超过背包携带上限时触发逻辑错误，修改交易脚本，增加金币上限判断，禁止超出携带额度的输入。角色属性下线重置，是属性修改脚本没有永久写入人物数据，每次上线重新临时赋予属性，调整脚本存储方式，将属性持久写入人物数据库。

客户端显示bug，进入游戏黑屏、装备或者怪物不显示、文字乱码、窗口错位。黑屏问题优先核对客户端补丁路径，补丁文件夹层级错误、素材文件缺失，都会导致资源加载失败。文字乱码一般是脚本文件编码不对，脚本另存为ANSI编码。装备图标空白，物品数据库外观代码没有对应客户端素材，重新核对素材编号，打包补丁放到客户端目录。部分高分辨率系统会出现游戏窗口拉伸错位，在登录器或者程序兼容性设置里开启替代高DPI缩放。

服务端逻辑类bug，包括泡点经验无限增加、NPC重复领取奖励、NPC对话点击无响应、重复领取礼包。这类全部属于NPC任务脚本缺少领取标记，玩家领取奖励之后没有在人物变量里做领取标记，再次对话会重复发放。修复时在奖励发放脚本后增加变量赋值，判断变量标记，已经领取的账号不再执行奖励代码。机器人脚本定时任务频繁执行，会造成服务器卡顿，检查机器人脚本执行周期，避免短间隔循环执行大量逻辑。

排查bug通用操作顺序，每次修改数据库或者脚本，必须完全关闭M2主程序，修改保存之后再启动。修改前备份服务端目录，防止改动造成数据损坏。优先查看M2启动日志，日志会标注出错脚本文件、行数，定位问题源头。区分是服务端逻辑故障还是客户端素材故障，服务端日志报错属于服务端问题，单纯画面图标异常属于客户端素材问题。修改完成之后新建账号进入游戏测试，不要使用旧角色直接验证，旧角色身上可能残留缓存变量，干扰测试结果。

引擎版本差异会带来很多隐性bug，同一份脚本和数据库，更换引擎之后校验规则改变，原本正常的功能会出现异常。跨引擎迁移资源，不能直接沿用旧数据库和全套脚本，需要使用引擎自带工具转换数据表和脚本语法，再逐项测试各项功能。遇到复杂逻辑bug，分步注释脚本代码，定位触发异常的指令段，不要一次性大面积修改脚本，缩小故障范围，降低修复难度。