Shtreimel

A server admin toolkit for Sable and Create Aeronautics. Find lag-causing airships, freeze runaways, undo accidental griefing, and stop guessing which contraption was on the server when it crashed.

NeoForge 1.21.1 only. Server-only install. No client mod required.

"Shtreimel" is the fur hat worn over a sable lining. It's a hat that goes on top of Sable. The name is a joke; the mod is not.

Why you want this

You run a Sable or Create Aeronautics server. Eventually one of these happens:

• Someone builds a 50,000-block monster contraption and your TPS dies. You don't know whose, where, or how to stop it without /stop.
• A player flies an airship out of survival range and it never comes back. Or it gets stuck in midair. Or it falls into the void.
• Someone you trust runs /sable remove on the wrong contraption and you have nothing to roll back to.
• Your server crashes and the crash report says "physics tick" with no other information.

Shtreimel gives you commands for every one of those.

What it does

Find the lag

When a dimension's physics gets hot, Shtreimel picks the most-likely-suspect contraption and prints one line in the server console with its position, owner-given name, UUID, and bounding box.

Example console line:

[shtreimel.lag] lag suspect dim=minecraft:overworld ewma=7.43ms max60=18.20ms uuid=8a1f... name="Big Blimp" plot=(10005,10003) center=(124.0,72.5,-88.3) bb=24x10x32 suspect=83

If your server is heavier or lighter than typical, run /shtreimel lag autotune after a few hours of normal play and it prints recommended thresholds for the config.

You can also pull a live ranking on demand:

• /shtreimel rank
• /shtreimel physics-stats
• /shtreimel list

Stop the lag

• /shtreimel freeze <uuid>
• /shtreimel freeze nearest
• /shtreimel unfreeze <uuid>

freeze pins a contraption in place without pausing physics for the whole dimension. The pin sticks across server restarts.

• /shtreimel delete uuid <uuid> --confirm
• /shtreimel delete at <x> <y> <z> --confirm
• /shtreimel delete nearest --confirm

delete runs Sable's own removal path. Same cleanup as /sable remove.

Undo your mistakes

• /shtreimel archive save <uuid>
• /shtreimel archive list
• /shtreimel archive restore <uuid> <archiveId>

archive save writes the contraption's full block data to disk. restore brings it back, optionally with the same UUID. Per-contraption undo.

Inspect a contraption

/shtreimel info <uuid>

Pose, bounding box, mass, center of mass, reaction wheels, queued forces, network drift, who's currently inside it, who's tracking it, lag-score breakdown. In-game, the header has clickable [teleport], [freeze], [archive] buttons.

Find what's where

• /shtreimel at <x> <y> <z>
• /shtreimel in <fromPos> <toPos>
• /shtreimel near
• /shtreimel who <uuid>
• /shtreimel watch <uuid>

at says which contraption is at a block position. in lists every contraption in a region. near lists what's around the calling player. who says which players are inside a contraption right now. watch subscribes a staff member to live pose updates for a contraption for N seconds (great for following an airship live).

Teleport to it

• /shtreimel tp <uuid>
• /shtreimel tp player <playerName> <uuid>
• /shtreimel tp back

Teleports to the top of the contraption's bounding box. tp back returns you to where you were.

See who did what

• /shtreimel audit tail
• /shtreimel audit since 1h
• /shtreimel audit by Steve
• /shtreimel audit uuid <uuid>

Every destructive command (delete, freeze, archive save) writes a single line to <world>/shtreimel/audit.log. Query it from in-game.

Better crash reports

When Sable's physics tick crashes, Shtreimel adds a block to the crash report listing every loaded contraption (UUID, name, position, bounding box) and per-dimension physics timing.

Permissions

With no permissions mod installed, Shtreimel uses vanilla op levels:

• Op 2: read-only commands.
• Op 3: destructive commands (delete, freeze, archive save / restore / prune).
• Op 4: skip the --confirm token. Server console and RCON are op 4.

If you run a permissions mod (LuckPerms, FTB Ranks, etc.), the named nodes are:

• shtreimel.observe
• shtreimel.delete
• shtreimel.delete.confirm_bypass
• shtreimel.audit.read

Install

1. Make sure your server has Sable 1.2.1 or newer in mods/.
2. Drop the latest shtreimel-neoforge-1.21.1-<version>.jar from the Files page into the same mods/ folder.
3. Start the server. The config generates at <world>/serverconfig/shtreimel-server.toml and reloads when you edit the file.

That's it. Nothing to install on your players' clients.

Compatibility

Honest limits

The "lag suspect" picker is a heuristic. Sable advances physics in a fused tick and doesn't expose per-contraption timing through any stable API, so Shtreimel cannot tell you "this contraption used 4ms of Rapier physics time last tick." It ranks by cheap proxies that usually correlate with cost: size, footprint, loaded chunks, block-entity count, speed, network drift, reaction wheels, queued forces, intersecting entities. Treat a high suspect score as somewhere to start looking, not as a verdict.

License

MIT. Bundled LICENSE file in the jar.