Shtreimel: FTB Skies 2: Aero config options

Append destructive audit lines to <world>/shtreimel/audit.log in addition to the server log.

Register a CrashReportCallables header that lists loaded sub-levels and physics EWMA.

Apply the optional fallback mixin into Sable's SubLevelPhysicsSystem.tick crash path. Off by default; fragile against upstream Sable refactors.

If true, /shtreimel delete subcommands require an explicit --confirm flag.

If true, deleting a named sub-level requires re-typing the name as a confirm token.

Freeze a newly split child at its own pose when its parent is frozen.

Persist the frozen-set across server restarts to <world>/shtreimel/state/frozen.json.

Master switch for the autotuner sample recorder. Has near-zero cost when off.

Queue a full diagnostic snapshot when a hot incident is reported.

Master switch for the heat detector.

Capture the contraption being processed inside Create's ContraptionCollider.collideEntities. When the server crashes inside that path (e.g. propeller-collision NPEs from Aeronautics), the Shtreimel crash header prints the contraption's coordinates and entity id. Requires Create at runtime; safe to leave on for servers without Create (the mixin no-ops).

Audit Sable's NaN-recovery attempts (SubLevelPhysicsSystem#recoverSubLevel). Useful forensics when contraptions silently get removed.

Capture one caller stack frame at the exact SubLevelObserver removal callback. This is more reliable than a removeSubLevel mixin but retains the legacy config key.

Emit sub-level add/remove log lines at INFO; otherwise DEBUG.

Master switch. When off, nothing is sampled and the who history subcommands report that tracking is disabled.

Persist history to <world>/shtreimel/state/occupancy.json so 'who was last on this ship' survives a restart.

Format(s) to write when a snapshot is dumped. JSON|CSV|BOTH.

Maximum compressed plot.nbt size accepted for verify/restore.

Max archives to retain per sub-level UUID before pruning oldest.

Hard cap across all sub-levels.

Soft size cap for the audit log file before rotation.

Maximum bytes scanned per audit file by a filtered query.

Maximum sub-levels enumerated in crash output per dimension.

Maximum sub-levels whose individual point forces may be tracked at once.

How long completed summaries remain available to /shtreimel forces show.

Max simultaneously-frozen sub-levels per dimension. Bounded so a runaway freeze script cannot induce per-tick work spikes.

How many minutes of history to retain in the ring buffer.

Seconds between recorded samples. Lower means a denser history at higher memory cost.

Required consecutive hot scans before reporting. 1 preserves legacy behavior.

Per-dimension physics-slice EWMA above which the detector starts naming suspects, in milliseconds. Default 5.0 ms is well below a 50 ms tick budget; tune lower if you want earlier warnings.

Global cooldown between automatic incident snapshots.

Minimum seconds before the same sub-level can be named again. Prevents log spam.

Minimum seconds between heat scans. The detector returns immediately if this hasn't elapsed since the last scan, so the per-tick cost on a healthy server is one config read.

How many highest-ranked suspects to include in each hot-dimension incident.

Maximum exact add/remove events retained in memory for /shtreimel history and crash reports.

Maximum lifecycle log lines (add/remove) per dimension per minute.

Retained distinct players per sub-level, newest kept. Only each player's most recent visit is held, so one player boarding repeatedly cannot evict the others.

Total players with retained history before the least recently seen is dropped.

Total sub-levels with retained history before the least recently used is dropped.

Retained visits per player, newest kept. Bounds /shtreimel who player.

Minimum seconds between background writes. A final write always happens on stop.

Rows shown by /shtreimel who recent and /shtreimel who player without a limit.

Ticks between samples. Lower catches shorter hops at proportionally more cost; a boarding shorter than one interval may be missed entirely.

Disabled by default because traversing connected actors is more expensive.

Disabled by default because dependency traversal can query intersections.

Maximum bodies captured per dimension. Separate from the smaller crash-report limit.

Minimum ticks between events delivered to a watcher. Prevents spam from a velocity-spinning sub-level.