待办清单

PunchList 是 Litematica 的辅助模组。你可以选择要在原理图验证器（Schematic Verifier）中处理的类别（缺失、方块错误、状态错误、多余），切换过滤器后，仅这些位置会渲染为幽灵方块。其他所有幽灵方块都会被隐藏，而隐藏的幽灵方块不会阻挡你的准星瞄准，因此被未建造的幽灵方块挡住的标记方块可以在不将视角移入原理图的情况下被选中。

特性

• 验证器过滤器 仅将你选择的验证器类别中的位置显示为幽灵方块。隐藏的幽灵方块不会阻挡简易放置（Easy Place）或方块选择（pick block）。
• 封闭方块隐藏 在验证器界面添加了一个循环切换按钮。它会隐藏在成品建筑中不可见的位置，无论是因所有面都被覆盖，还是因它们面向密封的内部空间。三种模式在“使用方法”下说明。
• 调整后的计数 当你悬停在验证器行上时显示，展示该材料有多少被隐藏，多少可见。即使过滤器关闭，此功能也有效。
• 跟随玩家 会随着你的移动而重新居中验证器标记窗口。原版 Litematica 只会在你放置方块或操作界面时重新排序。距离默认为 32 格，设为 0 可关闭此功能。该设置在“配置”下说明。

使用方法

1. 对某个布局运行原理图验证器，并选择你想要处理的类别或条目。过滤器会跟随驱动验证器覆盖标记的同一选择。
2. 使用快捷键（Litematica > 热键 > punchListFilterToggle，默认未绑定）或验证器界面上的 PunchList 按钮切换过滤器。
3. 使用验证器界面上的“封闭”（Enclosed）按钮循环切换封闭隐藏模式。左键单击向前循环，右键单击向后循环。隐藏功能需要开启过滤器。悬停计数在两种情况下都有效。
   • 显示。 不隐藏任何内容。
   • 隐藏。 在成品建筑中不可见的位置会被隐藏，无论是完全被覆盖还是面向密封空间。树叶与其他树叶视为实心方块进行判断，因此树冠内部会被隐藏，而穿过树叶的圆木和树枝仍然可见。
   • 隐藏（严格）。 只有不透明的完整方块才算作覆盖物，因此树叶后面不会隐藏任何内容。密封空间隐藏仍然适用。
4. 在验证器中未选择任何内容时，过滤器不会生效。过滤器在启动时始终处于关闭状态。

配置

热键绑定在 Litematica > 热键下。其他所有选项都出现在 Litematica 配置界面的“常规”（Generic）选项卡中，可像任何 Litematica 选项一样搜索，并保存在 litematica.json 中。

• 跟随玩家距离。 标记窗口重新居中前移动的方块数。默认 32。设为 0 可禁用此功能。
• 封闭软遮挡物。 在“隐藏”模式下，仅对同类方块视为遮挡物的方块，例如树叶。条目格式为 #命名空间:标签 或 命名空间:方块。默认值为 #minecraft:leaves。
• 空间填充。 开启或关闭密封空间检测。默认开启。
• 空间填充最大体积。 空间洪泛填充体积的安全上限。默认值为 1 亿。

需求

Minecraft 26.2、Fabric，以及 Fabric API、MaLiLib 和 Litematica。仅限客户端。

已针对 Litematica 0.28.4 和 MaLiLib 0.29.3 进行测试。在不兼容的版本上，该模组会通过聊天消息禁用自身，而不会崩溃。

可与 bHold easyPlace 搭配使用。开启过滤器后，简易放置只能瞄准你列表上的幽灵方块，并且保持模式无需按住使用键即可放置它们。

致谢

masa 编写了 Litematica 和 MaLiLib。

源代码位于 GitHub，MIT 许可证。