一、前期准备（必做，避免安装失败）

1.1 必备工具与文件

• 核心文件：传奇地图包（后缀通常为 .zip/.rar，包含 .map 地形文件、Objects/SmTiles/Tiles 资源文件，建议从正规素材站下载，避免文件损坏或加密不兼容）；
• 解压工具：WinRAR 或 7-Zip（用于解压地图包，确保能正常提取所有文件，避免解压不完整）；
• 辅助工具：地图编辑器（可选，推荐能兼容多格式的地图编辑工具，用于查看地图完整性、修改地图参数，排查黑屏/花屏问题）；
• 基础准备：找到传奇服务端（服务器端，用于配置地图参数）和客户端（玩家本地游戏文件夹，用于安装地图补丁）的安装路径，记好路径避免后续操作出错。

1.2 前期检查（关键步骤）

1. 确认地图包与游戏版本兼容：传奇地图分为12字节、14字节、36字节等格式，不同引擎（GOM/GEE/HERO/996纯PC）支持的地图格式不同，本站素材包含通用WIL/PAK/996专用类型格式；
2. 关闭杀毒软件与防火墙：部分杀毒软件会误判地图文件为恶意程序，导致文件被拦截、删除，安装全程关闭杀毒软件，安装完成后再重新开启；
3. 备份原文件：复制传奇服务端的 Envir 文件夹、客户端的 Map 和 Data 文件夹，保存到其他路径，若安装失败可随时恢复，避免丢失原有地图数据。

二、核心安装步骤（分2步：服务端配置+客户端安装）

第一步：服务端配置（地图能被服务器识别的关键）

1. 解压地图包

• .map 文件：地图核心地形文件，存放地图尺寸、坐标、封边、光线等所有基础信息，命名通常为 MapXXX.map（XXX为地图编号）；
• Objects/SmTiles/Tiles 文件：地图资源文件，分别对应表层建筑/索引、小地砖、大地砖图片，引擎会通过这些文件渲染地图画面；
• 配置文件（可选）：部分地图包会附带 maps.txt、mapinfo.txt 配置模板，可直接复制使用，减少手动配置错误。一般出现在包含沙城的门洞配置。其他地图一般不包含
• 地图素材包/
• ├── Objects/      # 地砖文件
• ├── Tiles/        # 地表文件
• ├── SmTiles/      # 物体文件
• ├── Map/          # 地图文件(.map)
• └── MiniMap/      # 小地图文件

2. 复制地图文件到服务端对应目录

1. 将解压后的所有 .map 文件，复制到D:\MirServer\Mir200\MAP文件夹中，（补丁内同样需要放置）确保文件名无中文乱码、无重复（若有重复，可修改地图编号，避免冲突）；
2. 若地图包包含 Objects、SmTiles、Tiles 资源文件，将其复制到服务端的 Data 文件夹中，覆盖原有文件 或（独立补丁简称[Resources]）（覆盖前确认已备份，避免影响原有地图）。

3. 配置地图参数（关键，避免地图无法进入）

（1）配置 maps.txt 文件

1. 在服务端文件夹中，找到 maps.txt 文件（通常在服务端根目录或 Envir 文件夹内），右键选择“打开方式”→“记事本”；
2. 在文件末尾添加新地图条目，格式为：地图编号,地图名称（例如：1001,新沙漠城），注意逗号为英文逗号，无多余空格；
3. 添加完成后，保存文件并关闭，确保无中文乱码（若有乱码，将文件编码改为 ANSI 格式）。

（2）配置 mapinfo.txt 文件

1. 找到服务端 Envir 文件夹内的 mapinfo.txt 文件，用记事本打开，此文件用于设置地图坐标、宽高、传送点等关键参数；
2. 在文件末尾添加新地图配置，格式为：地图编号,起始X坐标,起始Y坐标,地图宽度,地图高度,地图类型,其他参数（例如：1001,0,0,200,300,0,0）；
   1. 注意：宽高参数不可写反，否则会出现地图显示异常，需按 .map 文件实际尺寸填写，可通过地图编辑器查看尺寸；
   2. 地图类型通常填 0（普通地图），其他参数默认填 0 即可，无需额外修改。
3. 保存文件并关闭，若地图包有现成的 mapinfo 配置模板，可直接复制粘贴，替换对应参数即可。

4. 重启服务端（生效关键）

第二步：客户端安装（玩家能看到地图的关键）

