Schematic Printer 2.0.0

Minecraft 1.20.1 | Forge 47.x

This is the first release since 1.4.2. Every command and setting from 1.4.2 is still here. Existing config files and supported schematic formats still work.

Requirements

• Minecraft 1.20.1 with Forge 47.x
• The mod has to be on the server. In singleplayer, the same jar is enough.
• The client install is optional. You only need it for the catalog GUI and the 3D preview. Vanilla clients can join and use every command.

Catalog GUI

Open the catalog with K (this key is rebindable) or /schematic gui. A player without the mod on the client gets a chat hint instead.

The left side lists your schematics. You can search and sort them. Each row shows the name, format, size, and block count.

The right side is a 3D preview. Drag to rotate, and scroll to zoom. Large previews are built as a mesh on a background thread, and the panel shows "Building preview N%" while that runs. Faces hidden behind other blocks are skipped, so big builds stay readable. A bug that made blocks look hollow is fixed. The preview was flipping an extra axis, which showed the inside of each block.

You can run most of a print from the GUI:

• Pick the print location with X, Y, and Z boxes, Me (where you stand), or Aim (the block face you look at, up to 128 blocks). Set saves the location. Clr clears it.
• Choose a rotation: facing, 0, 90, 180, or 270.
• Pre-clear clears the area the schematic would occupy.
• Print, By layer, Ghost, pause, resume, next layer, and cancel are all in the catalog. Print and Ghost include the position and rotation you picked.

Every button runs the matching /schematic command on the server, with your permissions and the same chat feedback.

Print paths

/schematic path still has layer (the default), snake, spiral, and radial. These options are also available:

• bottomup: the same order as layer, under a clearer name
• topdown: starts at the top layer and works down
• centerout: grows outward from the middle of the build in every direction
• growth (also called groundgrowth or footprint): lays the whole footprint first, then builds up
• sheets: fills each layer in a zigzag, along the other axis from snake
• jitter: a random order. /schematic path jitter seed <number> repeats the same pattern

Two toggles work with any path:

• /schematic path fluidslast on places water and lava after everything else
• /schematic path skipair on|off (on by default). Turning skip-air off is accepted, but the file readers still drop air when a schematic is loaded, so this does not place air gaps yet

Auto print, /schematic nextblock, and /schematic nextlayer follow the chosen path.

Survival materials

Off by default. With nothing changed, prints behave as they did in 1.4.2.

/schematic survival on makes your next print pay for blocks with items. It spends from your inventory and offhand first, then shulker boxes you are carrying, then containers within range (chests, barrels, placed shulkers, hoppers, and other storage that exposes an item handler). Renamed, enchanted, or otherwise NBT-tagged stacks are never spent.

If you run out, the print pauses and lists the top missing items. It retries every 2 seconds and continues once the items are there. /schematic resume retries immediately. /schematic materials lists what the rest of the print still needs.

A server can require this for every survival print with the [survival] config keys requireMaterials and containerRadius. Survival players also need general.requireCreativeMode set to false, or they cannot run /schematic.

Large files

Schematic files are read and decoded off the server thread, so a large load no longer freezes the server, players, or mobs. You see Loading <file>... in chat right away, and the action bar shows progress. /schematic cancel and logging out stop a load. A second print while one is already loading is refused.

The default size cap is 5 million blocks (the whole bounding box, including air). The file-size cap is max_schematic_file_mb (default 64). Operators can raise either cap with /schematic config. For city-sized builds, about 25 million blocks fits a server with 2 GB of memory. The maximum is 50 million, which needs about 4 GB.

Speed

/schematic speed with no active print now sets your own speed for the next print or clear, still capped by the server master. It no longer changes the server-wide master. Console speed and /schematic masterspeed still set the master.

Changing speed mid-print applies to the running task. This also works from the catalog Speed option.

If an earlier test build lowered masterBlocksPerTick in the config, set it back once with /schematic masterspeed 1500 or /schematic config set masterBlocksPerTick 1500.

Config command

Operators (permission level 2) can change limits in game:

• /schematic config or /schematic config list lists every key, its value, default, and range
• /schematic config get <key> shows one key
• /schematic config set <key> <value> checks the range, applies the value immediately, and saves it to schematicprinter.toml

Creative players who are not operators cannot use this command.

Other changes

• Vanilla clients can join a server that has this mod. Ghost preview tells a vanilla player that it needs the mod installed.
• If you log out, a paused print or a step-by-step print (printlayer or printblock) is canceled. A running automatic print keeps going and finishes on its own, as in 1.4.2.
• Operators at permission level 2 can use print commands in survival. Survival players who are not operators are still blocked when creative mode is required.
• Litematica .litematic files and WorldEdit 7.3+ Sponge v3 .schem files load and print, including multi-region Litematica files.

Known limits

• /schematic path skipair off does not place air yet, because the file readers drop air when they load a schematic.
• The catalog preview cap stays at 100,000 blocks (maxPreviewBlocks).
• Very large prints can still hitch when they load new chunks.