Warning
该 README 正在重构，目前的内容可能不完整或有误。请耐心等待更新或者贡献这个项目。
为 Litematica 投影添加自动建造功能的 Minecraft Fabric 模组。支持 1.18.2 ~ 1.21.10 版本。
该分支基于宅咸鱼二改版修改，添加了更多实用功能。
如果你觉得好用，欢迎给项目点个 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 |
Note
1.18.2 以下版本暂不接受更新，小版本是否可用请自行尝试
- Twrakeroo - 破基岩模式
- Chest Tracker (≤1.21.4) - 箱子追踪
- Quick Shulker - 快捷潜影盒
- 更流畅的打印体验
- 数据包打印模式（速度更快，避免幽灵方块）
- 可视化放置进度条（HUD 显示）
- 服务器卡顿检测，防止因延迟导致的大量方块放置错误
- 修复迭代水时因缺少水源卡死的 bug
- 填充功能（使用投影选区范围）
- 双兼容快捷潜影盒（支持 AxShulkers 和 Quick Shulker）
- 珊瑚替换（用活珊瑚打印投影内的死珊瑚）
- 破坏错误方块优化（破冰、放水）
- 48 种范围迭代逻辑
- 破坏错误额外方块和错误状态方块
- 合成器、拉杆、红石粉（非连接模式）
- 枯叶、各种花簇的方向
- 发光浆果、带花的花盆
- 楼梯、藤蔓、缠怨藤、垂泪藤
- 砂轮、门、活版门、漏斗、箱子
- 在世界中加载一个 Litematica 原理图（Schematic）
- 移动到可以接触到原理图方块的位置
- 按下
Caps Lock键开启打印机 - 等待自动建造完成 🎉
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 打开项目
- 在 Gradle 面板中找到
Tasks → build，双击build - 等待编译完成
| 类型 | 位置 |
|---|---|
| 多版本 jar | ./fabricWrapper/build/libs/ |
| 单版本 jar | ./fabricWrapper/build/tmp/submods/META-INF/jars |
可能原因：
- 服务器反作弊检测 — 投影打印机基于静默看向方式放置方块，可能被检测
- 打印机工作间隔设置过小 — 有放置速率限制的服务器（如 Luminol）无法及时响应
解决方案：
- 开启「使用数据包打印」模式
- 调大「打印机工作间隔」
如仍无法解决，请提交 Issue
可能原因：
- 服务器反作弊插件干扰
- 打印机工作间隔过小，服务器响应不及时
- 识别算法未考虑该方块特性
解决方案：
- 增大「打印机工作间隔」
- 降低建造速度
如问题持续，请提交 Issue
可能原因：
- 服务器未安装 AxShulkers 等支持在背包右键打开潜影盒的插件
- 投影打印机设置与实际支持模式不符
- 预选栏位被潜影盒填满
解决方案：
- 在 Litematica 设置中调整
pickBlockableSlots（快捷选择栏位）值 - 确认所选择的工作模式是正确的
Note
快捷潜影盒功能仍处于测试阶段，如遇问题请提交 Issue
- bunny_i - 开发者之一
- aleksilassila - 原创基础
- zhaixianyu - 二改版本
- MoRanpcy - 快捷潜影盒支持
- bunnyi116 - 新的破基岩
以及所有支持开发的朋友，包括你！💖