1. 找到客户端安装路径

1. 打开传奇客户端（游戏补丁所在文件夹），确认文件夹内有 Map、Data 两个核心文件夹（Map 存放地图地形文件，Data 存放地图资源文件）；
2. 若找不到路径，可右键点击传奇登录器，选择“属性”→“打开文件所在位置”，即可快速定位客户端根目录。

2. 复制地图补丁到客户端对应目录

1. 将解压后的 .map 文件，复制到客户端的 Map 文件夹中，覆盖原有文件（若提示“是否替换”，点击“全部替换”即可，确保地图文件同步）；
2. 将解压后的 Objects、SmTiles、Tiles 资源文件，复制到客户端的 Data 文件夹中，覆盖原有文件；
3. 若地图包包含小地图文件（minimap 相关文件），将其复制到客户端的 Minimap 文件夹中，确保游戏内小地图能正常显示。

3. 配置客户端登录器（可选，针对部分引擎）

• 打开客户端登录器生成工具，设置“地图读取路径”为客户端 Map 文件夹路径，“补丁读取路径”为 Data 文件夹路径；
• 若地图补丁有加密密码，需在登录器中输入对应密码，保存配置后重新生成登录器，替换客户端原有登录器。

三、测试地图（确认安装成功）

1. 启动传奇服务端，确认服务端日志无报错（无“File not found”“MapInfo invalid”等提示）；
2. 启动客户端登录器，登录游戏，通过 NPC 传送（或命令传送）进入新安装的地图；
3. 测试要点：① 地图能正常加载，无黑屏、花屏；② 地图内地形、建筑显示完整；③ 能正常移动、打怪，无卡顿、闪退；④ 小地图能正常显示，坐标对应正确。

四、常见故障排查（新手必看，解决90%安装问题）

1. 地图加载失败（卡在加载界面/提示“无法进入地图”）

• 原因1：服务端 maps.txt 未添加地图编号，或格式错误（如中文逗号、多余空格）；解决：重新检查 maps.txt 文件，按“地图编号,地图名称”格式修改，保存后重启服务端；
• 原因2：.map 文件路径错误或缺失；解决：确认 .map 文件已复制到服务端 MapQuest_def 文件夹和客户端 Map 文件夹，文件名无乱码、无缺失；
• 原因3：服务端未重启，配置未生效；解决：关闭服务端引擎，重新启动，查看日志确认地图加载成功。

2. 地图黑屏（能进入地图，但无任何画面）

• 原因1：客户端 Data 文件夹未复制 Objects/SmTiles/Tiles 资源文件；解决：重新复制资源文件到 Data 文件夹，覆盖原有文件，重启客户端；
• 原因2：地图格式与引擎不兼容（如老引擎加载新格式地图）；解决：更换适配当前引擎的地图包，或使用地图编辑器转换地图格式；
• 原因3：登录器未读取到地图补丁；解决：重新配置登录器，设置正确的地图和补丁读取路径，重新生成登录器。

3. 地图花屏（画面错乱、出现乱码图案）

• 原因1：地图补丁编号冲突（如与盛大客户端补丁编号重复）；解决：使用地图索引修改工具，将补丁编号修改为30以后，避免冲突；
• 原因2：资源文件损坏或解压不完整；解决：重新下载地图包，用解压工具重新解压，确保所有资源文件完整；
• 原因3：引擎不支持当前补丁编号；解决：更换适配的地图包，或升级引擎版本。

4. 小地图不显示（大地图正常，小地图空白）

• 原因：小地图文件未复制到客户端 Minimap 文件夹，或小地图编号与地图编号不匹配；解决：将小地图文件复制到 Minimap 文件夹，确保小地图编号与 maps.txt 中的地图编号一致，重启客户端。

五、注意事项（避坑关键）

• 所有操作前必须备份原文件（服务端 Envir、客户端 Map/Data），避免误删导致原有地图丢失、游戏无法启动；
• 地图编号不可重复，建议从1000以后开始编号，避免与原有地图编号冲突；
• 配置文件（maps.txt、mapinfo.txt）需用记事本打开，保存时编码选择 ANSI，避免中文乱码；
• 地图包建议从正规素材站下载，避免下载到加密异常、文件损坏的地图，导致安装失败；
• 不同引擎的配置略有差异（如996纯PC引擎需转换地图格式），若遇到引擎相关问题，可查看引擎说明文档，或参考对应引擎的地图安装教程。