Litematica Printer

为 Litematica 投影添加自动建造功能的 Minecraft Fabric 模组。支持 1.18.2 ~ 26.2 版本。

该分支基于宅咸鱼二改版修改，添加了更多实用功能。

如果你觉得好用，欢迎给项目点个 Star ⭐️

Tip

该分支始终保持开源免费，不会存在任何收费内容。条件允许的话可以给作者买瓶脉动支持一下！

---

下载

渠道	链接
GitHub Releases	点击下载
蓝奏云分流（密码: cgxw）	点击下载

---

支持的游戏版本

版本支持
1.18.2 · 1.19.4 · 1.20.1 · 1.20.2 · 1.20.4 · 1.20.6
1.21.1 ~ 1.21.11 · 26.1 · 26.2

Note

1.18.2 以下版本暂不接受更新，小版本是否可用请自行尝试

---

前置模组

必需

• Fabric API
• MaLiLib
• Litematica

可选

• Tweakeroo - 挖掘限制名单，自动选择工具
• Quick Shulker 或 AxShulkers - 快捷潜影盒（双模式兼容）
• Fabric-Bedrock-Miner - 破基岩所需前置

---

特性

远程容器系统-重构版

• 远程容器物品获取 — 通过网络数据包远程扫描/请求容器（箱子、潜影盒等）中的物品，自动取料打印
• 智能物品回塞（FIFO） — 使用完后自动将物品按 FIFO 顺序回塞到原来的容器，缓存持久化到磁盘

性能优化

• 更流畅的打印体验
• 数据包打印模式（速度更快，避免幽灵方块）
• 延迟卡顿检测，防止因延迟导致的大量方块放置错误

新功能

• 可视化工作进度条 - 一目明了范围内是否完工
• 区域内缺失材料显示 - 快速感知缺失材料，方便及时补充
• 高亮处理中方块 — 多种高亮类型与样式，支持自定义颜色、透明度
• 双兼容快捷潜影盒 — 重写支持Mod/服务器插件双模式
• 填充功能（使用投影选区范围）
• 珊瑚替换（用活珊瑚打印投影内的死珊瑚）
• 48 种范围迭代逻辑
• 破坏错误额外方块和错误状态方块
• 农作物催熟 - 方便打印大片稻田类原理图
• 即时挖掘 - 经可能更快的破坏方块
• 多语言支持 - 中文（简体） · 中文（繁体） · 文言文 · English · Русский

方块放置修复

• 合成器、拉杆、红石粉（非连接模式）
• 枯叶、各种花簇的方向
• 发光浆果、带花的花盆
• 楼梯、藤蔓、缠怨藤、垂泪藤
• 砂轮、门、活版门、漏斗、箱子
• 旗帜、头颅（16 朝向支持）
• 告示牌悬挂状态修正
• 以及更多

---

使用方法

1. 在世界中加载一个原理图
2. 移动到可以接触到原理图方块的位置
3. 按下 Caps Lock 键开启打印机
4. 等待自动建造完成 🎉

Tip

大部分功能都含有游戏内注释可供参考使用

---

未支持方块

以下方块由于特殊原因暂未实现，打印时会自动跳过或呈现错误状态：

• 装有液体的炼药锅
• 睡莲
• 实体方块（物品展示框、盔甲架、画等）
• 非原版游戏内容

Tip

如发现其他方块放置错误，请尝试降低建造速度。若问题依旧存在，请提交 Issue

---

🔨 编译

Warning

部分模组使用 Github Maven 源，从 pkg.github.com 下载需要认证。本地构建时需要在系统环境中设置 GH_USERNAME 和 GH_TOKEN，否则会构建失败。

命令行编译

git clone https://github.com/BiliXWhite/litematica-printer.git
cd litematica-printer
./gradlew build

IDEA 编译

1. 用 IDEA 打开项目
2. 在 Gradle 面板中找到 Tasks → build，双击 build
3. 等待编译完成

构建产物位置

类型	位置
多版本 jar	./fabricWrapper/build/libs/
单版本 jar	./fabricWrapper/build/tmp/submods/META-INF/jars

---

❓ 常见问题

加入QQ群（适用于中国大陆用户）

如果你喜欢跟进体验最新的功能，持续提供可复现的Bug，那么推荐你加入QQ群聊以便直接和开发者沟通！

点击加入 QQ 群聊

---

Q: 开启打印后，打印机不工作？

可能原因：

1. 服务器反作弊检测 — 投影打印机基于静默看向方式放置方块，可能被检测
2. 打印机工作间隔设置过小 — 有放置速率限制的服务器（如 Luminol）无法及时响应

解决方案：

• 请求你的服主关掉反作弊或者是换一个服务器玩
• 开启「使用数据包打印」模式
• 调大「打印机工作间隔」

如仍无法解决，请提交 Issue

---

Q: 打印机放置的方块是错的？

可能原因：

1. 服务器反作弊插件干扰
2. 打印机工作间隔过小，服务器响应不及时
3. 识别算法未考虑该方块特性

解决方案：

• 增大「打印机工作间隔」
• 降低建造速度

如问题持续，请提交 Issue

---

Q: 快捷潜影盒功能无法使用？

可能原因：

1. 服务器未安装 AxShulkers 等支持在背包右键打开潜影盒的插件
2. 投影打印机设置与实际支持模式不符
3. 预选栏位被潜影盒填满

解决方案：

• 在 Litematica 设置中调整 pickBlockableSlots（快捷选择栏位）值
• 确认所选择的工作模式是正确的

Note

快捷潜影盒功能现已重写。如遇问题请提交 Issue

---

🙏 感谢

• bunny_i - 开发者之一
• aleksilassila - 原创基础
• zhaixianyu - 二改版本
• MoRanpcy - 快捷潜影盒支持
• bunnyi116 - 新的破基岩
• Rofumer - 俄语本地化、性能优化、Bug 修复
• Cjsah - 选区内容器材料识别功能
• EnderPhantomWing 适配新版本、Bug 修复

以及所有支持开发的朋友，包括你！💖