Skip to content
Previewer

Schematic formats

Import structures from Minecraft, WorldEdit, Litematica and older exporters.

Format File extension Supported versions
Vanilla structure .nbt Native structure data, with alternative palettes when present.
Sponge / WorldEdit .schem 1 to 3
Litematica / Forgematica .litematic 1 to 7
Legacy Alpha / MCEdit .schematic Legacy format with resolvable registry/name data.

The reader detects file contents rather than relying only on the extension. Multiple or negative Litematica regions, packed states and offsets are supported. Conflicting overlapping regions and unresolved historic numeric metadata are reported rather than guessed.

Use an exporter you already have, such as Minecraft’s structure blocks, WorldEdit, Litematica or Forgematica. Put the result in your active instance’s schematics/ library. If you have none, you can save one of your own builds with Capture. Never made a schematic? Start here.

Palette-less global-ID Sponge files, Classic schematic format and Bedrock conversion are outside the implemented path. A future Minecraft DataVersion, missing historical registry map or removed mod property remains a diagnostic.

If an old file cannot resolve an ID, use a suitable external exporter or converter that understands the source format and mods. Renaming the extension does not fix its contents.

Install the matching source mod where appropriate, pick replacement blocks, or mark missing content for manual placement. Installed mods must still agree on the meaning of their saved data. The compatibility guide explains that boundary.

Capture turns part of your world into a new .schem file, with no other mod needed. Added in 0.3.0. For a gentler walkthrough see Your first schematic.

  1. By default you must be in Creative mode with operator permission (level 2). In singleplayer, turn cheats on for the world. A server owner can let everyone capture (captureAccess). Open Capture from the Library, or Capture / export from Settings. If you may not capture, the button is greyed out and says why.
  2. The game returns to the world. Right-click for corner 1, then for corner 2. Both corners are included. A corner is the block you aim at or, in open air, a marked spot ahead of you (5 blocks to start). Hold Ctrl and use the wheel to change that distance (2 to 64), or to move a side of the box one block when you aim at it. Press V to go back to the capture menu. See the capture controls.
  3. In the capture menu, select Select origin and aim the same way. The first corner is the initial origin; the chosen origin controls where the exported schematic anchors later.
  4. Enter a new filename using 1 to 48 lowercase letters, digits, _ or -. The .schem extension is added automatically.
  5. Choose whether to include fluids and Data blocks, then select Export .schem. Refresh the Library to load the new file.

Capture supports up to 262,144 loaded blocks, a 4 MiB output, and two captures per server, with one running capture per player. Both corners and the origin must be within 128 blocks of you. It never force-loads chunks. Spawn protection still applies. The file is saved in the requesting client’s active instance schematics/ folder; an existing file is kept, so choose a new name to capture another revision.

Data blocks is off by default. Enabling it includes only the block states of signs, containers and machines. Their text, configuration and inventories are never copied. Entities, living mobs, biome data and all saved block-entity data are excluded from this initial exporter. Reads run across ticks: keep the selected area stable while capturing.

The output uses Sponge schematic format v3. You can still use other exporters when you need content beyond this initial block-only capture.