Litematica-Printer-Hana

Litematica-Printer-Hana

litematica-printer，随Hana多次修订

游戏机制

Litematica Printer — Hana

GitHub Actions Modrinth GitHub release License

Litematica Printer — Hana 是一个客户端 Fabric 模组，为 Litematica 添加了自动化原理图建造功能。它通过围绕玩家放置正确的方块来还原原理图，并提供填充、流体移除、挖掘、基岩破坏、物品栏辅助及相关实用功能。

本仓库是早期 Litematica Printer 分支的独立维护延续，重写了基岩破坏工作流，改进了扫描器和迭代器，并增加了额外的建造功能。

支持的 Minecraft 版本

  • 1.18.2
  • 1.19.4
  • 1.20.1、1.20.2、1.20.4 和 1.20.6
  • 1.21 至 1.21.11
  • 26.1.x 和 26.2

不支持早于 1.18.2 的版本。中间版本的 Minecraft 如果属于同一兼容范围可能可以运行，但并非总是单独构建为独立的 JAR 文件。

依赖要求

必需：

可选集成：

依赖版本必须与所启动的 Minecraft 版本匹配。

功能特性

打印与性能

  • 以玩家为中心的按距离排序放置。
  • 针对大型原理图区域的扫描器缓存和限时迭代。
  • 基于数据包的放置方式，无需客户端幽灵方块即可更快运行。
  • 放置进度和缺少材料 HUD。
  • 针对混合材料打印的服务器延迟和往返时间保护。
  • 对方块方向和状态敏感方块的更安全处理。

建造工具

  • 在活动原理图或选区范围内进行填充。
  • 排干水和熔岩源方块。
  • 在选区内挖掘方块。
  • 独立处理多余方块和错误状态方块。
  • 带白名单的基岩破坏模式。
  • 含水泥泞方块的放置及破冰后放置水。
  • 使用活珊瑚替换原理图中的死珊瑚。

物品栏集成

  • Quick Shulker 材料获取和有序放回。
  • 在受支持的版本上通过 Take It Out 远程获取材料。
  • 材料切换保护，防止上一个快捷栏物品被错误放置。

打印机还包含许多原版方块的特殊放置逻辑，包括楼梯、门、活板门、漏斗、箱子、拉杆、红石线、藤蔓、悬垂植物、磨石、合成器、花簇以及其他方向性方块。

基本使用方法

  1. 使用 Litematica 在主世界中加载一个原理图。
  2. 移动到原理图方块的交互范围内。
  3. 按下 Caps Lock 键启用打印机。
  4. 当服务器需要时，在配置界面中调整打印机设置。

大多数选项在配置界面中都有提示。目前还没有官方的完整教程。

已知不支持的内容

某些内容目前无法可靠打印，可能会被跳过或以错误状态放置：

  • 头颅、告示牌、旗帜以及其他具有特别复杂状态或数据处理方式的方块。
  • 装有流体的炼药锅。
  • 实体，例如物品展示框、盔甲架和画。
  • 非原版内容，除非明确支持。

如果即使在保守的工作间隔下原版方块仍被错误放置，请提交方块支持报告。

疑难解答

启用后打印机不工作

  • 某些反作弊系统会拒绝打印机的静默旋转或放置交互。
  • 非常短的工作间隔可能超过服务器的放置速率限制。请增加间隔时间，或在服务器支持时尝试基于数据包的打印方式。
  • 账号或会话状态有时可能干扰交互数据包。重新连接账号或服务器可能会有所帮助。

方块以错误状态放置

  • 服务器反作弊或高延迟可能阻止模拟旋转被接受。
  • 工作间隔可能过短，服务器无法确认材料切换和放置。
  • 该方块可能需要尚未实现的放置逻辑。请在问题中附上方块 ID、目标状态、Minecraft 版本、打印机版本以及可复现的示例。

Quick Shulker 无法工作

  • 对于所选的集成模式，服务器必须支持从物品栏中打开潜影盒。
  • 配置的模式必须与实际可用的模组或服务器行为匹配。
  • Litematica 的 pickBlockableSlots 中必须包含可用的快捷栏槽位，且不应完全被潜影盒填满。

Box

支持与贡献

  • 在 GitHub Discussions 中寻求安装帮助、配置问题、兼容性讨论和一般反馈。
  • 仅在 GitHub Issues 中报告可复现的 Bug、方块支持问题和具体的功能请求。
  • 打开新报告前，请先搜索现有的 Issues 和 Discussions。
  • 每个 Issue 只包含一个独立可复现的问题，并附上 latest.log、崩溃报告、截图或相关短视频。

致谢

许可证

本项目基于 GNU Affero General Public License v3.0 许可。