Litematica Printer 4th v1.1.0-alpha.3

Litematica Printer 4th 1.1.0-alpha.3

This prerelease reduces continuous-scan allocation and main-thread snapshot-capture work on Minecraft 26.1.2 and 26.2 without changing printer action semantics.

Changes since alpha.2

• Replaced per-search-tile coordinate, block-state, and target-mask arrays with cursors that stream directly from immutable shared snapshot pages.
• Kept the existing fine-grained search tasks and worker parallelism while creating BlockPos objects only for positions that actually produce jobs.
• Replaced boxed page keys and reference-count maps with a packed-coordinate page directory and explicit page lifetimes.
• Reused one calculated page index for the current-world and schematic views at each scanned position.
• Preserved producer/consumer independence, continuous rescanning, consumer-side live-world validation, visible-layer filtering, and all existing action implementations.

Validation and performance

The full-print profile placed a 1,026-block mixed schematic with all 1,026 blocks correct, no wrong or extra blocks, and no remaining materials. The 82-case printer behavior fingerprint remained identical and covers directional placement, stripping logs, breaking, fluid handling, ice-to-water behavior, and other special rules.

Across the 425 scan rounds in that full print on the development system:

• Snapshot capture time decreased from 176.1 ms to 90.8 ms (-48.4%).
• Producer active time decreased from 492.5 ms to 441.1 ms (-10.4%).
• Sampled search-thread allocation decreased from 229.62 MiB to 150.95 MiB (-34.3%).
• Scheduler-thread allocation decreased from 158.05 MiB to 76.58 MiB (-51.5%).

The end-to-end print duration remains governed by the configured per-tick placement and time limits; those limits were deliberately retained during profiling. Actual performance varies by system, loaded mods, render distance, and schematic contents.

Downloads

• litematica-printer-mc26.1.2-1.1.0-alpha.3+26.1.2.jar
• litematica-printer-mc26.2-1.1.0-alpha.3+26.2.jar

Required dependencies: Fabric API, MaLiLib, and Litematica.

Optional dependencies: ChainVeinFabric (block breaking during printing), QuickShulker/AxShulkers (remote shulker access), Servux (server hand-state confirmation), and a supported bedrock-mining mod.

This is an alpha prerelease. Back up important worlds and report reproducible issues with the client and server logs attached.

Litematica Printer 4th v1.1.0-alpha.2

Litematica Printer 4th 1.1.0-alpha.2

This prerelease improves continuous scanning performance and keeps the HUD completion percentage independent from the producer's in-flight scan progress on Minecraft 26.1.2 and 26.2.

Changes since alpha.1

• Kept fine-grained 8 x 8 x 8 search tasks for worker parallelism while separating them from snapshot storage.
• Added reference-counted snapshot pages shared across the GUI and printer producer. Overlapping task halos and modules no longer read the same world and schematic positions repeatedly within one scan round.
• Released shared pages as soon as their final dependent task completes, avoiding a monolithic full-range snapshot.
• Changed HUD completion statistics to publish as one immutable result only after a complete GUI scan round. The completion bar no longer follows the producer's partial scan while the player and world remain unchanged.
• Corrected ice-to-water phase-two job classification without changing the existing print action implementation.
• Added a large mixed-schematic performance regression test and an 82-case printer action fingerprint covering placement directions, stripping logs, breaking, fluid handling, ice-to-water behavior, and other special placement rules.

Performance fixture

On the 531,441-position mixed schematic used by the regression test:

• World and schematic state reads decreased from 8,001,504 to 1,272,112 per complete GUI + printer round.
• Median scan time decreased from 589.6 ms to 169.4 ms on the development system.
• Worker granularity remains at 1,331 search tasks instead of being reduced to larger snapshot-sized tasks.

Actual performance varies by system, loaded mods, render distance, and schematic contents.

Downloads

• litematica-printer-mc26.1.2-1.1.0-alpha.2+26.1.2.jar
• litematica-printer-mc26.2-1.1.0-alpha.2+26.2.jar

Required dependencies: Fabric API, MaLiLib, and Litematica.

Optional dependencies: ChainVeinFabric (block breaking during printing), QuickShulker/AxShulkers (remote shulker access), Servux (server hand-state confirmation), and a supported bedrock-mining mod.

This is an alpha prerelease. Back up important worlds and report reproducible issues with the client and server logs attached.

Litematica Printer 4th v1.1.0-alpha.1

Litematica Printer 4th 1.1.0-alpha.1

