Litematica-Printer-Hana

Litematica Printer - Hana Version

This mod adds automatic building features to Litematica for Minecraft Fabric versions from 1.18.2 to 26.2.
It allows players to quickly rebuild schematics by automatically placing the correct blocks around the player.

This is an independent fourth-generation fork, separate from the previous third-party modified versions.
The main features include independent bedrock-breaking logic and many additional quality-of-life improvements.

If you find this project useful, please consider giving it a Star ⭐️ to support the project.

Supported Minecraft Versions

Currently supported versions:

• 1.18.2
• 1.19.4
• 1.20.1
• 1.20.2
• 1.20.4
• 1.20.6
• 1.21(.1)
• 1.21.3
• 1.21.4
• 1.21.5
• 1.21.6~8
• 1.21.9~11
• 26.1+
• 26.2

Versions below 1.18.2 are not currently supported.
Minor versions between the listed versions may or may not work. Please test them yourself.
In general, version support will follow the upstream branch progress.

Dependencies

This mod requires the following mods:

• Fabric API
• MaLiLib
• Litematica

Optional dependencies:

• Tweakeroo
• Quick Shulker

Features

🚀 Optimizations

• Smoother printing experience
• Data packet based printing support, providing faster placement and fewer ghost blocks
• Visual placement progress bar with printer HUD
• Server lag detection to prevent large numbers of incorrect block placements during lag spikes

⏩ Improvements

• Fixed the issue where water iteration could get stuck when no water source was available
• Fill mode using the selected schematic area
• Fluid draining mode for automatically handling water and lava source blocks
• Digging mode based on the selected area
• Bedrock breaking mode within the selected area, with whitelist support
• Loosened Tweakeroo flexible block placement restrictions, allowing floating placement in survival mode
• Quick Shulker support
• Take It Out remote item retrieval support
• Coral replacement support, using live coral to print dead coral in schematics
• Improved handling for breaking incorrect blocks and placing water after breaking ice
• Up to 48 range iteration algorithms
• Support for breaking incorrect extra blocks and incorrect block states
• Regeneration II beacon support
• Independent bedrock-breaking feature with whitelist support
• Improved scanner performance
• Waterlogged block placement logic
• Improved digging, filling, and fluid-draining iteration logic

🛠️ Fixes

Fixed placement algorithms for many blocks, including:

• Crafter
• Lever
• Redstone dust in non-connection mode
• Leaf litter
• Various flower clusters with direction and count states
• Glow berries
• Flower pots with flowers
• Stairs
• Vines
• Twisting vines
• Weeping vines
• Grindstone
• Doors
• Trapdoors
• Hoppers
• Chests

Usage

1. Load a schematic in your world.
2. Move your player close enough to reach the schematic blocks.
3. Press Caps Lock to enable the printer.
4. Enjoy automatic building :)

[!TIP]

There is currently no official tutorial, but most features include comments or descriptions inside the mod settings.

Unsupported Blocks

The following blocks are not supported yet due to special placement or entity-related behavior.
The printer will automatically skip them, or they may appear as incorrect printing states.

If you find other blocks being placed incorrectly, try lowering the printing speed first.
If the issue still happens, please submit an Issue.

Unsupported blocks include:

• Skulls, signs, banners, and any blocks with 16-direction placement
• Cauldrons containing fluids
• Entity-based blocks, including but not limited to item frames, armor stands, paintings, and similar entities
• Non-vanilla game content

Building

1. Download the source code using any method you prefer.
2. Run:

./gradlew build

1. The built multi-version jar file will be located in:

./fabricWrapper/build/libs/

1. Individual version jars will be located in:

./fabricWrapper/build/tmp/submods/META-INF/jars

Building with IntelliJ IDEA

1. Open the project in IntelliJ IDEA.
2. Open the Gradle panel.
3. Go to:

Tasks -> build

1. Double-click the build task.
2. After the build finishes, the multi-version jar will be located in:

./fabricWrapper/build/libs/

1. Individual version jars will be located in:

./fabricWrapper/build/tmp/submods/META-INF/jars

[!TIP]

In mainland China, dependency downloads may fail due to network issues.
Please try using a proxy if the build process cannot download required libraries.

FAQ

Why does the printer not work after being enabled?

Possible reasons:

1. The printer works by silently sending rotation/look packets for block placement.
   It does not fully validate whether the clicked face is legal, so it may be blocked by server anti-cheat systems.

2. The Printer Working Interval may be too low.
   Some servers, such as those using Luminol or other placement rate limits, may not respond quickly enough.
   Try enabling Data Packet Printing, or increase the printer working interval.

3. In some rare cases, servers with online-mode authentication may have abnormal packet interaction after login.
   Try re-logging into your Minecraft account.
   Using the Auth Me mod is recommended.

If none of the above solves the issue, please submit an Issue.
The developer will try to help you resolve the problem.

Why are some blocks placed incorrectly?

Possible reasons:

1. The server has anti-cheat plugins, which may prevent the printer from simulating looking and placing correctly.

2. The printer working interval is too low, and the server cannot respond in time.
   This is a normal issue under high-speed printing. Try increasing the Printer Working Interval.

3. The recognition algorithm may not support the specific block yet.
   Please submit an Issue and describe which block is placed incorrectly.

Why does Quick Shulker not work?

Possible reasons:

1. The server does not have a plugin that allows shulker boxes to be opened by right-clicking in the inventory.
   AxShulkers is recommended.

2. The printer setting does not match the actual supported Quick Shulker mode.
   Please adjust it to the correct mode.

3. The pre-selected slots are filled with shulker boxes.
   You need to configure pickBlockableSlots in Litematica settings.

Example:

Quick Shulker support is still experimental and may have issues.
If you encounter problems, please submit an Issue.

QQ Group

Since not everyone is comfortable submitting GitHub Issues, you can join our QQ group to report bugs, receive updates, and get support.

Click here to join the QQ group