Litematica Container Filler

A client-side Litematica extension for automatically filling schematic containers, highlighting container states, replacing required items, and providing practical container tools.

It reads container contents from Litematica schematics and helps fill matching real-world containers such as chests, barrels, shulker boxes, crafters, furnaces, hoppers, dispensers, and more. It is designed for large storage systems, item sorters, crafting stations, map-art boxing, auto-crafting setups, and dense container piles.

Main Features

Schematic Container Filling

• Fills real containers according to the container NBT and slot layout stored in the Litematica schematic.
• Supports one-shot filling: look at a target container and press the fill hotkey.
• Supports Work State: continuously scans nearby containers, queues valid tasks, and fills them automatically.
• Supports crafter slot locking. If materials are missing, the mod still prioritizes required slot locks instead of doing nothing.
• Handles double chests as one connected container.
• Supports Carpet largeBarrels, but it must be enabled manually in the config.
• Configurable fill radius, action delay, safety delay, and state protection.

Container State Highlights

The mod can render container status directly in the world:

• Unfilled
• Partial
• Satisfied
• Overfilled
• Wrong item
• Unknown data
• Unplaced container
• Manually completed
• Manually needs fill

The current renderer uses translucent bodies, top plates, and animated 3D task markers instead of old-style wireframes. Containers currently being filled, queued containers, and missing-material events can also show separate animated markers.

Highlight colors, opacity, task markers, animation FPS limits, render radius, and per-state toggles are configurable. X-ray highlights are disabled by default, and the default highlight render radius is 0.

Item Replacement

Item replacement affects actual filling behavior, not only the material list display.

• Supports global replacement rules.
• Supports per-schematic replacement rules.
• Per-schematic rules take priority over global rules.
• Provides a visual replacement picker.
• Supports exact item data, including custom names, enchantments, and data components.
• Manual rules use source_item_id->target_item_id, for example minecraft:stone->minecraft:cobblestone.
• Custom-name matching is supported, for example minecraft:paper#slot1->minecraft:iron_ingot.
• Replacing an item with minecraft:air makes the filler ignore that item.

Material List Integration

The Litematica material list gets extra container-aware controls:

• Show only building blocks.
• Show only items required inside schematic containers.
• Show blocks and container items together.
• Open the item replacement picker directly from the material list.
• Show replacement markers and tooltips for replaced items.
• Collect missing material-list items from the container you are looking at.

Inventory and Shulker Logistics

• Extracts required items from shulker boxes in the player inventory.
• Supports QuickShulker.
• Provides a simulated right-click mode for other quick-shulker-like mods, depending on whether those mods listen to compatible GUI actions.
• Supports the TakeItOut server-side protocol; the client-side TakeItOut mod is not always required.
• Can treat shulker boxes with different colors as compatible if their contents match.
• Orderly item storage replaces the old automatic inventory-space freeing logic: items are returned to source shulkers or matching shulkers first when space is needed.
• Slow click packet mode is available for plugin-heavy or stricter anti-cheat servers.

Container Tools

The mod includes several look-at-container tools independent of schematic filling:

• Clear Container: clears the looked-at container. Output can be dropped, moved to inventory, or moved to inventory first and then dropped.
• Fill Full: fills the looked-at container with an unambiguous item from your inventory. Useful for temporary crafting stations.
• Sync Container: reads a template container, then syncs other target containers to the same layout.
• Container Packing: packs items from the target container into shulker boxes in your inventory.
• Collect Materials: collects missing Litematica material-list items from the target container.

Tools support next/previous tool switching, closing all tools, hold-to-repeat, same-container cooldowns, and an optional tool HUD.

Container Filter

Limit which containers are affected by schematic filling and tools:

• Disabled, whitelist, and blacklist modes.
• Apply the filter to schematic filling, container tools, or both.
• Visual container picker.
• Wildcard rules such as minecraft:*_shulker_box.
• Attempts to detect modded containers through block entities, inventory interfaces, and common container-like block IDs.

Manual Container Marks

If a container cannot be judged correctly because of schematic data, server plugins, or temporary workflow needs, you can manually cycle its state:

• Automatic
• Manually completed: filling will skip this container
• Manually needs fill: the container stays highlighted and participates in filling

Manual marks can also be used on containers outside the current schematic range.

Usage

Default config hotkey: L + C

Default one-shot fill hotkey: V

For continuous filling, enable Work State in the config, bind a hotkey if needed, and adjust the fill radius and action delay for your environment.

Dependencies

Required:

• Fabric Loader
• Fabric API
• MaLiLib
• Litematica

Optional:

• Mod Menu: config screen access.
• QuickShulker: fast inventory shulker opening and extraction.
• Servux or a compatible data source: fetch real container data without opening containers.
• MiniHUD: the mod may read its container preview cache.
• TakeItOut server-side protocol: server-side shulker extraction support.

Notes and Warnings

Server risk: automated container operations may be considered abnormal clicking, auto-sorting, or auto-filling by server plugins or anti-cheat systems. Increase the action delay or enable slow click packet mode if needed.

Empty-schematic container clearing: if enabled, the mod may remove items from real containers that are empty in the schematic. This can be useful for clearing furnace ash, but it can also break machines. Check your schematic and range before enabling it.

Carpet large barrels: only enable this option if the server actually has Carpet largeBarrels enabled. Otherwise, slot offsets and incorrect state checks may occur.

Render editor layout: in small windows, custom GUI scales, unusual resolutions, or unusual aspect ratios, the render editor may become misaligned or hard to click. Use a larger window or default GUI scale when editing those settings.

License and Third-Party Projects

This project is licensed under LGPL-3.0-only.

This project depends on, integrates with, or references projects such as Litematica, MaLiLib, Fabric API, Mod Menu, QuickShulker, TakeItOut, Servux, MiniHUD, SchematicPreview, litematica-printer, itemscroller, and tweakermore. Unless explicitly stated in source files, this project does not bundle, copy, or redistribute their source code, assets, or binaries. Project names and descriptions are used only to explain dependencies, compatibility, or design references.