What is the SCHEMATIC file format?
A .schematic file is used by MCEdit and other Minecraft editor programs, including WorldEdit. The format allows editors to create and edit 3D structures, map sections, terrain, and related block objects that can be imported and exported between worlds. A .schematic associated with a specific build can be placed into a game world using the MCEdit selection tool or WorldEdit's //schematic load command.
Internally, the format stores a gzip-compressed NBT byte array of block IDs arranged in YZX order. It relies on legacy numeric block IDs predating Minecraft 1.13, so it cannot represent newer blocks without remapping. Modern editors now prefer the Sponge Schematic .schem format for current Java Edition builds.
Security & safety
RISK: LOWA .schematic is passive block data, not executable code, so opening one is low-risk. The realistic concern is gameplay/world integrity: pasting a downloaded build with WorldEdit overwrites whatever is in the target area, so always back up your world (or test on a copy) before importing. Schematics with command-block contents could run commands when triggered in-game - inspect downloads from untrusted sources. Watch for fake "schematic download" pages that wrap files in PUP installers; get builds from reputable community sites and download the .schematic directly.
Format details
in a nutshell- Generic NBT data file - Some non-Minecraft tools have reused .schematic for gzip-NBT block data; the structure is the same NBT container.
Programs that open SCHEMATIC files
//schematic load <name> and //paste. The standard way to import a schematic. //schematic load + //paste workflow on a Mac client or server. //schematic load and //paste. Technical details
deep spec| Compression | GZIP (DEFLATE) wrapping the NBT payload; magic bytes `1F 8B 08` at offset 0 |
| Internal encoding | NBT (Named Binary Tag) - big-endian binary with typed tag tree |
| Root structure | TAG_Compound named `Schematic` containing `Width`, `Height`, `Length` (TAG_Short), `Materials`, `Blocks`, and `Data` tags |
| Block storage order | YZX - `Blocks[y * Width * Length + z * Width + x]` |
| Block ID system | Legacy numeric block IDs (0-255) with 4-bit metadata values; pre-Minecraft 1.13 flattening |
| Dimension limits | Width, Height, Length stored as TAG_Short; maximum 32,767 blocks per axis |
| Byte order | Big-endian for all multi-byte NBT numeric values |
| Entity data | Optional `Entities` and `TileEntities` TAG_List entries store mobs and block entities within the region |
| Integrity check | GZIP CRC-32 over the compressed stream; no additional content signature |
| MIME type | `application/octet-stream` (no format-specific MIME type is registered for `.schematic`) |
| Platform scope | Java Edition only; legacy numeric IDs are incompatible with Bedrock Edition, which uses `.mcstructure` |
| Superseded by | Sponge Schematic `.schem` (2018), which uses namespaced block-state palettes and supports post-1.13 blocks |
| Typical file size | A few KB to tens of MB, scaling with the bounding-box volume of included blocks |
| Materials tag | `Materials` TAG_String identifies the block ID set (`Classic`, `Alpha`, or `Pocket`) used in the region |
| Released | around 2011 (MCEdit; format loosely based on Minecraft's Indev level format) |
| Latest version | Legacy numeric-block-ID format; superseded by the Sponge .schem format (2018) and Litematica .litematic |
| Open standard | Yes · royalty-free |
| Specification | minecraft.wiki |
SCHEMATIC conversions
Community Q&A
asked by usersNo questions yet - be the first to ask about SCHEMATIC files.
Frequently asked questions
How do I open a .schematic file in Minecraft?
//schematic load <name> and //paste. Standalone, use the Amulet (or MCEdit) world editor to import it into a world.What's the difference between .schematic and .schem?
How do I convert a .schematic to .schem?
//schematic save -f sponge, or use Amulet or the SchemConvert tool. This is needed when an old schematic must work with modern blocks.