File format · .s2mh
StarCraft 2 Map (.SC2Map) Format and Repair Guide
StarCraft 2 maps (.SC2Map) are MPQ archives holding terrain, triggers, and assets. Learn how headers fail, why maps corrupt, and how custom game data is re
StarCraft 2 maps (saved with the .SC2Map extension) are the container files used by Blizzard Entertainment's StarCraft 2 Galaxy Editor to define custom battlegrounds, campaigns, and arcade games. Despite appearing as a single file in Windows or macOS, a map is actually a complex archive. When the internal structure or header data becomes inconsistent, the map may fail to load in the game or the editor, requiring targeted repair to recover the terrain, triggers, and custom assets inside.
What the Format Is and What Software Uses It
A .SC2Map file is a proprietary archive format built on Blizzard's Mo'PaQ (MPQ) technology—the same archive system used across many Blizzard titles. It is created and edited exclusively via the StarCraft 2 Galaxy Editor (often called the SC2 Editor), which ships with the base game. The game client itself reads these files when loading custom matches or Arcade games.
Each map archive stores a wide variety of interconnected game data, including:
- Terrain geometry, heightmaps, and texture splat data
- Pathing and placement rules (where units can walk or build)
- Triggers and custom scripts (written in Galaxy Script)
- Unit, ability, and behavior definitions stored in XML-like game data files
- Imported custom assets (models, sounds, textures)
- UI layout and campaign progression data
Because a single map functions as a self-contained game project, a corruption in the archive structure can render months of custom development inaccessible.
Structure and Key Technical Facts
StarCraft 2 relies on the MPQ (Mo'PaQ) archive format to bundle thousands of internal files into one readable .SC2Map container. The MPQ format uses a specific internal structure to organize this data:
- Header: The archive begins with a header block that identifies the file as an MPQ archive and points to internal offset tables. This header must be intact for any tool to read the rest of the file.
- Hash Table: Used to quickly look up files by name. Each internal file (such as a trigger script or terrain file) is assigned a hash value.
- Block Table: Defines the physical disk offsets, compressed sizes, and flags (such as whether a file is compressed or encrypted) for each internal file.
- Files: The actual game data, which is often compressed using zlib or bzip2 to reduce the final file size.
Blizzard's MPQ format has evolved over time, and StarCraft 2 maps typically use MPQ version 4 (sometimes referred to in community documentation as MPQ v4), which supports larger archive sizes and extended header information. The authoritative specification for MPQ internals is maintained in Blizzard's official documentation and software development kits.
Why Map Files Become Corrupt or Unreadable
Map corruption usually occurs when the relationship between the header, hash table, block table, and the internal files becomes broken. Common causes include:
- Improper saves: If the Galaxy Editor or game client crashes while writing the archive, the header or block table may be updated but the internal file data may be incomplete, leaving the archive in an inconsistent state.
- Disk or transfer errors: Copying a map across drives, uploading it to a third-party hosting site, or transferring it over an unstable network can truncate the file, cutting off the final bytes needed to read the archive.
- Third-party modification: Using unofficial tools to inject custom models, bypass size limits, or alter triggers can miswrite the block table offsets, making the archive impossible to open natively.
- Version conflicts: Opening a map created in a newer version of StarCraft 2 with an older version of the editor can sometimes result in unrecognized data structures, leading to load failures.
What Data Can Be Recovered
Because a .SC2Map is an archive rather than a single monolithic blob, corruption rarely destroys all data at once. Depending on where the damage occurs, recovery efforts can often extract:
- Terrain data: Heightmaps, cliff definitions, and texture layouts.
- Trigger scripts: Custom Galaxy Script code that dictates map logic.
- Data definitions: Custom units, abilities, and buffs defined in the map's XML data modules.
- Imported assets: Custom sounds, 3D models, and textures bundled within the archive.
If the MPQ header and block table are intact, recovery is highly successful. If the header itself is damaged, recovery depends on rebuilding the offset tables so the remaining internal files can be located and extracted.
How Recovery Works
Recovering a damaged StarCraft 2 map involves treating the file as a broken MPQ archive rather than a proprietary game file. The process generally follows these steps:
- Diagnostic scanning: Specialized MPQ tools read the file to determine if the header signature is present and whether the hash and block tables can be parsed.
- Table reconstruction: If the block table is out of sync with the actual file data, recovery software can scan the archive for known internal file signatures and rebuild the offsets, allowing the files to be indexed again.
- Extraction: Once the tables are repaired or bypassed, the internal files (terrain, triggers, assets) are extracted to a standard directory structure.
- Repackaging: The extracted files can be packed into a fresh, clean
.SC2Maparchive using the Galaxy Editor or official MPQ tools, restoring the map to a playable state.
At FileRepair.net, we have extensive experience rebuilding damaged Blizzard MPQ archives. If you have a StarCraft 2 map that crashes on load, fails to open in the Galaxy Editor, or cannot be extracted, we can help.
Frequently Asked Questions
What is an .SC2Map file?
An .SC2Map file is a custom map or scenario for StarCraft 2. It is an MPQ archive containing terrain, triggers, unit data, and custom assets used by the game and the Galaxy Editor.
Can a StarCraft 2 map with a corrupted header be repaired?
Yes. If the underlying file data is still present, recovery tools can often rebuild the MPQ header and block tables, allowing the internal files to be extracted and repackaged into a working map.
Why does my map crash when loading in StarCraft 2?
Loading crashes often indicate that the archive's internal structure is incomplete, a file transfer truncated the archive, or a third-party tool wrote incorrect offset data into the block table.
Can I recover custom triggers and scripts from a broken map?
In most cases, yes. Triggers and Galaxy Script files are stored as individual files within the MPQ archive. If those files are not located in the corrupted portion of the archive, they can typically be extracted successfully.
Does Blizzard provide official tools for repairing maps?
Blizzard provides the Galaxy Editor for creating and saving maps, but it does not include a dedicated repair tool for corrupted archives. Recovery requires specialized MPQ diagnostic and extraction techniques.
If you have a corrupted or unreadable StarCraft 2 map, send it to our team for a free evaluation. We will analyze the archive structure, determine exactly what can be recovered, and provide a clear plan to restore your custom game data.
Send us your .s2mh file for a free evaluation
Our recovery engineers will tell you exactly what can be recovered — at no cost. There is no charge if we cannot recover your data.
Start a free evaluation