# Sable Cleanup Tools
(new demo vid coming soon)

An operator toolkit for finding, inspecting, and cleaning up **[Sable](https://github.com/ryanhcode/sable) sub-levels** — the physics contraptions behind **Create: Aeronautics** and other Sable-based content.

Airships, rovers, and other contraptions pile up over a server's lifetime: abandoned builds, runaways, half-finished projects drifting in chunks nobody's loaded in weeks. Sable Cleanup Tools gives operators one GUI to see **every** sub-level in the dimension — *including ones sitting in unloaded chunks* — and act on them safely.

> Works with **any** Sable-based contraption, not just Create: Aeronautics. It only talks to Sable's own API.

## ✨ New in 0.3.0

- **Multi-select + bulk actions** — checkboxes on every row (Ctrl+A selects all); delete, freeze, or boot a whole batch at once.
- **Schematic browser** — browse, preview, and manage the schematics you've exported, right in the GUI.
- **Sort & search** — sort by Age, Name, Last Active, Size, orve by name.- **Teleport variants** — jump to a contraption's plot *or* it **Move Here** to bring the sub-level to you.
- **Save-schematic bearing warning** — warns before exporting a contraption with an active bearing.                                                  
## What it does                                                                                                                                      
Run `/sablecleanup` (operator / permission level 2), or bind a key under **Controls → Sable Cleanup Tools**, to open the panel:                      
- A scrollable **list of every sub-level** in the current dimension — id, name, and a **lifetime / created-at counter**.                             - **At-a-glance moderation coloring**: orange once a sub-level 7 days), red if it's *also* gone that long without moving,green if you've flagged it "ignore".                                                                                                                 - A live **3D diagram preview** with drag-to-orbit and scroll-ion actually is before you touch it.
- **Unloaded sub-levels show up too** (marked `(unloaded)`). Clicking any action transparently force-loads its chunk just long enough to act, then lego back to sleep.
                                                                                                                                                     ## Actions
                                                                                                                                                     - **Teleport** — jump to the contraption (plot or current visu
- **Delete** — remove a sub-level. Refuses if something's still physically attached or an active Create contraption is inside, so you can't silently destroy those too.
- **Freeze / Unfreeze** — pin it in place with a real physics constraint that survives restarts.
- **Boot / Un-boot** — moderation lockdown: forces Freeze on ae / un-Freeze (and block-breaking inside) until un-booted, soanything a staff member is actively reviewing can't move or vanish out from under them.
- **Rename** — set the sub-level's display name.
- **Save as schematic** — export its blocks to a Create-compatible `.nbt` schematic (needs Create; everything else works without it).
- **Disassemble** — move the blocks back into the plain world he reverse of assembling a contraption. Guards againstdestroying attached contraptions or in-plot entities.
- **Ignore flags** — mark a sub-level as reviewed and fine to
- **Hold shift over an option for a description of what it does**
## Requirements

- **Minecraft 1.21.1**, **NeoForge 21.1.228+**
- **[Sable](https://github.com/ryanhcode/sable) 1.2.2+** (and whatever Sable itself needs — Create, Veil)

## Installation

Drop the jar in your `mods` folder alongside Sable. No config needed beyond two client-side list-coloring thresholds (`LONG_LIFE_DAYS` /
`NO_MOVEMENT_DAYS`) in the generated config.

## Known limitations

- **Single-dimension** — lists the dimension the command was r
- Shafts / cogwheels render with a **cosmetic doubled look** in the diagram (a rotated copy over the static model). Cosmetic only — it doesn't affect
anything.
- With an **Iris shaderpack** active, the diagram may show some blocks as invisible. Switch to internal/vanilla shaders while using `/sablecleanup` as a
workaround.
- Freeze is a soft physics-constraint pin, not a true engine-level pause (Sable has no per-body pause).

## License & credits

MIT. Built against **Sable** by ryanhcode — this mod only links to Sable's public API and doesn't bundle or modify it.

Sable Cleanup Tools

(new demo vid coming soon)

An operator toolkit for finding, inspecting, and cleaning up Sable sub-levels — the physics contraptions behind Create: Aeronautics and other Sable-based content.

Airships, rovers, and other contraptions pile up over a server's lifetime: abandoned builds, runaways, half-finished projects drifting in chunks nobody's loaded in weeks. Sable Cleanup Tools gives operators one GUI to see every sub-level in the dimension — including ones sitting in unloaded chunks — and act on them safely.

Works with any Sable-based contraption, not just Create: Aeronautics. It only talks to Sable's own API.

✨ New in 0.3.0

• Multi-select + bulk actions — checkboxes on every row (Ctrl+A selects all); delete, freeze, or boot a whole batch at once.
• Schematic browser — browse, preview, and manage the schematics you've exported, right in the GUI.
• Sort & search — sort by Age, Name, Last Active, Size, orve by name.- Teleport variants — jump to a contraption's plot or it Move Here to bring the sub-level to you.
• Save-schematic bearing warning — warns before exporting a contraption with an active bearing.

What it does

Run /sablecleanup (operator / permission level 2), or bind a key under Controls → Sable Cleanup Tools, to open the panel:

• A scrollable list of every sub-level in the current dimension — id, name, and a lifetime / created-at counter. - At-a-glance moderation coloring: orange once a sub-level 7 days), red if it's also gone that long without moving,green if you've flagged it "ignore". - A live 3D diagram preview with drag-to-orbit and scroll-ion actually is before you touch it.
• Unloaded sub-levels show up too (marked (unloaded)). Clicking any action transparently force-loads its chunk just long enough to act, then lego back to sleep. ## Actions - Teleport — jump to the contraption (plot or current visu
• Delete — remove a sub-level. Refuses if something's still physically attached or an active Create contraption is inside, so you can't silently destroy those too.
• Freeze / Unfreeze — pin it in place with a real physics constraint that survives restarts.
• Boot / Un-boot — moderation lockdown: forces Freeze on ae / un-Freeze (and block-breaking inside) until un-booted, soanything a staff member is actively reviewing can't move or vanish out from under them.
• Rename — set the sub-level's display name.
• Save as schematic — export its blocks to a Create-compatible .nbt schematic (needs Create; everything else works without it).
• Disassemble — move the blocks back into the plain world he reverse of assembling a contraption. Guards againstdestroying attached contraptions or in-plot entities.
• Ignore flags — mark a sub-level as reviewed and fine to
• Hold shift over an option for a description of what it does

Requirements

• Minecraft 1.21.1, NeoForge 21.1.228+
• Sable 1.2.2+ (and whatever Sable itself needs — Create, Veil)

Installation

Drop the jar in your mods folder alongside Sable. No config needed beyond two client-side list-coloring thresholds (LONG_LIFE_DAYS / NO_MOVEMENT_DAYS) in the generated config.

Known limitations

• Single-dimension — lists the dimension the command was r
• Shafts / cogwheels render with a cosmetic doubled look in the diagram (a rotated copy over the static model). Cosmetic only — it doesn't affect anything.
• With an Iris shaderpack active, the diagram may show some blocks as invisible. Switch to internal/vanilla shaders while using /sablecleanup as a workaround.
• Freeze is a soft physics-constraint pin, not a true engine-level pause (Sable has no per-body pause).

License & credits

MIT. Built against Sable by ryanhcode — this mod only links to Sable's public API and doesn't bundle or modify it.