Schematic/NBT Printer

Schematic Printer — How to use

Schematic Printer is a server-side Forge mod for Minecraft 1.20.1 that loads a
schematic from disk and places it in the world.

Requirements

• Minecraft 1.20.1
• Forge 47 or newer for Minecraft 1.20.1
• Java 17
• Creative mode, unless requireCreativeMode is disabled in the config

The command permission is also checked. Operators with permission level 2 can
use the commands even when creative mode is required.

Installation

1. Install the matching Forge server or client.
2. Put the Schematic Printer .jar in the mods folder.
3. Start Minecraft once so the mod can create its configuration and
   schematics folder.
4. Copy schematic files into the schematics folder in the server’s working
   directory. On an integrated client, this is the game instance directory.
5. Run /schematic list to confirm that the files were found.

The file name can be entered with or without its extension. The mod searches
for .schematic, .nbt, .litematic, and .schem files.

Basic workflow

1. Stand at the position where the schematic should be placed.
2. Run /schematic list and note the file name.
3. Preview it first:

   /schematic print house.litematic simulate

1. If the preview is correct, print it:

   /schematic print house.litematic

By default, a schematic is placed at the player’s position and aligned to the
player’s facing direction. If a saved location exists, that location is used
instead.

Command reference

All commands use the /schematic root.

Find and choose a location

Coordinates can be absolute or relative Minecraft coordinates, such as
~ ~ ~.

Print schematics

For manual modes, advance the operation with /schematic nextlayer or
/schematic nextblock.

Control an active print

/schematic speed <blocks> affects an active print. Speed profiles use the
values configured in speedControl. A higher value places more blocks per
tick and may increase server load.

Clear an area

Clear operations remove blocks around the player before a print. A print must
not already be active, and the dimensions are limited by the mod configuration
and command argument ranges.

Configuration

Forge stores the common configuration at:

config/schematicprinter.toml

The most useful settings are:

Edit the file while the game is stopped, or use the Forge configuration
screen where available. Make backups before changing speed or size limits on a
server.

Troubleshooting

• No schematics found: Confirm the file is in the instance/server
  schematics folder and has one of the supported extensions.
• File not found: Use the file name shown by /schematic list; include the
  extension if two files have the same base name.
• Command rejected: Check creative mode and operator permissions, then
  review requireCreativeMode.
• Print is too slow or affects the server: Lower the active speed or
  reduce masterBlocksPerTick, the speed profiles, and maxBlocksPerTick.
• A print will not start: Only one print task can be active per player.
  Cancel or finish it before starting another.
• Blocks are missing: Check restrictedBlocks; protected blocks such as
  bedrock, portals, command blocks, structure blocks, and jigsaws are blocked
  by default.

Use /schematic help in game for a compact command list.