Litematica Printer 4th 是一个面向 Litematica 的客户端 Fabric 扩展。它持续发现未完成的图纸位置,并通过有界、多线程的生产者-消费者调度器对其进行处理。放置、填充、流体移除和基岩破坏是独立的功能模式。

依赖项
为相同的 Minecraft 版本安装以下客户端依赖:
已测试的基础组合包括:Minecraft 26.1.2 下的 MaLiLib 0.28.8 搭配 Litematica 0.27.9,以及 Minecraft 26.2 下的 MaLiLib 0.29.2 搭配 Litematica 0.28.3。在声明的 Minecraft 范围内,更新的 Litematica 版本也可能兼容。
可选集成
基础放置、填充和流体移除功能不需要以下集成。
| 集成 | 启用功能 |
|---|---|
| ChainVeinFabric | 破坏错误或多余的方块,并执行冰转水任务。仅客户端安装即可实现基础破坏;需要服务器支持的 ChainVein 功能则需服务端支持。 |
| Quick Shulker | 从携带的潜影盒中获取所需材料。当受支持时使用直接屏幕无关协议;旧版屏幕路径保持隔离以兼容较旧的发布版本。请使用匹配的 Quick Shulker 客户端和服务端版本。 |
| AxShulkers 或 TakeItOut | 打印机设置中可选的、由服务器支持的潜影盒材料来源替代方案。 |
| Servux | 支持 Litematica Easy Place 协议及可选的服务端权威持有物品确认。 |
| Fabric-Bedrock-Miner 或 Block-Miner | 执行由基岩破坏模式生成的任务。 |
所有集成均具备能力检测功能。依赖于缺失集成的功能将保持禁用或被跳过;正常打印功能仍可用。
第四版更新内容
连续的生产者-消费者调度
- 生产者持续扫描不可变的世界和图纸快照,而不是在全局搜索与打印阶段之间交替进行。
- 搜索工作被划分为小任务,并由可配置的工作线程池处理,且工作线程不会读取实时世界数据。
- 有界任务池按事务类型(如放置、状态调整、使用、破坏)对任务进行分组。
- 消费者公平遍历任务桶并对兼容的任务进行批处理,减少物品切换,并防止某个跳过的位置阻塞不相关的其他工作。
- 已处理、失败、跳过、过期和材料不足的任务都会被消费。如果某位置仍需处理,后续的生产者扫描会再次发现它。
- 消费者在执行前会验证实时世界,因此旧的快照无法强制执行过时的操作。
降低扫描开销
- 工作范围形状和图纸/选择工作区被编译为可复用的空间掩码。
- GUI 统计信息和打印机发现功能复用兼容的搜索计划和共享的快照页。
- 搜索游标直接读取打包的页面数据,仅在被转化为任务时才创建
BlockPos对象。 - HUD 显示已完成统计信息,而非展示生产者部分进行中的扫描过程。
在 Minecraft 26.2 A/B 基准测试中使用相同的 531,441 位置固定装置,四线程搜索、两轮预热和七轮测量结果显示,完整的 GUI + 打印机扫描时间中位数从 1.0.0 版本的 457.45 ms 降至 1.1.0 版本的 45.59 ms——在开发系统上速度提升了约 10.0x。有关方法论、正确性检查和注意事项,请参阅 1.1.0 发行说明。
可预测的物品与操作处理
- 每次背包或快捷栏物品变化都会等待配置的确认路径完成后,打印才会继续。
- 远程潜影盒检索具有明确的等待状态,防止消费者在材料到达前提前执行。
- 同类任务可在一个刻内处理完毕,直至达到配置的放置或破坏上限。
- 禁用全局工作开关会暂停工作,但不会清除生产者或消费者的状态。
- 切换模式会更改所选模式,但绝不会自动开启全局工作开关。
功能
工作模式
- 打印: 放置缺失的方块,调整支撑方块的块状态,并可选择性地破坏错误或多余的方块。
- 填充: 使用可配置的方块和方向过滤器填充当前 Litematica 选区。
- 流体移除: 移除选定工作区域内的指定静止或流动流体。
- 基岩破坏: 发现基岩任务并提交给支持的基岩挖掘模组。
传统的通用采矿模式和内置的远程仓库已被移除。
特殊打印动作
现有的方块操作行为仍然可用,包括:
- 放置原木并在需要去皮原木时将其剥皮;
- 放置冰块并将其破坏以生成水;
- 直接放置水流和处理含水方块;
- 针对观察者、活塞、楼梯、门、陷阱门、告示牌、头颅、旗帜、红石组件及其他支持方块的定向和状态敏感放置;
- 音符盒调音、安全放置观察者、珊瑚替换、作物骨粉施肥和堆肥桶填充;
- 可配置的跳过和替换列表;
- 普通交互放置和备用数据包放置路径。
反馈与控制
- 稳定的完成进度与缺失材料 HUD。
- 当前消费者活动、等待原因、工作位置以及工作池长度。
- 当前轮次的生产者扫描进度。
- 可配置的放置高亮,用于放置、调整、破坏和失败操作。
- 工作范围形状、遍历顺序、轴方向、搜索线程数量以及每刻动作限制。
- Litematica 可见层过滤同时适用于发现与执行阶段。
开始使用
- 安装正确版本的打印机 jar 文件及所需的依赖项。
- 使用 Litematica 加载并放置一个结构图。
- 默认情况下按下
Z,然后按Y以打开打印机设置。 - 启用 Print(打印) 模块,或选择你想要使用的其他工作模式。
- 移动到目标方块的可交互范围内。
- 按下
Caps Lock以启用全局 工作开关。
全局工作开关与特定工作模式的开关都必须处于启用状态。默认工作范围为 0 时,将自动使用可用的交互距离。
重要设置
- 每刻方块数 / 工作间隔: 控制吞吐量。具有速率限制或反作弊机制的服务器可能需要降低数值或延长间隔。
- 空中放置: 允许在服务器接受的情况下,无需现有相邻支撑块即可进行放置。
- 数据包放置: 使用替代的数据包发送路径进行放置。它不会覆盖服务器验证或网络丢包的影响。
- Servux 手持物品确认: 切换后等待服务器权威的主手物品信息。如果启用了此选项但服务器不兼容 Servux,打印机会故意暂停并报告该等待状态。
- 破坏错误/多余方块: 需要 ChainVeinFabric。如果没有安装,则破坏性打印任务将无法启用。
- 快速潜影盒来源: 选择 Quick Shulker、AxShulkers 或 TakeItOut 以匹配实际安装的集成环境。
故障排除
打印机没有任何反应
请检查:
- jar 文件是否与确切的 Minecraft 版本匹配;
- Fabric API、MaLiLib 和 Litematica 是否已加载;
- 是否已放置结构图且其相关图层可见;
- 所选模式与全局工作开关是否均已启用;
- 玩家是否在配置的工作范围内;
- 所需物品是否可用,且 HUD 未报告手部或潜影盒等待状态;
- 服务器的反作弊或放置限制是否拒绝了配置的速率。
破坏任务从未运行
错误方块、多余方块和冰层破坏任务需要 ChainVeVeinFabric。基岩挖掘任务还需要至少一个支持的基岩挖掘模组。
HUD 显示正在等待 Servux
已启用服务器权威手持物品确认,但当前服务器未暴露兼容的 Servux 通道。请在服务器上安装/配置 Servux,或禁用该确认选项。
快速潜影盒取物处于等待或不可用状态
请确认所选的潜影盒来源与实际安装的集成相匹配。对于直接的 Quick Shulker 协议,请保持客户端和服务器处于相同的兼容版本。HUD 的等待状态会指明打印机是在等待容器操作还是物品切换。
如需重现 Bug,请在 此仓库 中提交 issue,并附上客户端和服务器的日志、Minecraft/模组版本、相关设置,以及在可能的情况下提供最小化的结构图。
许可证
本项目依据 GNU Affero General Public License v3.0 发布。
Litematica Printer 4th is a client-side Fabric extension for Litematica. It continuously discovers unfinished schematic positions and processes them through a bounded, multithreaded producer-consumer scheduler. Printing, filling, fluid removal, and bedrock breaking are independent modes.

