Litematica Printer 4th

模组

· 作者 water2004

Litematica Printer 的第四代分支,具有连续异步扫描、公平作业调度、批量打印以及可选的 ChainVein 集成。

0 本站下载 0 关注 更新于 3 周前

需要前置:Litematica

最新 1.1.3-hotfix.1+26.3 · 26.3 · Fabric

一键开服(送7天)

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

example

依赖项

为相同的 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 可见层过滤同时适用于发现与执行阶段。

开始使用

  1. 安装正确版本的打印机 jar 文件及所需的依赖项。
  2. 使用 Litematica 加载并放置一个结构图。
  3. 默认情况下按下 Z,然后按 Y 以打开打印机设置。
  4. 启用 Print(打印) 模块,或选择你想要使用的其他工作模式。
  5. 移动到目标方块的可交互范围内。
  6. 按下 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 发布。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源