Sable CleanUp

# Sable Cleanup Tools
（新演示视频即将推出）

一套用于查找、检查和清理 **[Sable](https://github.com/ryanhcode/sable) 子层级**的管理员工具包——这些是 **Create: Aeronautics** 和其他基于 Sable 的内容所使用的物理结构。

飞艇、漫游车和其他结构会随着服务器运行时间不断堆积：被遗弃的建造、失控的装置、尚未完工的项目，漂浮在数周都无人加载的区块中。Sable Cleanup Tools 为管理员提供一个 GUI，查看当前维度中的**所有**子层级——*包括位于未加载区块中的子层级*——并安全地对它们进行操作。

> 适用于**任何**基于 Sable 的结构，不仅限于 Create: Aeronautics。它只会调用 Sable 自带的 API。

## ✨ 0.3.0 版本新增内容

– **多选与批量操作** — 每一行都有复选框（Ctrl+A 可全选）；可一次性删除、冻结或踢出一整批结构。
– **蓝图浏览器** — 可直接在 GUI 中浏览、预览和管理已导出的蓝图。
– **排序与搜索** — 可按年龄、名称、最近活动时间、大小排序，也可按名称搜索。
– **传送选项** — 可跳转到结构所在位置，*也可将其**移动到这里***，把子层级带到你身边。
– **保存蓝图时的轴承警告** — 导出带有活动轴承的结构前会发出警告。                                                  
## 功能介绍                                                                                                                                
运行 `/sablecleanup`（管理员 / 权限等级 2），或在 **控制 → Sable Cleanup Tools** 下绑定按键，即可打开面板：              
– 可滚动浏览当前维度中**所有子层级的列表**——包括 ID、名称和**存在时长 / 创建时间计数器**。                             – **一目了然的管理颜色标记**：子层级达到 7 天时标为橙色；如果它同样已有那么久没有移动，则标为红色；若已将其标记为“忽略”，则标为绿色。                                                                                                               – 实时**3D 示意图预览**，可拖动旋转、滚动缩放，让你在操作前看清它的样子。
– **未加载的子层级也会显示**（标记为 `(unloaded)`）。点击任意操作时，工具会自动临时强制加载对应区块以完成操作，随后让区块恢复未加载状态。
                                                                                                                         ## 操作

                                                                                                                                                 – **传送** — 跳转到该机械（地块或当前视图
– **删除** — 移除一个子层级。如果仍有物体与其物理连接，或其中包含正在运行的机械动力机械，则会拒绝删除，因此不会悄无声息地把它们也毁掉。
– **冻结 / 解冻** — 使用真正的物理约束将其固定在原地，且重启后仍然有效。
– **封锁 / 解除封锁** — 管理锁定：强制冻结该子层级，或解除冻结（并禁止在其中破坏方块），直到解除封锁；这样，工作人员正在审核的内容就不会在他们眼皮底下移动或消失。
– **重命名** — 设置子层级的显示名称。
– **另存为原理图** — 将其中的方块导出为兼容机械动力的 `.nbt` 原理图（需要机械动力；其他功能无需它即可使用）。
– **拆解** — 将方块移回普通世界，是组装机械的反向操作。会防止拆毁相连的机械或地块内的实体。
– **忽略标记** — 将子层级标记为已审核且状态正常，可以
– **将鼠标悬停在选项上并按住 Shift，可查看选项说明**
## 前置要求

– **Minecraft 1.21.1**、**NeoForge 21.1.228+**
– **[Sable](https://github.com/ryanhcode/sable) 1.2.2+**（以及 Sable 本身所需的内容 — Create、Veil）

## 安装

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

## 已知限制

– **单维度** — 只列出命令运行所在的维度
– 轴 / 齿轮在示意图中会呈现**视觉上的重影效果**（在静态模型上叠加一个旋转副本）。仅为视觉效果 — 不会影响
任何内容。
– 启用 **Iris 光影包**时，示意图中部分方块可能会显示为不可见。使用 `/sablecleanup` 时，可切换为内置 / 原版光影作为
临时解决方法。
– 冻结是通过软性物理约束固定对象，并非真正的引擎级暂停（Sable 不支持按实体暂停）。

## 许可与鸣谢

MIT。基于 ryanhcode 的 **Sable** 构建 — 此模组仅链接到 Sable 的公开 API，不会将其打包进来或对其进行修改。