Sable CleanUp

# 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.