Java library for reading and writing mpq archives.
Branch: master
Clone or download
3d12 and Frotty Added UNIX compatibility to extracted files (#25)
Used File.separator rather than a "\\" string
for compatibility with UNIX filesystems.
Latest commit 475e84e Nov 17, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper fix mistake May 4, 2017
src Added UNIX compatibility to extracted files (#25) Nov 17, 2018
.gitignore run correct task May 4, 2017
.travis.yml another travis test Nov 14, 2017
LICENSE.txt Change license to Apache 2.0 Aug 23, 2018 Update Aug 12, 2018
build.gradle 1.7.6 Oct 8, 2018
gradlew prepared project for maven Mar 13, 2016
gradlew.bat prepared project for maven Mar 13, 2016
settings.gradle fixes for artifact generation May 4, 2017

Build Status Jit Coverage Status codebeat badge



JMPQ3 is a small java library for accessing and modifying mpq (MoPaQ) archives. Common file endings are .mpq, .w3m, .w3x.

MoPaQ is Blizzard's old, proprietary archive format for storing gamedata (replaced with CASC).

You can find more info and an excellent graphical editor here

Get it

currently only warcraft 3 maps and mpqs are confirmed supported. Mpqs from other games (WoW, starcraft) might cause problems.

It is recommended to use jitpack with a dependency manager like gradle.


Gradle Example:

dependencies {
    compile 'com.github.inwc3:JMPQ3:1.7.1'
allprojects {
    repositories {
	maven { url '' }

You can still download the jar directly if you prefer

How to use

Quick API Overview:

Jmpq provides the OpenOptions READ_ONLY which should be selfexplanatory and FORCE_V0 which forces the mpq to be opened like warcraft3 would open it, ignoring optional data from later specifications for compatability.

// Automatically rebuilds mpq after use if not in readonly mode
try (JMpqEditor e = new JMpqEditor(new File("my.mpq"), MPQOpenOption.FORCE_V0)){
        e.hasFile("filename"); //Checks if the file exists
        e.extractFile("filename", new File("target location")); //Extracts a specific file out of the mpq to the target location
        if (e.isCanWrite()) {
            e.deleteFile("filename"); //Deletes a specific file out of the mpq
            e.insertFile("filename", new File("file to add"), true); //Inserts a specific into the mpq from the target location
            e.extractAllFiles(new File("target folder")); //Extracts all files inside the mpq to the target folder. If a proper listfile exists,
            e.getFileNames(); //Get the listfile as java HashSet<String>


Known issues:

  • To work around jmpq creates tempfiles for every object in the mpq
  • Unsupported decompression algorithms: sparse and bzip2
  • Only supported compression is zlib/zopfli
  • JMPQ doesn't build a valid (attributes) file for now. (which seems to be fine for warcraft3)