JMir是基于Java实现的热血传奇2客户端项目，其核心工作之一就是正确解析和渲染传奇的资源文件与地图数据。理解这套资源的组织结构，是后续开发或修改的基础。
### 资源文件体系：WIX与WIL
传奇客户端的大部分图形素材存储在WIL文件中，而WIX文件则是这些素材的索引。
一个WIL文件包含大量图片，比如怪物动作序列、装备外观、技能特效等。但图片在WIL文件中并非按逻辑顺序连续存放，而是通过WIX文件记录每张图片的具体起始位置。
WIL文件的结构相对固定。文件头部由固定的44个字节构成，紧接着是1024字节的调色板信息。之后才是实际的位图数据，而每张位图数据的开始位置，正是由对应的WIX文件指明的。
在Java中解析时，流程如下：
1. 读取并解析WIX文件，获取每张图片在WIL文件中的偏移量。
2. 读取WIL文件头部，跳过固定头和调色板。
3. 根据WIX提供的偏移量，定位并读取每张图片的宽度、高度和像素数据。
原始数据是8位位图，JMir在解析时通常会将其转换为背景透明的PNG格式以方便渲染。
### 地图文件结构：MAP文件
地图文件，即`.map`文件，保存着地图的布局信息，但它不存储具体的图片色彩数据，只存储构成地图的“砖块”所对应的图片索引。
地图由一个个“Tile”拼接而成。在传奇中，一个Tile对应游戏世界里的一个基本单元，其屏幕像素大小为48x32。
一个完整的`.map`文件包含文件头和数据区两部分。以Delphi语言的结构来描述，其文件头（TMapHeader）通常包含地图的宽度、高度、地图名称、更新日期等元信息。紧随其后的是数量为`宽度 x 高度`的Tile数据（MapTile）。
在Java中，一个典型的MapTile对象包含以下关键字段，用于描述当前格子显示的图像及动态效果：
* **bngImgIdx / midImgIdx**：背景层和中间层的图片索引。
* **objImgIdx**：对象层（如建筑、树木）的图片索引。
* **doorIdx / doorOffset**：门的索引及其开关状态。
* **aniFrame / aniTick**：用于实现动态效果的帧数和跳帧数。例如，一个水潭的Tile通过轮询显示一组图片来模拟水波。
* **objFileIdx**：指明当前Tile的图片来自哪个具体的资源文件，如`Objects`、`SmTiles`或`Tiles`文件。
### 相关资源文件说明
与地图渲染密切相关的资源文件主要是以下几种：
* **Tiles.wil / SmTiles.wil**：存放地面砖块，前者用于大地砖，后者用于小地砖。
* **Objects.wil (及Objects2-7.wil)**：存放地表之上的建筑、植被等静态对象。
* **mmap.wil**：存放小地图图片。
地图的`.map`文件记录了引用这些WIL文件中具体图片的索引。例如，一个草地砖块可能引用`Tiles.wil`中的第100号图片。地图编辑器通过修改`.map`文件中的这些索引值，可以更换地图的外观，而无需改动WIL文件本身。
传奇JMir资源文件与地图结构解析及读取方法
来源：
作者：
点击：