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 also planned), 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
About Forge ports for 1.14.4+
Forge versions for 1.14.4 and later (possibly only for 1.16.5+) are planned.
Still no ETA about 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. I have one build of that available here: https://masa.dy.fi/tmp/minecraft/mods/misc_test_versions/unsupported_temporary_forge_1.16.5/
Some more info and discussion about the Forge port/builds is here: https://github.com/maruohon/litematica/issues/234
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 (at least at times) versions of my mods available for the latest Minecraft snapshots here: https://masa.dy.fi/mcmods/client_mods/
That page also often includes newer development builds than what is available here on CurseForge.
If you encounter bugs, then try to update all the mods (from the ones that you use) from that page to see if the issue has been fixed already.
(There are at times changes in malilib or the dependent mods that require both malilib and the mods to be updated at the same time!)
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 yet. It is on my TODO-list and will be added at some point.
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+ versions of Litematica can't currently load the new 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. Support for the Sponge format already exists in the main development version in 1.12.2, and it will come to the other versions with the next bigger update.
2.) Currently the way to load Sponge schematics with Litematica is:
- Create a temporary (flat) world.
- Place the schematic there using World Edit (quick guide: https://old.reddit.com/r/Minecraft/comments/kt2znv/convert_schem_file_to_litematic_file/gilwla8/)
- Make a new Litematica schematic from the placed structure from that world
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.
Currently it has everything else Schematica had, except the "full/automatic" printer hasn't been implemented yet, but it's on my TODO-list.
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 currently the #masas-mods channel on the SciCraft Discord server.
I need help, I love this mod it's very useful but I did something and I don't know how to undo it. In the bottom right corner of my screen, it says "save schematic, missing chunks (1) what do I need to do
CX: -3, CZ: 48 (x:-48, z:768)"
In reply to W0lfyXBL:
It means some of the chunks in your area selection are not loaded on your client. You would need to move around closer to those chunks to load them, so that the mod can see what is in those chunks, to save the schematic.
Or if you want to cancel making the schematic, you can remove that saving task via the Task Manager menu in Litematica.
for some reason the executeoperation command doesnt work for 1.17.1 fabric litematica. has anyone else had this issue I have messed around with the settings making it a setblock command instead of the normal, all the chunks are loaded its a small build. please shoot me a message if you have feedback please!
In reply to deals4you1:
I'm assuming you are trying to use the Paste feature? By default you need to be holding the "tool item" for the executeOperation hotkey to work. Basically when you see the tool HUD text on the bottom left, then it should be "operational". Two things can disable it: the main rendering being disabled (M + R) or the tool item functionality being disabled (M + T), and of course you need to be holding the configured tool item.
In reply to masady:
I made sure both things were enabled, it says paste, missing chunks. and lists a bunch of coordinates. and then just doesn't do anything is there usually a delay. my build is a mapart so its only the size of one regular map so its not that big. and it all fits on my screen so idk why it isnt working. im on creative, and open to LAN while holding the litematica tool under the section paste schematic in world
everything else on litematica seems to mostly work. besides this one feature.
In reply to deals4you1:
If it fails to detect the chunks as being loaded, then it might be a conflict with some other mod. I remember there was some mod that changes the chunk manager in a way that Litematica somehow fails to see the chunks as being loaded in some cases.
The missing chunk coordinates are around where you are though, right? So you don't accidentally have some other placement selected somewhere far away?
In reply to masady: okay so I removed my world edit mod. tried it again it still says the same thing i reset all of the settings to the base settings made sure m + t and m + r is turned on made sure the schematic was right under me with all chunks loaded (yes the missing chunk cords are right where my cords are) made sure i was holding the tool and selected under the right mode and did the execute command and still nothing it pasted it just gives me a list of missing chunks
The only mods in the folder are Litematica-mod-fabric-1.17.1 and malilib-fabric-1.17.1-0.10.0-dev.25 which i believe is required for litematica to work so that shouldn't be the issue.
In reply to deals4you1:
And it doesn't paste any of it? Were you in Open to LAN mode every time? I'm not sure if that would change things, I haven't ever tested my mods in that mode I don't think... Also if that is the file name of the Litematica mod file, then it's not downloaded from here? Download the latest version from here from the Files page/tab to be sure.
In reply to masady:
okay so for some reason that world i was testing the mod on was messed up somehow. I re made a new world and it worked perfectly fine I should've known to try a different world I apologize but no It works. do you know by chance what might prevent it something on the settings on a world?
In reply to masady:
copied this message and edited my last message and put it there i found out the problem. I really appreciate you helping me.
In reply to deals4you1:
Pasting seems to work just fine for me even when opened to LAN, which I didn't really expect to change anything anyway. Can you post a screenshot or a video clip of when you are trying to paste it? Maybe I can spot something there that I'm not thinking of now. And maybe also quickly scroll through the config menus in the video if you make a video clip.
In reply to deals4you1:
Oh whoops just replied to the previous message now before seeing these... I have no idea how a specific world would prevent pasting. I would like to figure that out. Can you send me the schematic, the exact coordinate where you tried to paste it, and if possible, also that world where it happens. Did you try it in different locations within that world? It wasn't outside the normal build height for example?
In reply to masady:
the world wasn't created by me it was a world download from the altitude server. so maybe they had some command prompts blocking it that i didnt know about. but i figured those would be removed since its not apart of the server anymore. its a total of around 26 gb to download if i remember correctly. it was the creative world on altitude where world edit was allowed but had never tried to paste with litematica on there. but if you still want to check out the world and the thing i tried to paste i will gladly send all of the info your way. It was at the normal build height and yeah i tried around 5 different locations. idk if it would be worth your time since any vanilla non server related world it seems to work great. I shouldve been smarter and known that a server might have things installed to block the mod even after its not apart of the server anymore
In reply to deals4you1:
I definitely don't want to download 26 GB of world just for that :D And also it should be unnecessary to download the entire world anyway. It's just that I can't think of anything the world could "do" or contain (configuration wise) that would prevent the paste feature from working in single player. So I'm mostly just curious how that can happen, and only in some specific world on top of everything. It's just a weird mystery atm. Unless it's some weirdness like a data pack that sets the world height to 0 or something... but even in that case it shouldn't interfere with the paste task so that it thinks the chunks are not loaded, in that case it just wouldn't be able to place any blocks in the world, but the task should still run through.
One thing to try to replicate it in a minimal case would be to create a new empty world directory inside the saves directory, and then copy the level.dat file from that server world there, and then create a region directory (assuming this was in the overworld) and copy the 1, 2 or 4 region files you were in (MiniHUD has an info line and a region file border overlay to easily see the region name(s)). That way if it's still reproducable in that case, the world size should be like 5-20 MB when zipped. But you also said you tried to paste it in multiple locations? Or just positions very nearby? And also I kind of doubt it the region files or chunks could somehow cause this. Then again since I have no idea what could cause it, who knows...
In reply to masady:
honestly i wouldn't worry about it your mod works in every world ive used besides the one i got from a server with many commands and rules which specifically target mod cheats. its def gotta be something like that. but i found a work around since it allows world edit to work I just did the //schematic save (name) command for world edit I just paste my schematic with litematica into the world that allows it to paste into then i copy it and turn it into a world edit schematic and paste it in the world that wont allow it. I really appreciate you taking your time to help me and respond.
It appears the latest Paper update has broken EasyPlaceMode for any block with a "facing" tag. My server admin believes this might be the cause from their latest update https://github.com/PaperMC/Paper/pull/6591
In reply to roso4991:
Yes those distance checks likely will cause it to fail. The Easy Place mode encodes the requested block facing or other state into the hit vector x coordinate value, which is not used for anything in vanilla. The only fix from Litematica's side would be to add a separate config option for making the Easy Place mode request the correct block rotation/state, and if that is disabled then it would just place it however it is placed normally, basically just leaving the functionality of allowing easier basic block placement, including placing on air and doing automatic pick block.
In reply to masady:
Is that planned to be added to litematica? It sounds like a nice addition in general.
In reply to roso4991:
I can add that option at some point.
In reply to masady:
That would be awesome, thanks!