Mod

Litematica
Rank 1,008
Rank 752 among mods

Quick rating

Litematica

Overall rating distribution
0.5★ (no ratings)
1.0★ (no ratings)
1.5★ (no ratings)
2.0★ (no ratings)
2.5★ (no ratings)
3.0★ (no ratings)
3.5★ (no ratings)
4.0★ (no ratings)
1 rating (100%) · 4.5★
5.0★ (no ratings)
0.5★ 5★
Gameplay
0.0
Aesthetics
0.0
Performance
0.0

A modern schematic mod written for Fabric (and LiteLoader on 1.12.x), with extra features for Creative mode work

No Theme
No Genre
Client Utility
Mod Loaders
Forge
Fabric
Quilt
Minecraft
26.2

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Required
Server Unsupported

About

Project Details

Type
Mod
License
GNU Lesser General Public License v3.0 only
Latest Version
litematica-fabric-26.2-0.28.3.jar
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

About

Description

Severe vulnerability in 1.21+ versions of the mod

See the announcement post here for details:

https://old.reddit.com/r/litematica/comments/1up8uqk/important_announcement_litematica_vulnerability/

As a summary, everyone using MC 1.21+ versions of Litematica should update to the latest available mod versions immediately!!

The vulnerability does not exist in the 1.20.x and older mod versions. With the affected mod versions, connecting to potentially any server might transfer malware to your system. Single player is not at risk. But update the mod!

See this about MC 1.20.5 and later versions

https://old.reddit.com/r/litematica/comments/1di4o3h/announcement_about_litematicas_future_and_updates/

TL;DR; I won't maintain the 1.20.5+ versions myself anymore, at least for now. There are ports by Sakura-Ryoko. They will be here once they are more stable, see the post for the links and details before then.

 

Description:

Litematica is a new schematic mod written from scratch, and it is primarily targeting light mod loaders like LiteLoader on 1.12.x, Rift on 1.13.x and Fabric on 1.14+. There is also a Forge version for 1.12.2, but not yet for 1.14.4+ (but Forge ports for 1.14.4+ are also planned, see below).
It has all the features of the old Schematica mod except for the printer (which is not planned for Litematica itself, but instead is left to extension mods), plus a bunch more.

  • The main feature of a schematic mod is to display a "hologram" version of a structure, which shows you exactly how to build the structure and where to place the blocks. It also includes a (configurable) overlay to highlight missing, extra or wrongly placed blocks.
  • Litematica also includes a nice Material List, including a Material List HUD, to help you collect the materials needed for the build.
  • There is also a Schematic Verifier feature, including an overlay, which you can use to scan the entire schematic area and look for any mistakes. This can be extremely useful especially with technical/redstone builds, where tiny mistakes can break everything.
  • There are also several Creative-mode-only helper features, such as Fill, Replace, Delete and also a Paste mode for "pasting" schematics into the world (immediate/direct in single player, using /setblock commands in multiplayer).

NOTE: Litematica also requires the MaLiLib library mod:
https://www.curseforge.com/minecraft/mc-mods/malilib

WARNING: The Easy Place mode feature may get you banned on some servers!
The Easy Place feature will always be clicking on the target position's air block, and this can easily be detected by anti-cheat systems. So this can result in at least two things: The block placement will just be rejected and you just get client-side ghost blocks, or some anti-cheat system flags that as cheating and auto-bans you from the server. So before using Easy Place, find out of it's allowed on the server!

About Forge ports for 1.14.4+
Forge versions for 1.14.4 and later are planned.
Still no ETA for the "official port", which will only be done from the still being worked on new development code. But ZacSharp already ported the current 1.16.4 Fabric version to 1.16.5 Forge. That port is available here: https://legacy.curseforge.com/minecraft/mc-mods/litematica-forge

Some more info and discussion about the Forge port/builds is here: https://github.com/maruohon/litematica/issues/234

There are also at least a couple of other 3rd party Forge ports on GitHub and at least one on Modrinth. I haven't tested those myself, so I can't say anything about how well they work.

The default hotkey to open the in-game config GUI is M + C. If you are for example on AZERTY keyboard layout instead, then the keys are different, and M + C becomes , + C instead, etc.

If you have Optifine installed, then there are some options that you most likely will need to disable in Optifine, or otherwise it will break the schematic rendering:

  • If you get glitchy weird triangles, then in 1.16+ first try updating to the latest Litematica version. If that doesn't work, then set shaders to OFF (not Internal) and restart the game.
  • Render Regions probably needs to be disabled to prevent weird rendering issues (the schematic (partially?) rendering in weird places)
  • Fast Render might also need to be disabled if there are still some weird HUD/GUI rendering issues

Snapshot versions and latest development builds

There are sometimes newer "development" or snapshot versions of my mods available here: https://masa.dy.fi/mcmods/client_mods/
Lately I've stopped making releases for MC snapshots, as it's mostly a waste of my limited modding time and energy. Snapshot releases maye start again at some point, if I ever get the elusive but often mentioned "new code versions" of the mods actually released to the public first. I geuss time will tell.

