File format · .s2ma
StarCraft II Map (.SC2Map) File Format & Repair Guide
StarCraft II map files (.SC2Map) are complex archives storing terrain, triggers, units, and custom assets. Learn how these files work, why they corrupt, an
StarCraft II maps (.SC2Map files) are the containers that define every skirmish, campaign mission, and custom game in Blizzard Entertainment's real-time strategy universe. Developed by Blizzard and first shipped with StarCraft II: Wings of Liberty in 2010, the format remains the backbone of the game's arcade and modding community. Because these files pack massive amounts of interconnected data—terrain geometry, unit logic, scripting, audio, and custom textures—into a single package, they are vulnerable to specific types of corruption that can ruin hours of map-making effort. At FileRepair.net, we frequently help users recover damaged custom maps and mods. Here is a deep dive into how these files work and what to do when they break.
What Is an SC2Map File?
An .SC2Map file is a compiled game map used by StarCraft II. It is not a single flat file, but rather an archive that the StarCraft II game engine reads to load a playable environment. The game's editor, known as the StarCraft II Editor (or "Galaxy Editor"), is the primary tool used to author these files.
The format was introduced with Wings of Liberty and has persisted through the Heart of the Swarm and Legacy of the Void expansions, as well as the free-to-play era that began in November 2017. The StarCraft II Editor is known for its immense complexity and power, allowing creators to alter fundamental game data, write custom scripts, and build entirely new game modes. This flexibility means a single .SC2Map file can contain highly intricate dependency chains, relying on both base game assets and user-imported custom files.
Internal Structure and Technical Facts
While Blizzard does not publicly maintain a formalized, standalone specification for the file format, the modding community and the behavior of the official editor reveal a clear underlying structure.
- Archive Format:
.SC2Mapfiles are functionally MPQ (Mo'PaQ) archives—the proprietary archive format developed by Blizzard Entertainment and used across many of their titles, from Warcraft III to Diablo. - Internal Hierarchy: Inside the MPQ archive, the data is organized into a logical folder structure. Key directories typically include:
Maps: Containing the raw terrain data, heightmaps, and pathing layouts.TriggerLibs: Holding the compiled or source code for custom scripts (often written in Galaxy Script, StarCraft II's native scripting language).Base.SC2Dataand other.SC2Datadirectories: Storing game data modifications, such as custom unit stats, abilities, and visual effects.Assets: Housing any custom textures, 3D models, sounds, or music imported by the mapmaker.
- Dependencies: Maps rarely exist in a vacuum. They usually reference dependencies (such as
Core.SC2ModorLiberty.SC2Mod) which provide the base game assets. If a map's dependency chain is broken or mismatched with the installed version of StarCraft II, the map will fail to load.
Why SC2Map Files Become Corrupt or Unreadable
Because .SC2Map files are complex MPQ archives, they are susceptible to several common points of failure:
- Improper Editor Closure: The StarCraft II Editor must compile and write vast amounts of data to the archive. If the editor crashes, is force-closed via the Task Manager, or if the computer loses power during a save operation, the MPQ header or file table can be left incomplete.
- File Bloat and Size Limits: Custom maps often import high-resolution textures and audio. If a map's file size becomes excessively large, it can exceed engine memory limits, leading to read errors during gameplay or saving.
- Corrupt Custom Assets: If a mapmaker imports a malformed 3D model or an improperly formatted image file, the archive might save correctly, but the game engine will crash when attempting to render that specific asset.
- Transfer Errors: When sharing maps over third-party file-sharing sites rather than the official Battle.net servers, incomplete downloads can result in truncated MPQ archives that the game refuses to open.
- Version Mismatches: Blizzard occasionally updates the core game data. If a map relies on deprecated base assets or older script syntax, it may be flagged as unreadable or cause the editor to crash on launch.
What Data Can Be Recovered?
When an .SC2Map file becomes corrupt, the recoverability depends on which part of the archive failed.
If the MPQ header is intact but internal files are damaged, we can often extract the raw components. The terrain heightmap, trigger scripts (the logic of the game), and imported custom assets (like textures and audio) are usually stored as distinct files within the archive. Even if the map can no longer be opened directly in the game, these individual elements can frequently be salvaged and ported into a fresh, newly created map file, saving the creator from having to rebuild the map from scratch.
How Recovery Works
Recovering a StarCraft II map requires treating the .SC2Map file as a damaged archive rather than a single document. Our process generally involves:
- Header and File Table Repair: We analyze the MPQ structure to rebuild the file allocation table. If the header was truncated during a bad save, we attempt to reconstruct the index so the archive's contents can be browsed again.
- Data Extraction: Using specialized archive extraction tools, we unpack the readable data from the damaged
.SC2Mapfile to a standard folder structure. - Asset Isolation: We isolate the specific file—often a custom imported asset or a specific trigger script—that caused the engine to crash, allowing the rest of the map data to function normally.
- Repackaging: Once the viable data is extracted and the corrupt elements are isolated, the map's contents can be repackaged into a new, clean
.SC2Mapfile using the official StarCraft II Editor.
Frequently Asked Questions
Can I open an SC2Map file like a ZIP file?
Yes. Because .SC2Map files use Blizzard's MPQ archive format, third-party MPQ editors can often open them, allowing you to view and extract the internal folders, scripts, and custom assets—provided the archive itself is not heavily corrupted.
Why does the StarCraft II Editor crash when I open my map?
Crashes on launch usually indicate a severe error in the map's header, a corrupted master trigger file, or an improperly formatted custom asset that the editor attempts to parse immediately upon opening the file.
Does Battle.net automatically back up my maps?
While Battle.net hosts published maps, local unpublished projects are stored solely on your hard drive. If a local .SC2Map file is corrupted before you publish it to Battle.net, the game cannot automatically restore it.
Can a corrupted map be saved if the MPQ header is completely destroyed?
If the header is entirely overwritten or destroyed, the internal file structure is lost. However, raw data carving techniques can sometimes recover uncompressed assets, such as imported images or audio files, though the core terrain and trigger data may be permanently lost.
If you have a damaged StarCraft II map, a failed custom mod, or an unreadable .SC2Map file that is preventing you from accessing months of development work, don't start over from scratch. Contact FileRepair.net for a free evaluation, and let our team determine exactly what can be salvaged from your corrupted game data.
Send us your .s2ma 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