BYR Achieve · 镜像论坛

INTRODUCTION As should be self-evident, this article is about the MPQ format, the "Blizzard archive". I hope that I can explain what MPQs are, how they works, and why they do the things they do. This article is organized in six chapters. The first chapter gives a brief overview and history of the MPQ format. The second covers basic programming concepts that you will need to know before we get into the MPQ format. The third chapter covers the Storm library, and how it can be used to read from MPQs. The fourth explains about the MPQ API Library, and how it provides the capability to edit MPQs. In the fifth chapter, I'll cover the internal format of MPQs, which we'll use in the sixth chapter to view and edit MPQs without Storm or the MPQ API Library. Why I Wrote this Article I've been interested in the MPQ format since shortly after Starcraft was released. I poked around a bit, but I just wasn't a good hacker then, and I didn't know what I was doing. Consequently, I didn't get very far. But, with a streak of providential luck, I met Bobby Newmark in a Starcraft hacking BBS. Bobby had been writing a Java archive viewer which could read and extract from the archives of numerous games, and he wanted to add MPQs to it. Unlike me, he was a skilled hacker. He worked slowly (he did have a life and a job), but he hacked away at the MPQ format. Eventually he figured out enough of it to build MPQ support into his viewer. He told me about a third of the format, although I only understood about half that at the time. About 6 months later, after Bobby and I lost contact, Andrey (commonly know as Lelik) came into the picture. He released a program called MPQ Archiver, the ancestor of my own Mo'PaQ 2000. I was immediately interested in it. At the time, I would have been happy just to use it. But, it had one major deficiency - it couldn't import files that weren't encrypted (this means that Smackers couldn't be imported, as explained in chapter 4). I sent him a message telling him this. His response more than surprised me. He said that he was too busy to do it, and if I wanted it, I'd have to fix it myself - with the source code attached to the e-mail. Okay, then. I hadn't expected this, but I knew a good thing when I saw it. I looked at the code for about a week straight (that's how long it took me to figure out his unorthodox code). Well, eventually, I made the fix. But I didn't stop there. With Lelik's permission, I started redoing MPQ Archiver's shell from scratch, in what eventually evolved into Mo'PaQ 2000. But things didn't stop even there. After releasing version 1.0 of MPQ2K and several bug-fix versions, I wanted to add renaming and MPQ compacting. I knew from Lelik that these functions didn't exist in Storm or StarEdit (explained in chapter 3 and 4), so they would have to be written from scratch. At the time I thought Lelik would be more qualified to figure out the MPQ format than me. So I asked him, and I waited. And waited. And waited. And finally I got tired of waiting, and I did something crazy. I started hacking the format myself. I really didn't know what I was doing, and I spent the first week getting the hang of it. But after that, things really took off. 6 weeks after I started, I had figured out about 90% of the MPQ format, and was able to write the rename and compact functions. Anyway, the whole point of this lengthy explanation is that I have worked extensively with MPQs, and I am considered one of the worldwide authorities on MPQs. And, obviously, it is important for people to be able to use and understand the MPQ format, because of the power it provides for customizations. So, I want to use my knowledge to explain the MPQ format to everyone who wants to know. Who Should Read this Article There are principally three types of people who ought to read this article. The most obvious is people who want to customize games to play in interesting new ways, such as Campaign Creations and Camelot Systems. These types of customizations have become very popular, but most customizers still don't understand the MPQ format, and the benefits it provides. So, I intend for this article to teach these people the MPQ format so that they can make the best use of it. Considering my obvious programming slant, it should also be fairly obvious that I also write this for programmers who want to know about the MPQ format so that they can use it to their own liking. Until now, formal documentation for the MPQ format was completely nonexistent. Ladislav's overview gave a little taste, but it didn't provide usable knowledge for programmers. But, I intend this article to be the definitive, comprehensive guide for, among other things, programming the MPQ format. And finally, the third class is those people who are curious in general. It's far from uncommon for one of my Mo'PaQ 2000 beta testers to ask me something about MPQs that can't be easily answered (by far, the most common is "How come you can't list ALL the files in an MPQ?"). The answers to such questions lie in the fundamental architecture of MPQs, and can't be explained without a lot of background information. So, I hope to provide that information in this article, and answer everyone's problems and curiosities once and for all. http://shadowflare.samods.org/inside_mopaq/index.htm

[zz]Inside MoPaQ