FAQ - please read first if you have questions

  • Q: The main menu and the config menu don't open with M and M + C
  • A: 1.) Check that the mod is installed and working: check if you see the orange Litematica text on the F3 screen.
    2.) If you are on a non-QWERTY keyboard layout, then the default hotkeys are different. For example on AZERTY the M key is , (comma) instead, so the config menu hotkey for example is , + C. I'm looking for a solution to this issue.
  • Q: How do I rotate a schematic (placement)?
  • A: In the Placement configuration GUI. You can open it (for the currently selected Placement) with a hotkey, or you can go via the Main menu -> Schematic Placements -> Configure.
  • Q: How do I only render one layer at a time
  • A: You can control the rendered layers on the Render Layers tab inside the in-game config menu (via the Main menu -> Configuration Menu, or the default hotkey M + C
  • Q: How do I change blocks in the schematic? Is there a /schematicaReplace command?
  • A: There is no command, but there is the Schematic Rebuild mode (should be called Schematic Edit mode...). See the wiki here for more details: https://github.com/maruohon/litematica/wiki/schematic_editing
  • Q: Is there a printer like in Schematica?
  • A: 1.) There is no printer for survival, and it's not planned for Litematica itself. There are at least two separate extension mods to add a printer. See: https://github.com/aria1th/litematica-printer or https://github.com/aleksilassila/litematica-printer
    2.) For Creative mode there is the Paste Schematic in world tool mode, which places the entire schematic at once in a single player world, or using setblock commands in multiplayer.
  • Q: I get an error "Failed to load schematic" when trying to load a '*.schematic' file in 1.13+.
  • A: 1.) The 1.13 - 1.16 versions of Litematica can't currently load the Sponge schematic format yet. That format is used for example by World Edit in 1.13+. Although those schematics should preferably be named with the *.schem file name extension, many web sites use the *.schematic extension, which makes them hard to tell apart from the old, completely different MCEdit/Schematica format, which Litematica can already load. Full support for the Sponge format exists in the main development version in 1.12.2, and a "quick hax" temporary support for just loading that format also exists in the 1.17+ mod versions. It will also come to the other versions with the next bigger update.
    2.) Currently the way to load Sponge schematics with Litematica is:

The mod is still under development, and some of the planned "extra" features (for example some of the "tool modes") haven't yet been implemented fully or at all.



Here is a Reddit post that explains the very basics of the mod:
https://old.reddit.com/r/Minecraft/comments/cqdmkk/anyone_can_help_me_how_do_i_make_schematics_with/exeug78/

Here are some tutorial videos for the basics of the mod. A more detailed, "official" tutorial video is planned after I finish some changes and still missing features I'm still working on for the mod.

A short, quick tutorial of the basics of the mod:


Another, a bit longer tutorial that also covers some other things like the Rebuild mode:


A couple of more tutorials:



If you have questions or need help with something, the best/fastest way to get answers is on my Discord server.
0XvKswp.png

Description

Litematica is a modern schematic mod primarily targeting light mod loaders like LiteLoader on MC 1.12.x, Rift on MC 1.13.x and Fabric on MC 1.14+.

There is also a Forge version, but currently only for MC 1.12.2. For later MC versions there are currently only third party ports such as Forgematica.

Litematica has all the main features (plus a bunch more) of the old Schematica mod, except for the printer, which is not planned for Litematica itself, but instead is left to extension mods (see: aria1th printer or the other printer).

Compatibility with shaders

Litematica's rendering doesn't currently work properly with shaders (even with Iris) in 1.21.3+. So when you need to use Litematica (schematic rendering), disable shaders.

In older MC versions the rendering works better with shaders, at least with Iris, but also depending on the shader pack. Some shader packs break the rendering pretty badly, but some used to work pretty nicely. Optifine in general is/was a lot more problematic, pretty much you can't use shaders at all with Optifine if you use Litematica. The general recommendation is to use Sodium (and Iris) instead of Optifine.

Hotkeys

The default hotkey to open the Litematica main menu is M.

Note: If you use a non-QWERTY keyboard layout, then the keys may be different, such as M becoming , on AZERTY.

Other common default hotkeys:
  • M + C - The direct hotkey to open the config menu
  • M + R - Toggle ON/OFF ALL rendering from Litematica
  • M + G - Toggle ON/OFF just schematic rendering ("ghost blocks" - all HUDs for example will still render)
  • M + T - Toggle ON/OFF the "tool item" (which is by default a stick) functionality
  • M + P - Directly open the Schematic Placements menu/list
  • M + V - Open the Schematic Verifier menu
  • Numpad minus - Open the placement configuration menu for the currently selected placement
  • Numpad multiply - Open the Area Editor menu
  • Page Up/Down - Change the selected layer in the render layers settings
  • M + Page Up/Down - Change the render layers mode
  • Ctrl + scroll (holding the tool) - Cycle the "tool mode" (there is also a button for this in the lower left corner of the main menu)
  • Alt + scroll (holding the tool) - Nudge/move the selected placement or area selection box or corner (depending on the tool mode) in the direction the player is looking at
  • Ctrl + M - Toggle or cycle the "sub-mode" or main setting of some of the "tool modes", such as pasteReplaceBehavior in Paste mode, the Corners vs. Expand behavior in Area Selection mode, or the Area vs. Placement behavior of the Delete mode

