Configuration — Litematica Wiki

Get the files on 9Minecraft

Option	What it does
`areaSelectionBoxSideColor`	Sets the color of unselected area selection box sides
`hightlightBlockInInventoryColor`	Sets the highlight color for the looked-at block's item in inventory
`materialListHudItemCountsColor`	Sets the color of item counts shown in the Material List HUD
`schematicOverlayColorDiffBlock`	Sets overlay color for different blocks of matching predefined types
`schematicOverlayColorExtra`	Sets the overlay color drawn on extra blocks not present in the schematic
`schematicOverlayColorMissing`	Sets the overlay color drawn on blocks missing from the world
`schematicOverlayColorWrongBlock`	Sets the overlay color drawn on blocks that are entirely wrong
`schematicOverlayColorWrongState`	Sets the overlay color drawn on blocks with incorrect block states
`schematicRebuildBreakExceptPlaceOverlayColor`	Sets overlay color for break-all-except-targeted blocks in rebuild mode
`schematicRebuildBreakPlaceOverlayColor`	Sets overlay color for break-or-place selector in rebuild mode
`schematicRebuildReplaceOverlayColor`	Sets overlay color for the replace selector in rebuild mode
`toolItemComponents`A Data Components-aware version of toolItem. Set to "empty" to disable. The syntax accepted is the same as the "/give" c	Sets the item components required on the tool item
`placementManagerProfile`Adjust the Placement Manager Thread performance metrics as follows: MAX - 32 tasks per cycle (20ms yield, 2048 deferred	Selects the placement manager performance profile
`areaSelectionsPerWorld`	Stores area selections per-world or per-server instead of globally
`signTextPaste`Automatically set the text in the sign GUIs from the schematic	Enables pasting text onto signs
`pickBlockAvoidDamageable`Avoids replacing any damageable items in the hotbar	Avoids picking items with durability damage
`pickBlockAvoidTools`Avoids replacing any tool items in the hotbar. This means any items that extend the vanilla ToolItem class.	Avoids picking tool items when pick blocking
`betterRenderOrder`	Injects schematic rendering into vanilla rendering code for better render order
`itemUsePacketCheckBypass`Bypass the new distance/coordinate check that was added in 1.18.2. That check breaks the "accurate placement protocol" a	Bypasses the 1.18.2 distance check that breaks accurate placement protocol
`debugHudMode`Change the behavior of the Debug Information that is displayed under the F3 screen for the Litematica World Renderer. [§	Changes what debug info the Litematica world renderer shows under F3
`changeSelectedCornerOnMove`	Sets the selected corner to the last moved corner when setting corners
`cloneAtOriginalPosition`	Creates clone placements at the original area selection position instead of the player
`commandDisableFeedback`	Disables then re-enables command feedback around multiplayer Paste, Fill and Delete
`commandFillMaxVolume`	Sets the maximum volume of each box filled via command-based Fill/Delete
`commandFillNoChunkClamp`	Stops fill/replace/delete volumes from being split into per-chunk boxes
`commandLimitPerTick`	Sets the maximum number of commands sent per game tick on servers
`commandNameClone`	Sets the clone command name used for command-based creative mode on servers
`commandNameFill`	Sets the fill command name used for command-based creative mode on servers
`commandNameSetblock`	Sets the setblock command name used for command-based creative mode on servers
`commandNameSummon`	Sets the summon command name used for command-based creative mode on servers
`commandTaskInterval`	Sets the tick interval at which Paste, Fill and Delete tasks execute
`commandUseStrict`	Uses the strict parameter in fill, setblock, and clone commands
`commandUseWorldEdit`	Uses WorldEdit //pos1, //pos2 and //set commands instead of configured setblock/fill commands
`translationMode`Configure the Translation 'Mode' to be used. Follow Vanilla, Follow MaLiLib, Independent, or OFF.	Sets how schematic translations are performed
`customSchematicBaseDirectory`	Sets the root schematic directory used when the custom base directory is enabled
`customSchematicBaseDirectoryEnabled`	Uses the customSchematicBaseDirectory setting as the root schematic directory
`datafixerDefaultSchema`	Sets the default schema value for the vanilla data fixer
`datafixerMode`	Sets the data fixer level applied to loaded schematics, affecting load performance
`deduplicateSchematicEntities`De-Duplicate any matching entities loaded into the Schematic World. The current code tries to spawn the entities with th	Removes duplicate matching entities loaded into the schematic world
`debugHudPMThreads`	Shows the placement manager thread daemon debug line on the F3 screen
`debugHudWorld`	Shows the schematic world debug line on the F3 screen
`debugLogging`	Prints extra debug messages to the console for troubleshooting issues
`displayFileOpsFeedback`Display file operation confirmation feedback. Example: Deleting a file will display a message confirming that the op	Shows a chat confirmation message after file operations like deleting
`easyPlaceMode`	Using an item on a schematic block places that block at that position
`easyPlaceClickAdjacent`	Uses 1.12.2 ornithe Clicks Adjacent code, requiring easyPlacePostRewrite enabled
`easyPlaceFirst`	Toggles Easy Place First mode on or off
`easyPlaceHoldEnabled`	Lets you hold the use key and look at schematic blocks to place them continuously
`easyPlacePostRewrite`	Makes Easy Place use the experimental 1.12.2 ornithe Post-Rewrite code
`easyPlaceProtocolVersion`	Chooses which accurate placement protocol Easy Place uses
`easyPlaceSinglePlayerHandling`	Handles Carpet mod Accurate Block Placement Protocol itself in single player
`easyPlaceSinglePlayerValidation`	Validates blocks placed by Easy Place in single player
`easyPlaceSwapInterval`	Sets milliseconds Easy Place waits after swapping slots before placing
`easyPlaceSwingHand`	Swings the player's arm animation when Easy Place places a block
`easyPlaceVanillaReach`	Reduces easy place reach to vanilla distance so servers accept far placements
`fixChestMirror`Enable a fix to the broken chest mirror code in vanilla	Fixes vanilla's broken chest mirroring when pasting mirrored schematics
`fixGlazedTerracottaMirror`Enable a fix to the glazed terracotta mirror code in vanilla; This code attempts to help keep the patterns aligned.	Fixes vanilla glazed terracotta mirroring to keep patterns aligned
`materialListContainerScanBundles`Enable including Bundles in the scan while using materialListContainerScan	Enables scanning bundles for materials in the material list
`materialListContainerScanShulkers`Enable including Shulker Boxes in the scan while using materialListContainerScan	Enables scanning shulker boxes for materials in the material list
`translationTryBaseLanguage`Enable tracking MaLiLib's configured language. Leave this disabled to customize Litematica's language independently. Y	Tries the base language when the target translation is unavailable
`enableDifferentBlocks`	Shows a "Different Blocks" status in the wrong block verifier for mismatched blocks
`pickBlockIgnoreNbt`Enables the "pickBlockIgnoreNbt" setting for Easy Place Post-Rewrite from 1.12.2 ornithe.	Ignores NBT data when matching blocks for pick block
`pickBlockEnabled`Enables the schematic world pick block hotkeys. There is also a hotkey for toggling this option to toggle those hotkeys.	Toggles the pick block feature on or off
`entityDataSync`	Uses the Servux Entity Data Sync protocol to obtain entity data from the server
`entityDataSyncBackup`	Uses vanilla NBT Query when Servux is unavailable, requiring operator privileges
`entityDataSyncCacheTimeout`	Sets how many seconds the Entity Cache keeps records before refreshing
`entityDataSyncLoadNbt`	Loads synced NBT data into the client world, may conflict with other mods
`executeRequireHoldingTool`	Requires holding the tool item to run the execute hotkey
`fixRailRotation`	Applies a fix for vanilla rail bugs with 180 degree rotations of straight rails
`fixStairsMirror`	Applies a fix for vanilla stair shape bugs when mirroring stairs
`generateLowercaseNames`	Makes suggested schematic names lowercase with underscores instead of spaces
`highlightBlockInInventory`	Highlights the looked-at schematic block's item in inventory, including shulker boxes
`reverseOperationModeDirection`If enabled, reverses the scroll direction used for cycling through operation modes while holding the operation mode chan	Reverses the direction used by reverse operation mode
`pasteIgnoreBlockEntitiesFromFill`If enabled, then all block entities are ignored from the fill commands when pasting. This allows them to get pasted indi	Ignores block entities from fill commands during paste so they paste individually
`pickBlockShulkers`If enabled, then if the required item for the pick block is not found directly in the player's inventory, but there is a	Allows pick block to target items inside shulker boxes
`pasteToMcFunctionFiles`If enabled, then instead of actually pasting schematics to the world, they are written as setblock commands into text fi	Writes paste operations to mcfunction files instead of executing
`pasteUseFillCommand`If enabled, then instead of only using individual /setblock commands, the command-based Paste operation (which is used o	Uses the /fill command for faster pasting
`pasteIgnoreCommandLimitWithNbtRestore`If enabled, then the command limit is ignored when pasting blocks with a block entity with the NBT restore option enable	Allows NBT restore to bypass the command block limit
`pasteIgnoreEntities`If enabled, then the Paste feature will not paste any entities	Prevents entities from being pasted into the world
`toolItemEnabled`If true, then the "tool" item can be used to control selections etc.	Toggles whether the configured tool item is required for selections
`loadEntireSchematics`If true, then the entire schematic is always loaded at once. If false, then only the part that is within the client's vi	Loads the entire schematic at once instead of only the visible portion
`layerModeFollowsPlayer`If true, then the render layer follows the player. Note: This currently collapses Layer Range type ranges unfortunately	Makes the render layer follow the player's position
`recipeBookSinglePlayerShadowUnlock`In Single Player, unlock the full Server Recipe Book for the player to improve the Raw Material List output results. Thi	Unlocks shadowed recipe book entries in singleplayer
`serverNbtRequestRate`Limit request rate for server entity data syncer	Sets the rate of NBT data requests to the server
`materialListContainerScan`	Enables scanning containers for materials in the material list
`materialListCountEnderCache`	Counts items in the ender chest cache for the material list
`materialListIgnoreState`	Ignores exact block state in the material list, matching only block type
`materialListRecipeDetails`	Adds debug-level recipe details to the Raw Materials export of the material list
`pasteAlwaysUseFill`	Forces using the fill command even for single blocks
`pasteAlwaysUsePersistent`	Forces pasted leaves to be persistent so they do not decay
`pasteLayerBehavior`	Sets how rendered layers behave during Paste tool mode
`pasteNbtRestoreBehavior`	Chooses whether and how block NBT data is restored when pasting
`pasteReplaceBehavior`	Sets how existing blocks are replaced during Paste tool mode
`pasteUsingCommandsInSp`	Enables command-based pasting in singleplayer
`pasteUsingServux`	Uses Servux to paste schematics directly to the server, faster than commands
`pickBlockableSlots`	Sets which hotbar slots can be used for schematic pick block
`placementRestriction`	Restricts using the use key to only when holding the correct item for the target
`placementManagerThreadCount`	Sets the max number of placement manager threads
`placementReplaceBehavior`	Sets block replace behavior when adding blocks to the schematic world
`placementRestrictionWarn`	Selects the warning message shown when placement is restricted
`renderThreadNoTimeout`Removes the timeout from the rendering worker threads. If you get very stuttery rendering when moving around or dealing	Removes the timeout from rendering worker threads
`renderMaterialListInGuis`	Toggles whether the material list is drawn inside GUIs
`schematicVcsDeleteMode`	Sets the deletion mode for removing the previous schematic version in Schematic VCS
`selectionCornersMode`	Chooses whether area selection corners use Corners or Expand mode
`translationLanguage`Set Litematica's language independently of Minecraft's Language setting. Requires MaLiLib's translationOverrides to	Sets the target language used for schematic translations
`toolItem`The item to use as the "tool" for selections etc.	Sets the item used as the tool for selections and similar actions
`unhideSchematicVCS`Un-hides the Schematic VCS (Version Control System) menu button, and enables the hotkey and the VCS functionality in gen	Un-hides the Schematic VCS menu button and enables its hotkey and functionality
`renderOverlayThroughBlocks`A hotkey to allow the overlays to render through blocks. This is just a quicker way to temporarily enable the same thing	Toggles whether overlay boxes render through solid blocks
`schematicEditReplaceSelection`A hotkey to copy the blocks in the world within the area selection into the litematic. This feature was requested to be	Replaces blocks within the current selection
`schematicVersionCycleNext`A hotkey to cycle to the next schematic version in the Version Control tool mode	Cycles to the next schematic version
`schematicVersionCyclePrevious`A hotkey to cycle to the previous schematic version in the Version Control tool mode	Cycles to the previous schematic version
`pickBlockToggle`A hotkey to toggle the pick block toggle option in the Generic configs. This is provided as a quick way to enable or dis	Toggles pick block behavior between first and last match
`togglePlacementRestriction`A hotkey to toggle the placement restriction mode	Enables or disables the placement restriction that limits where blocks can be placed
`schematicVCSDeleteBlockByPlacement`A key to delete blocks from the world based on the currently selected version's placement. See Generic -> 'schematicVcsD	Deletes schematic blocks by placement in version control
`pickBlockFirst`A key to pick block the first schematic block ray traced to	Sets the pick block key to pick the first matching block
`pickBlockLast`A key to pick block the last schematic block ray traced to, before the first (possible) client world block ray traced to	Sets the pick block key to pick the last matching block
`addSelectionBox`Add a new selection box (position 1) here	Adds a new selection box at the current position
`toggleAllRendering`All Rendering	Toggles all Litematica rendering on or off
`easyPlaceToggle`Allows quickly toggling on/off the Easy Place mode	Hotkey to toggle Easy Place mode
`selectionModeCycle`Change the corner mode between Corners and Expand in the Area Selection mode	Cycles through the area selection modes
`cloneSelection`	Clones the current area selection into an in-memory schematic
`layerModePrevious`Cycle the rendering mode (all, layers) backwards	Cycles the rendering mode (all, layers) backwards
`layerModeNext`Cycle the rendering mode (all, layers) forward	Cycles the rendering mode (all, layers) forward
`deleteSelectionBox`Delete the currently selected box	Deletes the currently selected selection box
`easyPlaceUseKey`	Sets the key used to place blocks when easy place mode is enabled
`executeOperation`Execute the currently selected tool operation with the current selection or placement in the Fill, Replace, Paste Schema	Executes the selected tool operation with the current selection or placement
`rerenderSchematic`Hotkey to refresh/redraw only the schematic, instead of having to refresh the vanilla terrain too with F3 + A	Forces a re-render of the schematic rendering
`toggleInfoOverlayRendering`Info Overlay Rendering	Toggles rendering of the hovered block info overlay on or off
`invertGhostBlockRenderState`	Inverts schematic/ghost block rendering status while the keybind is held down
`invertOverlayRenderState`	Inverts overlay rendering status while the keybind is held down
`layerNext`	Moves the rendered layer selection up by one layer
`layerPrevious`	Moves the rendered layer selection down by one layer
`layerSetHere`	Sets the render layer to the player's current position
`schematicEditBreakPlaceAll`Modifier key to activate the "break all identical blocks" function in the Schematic Edit tool mode	Breaks and places all blocks in the selection
`schematicEditBreakAllExcept`Modifier key to activate the "break everything except" mode/function in the Schematic Edit tool mode. Basically when you	Breaks all schematic blocks except the targeted block type
`schematicEditReplaceAll`Modifier key to activate the "replace all identical" replace mode/function in the Schematic Edit tool mode	Replaces all blocks of one type with another
`schematicEditReplaceBlock`Modifier key to activate the "replace block type" replace mode/function in the Schematic Edit tool mode	Replaces the targeted block type in the schematic
`schematicEditBreakPlaceDirection`Modifier key to activate the directional/continuous break or place function in the Schematic Edit tool mode	Sets the direction for break/place schematic editing
`schematicEditReplaceDirection`Modifier key to activate the directional/continuous replace mode/function in the Schematic Edit tool mode	Sets the direction for replace schematic editing
`moveEntireSelection`Move the entire current selection here	Moves the entire current selection to the player's position
`nudgeSelectionNegative`Nudge the current selection in the "negative" direction This is basically the same as mouse wheel down with the Nudge mo	Nudges the current selection in the "negative" direction
`nudgeSelectionPositive`Nudge the current selection in the "positive" direction This is basically the same as mouse wheel up with the Nudge modi	Nudges the current selection in the "positive" direction
`openGuiSelectionManager`Open the Area Selection manager GUI	Opens the Area Selection manager GUI
`openGuiAreaSettings`Open the Area Settings GUI for the currently selected area	Opens the Area Settings GUI for the currently selected area
`openGuiSettings`Open the Config GUI	Opens the Config GUI
`openGuiMainMenu`Open the Litematica main menu	Opens the Litematica main menu
`openGuiLoadedSchematics`Open the Loaded Schematic GUI	Opens the Loaded Schematic GUI
`openGuiMaterialList`Open the Material List GUI for the currently selected schematic placement	Opens the Material List GUI for the currently selected schematic placement
`openGuiPlacementSettings`Open the Placement Settings GUI for the currently selected placement or sub-region	Opens the Placement Settings GUI for the currently selected placement or sub-region
`openGuiSchematicPlacements`Open the Schematic Placements GUI	Opens the Schematic Placements GUI
`openGuiSchematicProjects`Open the Schematic Projects GUI	Opens the Schematic Projects GUI
`openGuiSchematicVerifier`Open the Schematic Verifier GUI for the currently selected schematic placement	Opens the Schematic Verifier GUI for the currently selected schematic placement
`operationModeChangeModifier`	Modifier key used to change the operation mode
`toggleOverlayOutlineRendering`Overlay Outline Rendering	Toggles rendering of the block overlay outline on or off
`toggleOverlayRendering`Overlay Rendering	Toggles rendering of the block overlay on or off
`toggleOverlaySideRendering`Overlay Side Rendering	Toggles rendering of the block overlay sides on or off
`togglePlacementBoxesRendering`Placement Boxes Rendering	Toggles rendering of schematic placement boxes on or off
`renderInfoOverlay`	Toggles rendering of the info overlay text on screen
`saveAreaAsSchematicToFile`Save the current Area Selection as a Schematic to a file	Saves the current area selection as a schematic file
`saveAreaAsInMemorySchematic`Save the current Area Selection as an in-memory Schematic	Saves the current area selection as an in-memory schematic
`toggleSchematicBlockRendering`Schematic Block Rendering	Turns rendering of schematic blocks on or off
`toggleSchematicRendering`Schematic Rendering	Turns rendering of the schematic overlay on or off
`schematicPlacementMirror`	Mirrors the schematic placement along an axis
`schematicPlacementRotation`	Rotates the schematic placement by 90-degree steps
`schematicVersionCycleModifier`	Modifier key for cycling schematic versions
`selectionGrabModifier`	Modifier key for grabbing the selection
`selectionGrow`	Grows the current area selection outward
`selectionGrowModifier`	Modifier key for growing the selection
`selectionNudgeModifier`	Modifier key for nudging the selection
`selectionShrink`	Shrinks the current area selection inward
`setSelectionBoxPosition1`Set the first position of the currently selected box to the player's position	Sets the first corner position of the current selection box
`setSelectionBoxPosition2`Set the second position of the currently selected box to the player's position	Sets the second corner position of the current selection box
`setAreaOrigin`Set/move the origin point of the current area selection to the player's position	Sets the corner block that defines the origin point of the current area selection
`toggleSignTextPaste`Sign Text Paste	Enables or disables pasting sign text from the schematic
`toolSelectElements`The button to use to select corners or boxes while holding the "tool" item	Selects elements under the cursor with the tool
`toolPlaceCorner1`The button to use while holding the "tool" item to place the primary/first corner	Sets the first corner position for the area selection tool
`toolPlaceCorner2`The button to use while holding the "tool" item to place the second corner	Sets the second corner position for the area selection tool
`toolEnabledToggle`The keybind to toggle the "tool" item functionality on/off	Toggles whether the currently held tool is active
`toolSelectModifierBlock1`The modifier key to hold while using the 'toolSelectElements' hotkey, to select the primary block type to use in some of	Sets the first modifier block for the tool selection
`toolSelectModifierBlock2`The modifier key to hold while using the 'toolSelectElements' hotkey, to select the secondary block type to use in some	Sets the second modifier block for the tool selection
`toggleAreaSelectionBoxesRendering`Toggle Area Selection boxes rendering on/off	Toggles rendering of area selection boxes on or off
`toggleVerifierOverlayRendering`Toggle the Schematic Verifier overlay rendering	Turns the verifier overlay highlighting incorrect blocks on or off
`toggleTranslucentRendering`Toggle translucent vs. opaque ghost block rendering	Toggles translucent rendering mode for schematic blocks
`unloadCurrentSchematic`	Unloads the schematic of the currently selected placement,and thus also removes all placements created from it
`statusInfoHudAuto`Allow automatically momentarily enabling the status info HUD "when needed", for example when creating a placement and ha	Automatically shows the status info HUD when needed, such as creating placements
`blockInfoOverlayEnabled`Block Info Overlay Rendering	Turns the block info overlay rendering on or off
`blockInfoLinesAlignment`	Sets the alignment of the block info lines on screen
`blockInfoLinesEnabled`	Enables or disables individual block info lines
`blockInfoLinesFontScale`	Sets the font scale of the block info lines
`blockInfoLinesOffsetX`	Sets the horizontal offset of the block info lines
`blockInfoLinesOffsetY`	Sets the vertical offset of the block info lines
`blockInfoOverlayAlignment`	Sets the alignment of the block info overlay on screen

Other settings in this file

2 more options the mod ships without its own description. Names are taken straight from the config file.

pasteIgnoreInventoriesDon't paste inventory contents when pasting a schematic
pasteIgnoreBlockEntitiesEntirelyIf enabled, then block entities are not pasted at all via the command-based pasting in multiplayer. This allows you to e