This prerelease focuses on reliable scheduling, inventory integration, diagnostics, and automated compatibility testing for Minecraft 26.1.2 and 26.2.

Highlights

• Added the new screen-independent QuickShulker transfer path, with capability detection performed before printing starts.
• Kept the legacy QuickShulker integration as a separate, internally encapsulated compatibility path.
• Improved blocking item switching and shulker retrieval so printing waits for the selected material instead of racing inventory synchronization.
• Added detailed HUD status reporting for searching, printing, hand confirmation, shulker access, container closure, look adjustment, and world updates.
• Preserved producer and consumer state when the printer work switch is disabled.
• Prevented print mode rotation and Ctrl handling from enabling the global work switch automatically.
• Fixed fluid removal with supported placement so falling blocks replace the fluid target directly instead of being placed above it and potentially duplicated.
• Expanded Litematica compatibility coverage and added integration tests for optional ChainVein, QuickShulker, Servux protocol confirmation, bedrock-mining mods, and simulated packet loss.

QuickShulker compatibility

• New protocol: QuickShulker 4.0.0-alpha.1 for the matching Minecraft version.
• Legacy protocol: QuickShulker 3.0.4 remains supported.
• QuickShulker is optional; normal inventory printing continues to work when it is not installed.

Downloads

• litematica-printer-mc26.1.2-1.1.0-alpha.1+26.1.2.jar
• litematica-printer-mc26.2-1.1.0-alpha.1+26.2.jar

Required dependencies: Fabric API, MaLiLib, and Litematica.

Optional dependencies: ChainVeinFabric (block breaking during printing), QuickShulker/AxShulkers (remote shulker access), Servux (server hand-state confirmation), and a supported bedrock-mining mod.

This is an alpha prerelease. Back up important worlds and report reproducible issues with the client and server logs attached.

Litematica Printer 4th v1.0.1

Litematica Printer 4th 1.0.1

This patch release replaces the project and in-game mod icon with a clean, flat-color vector design based on the original three-block concept.

Downloads

• litematica-printer-mc26.1.2-1.0.1+26.1.2.jar
• litematica-printer-mc26.2-1.0.1+26.2.jar

Required dependencies: Fabric API, MaLiLib, and Litematica.

Optional dependencies: ChainVeinFabric 3.0.0 (block breaking during printing), Quick Shulker/AxShulkers (remote shulker access), and Fabric-Bedrock-Miner (bedrock breaking).

Litematica Printer 4th v1.0.0

Litematica Printer 4th 1.0.0

这是投影打印机四改版的首个正式版本，fork 自 BiliXWhite/litematica-printer（投影打印机三改版）。

主要变化

• 将打印调度重构为持续扫描的生产者与作业池消费者：扫描持续发现缺失、错误和多余方块，消费者按事务类型公平取出并批量处理。
• 同类放置、使用和破坏作业可以在同一游戏 tick 内批量提交；跳过、失败或已失效的作业均视为已消费，尚未完成的位置会由后续扫描重新加入。
• 搜索改为基于分块世界快照的异步并发扫描，避免扫描线程直接阻塞客户端主线程，并遵循 Litematica 可见层设置。
• 所有物品切换及远程容器取物都会等待客户端确认完成后再继续打印，降低材料尚未到手就误判或放置失败的问题。
• 错误方块、多余方块及破冰统一通过可选的 ChainVeinFabric 3.0.0 客户端作业 API 批量提交；未安装 ChainVeinFabric 时不会启用这些破坏功能。
• 调试 HUD 同时显示生产者扫描进度、作业池长度、消费者状态与当前作业；关闭打印开关不会清空生产者和消费者状态。
• 保留原有具体打印语义，包括原木放置后去皮、放水、破冰、方块状态调整、填充和破基岩等处理。
• 删除旧挖掘模式、内置远程大仓和多版本包装器；只发布 Minecraft 26.1.2 与 26.2 的独立 jar。
• 工程改为 Java 构建逻辑，并拆分为纯 Java core 调度层与各 Minecraft 版本的独立适配实现，不再依赖源码预处理和版本 mapping。

下载与依赖

请根据 Minecraft 版本下载对应 jar：

• litematica-printer-mc26.1.2-1.0.0+26.1.2.jar
• litematica-printer-mc26.2-1.0.0+26.2.jar

必需依赖：Fabric API、MaLiLib、Litematica。

可选依赖：ChainVeinFabric 3.0.0（打印过程中的方块破坏）、Quick Shulker/AxShulkers（远程潜影盒）、Fabric-Bedrock-Miner（破基岩）。