PunchList 是 Litematica 的辅助模组。在 Schematic Verifier(蓝图验证器)中选择你希望处理的项目类别(缺失、错误方块、错误状态、多余),切换过滤器,此时仅有这些位置的方块会以幽灵方块形式渲染。其他所有幽灵方块都会被隐藏,且被隐藏的幽灵方块不会阻挡你的准星瞄准,因此即使有未建造的幽灵方块挡在前面,你也可以直接瞄准其后方已被标记的方块,而无需移动视角深入蓝图内部。
功能特性
- 验证器过滤器:仅将你在选定验证器类别中的位置显示为幽灵方块。被隐藏的幽灵方块不会干扰 Easy Place(快速放置)或 Pick Block(拾取方块)。
- 封闭方块隐藏:在验证器屏幕上增加了一个循环按钮。它会隐藏那些在完成后的建筑中不可见的位置,原因可能是每个面都被覆盖,或者它们面向一个密封的内部空隙。三种模式详见“使用方法”部分。
- 调整后的计数:当鼠标悬停在验证器行上时,会显示有多少该材料被隐藏以及有多少可见。即使过滤器关闭,此功能依然有效。
- 跟随玩家:当你移动时,重新居中验证器标记窗口。原版 Litematica 仅在放置方块或操作 GUI 时才重新排序。默认距离为 32 格,设置为 0 则禁用此功能。该设置详见“配置”部分。
使用方法
- 在已放置的区域运行 Schematic Verifier(蓝图验证器),并选择你想要处理的类别或条目。过滤器遵循与驱动验证器叠加层标记相同的选中状态。
- 使用热键(Litematica > Hotkeys >
punchListFilterToggle,默认未绑定)或验证器屏幕上的 PunchList 按钮来切换过滤器。
- 通过验证器屏幕上的 Enclosed(封闭)按钮循环切换隐藏模式。左键单击向前循环,右键单击向后循环。隐藏功能需要开启过滤器才生效。悬停计数无论是否开启过滤器均可工作。
- 显示 (Show):不隐藏任何内容。
- 隐藏 (Hide):在完成后的建筑中不可见的位置会被隐藏,无论是完全被覆盖还是面向密封的空隙。树叶的判断逻辑是将其他树叶视为固体,因此树冠内部会被隐藏,而穿过叶丛的树干和树枝保持可见。
- 严格隐藏 (Hide (strict)):只有不透明的完整方块被视为遮挡物,因此没有东西会被树叶隐藏。密封空隙的隐藏规则仍然适用。
- 如果在验证器中未选择任何内容,过滤器不会生效。启动时过滤器始终处于关闭状态。
配置
热键绑定位于 Litematica > Hotkeys(热键)菜单下。其他所有选项出现在 Litematica 配置屏幕的 Generic(通用)标签页中,可通过搜索找到,与任何其他 Litematica 选项一样,并保存在 litematica.json 文件中。
- 跟随玩家距离 (Follow Player Distance):标记窗口重新居中前允许移动的方块数量。默认值为 32。设为 0 可禁用此功能。
- 封闭软遮挡物 (Enclosed Soft Occluders):在 Hide(隐藏)模式下,仅对同类方块计为遮挡物的方块,类似于树叶的作用。条目格式为
#namespace:tag 或 namespace:block。默认为 #minecraft:leaves。
- 空隙填充 (Pocket Fill):开启或关闭密封空隙检测。默认为开启。
- 空隙填充最大体积 (Pocket Fill Max Volume):限制空隙泛洪填充体积的安全上限。默认为 1 亿。
依赖要求
Minecraft 26.2, Fabric, 以及
Fabric API,
MaLiLib 和
Litematica。仅限客户端。
已在 Litematica 0.28.4 和 MaLiLib 0.29.3 版本上测试。在不兼容的版本上,该模组会通过聊天消息自我禁用,而不是导致崩溃。
与 bHold easyPlace 配合使用。
开启过滤器后,Easy Place 只能瞄准列表中的幽灵方块,并且 Hold 模式会在不使用按住使用键的情况下自动放置它们。
致谢
masa 编写了 Litematica 和 MaLiLib。
源代码托管于 GitHub,采用 MIT 许可证。
PunchList is a Litematica companion. Pick the categories you want to
work on in the Schematic Verifier (missing, wrong block, wrong state,
extra), toggle the filter, and only those positions render as ghost
blocks. Every other ghost is hidden, and hidden ghosts do not block your
aim, so a flagged block behind unbuilt ghosts can be targeted without
moving the camera into the schematic.
Features
- Verifier filter shows only the positions in your selected verifier
categories as ghosts. Hidden ghosts do not block Easy Place or pick
block.
- Enclosed block hiding adds a cycle button on the verifier screen. It
hides positions that are invisible in the finished build, either because
every face is covered or because they face a sealed interior pocket.
The three modes are described under Usage.
- Adjusted counts appear when you hover a verifier row, showing how
many of that material are hidden and how many are visible. This works
even with the filter off.
- Follow the player re-centers the verifier marker window as you move.
Stock Litematica only re-sorts when you place a block or touch the GUI.
The distance defaults to 32 blocks and 0 turns it off. The setting is
described under Configuration.
Usage
- Run the Schematic Verifier on a placement and select the categories or
entries you want to work on. The filter follows the same selection that
drives the verifier's overlay markers.
- Toggle the filter with the hotkey (Litematica > Hotkeys >
punchListFilterToggle, unbound by default) or the PunchList button on
the verifier screen.
- Cycle the enclosed hiding mode with the Enclosed button on the
verifier screen. Left-click cycles forward and right-click cycles
back. Hiding needs the filter on. Hover counts work either way.
- Show. Nothing is hidden.
- Hide. Positions invisible in the finished build hide, either
fully covered or facing a sealed pocket. Leaves are judged with
other leaves treated as solid, so canopy interiors hide while
logs and branches threading through foliage stay visible.
- Hide (strict). Only opaque full blocks count as cover, so
nothing hides behind foliage. Sealed pocket hiding still applies.
- With nothing selected in the verifier the filter does nothing. The
filter always starts off at launch.
Configuration
The hotkey binds under Litematica > Hotkeys. Everything else appears in
Litematica's config screen under the Generic tab, searchable like any
Litematica option, and persists in litematica.json.
- Follow Player Distance. Blocks moved before the marker window
re-centers. Default 32. 0 disables the feature.
- Enclosed Soft Occluders. Blocks that count as cover only for their
own kind in Hide mode, the way leaves do. Entries are
#namespace:tag
or namespace:block. Default #minecraft:leaves.
- Pocket Fill. Sealed pocket detection on or off. Default on.
- Pocket Fill Max Volume. Safety cap on the pocket flood fill volume.
Default 100 million.
Requirements
Minecraft 26.2, Fabric, plus
Fabric API,
MaLiLib, and
Litematica. Client-side only.
Tested against Litematica 0.28.4 and MaLiLib 0.29.3. On an incompatible
version the mod disables itself with a chat message instead of crashing.
Pairs with bHold easyPlace.
With the filter on, the only ghosts Easy Place can target are the ones
on your list, and hold mode places them without holding the use key.
Credits
masa wrote Litematica and MaLiLib.
Source on GitHub, MIT.
评论 0
登录后参与评分
还没有评论,来抢沙发吧