Litematica Mod Wiki

Litematica is a modern schematic mod designed as a successor to Schematica. It allows players to display a "hologram" version of a structure in-world, providing a precise guide for construction. Beyond simple blueprints, it offers powerful features for Creative mode such as schematic pasting, area cloning, and block replacement, as well as Survival-friendly tools like a detailed material list and a schematic verifier to detect building errors.

The mod is client-side, meaning it does not need to be installed on a server for most features to work, though certain Creative-mode operations like pasting may require specific server-side permissions or commands.

Litematica uses a custom keybind system provided by the malilib library, allowing for multi-key combinations and extensive customization. Unlike vanilla Minecraft, these keys are managed within the mod's own configuration menus.

Primary Hotkeys

Note: On non-QWERTY layouts (e.g., AZERTY), the M key typically maps to the , (comma) key.

The Tool Item (default: Stick) is the primary way to interact with schematics and areas in the world. It has nine distinct modes that can be cycled through by holding Ctrl and using the Mouse Scroll Wheel.

Tool Modes

1. Area Selection: Used to define the corners of a new schematic.
2. Schematic Placement: Used to move, rotate, or mirror a loaded hologram.
3. Edit Schematic: Allows for direct modification of the schematic file (formerly Rebuild Mode).
4. Paste Schematic: (Creative Only) Pastes the hologram into the world as real blocks.
5. Fill Mode: (Creative Only) Fills a selected area with a specific block.
6. Replace Mode: (Creative Only) Replaces specific blocks within an area.
7. Delete Mode: (Creative Only) Removes blocks within a selected area.
8. Move Mode: (Creative Only) Moves blocks from one location to another.
9. Rebuild Mode: Legacy name for Edit Schematic; used for fine-tuning blueprints.

To create a schematic, you must first define an Area Selection. This is a 3D box that encompasses the structure you wish to save.

Creating a Selection

1. Equip the Tool Item and set it to Mode 1: Area Selection.
2. Left-Click a block to set Corner 1 (Red box).
3. Right-Click a block to set Corner 2 (Blue box).
4. The area between these corners will be highlighted with a colored box.

Selection Types

• Simple Mode: A single box defined by two corners.
• Normal Mode: Allows for multiple "Sub-regions" within a single selection, useful for complex or non-contiguous structures.

If a selection is too large to fit in your current render distance, the mod will display a "Missing Chunks" warning. You must fly or walk around the area to load all chunks before the schematic can be saved.

Schematics are saved as .litematic files in the .minecraft/schematics/ directory.

Saving a Schematic

Once an area is selected, open the Area Editor (Numpad Multiply or via M -> Area Editor). Click Save Schematic, enter a name, and confirm. You can also use Ctrl + Alt + S as a shortcut.

Loading a Schematic

1. Open the Main Menu (M) and select Load Schematics.
2. Choose a file from the list.
3. Ensure Create a Placement is checked if you want the hologram to appear immediately.
4. Click Load Schematic.

A Placement is a specific instance of a loaded schematic in your world. You can have multiple placements of the same schematic.

Positioning and Adjusting

• Moving: With the tool in Mode 2, use Alt + Scroll while looking in a direction to nudge the schematic one block at a time.
• Configuration: Press Numpad Minus to open the configuration for the selected placement. Here you can manually enter coordinates, Rotate the build (90, 180, 270 degrees), or Mirror it.
• Locking: You can lock a placement to prevent accidental movement once it is perfectly aligned.

Litematica provides several ways to view schematics to make building easier, especially for large structures.

Render Modes

Accessible via M -> Configuration Menu -> Render Layers or M + Page Up/Down.

Visual Overlays

The mod uses color-coded overlays to indicate building status:

• Blue/Cyan: Correct block placed.
• Red: Wrong block placed (e.g., Dirt instead of Stone).
• Orange: Correct block, but wrong state (e.g., Stair facing the wrong way).
• Magenta: Extra block that is not part of the schematic.

Material List

Pressing M + L opens a comprehensive breakdown of every block needed. It tracks:

• Total: Total blocks in the schematic.
• Placed: Blocks already correctly positioned in the world.
• Missing: Blocks still needed in your inventory.
• Available: Blocks currently in your inventory.

Schematic Verifier

The Verifier (M + V) scans the world against the schematic and provides a list of every mismatch. Clicking an entry in the list will highlight the specific error in the world with a glowing box, making it easy to find and fix mistakes in complex redstone or large-scale builds.

The Edit Schematic mode allows you to modify the blueprint itself without changing the actual blocks in the world. This is useful for fixing errors in a downloaded schematic or updating a design.

• Adding Blocks: Place blocks against the hologram while in Edit Mode.
• Removing Blocks: "Punch" the hologram blocks to remove them from the schematic file.
• Replace All: Set a hotkey for schematicEditReplaceAll. Hold it and right-click a block in the hologram with a new block in your hand to swap every instance of that block type in the schematic.
• Storing States: Use Alt + Middle Click on a block in the world to "copy" its exact state (including orientation and NBT) into the Edit tool for precise placement.

In Creative mode, Litematica acts as a powerful world editor.

Pasting

To paste a schematic, set the tool to Mode 4: Paste Schematic and press the Execute Operation hotkey (must be set in M + C -> Hotkeys).

• Single Player: Pasting is near-instant.
• Multiplayer: The mod uses /setblock or /fill commands. You must have operator permissions.

Easy Place

When enabled, Easy Place allows you to place blocks in the correct orientation and position simply by holding the right-click button and moving your cursor over the hologram. It automatically selects the correct block from your hotbar.

Warning: Easy Place can be detected as a "printer" or "cheat" by some anti-cheat plugins on survival servers. Use with caution.