Warning for multiplayer

The Easy Place mode feature may get you banned on some servers!

The Easy Place feature will always be clicking on the target position's air block, and this can easily be detected by anti-cheat systems. So this can result in at least two things: The block placement will just be rejected and you just get client-side ghost blocks, or some anti-cheat system flags that as cheating and auto-bans you from the server. So before using Easy Place, find out of it's allowed on the server!

If you have Optifine...

In general I don't recommend using Optifine (with Litematica, or otherwise) due to the various rendering issues it causes. Instead I would recommend using Sodium and/or Iris if you want shaders.

If you have Optifine installed, then there are some options that you most likely will need to disable in Optifine, or otherwise it will break the schematic rendering:

  • If you get glitchy weird triangles, then in 1.16+ first try updating to the latest Litematica version. If that doesn't work, then set shaders to OFF (not Internal) and restart the game.
  • Render Regions probably needs to be disabled to prevent weird rendering issues (the schematic partially rendering in weird places)
  • Fast Render might also need to be disabled if there are still some weird HUD/GUI rendering issues

Documentation

There is a wiki. The wiki is still being worked on, and it will probably have a new address at some point (or rather there will be a new wiki in a new location with a lot more coverage).

Other/older documentation and explanations, some FAQ answers

Here is a Reddit post that explains the very basics of the mod:

Litematica - Easy Place support on servers

Misc explanations on Reddit or my Discord server

Schematic format conversions:

Litematica Normal selection mode with sub-regions:

Litematica - hiding an area selection:

Litematica - can't create new selection sub-regions (in Simple mode):

Litematica - Normal/Multi-Region area selection tutorial:

Litematica - Easy Place on a server with FabricCarpet but no CarpetExtra:

Litematica - easy/fast selections tutorial:

Litematica - schematic formats:

Litematica - saving and pasting with block entity data:

Litematica - Material Lists variants:

Litematica - Manual Origin issue:

Litematica - placing stairs correctly:

Litematica - performance tips with large schematics:

Litematica - large schematics, bad performance or crashes, what to do:

Litematica - how to only show one block type at a time:

Litematica not working/keys not working:

Litematica "only render one block":

Litematica - finding the schematics directory/game directory:

Litematica - using sub-regions:

Litematica - pasting redstone on servers:

Litematica - pasting inventory contents on servers, feat. Litemoretica:

Litematica - paste task not running + somewhat comprehensive mspt and profiling quick howto:

Litematica - schematic placement explained:

Litematica - material list:

Litematica - performance tips with large schematics:

Litematica - no schematics directory in the .minecraft directory:

Litematica "not working" (not in Controls) -> F3, malilib keys, Mod Menu:

World Edit pasting:

MacOS how to go up one directory:

Youtube tutorials

Here are some of the better Youtube tutorial videos I've come across.

Youtube tutorials

Screenshots

Gallery

  • Litematica - Schematic Verifier overlay
    Litematica - Schematic Verifier overlay The Schematic Verifier overlay, highlighting the currently selected mismatches in-world, and showing the locations of the closest problems on the HUD
  • Litematica - Schematic Verifier GUI
    Litematica - Schematic Verifier GUI The Schematic Verifier GUI, listing all the mismatches in the world compared to what the schematic expects.
  • Litematica - Material List HUD
    Litematica - Material List HUD The Material List HUD, showing the still missing (from the player's inventory) items, reducing the need to re-open the Material List GUI all the time
  • Litematica - Material List GUI
    Litematica - Material List GUI The Material List GUI showing the total, still unplaced and available number of items
  • Litematica - Schematic overlay
    Litematica - Schematic overlay The colored schematic overlay indicating the missing, extra and wrongly placed blocks
  • Litematica - All Below rendering mode
    Litematica - All Below rendering mode Schematic rendering in the All Below rendering mode
  • Litematica - Single layer mode
    Litematica - Single layer mode Schematic rendering in the Single Layer rendering mode
  • Litematica - Schematic rendering
    Litematica - Schematic rendering Schematic rendering
  • Material List Screen
    Material List Screen
  • Material List HUD
    Material List HUD A "shopping list" material list HUD in the bottom right of the screen
  • Schematic Verifier Screen
    Schematic Verifier Screen
  • Schematic Verifier Highlights
    Schematic Verifier Highlights The in-world highlights of selected verifier errors, and the position info HUD

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

1
Ratings
0
Followers
1
In stacks

By the numbers

Statistics

33.8m
Total Downloads
CurseForge
13.4m
Modrinth
20.4m
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched and imported data for this project from CurseForge or Modrinth. High-traffic and active projects are checked more often.
Next pipeline sync