Skip to content

uustory/u-mpq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

u-mpq

类似暴雪MPQ归档资源打包和读取工具

MPQ文件简介

在游戏制作中,会有很多资源,比如图片,json,txt,xml等各种游戏资源。如果直接将这些文件放在游戏包的目录下, 会造成碎文件过多,影响文件读取速度。 同时,很多游戏都有热更新, 需要对游戏资源做增量更新。比如初始包体是100M,后面更新了部分资源,需要在已有的包体运行初始化的时候,下载这部分改动或者添加的资源。

之前暴雪针对这些需求,实现了一个优化了的资源归档格式——MPQ。 该工具在其理论基础上, 针对手游做了一些调整和简化,但是原理一致。

这个工具的作用可以简单地概括为两句话:

1、将指定目录下的所有变更或者新增的资源,打包生成一个新的mpq文件。 2、程序运行时, 从mpq中读取资源时,自动采用较新的资源。

目录结构

mpqpacker:

----mpq.py MPQ打包工具脚本,需要安装python 2.*版本。建议安装python 2.7.10以上版本

MPQReaderForCSharp:

----MPQFileSystem.cs:MPQ文件格式,C#解析类, 使用该类进行mpq文件的读取
----其他辅助类

使用说明

1、打包方式:

python mpq.py [MPQ target dir] [Res source dir]

比如:

python mpq.py ./GameUpdates ./GameResources

就是将GameResoures下面所有的资源, 生成一个mpq文件,到GameUpdates目录下

2、解压方式:

如果要解压已经存在的mpq文件,则使用如下命令

python mpq.py -d [MPQ dir] [Res target dir]   -- 将[MPQ dir]目录下的mpq文件,解压到[Res target dir]目录下

比如:

python mpq.py -d ./GameUpdates ./GameResources

就是将GameUpdates目录下所有的mpq文件中的资源文件, 解压生成到GameReosurces目录下。


3、程序中使用方式(C#):

初始化,指定mpq所在目录:
        string path = "C:/game/res";        //游戏中mpq资源所在目录
        MPQFileSystem mpqFileSystem = new MPQFileSystem();
        mpqFileSystem.Init(new DirectoryInfo(path));

从mpq文件中读取指定的资源:
        string path = "/assets/res/test.xml";   //在mpq中的文件,相对路径
        byte[] ret = this.mpqFileSystem.ReadData(path);

这样就从MPQ文件中读取出了指定资源文件的二进制数据。

4、实际使用建议:

4.1、mpq作为资源增量打包和读取方式

4.2、对生成的mpq文件进行gzip压缩

4.3、对mpq文件生成文件索引文件, 做资源更新和检查。 游戏中初始化的时候, 先判断资源服务器上是否有新资源mpq文件, 有的话就下载, 然后程序解压并读取。