Requirements
Install these client-side dependencies for the same Minecraft version:
The tested baselines are MaLiLib 0.28.8 with Litematica 0.27.9 on Minecraft 26.1.2, and MaLiLib 0.29.2 with Litematica 0.28.3 on Minecraft 26.2. Compatible newer Litematica releases may also work within the declared Minecraft range.
Optional integrations
The base placement, filling, and fluid-removal features do not require the integrations below.
| Integration | What it enables |
|---|---|
| ChainVeinFabric | Break wrong or extra blocks and perform ice-to-water jobs. A client installation is enough for basic breaking; server-only ChainVein features require server support. |
| Quick Shulker | Retrieve required materials from carried shulker boxes. The direct screen-independent protocol is used when supported; the legacy screen path remains isolated for compatible older releases. Use matching Quick Shulker client and server versions. |
| AxShulkers or TakeItOut | Alternative server-backed shulker material sources selectable in the printer settings. |
| Servux | Litematica Easy Place protocol support and optional server-authoritative held-item confirmation. |
| Fabric-Bedrock-Miner or Block-Miner | Executes jobs produced by the bedrock-breaking mode. |
All integrations are capability-detected. Features that depend on a missing integration stay disabled or are skipped; normal printing remains available.
What changed in the fourth revision
Continuous producer-consumer scheduling
- A producer continuously scans immutable world and schematic snapshots instead of alternating between a full search and a print pass.
- Search work is divided into small tasks and processed by a configurable worker pool without reading the live world from worker threads.
- A bounded job pool groups placement, state-adjustment, use, and breaking jobs by transaction kind.
- The consumer traverses job buckets fairly and batches compatible jobs, reducing item switching and preventing one skipped position from blocking unrelated work.
- Processed, failed, skipped, stale, and unavailable-material jobs are all consumed. If a position still needs work, a later producer scan discovers it again.
- Consumer actions validate the live world before execution, so an old snapshot cannot force an obsolete action.
Lower scanning overhead
- Work-range shapes and schematic/selection workspaces are compiled into reusable spatial masks.
- GUI statistics and printer discovery reuse compatible search plans and shared snapshot pages.
- Search cursors read packed page data directly and create
BlockPosobjects only for positions that become jobs. - The HUD publishes completed statistics rather than displaying a producer's partial in-flight pass.
In a fresh Minecraft 26.2 A/B benchmark using the same 531,441-position fixture, four search threads, two warm-up rounds, and seven measured rounds, median complete GUI + printer scan time fell from 457.45 ms in 1.0.0 to 45.59 ms in 1.1.0—about 10.0x faster on the development system. See the 1.1.0 release notes for methodology, correctness checks, and caveats.
Predictable item and action handling
- Every inventory or hotbar item change waits for its configured confirmation path before printing continues.
- Remote shulker retrieval has explicit waiting states instead of allowing the consumer to race ahead of material arrival.
- Same-kind jobs can be processed in one tick up to the configured placement or breaking limits.
- Disabling the global work switch pauses work without clearing producer or consumer state.
- Cycling modes changes the selected mode but never turns on the global work switch automatically.
Features
Work modes
- Print: place missing blocks, adjust supported block states, and optionally break wrong or extra blocks.
- Fill: fill the active Litematica selection using configurable block and direction filters.
- Fluid removal: remove configured still or flowing fluids inside the selected work area.
- Bedrock breaking: discover bedrock jobs and submit them to a supported bedrock-mining mod.
The legacy general-purpose mining mode and the built-in remote warehouse were removed.
Special print actions
Existing block-operation behavior remains available, including:
- place a log and then strip it when stripped logs are required;
- place ice and break it to produce water;
- direct water placement and waterlogged-block handling;
- directional and state-sensitive placement for observers, pistons, stairs, doors, trapdoors, signs, heads, banners, redstone components, and other supported blocks;
- note-block tuning, safe observer placement, coral replacement, crop bonemealing, and composter filling;
- configurable skip and replace lists;
- normal interaction placement and the alternate packet placement path.
Feedback and controls
- Stable completion progress and missing-material HUD.
- Current consumer activity, wait reason, job position, and job-pool length.
- Producer scan progress for the current round.
- Configurable placement highlights for place, adjust, break, and failed actions.
- Work-range shape, traversal order, axis direction, search-thread count, and per-tick action limits.
- Litematica visible-layer filtering is respected by both discovery and execution.
Getting started
- Install the correct printer jar and required dependencies.
- Load and place a schematic with Litematica.
- Press
Z, thenYby default to open the printer settings. - Enable the Print module, or another work mode you want to use.
- Move within interaction range of the target blocks.
- Press
Caps Lockto enable the global Work Switch.
Both the global Work Switch and a specific work-mode switch must be enabled. The default work range of 0 automatically uses the available interaction distance.
Important settings
- Blocks per tick / work interval: controls throughput. Servers with rate limits or anti-cheat may require lower values or a longer interval.
- Place in air: allows placement without an existing adjacent support block where the server accepts it.
- Packet placement: uses the alternate packet-sending placement path. It does not override server validation or network loss.
- Servux held-item confirmation: waits for the server-authoritative main-hand item after a switch. If enabled without a compatible Servux server, the printer intentionally pauses and reports that wait state.
- Break wrong/extra blocks: requires ChainVeinFabric. Without it, destructive print jobs are not enabled.
- Quick Shulker source: select Quick Shulker, AxShulkers, or TakeItOut to match the environment actually installed.
Troubleshooting
The printer is not doing anything
Check that:
- the jar matches the exact Minecraft version;
- Fabric API, MaLiLib, and Litematica are loaded;
- a schematic is placed and its relevant layer is visible;
- both the chosen mode and the global Work Switch are enabled;
- the player is within the configured work range;
- the required item is available and the HUD is not reporting a hand or shulker wait;
- server anti-cheat or placement limits are not rejecting the configured speed.
Breaking jobs never run
Wrong-block, extra-block, and ice-breaking jobs require ChainVeinFabric. Bedrock jobs additionally require one of the supported bedrock-mining mods.
The HUD says it is waiting for Servux
Server-authoritative held-item confirmation was enabled, but the current server did not expose a compatible Servux channel. Install/configure Servux on the server or disable that confirmation option.
Quick Shulker retrieval is waiting or unavailable
Confirm that the selected shulker source matches the installed integration. For the direct Quick Shulker protocol, keep the client and server on the same compatible release. The HUD wait state identifies whether the printer is waiting for a container operation or an item switch.
For reproducible bugs, open an issue in this repository and attach both client and server logs, Minecraft/mod versions, relevant settings, and a minimal schematic when possible.
License
This project is distributed under the GNU Affero General Public License v3.0.
下载 Litematica Printer 4th
下载 Litematica Printer 4th
下载 Litematica Printer 4th
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Litematica Printer 4th
下载 Litematica Printer 4th
下载 Litematica Printer 4th
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Litematica Printer 4th
下载 Litematica Printer 4th
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Litematica Printer 4th
下载 Litematica Printer 4th
修复 QuickShulker 适配器
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