沙布清理

Sable Cleanup Tools

(新的演示视频即将推出)

一个供管理员查找、检查和清理 Sable 子层级的操作员工具包——这些是 机械动力：航空学以及其他基于 Sable 的内容背后的物理装置。

飞艇、漫游车和其他装置在服务器生命周期中会不断堆积：废弃的建筑、失控的载具、散落在数周无人加载区块中的半成品。Sable Cleanup Tools 为管理员提供了一个 GUI，可以查看维度中的 每一个子层级——包括位于未加载区块中的那些——并安全地对它们执行操作。

适用于 任何基于 Sable 的装置，而不仅仅是机械动力：航空学。它只与 Sable 自己的 API 进行交互。

✨ 0.3.0 新增内容

• 多选 + 批量操作 —— 每行都设有复选框（Ctrl+A 全选）；可一次性删除、冻结或驱逐整个批次。
• 蓝图浏览器 —— 直接在 GUI 中浏览、预览和管理你导出的蓝图。
• 排序与搜索 —— 可按时间、名称、最后活动时间、大小排序，或按名称搜索。
• 传送变体 —— 跳转到装置的放置点 或 使用 移至此处 将子层级带到你面前。
• 保存蓝图时的轴承警告 —— 在导出带有活动轴承的装置前发出警告。

功能介绍

运行 /sablecleanup（需要管理员/权限等级 2），或在 控制 → Sable Cleanup Tools 中绑定按键，即可打开面板：

• 当前维度中 每一个子层级的可滚动列表 —— 包含 ID、名称以及 存在时间 / 创建时间计数器。
• 一目了然的管理着色：子层级超过 7 天显示为橙色，如果同时长时间未移动则显示为红色，标记为“忽略”则显示为绿色。
• 实时的 3D 示意图预览，支持拖拽旋转和缩放，让你在实际操作前了解它的样子。
• 未加载的子层级也会显示（标记为 (未加载)）。点击任何操作都会透明地强制加载其所在区块，仅持续到操作完成，然后让其重新进入休眠状态。

操作

• 传送 —— 跳转到装置所在位置（放置点或当前可视位置）。
• 删除 —— 移除一个子层级。如果仍有物理连接的物体或内部有活跃的机械动力装置，则会拒绝操作，以防止无意中连带破坏它们。
• 冻结 / 解冻 —— 使用一个在重启后仍能保持的实体物理约束将其固定到位。
• 驱逐 / 解除驱逐 —— 管理封锁：强制冻结并禁止（涉及）……（原文不完整）直到解除驱逐，这样工作人员正在审查的装置就不会移动或消失。
• 重命名 —— 设置子层级的显示名称。
• 保存为蓝图 —— 将其方块导出为 Create 兼容的 .nbt 蓝图（需要 Create；无需其他模组即可完成其他所有操作）。
• 拆卸 —— 将方块移回普通世界，即装配装置的逆向操作。可防止破坏连接的装置或放置点内的实体。
• 忽略标记 —— 将子层级标记为已审查且状态良好。
• 将鼠标悬停在选项上可查看其功能描述。

前置要求

• Minecraft 1.21.1、NeoForge 21.1.228+
• Sable 1.2.2+（以及 Sable 本身所需的依赖——Create、Veil）

安装

将 jar 文件放入你的 mods 文件夹中，与 Sable 放在一起。除了生成的配置文件中的两个客户端列表着色阈值（LONG_LIFE_DAYS / NO_MOVEMENT_DAYS）外，无需进行任何配置。

已知限制

• 单一维度 —— 仅列出运行命令时的当前维度。
• 传动杆/齿轮在示意图中会呈现 外观双重效果（在静态模型上叠加一个旋转副本）。仅为视觉效果，不影响实际功能。
• 当 Iris 光影包 激活时，示意图中的某些方块可能显示为不可见。作为临时解决方案，可在使用 /sablecleanup 时切换到内部/原版着色器。
• 冻结是一种软性的物理约束固定，并非真正的引擎级暂停（Sable 没有针对单个物体的暂停功能）。

许可证与鸣谢

MIT 许可证。基于 ryanhcode 的 Sable 构建——本模组仅链接 Sable 的公共 API，不捆绑或修改它。