
vvvv DEMO VID HERE vvvv
https://www.youtube.com/watch?v=yG8Js2Z2FWI
***Operator tooling for inspecting and cleaning up [Sable](https://github.com/ryanhcode/sable)
sub-levels — the moving contraptions behind Create Aeronautics and any other
Sable-based content. Built for server admins who need to find and deal with
abandoned builds, including ones sitting in chunks nobody's loaded in months.***
This isn't a Create Aeronautics addon — it only depends on Sable's own public
API, so it works for **any** mod built on Sable, not just Aeronautics.
## What it does
Run `/sablecleanup` (operator-only, permission level 2) to open a GUI listing
**every** sub-level Sable knows about in your current dimension — loaded or
not — each with a creation-time counter and at-a-glance moderation coloring
(orange = old, red = old *and* hasn't moved). Select one to see a live, real-time
3D diagram of it and take action:
- **Teleport** — jump straight to it.
- **Delete** — remove it for good.
- **Freeze / Unfreeze** — pin it in place with a physics lock unaffected by Aeronautics Physics Staff.
- **Boot / Un-boot** — moderation lockdown. Forces Freeze on and blocks
Delete/Disassemble/Unfreeze functions until you un-boot it, so a build you're actively
reviewing can't move or vanish out from under you.
- **Disassemble** — move its blocks back into the world at their current
position and remove the sub-level. The reverse of assembling a contraption.
- **Save as schematic** — export it to a Create-compatible `.nbt` file (needs
Create installed; everything else works without it).
- **Rename** — set its display name.
- **Ignore flag** — mark it reviewed and fine to leave alone, overriding the
age/idle coloring permanently.
Sub-levels in unloaded chunks show up too (tagged `(unloaded)`) — clicking any
action on one transparently force-loads its chunk just long enough to act,
then lets it go back to sleep. No more flying around loading chunks by
hand to find out what's actually sitting out there.
## Requirements
- Minecraft 1.21.1, NeoForge `21.1.233`+
- [Sable](https://github.com/ryanhcode/sable) `2.0.0`+ (and whatever Sable
itself requires — Create, Veil)
- Create is optional, only needed for the "Save as schematic" action.
## Installation
Drop the jar in your `mods` folder alongside Sable. No setup required. Two
client-side config options (`LONG_LIFE_DAYS`, `NO_MOVEMENT_DAYS`, default 7
each) control the age-coloring thresholds in the generated config file — they
only affect how *your* list looks, nothing server-side.
## Known limitations
- **Freeze** is a re-applied physics constraint, not a true engine-level
pause — Sable has no per-body pause to hook into.
- The diagram view has a couple of known cosmetic quirks: Create's
shaft/cogwheel/large-cogwheel parts render slightly doubled, and
nested/attached sub-levels (e.g. a propeller riding on its own hull) aren't
drawn as part of the parent's diagram yet.
- **Iris shaderpack users:** the diagram view can render plain blocks as
invisible, showing only block-entity-backed ones (e.g. Copycats). Switch to
internal/vanilla shaders while using `/sablecleanup` as a workaround.
- Only the dimension you ran the command in is listed — not all dimensions at once.
- The unloaded-sub-level discovery scan reads Sable's on-disk storage format
directly (rather than its published API) to find sub-levels that have never
loaded since this mod was installed — a future Sable update could in
principle change that format and affect just this one piece.
## License
MIT. Sable itself is separately licensed — this mod only links against its
public API/runtime jar and doesn't bundle or modify any of its code.

