传奇登陆脚本加载错误排查与修复指南

传奇登陆脚本加载错误通常表现为服务端启动时提示“cannot load such file”、“error loading module”或M2Server控制台出现红字报错。这类问题主要由路径配置、文件编码、插件依赖以及引擎版本兼容性等因素引起。以下是具体的排查与修复方案：

一、路径配置与require机制排查
Lua脚本的加载高度依赖路径配置。当出现“cannot load such file”或“No such file or directory”时，需检查以下环节：
脚本存放位置：所有脚本必须严格放置在指定的Scripts子目录下。若模块放置在非预期目录，会导致加载中断。
require路径匹配：模块名需与实际文件层级对应。例如，执行require "battle.ai"时，系统会指向Scripts/battle/ai.lua。需确保代码中的拼写与物理文件完全一致。
引擎根路径设置：核对引擎配置文件中的脚本根路径，确保其指向正确的目录。

二、文件编码与隐藏字符处理
Windows环境下编辑的脚本文件常默认保存为ANSI或UTF-8 with BOM格式，而多数Lua虚拟机仅支持标准UTF-8。BOM头（EF BB BF）会导致首个字符解析异常，引发“unexpected symbol”报错。
统一编码格式：使用支持UTF-8无BOM的文本编辑器（如VS Code、Notepad++）打开脚本文件，将编码统一转换为UTF-8。
批量转换：若文件较多，可通过命令行工具批量转换编码，确保所有脚本文件均无隐藏字符干扰。

三、插件依赖与功能开关检测
现代传奇版本常依赖第三方插件来实现特定功能（如自动拾取、大背包等）。若插件未正确加载，调用相关功能的脚本便会报错。
检查PlugList.txt：在MirServerMir200目录下查找PlugList.txt文件，确认其中列出的插件DLL名称准确无误。
验证DLL文件：确保这些DLL文件真实存在于对应目录中，且与当前引擎版本（32位或64位）兼容。
观察启动日志：启动M2Server时，留意控制台是否输出“加载插件成功”的提示。若缺失，说明插件加载失败。
开启功能开关：在M2控制界面的“插件管理”或“功能设置”中，确保脚本所需的功能开关处于开启状态。

四、脚本语法与引擎版本兼容性
语法错误定位：当出现“syntax error during pre-compilation”时，需根据日志提示定位到具体的脚本文件和行号。常见错误包括#IF写成全角符号、GIVE拼写错误、参数格式缺失（如比较符号）等。
引擎版本匹配：不同版本的引擎对Lua语法的支持程度不同。若脚本使用了当前引擎不支持的新命令或API，会导致加载失败。此时需将引擎升级至支持该命令的版本，或修改脚本以适配当前引擎。

五、登录器配置与UI资源加载
登录器界面的错位、白屏或配置读取失败，多与资源路径和UI初始化有关。
配置文件路径：检查登录器的配置文件（如server.ini）是否使用了硬编码的绝对路径。若客户端部署路径变更，会导致文件找不到。建议改用相对路径或动态获取路径。
UI资源映射：白屏或界面空白通常源于UI版本不匹配或资源路径错误。需确保登录器目录下的UI文件（如login.xml、背景图等）路径正确，且UI版本与引擎匹配。
依赖文件完整性：若登录器启动时报错或界面缺失，需检查是否缺少必要的运行库文件（如vcruntime140.dll等），并确保Manifest文件中包含正确的DPI感知声明。