JMir作为用Java重写LegendofMir2客户端的开源/教学型实现，资源文件沿用原版传奇2的二进制布局，但在读取层用InputStream、ByteBuffer、ImageIO替代了Delphi/C++的原生API。核心资源目录依旧是客户端根下的Data、Map、Graphics、Wav、Sound，以及服务端Envirl/MapInfo.txt等文本配置。
Map目录与.map文件结构是场景底座。每个地图一个二进制文件，文件头52字节，原版头部含“LegendofMir”标识（部分衍生版为“ShandaWoool”），随后是按坐标排列的记录块，每条记录12字节，描述该格子的地形标志、物件索引、光照、阻挡位、门/传送点引用等。地图宽高在文件头中给出，JMir解析时先读头→拿到宽高→计算格子总数→循环读取width*height个12字节单元装入二维数组MapCell[][]。服务端Mir200\Map与客户端Map必须同名同结构，否则Java端解码后坐标错位、黑屏、卡墙。
MapInfo.txt是地图逻辑层绑定文件，格式为[地图代号|源Map编号显示名]属性，例如[0比奇省]RUNHUMANFIGHT、[0330329->5100100;Houses。JMir启动时常驻解析该文本，建立MapNo→MapFile→DisplayName→FlagSet的映射表；传送、回城、行会召唤、随机卷限制都查这张表。新增地图时既要丢.map进Map目录，也要在MapInfo.txt追加一行，否则@move命令找不到目标。
Data目录承载贴图库，主体是.wil/.wzl文件（WemadeImageLibrary）。原版.wil文件头含“WEMADEEntertainmentinc.”字样，结构为：标题区→图片数量int→偏移表int[]→调色板（256色老版）或RGBA像素块（真彩版）→逐帧图片头（宽、高、偏移、压缩标识）。配套.wix为索引文件，记录每张图在.wil中的绝对偏移，避免全量扫描。JMir里通常写WilArchive类：构造时读文件头、建偏移数组、懒加载指定index的解压像素，转成BufferedImage交给绘制层。Objects1~ObjectsN.wil存地砖与建筑碎片，Tiles.wil存地面拼贴，Mon1~MonN.wil存怪物帧，Hum/Weapon/Items/DnItems存角色、武器、物品栏与掉落物，mmap.wil存小地图。
地图渲染时JMir的TileRenderer按摄像机视口算出可见格子范围，对每个MapCell：先取地形编号→从Tiles.wil仍应帧画地面；再取物件编号→从ObjectsX.wil取建筑/树/门帧叠加；若有怪物/NPC/角色占用，再叠加Mon/Npc/Hum序列帧；最后合小地图mmap.wil。Z序按格子y坐标排序，保证上下遮挡正确。缺少对应.wil或index越界就画粉色/黑色占位块，表现为“白模地图”。
Graphics目录放扩展外观：Graphics\Human\放衣服外观（文件名对应物品库Shape值，如100.wil），Graphics\Weapon\放武器外观，规则同上；部分JMir分支把StateItem.wil、Prguse2.wil也归到这里做UI皮肤。
声音资源在Wav/Sound目录，格式为.wav，地图触发音（脚步、门响、技能）由MapCell音效索引+资源表定位；部分引擎扩展用.wem（Wwise封装）但JMir原生多走JavaSoundAPI直接读PCM，不解析Wwise容器。
Envir目录（服务端侧）与客户端资源形成双向约束：MonGen.txt决定某.map刷哪类怪，Merchant.txt/Npcs.txt决定NPC站在哪张地图哪坐标、引用哪个npc.wil形象，MapQuest.txt绑定地图事件脚本。JMir若做联机端，必须同时加载服务端Envir文本与客户端二进制资源，单边有缺失就会出现“进图空场”或“怪看不见但能挨打”。
读取顺序小结：启动→载MapInfo.txt建地图表→按需读Map\xxx.map解码格子→进图时WilArchive缓存Data\ObjectsX.wil/Tiles.wil/MonX.wil→逐帧BufferedImage合成→摄像机裁剪绘制。路径建议纯英文，DBC/编码用GBK读MapInfo，UTF-8读脚本，混淆会导致地图名乱码或加载空图。
Map目录与.map文件结构是场景底座。每个地图一个二进制文件，文件头52字节，原版头部含“LegendofMir”标识（部分衍生版为“ShandaWoool”），随后是按坐标排列的记录块，每条记录12字节，描述该格子的地形标志、物件索引、光照、阻挡位、门/传送点引用等。地图宽高在文件头中给出，JMir解析时先读头→拿到宽高→计算格子总数→循环读取width*height个12字节单元装入二维数组MapCell[][]。服务端Mir200\Map与客户端Map必须同名同结构，否则Java端解码后坐标错位、黑屏、卡墙。
MapInfo.txt是地图逻辑层绑定文件，格式为[地图代号|源Map编号显示名]属性，例如[0比奇省]RUNHUMANFIGHT、[0330329->5100100;Houses。JMir启动时常驻解析该文本，建立MapNo→MapFile→DisplayName→FlagSet的映射表；传送、回城、行会召唤、随机卷限制都查这张表。新增地图时既要丢.map进Map目录，也要在MapInfo.txt追加一行，否则@move命令找不到目标。
Data目录承载贴图库，主体是.wil/.wzl文件（WemadeImageLibrary）。原版.wil文件头含“WEMADEEntertainmentinc.”字样，结构为：标题区→图片数量int→偏移表int[]→调色板（256色老版）或RGBA像素块（真彩版）→逐帧图片头（宽、高、偏移、压缩标识）。配套.wix为索引文件，记录每张图在.wil中的绝对偏移，避免全量扫描。JMir里通常写WilArchive类：构造时读文件头、建偏移数组、懒加载指定index的解压像素，转成BufferedImage交给绘制层。Objects1~ObjectsN.wil存地砖与建筑碎片，Tiles.wil存地面拼贴，Mon1~MonN.wil存怪物帧，Hum/Weapon/Items/DnItems存角色、武器、物品栏与掉落物，mmap.wil存小地图。
地图渲染时JMir的TileRenderer按摄像机视口算出可见格子范围，对每个MapCell：先取地形编号→从Tiles.wil仍应帧画地面；再取物件编号→从ObjectsX.wil取建筑/树/门帧叠加；若有怪物/NPC/角色占用，再叠加Mon/Npc/Hum序列帧；最后合小地图mmap.wil。Z序按格子y坐标排序，保证上下遮挡正确。缺少对应.wil或index越界就画粉色/黑色占位块，表现为“白模地图”。
Graphics目录放扩展外观：Graphics\Human\放衣服外观（文件名对应物品库Shape值，如100.wil），Graphics\Weapon\放武器外观，规则同上；部分JMir分支把StateItem.wil、Prguse2.wil也归到这里做UI皮肤。
声音资源在Wav/Sound目录，格式为.wav，地图触发音（脚步、门响、技能）由MapCell音效索引+资源表定位；部分引擎扩展用.wem（Wwise封装）但JMir原生多走JavaSoundAPI直接读PCM，不解析Wwise容器。
Envir目录（服务端侧）与客户端资源形成双向约束：MonGen.txt决定某.map刷哪类怪，Merchant.txt/Npcs.txt决定NPC站在哪张地图哪坐标、引用哪个npc.wil形象，MapQuest.txt绑定地图事件脚本。JMir若做联机端，必须同时加载服务端Envir文本与客户端二进制资源，单边有缺失就会出现“进图空场”或“怪看不见但能挨打”。
读取顺序小结：启动→载MapInfo.txt建地图表→按需读Map\xxx.map解码格子→进图时WilArchive缓存Data\ObjectsX.wil/Tiles.wil/MonX.wil→逐帧BufferedImage合成→摄像机裁剪绘制。路径建议纯英文，DBC/编码用GBK读MapInfo，UTF-8读脚本，混淆会导致地图名乱码或加载空图。