Crash Utilities

Crash Utilities
Name	Crash Utilities
Creator	Darkere
Latest Version	10.0.1
Minecraft Version	26.1.2
CurseForge	CurseForge
Root Mod	Stand Alone
Modpacks	Feed The Beast Evolution; Feed The Beast OceanBlock 2; Feed The Beast Skies 2; Feed The Beast StoneBlock 4; Feed The Beast Stoneblock 3; Feed The Beast Unstable 6

Crash Utilities is a mod by Darkere that adds a single multipurpose admin command (and several quality-of-life tasks) aimed at server owners. It does not add any items, blocks, entities or world generation. Everything happens through the /crashutilities command (alias /cu) or through scheduled tasks configured in the server config.

All commands require the gamemaster permission level. On a normal server that means the player has to be opped, on a single-player world the host has the permission by default.

Commands

The mod registers every action under one root command, /crashutilities. /cu is a short alias and behaves identically.

Server tools

/cu help: prints a summary of every subcommand into chat.
/cu memoryCheck <count>: prints the last <count> memory snapshots taken by the memory checker. The memory checker itself is enabled in the config.
/cu callItemClear: triggers the item-entity clear immediately. Used to test the configured warning timings or to run a manual clear outside the schedule.
/cu chunks <dim>: reports every currently loaded chunk in the given dimension. The output groups chunks by ticket and by player.
- /cu chunks <dim> byLocation <loc>: shows which tickets are holding the chunk at the specified location.
- /cu chunks <dim> byTicket <tic>: lists every chunk loaded by the specified ticket.

Player tools

/cu activity : lists player activity over the last days, week or month.
/cu tp <player> <pos> <dim>: teleports <player> to the given block position in the given dimension. Useful for moving an offline player out of a broken area.
/cu tp <player> <otherPlayer>: teleports <player> to the position of <otherPlayer>.
/cu unstuck <name>: tries to free a stuck player by moving them to a nearby safe spot.

Entities

Available under /cu e or any of entity, entities.

/cu entities entityData <dim>: lists every loaded entity in the dimension, grouped by registry id with counts.
/cu entities find <res> <dim>: finds every loaded entity of registry id <res> in the dimension.
/cu entities remove byType <type> <force>: removes every entity matching <type>. With the force flag the removal happens immediately rather than waiting for the next entity tick.
/cu entities remove hostile <force>: removes every entity that is tagged as hostile.
/cu entities remove regex <regex> <force>: removes every entity whose registry key matches the regex.
/cu entities remove items <force>: removes every dropped-item entity.
/cu entities remove items <name> <force>: removes every dropped-item entity matching <name>.

Block entities

Available under /cu blockentity or any of te, tileentity, tileentities, be, blockentities.

/cu blockentity entityData <dim>: lists every loaded block entity in the dimension, grouped by type with counts.
/cu blockentity find <res> <dim>: finds every loaded block entity of type <res> in the dimension.
/cu blockentity delete <pos>: deletes the block entity at the given position. The block itself stays in place; only its data and ticking are removed.

Inventories

Available under /cu i or /cu inventory.

/cu inventory read <name>: prints the inventory contents of the named player into chat.
/cu inventory remove <name> <slotType> <slot>: removes the item from the specified slot of the player's inventory. <slotType> chooses between main inventory, armor and the off-hand. Each item printed by read is also clickable and runs the matching remove command automatically.
/cu inventory open <player>: opens the named player's inventory in a GUI on the issuer's screen.
/cu inventory enderchest <player>: opens the named player's ender chest in a GUI on the issuer's screen.

Configuration

The server config (named after the mod id) is split into three sections. All values reload automatically when the file is saved.

Item Clear

Schedules a periodic item-entity sweep with chat and title warnings.

enabled (default false): turn the scheduled clear on or off.
timer (default 30): minutes between checks.
maximum (default 1000): only clear when more than this many loose item entities are loaded.
warnings (default "5,20"): comma-separated list of seconds before the clear at which a warning is broadcast.
title (default true): also fire a vanilla /title on the first warning.
titletext (default "ITEMCLEAR INCOMING!"): title text.
warningtext (default "ITEMCLEAR IN % SECONDS"): chat warning text. The first % is replaced with the current countdown.

Memory Checker

Polls memory use and writes warnings to the server log when it spikes.

enabled (default false): turn the memory checker on or off.
timer (default 5): seconds between memory polls.
timer (logged value, default 30): seconds between samples that are kept for display via /cu memoryCheck.
threshold (default 1000): warning trigger, in megabytes of growth between samples.
heapdump (default false): when memory passes 95 percent for the first time, run /spark heapdump. Requires Spark to be installed. The flag resets itself to false after firing once.

FTB Chunks

If FTB Chunks is installed, automatically unloads loaded chunks for players who have not been online recently.

enabled (default false): turn the auto-unload on or off.
days (default 7): days of inactivity after which a player's loaded chunks are released.

Optional integrations

Crash Utilities detects three optional mods at load:

Curios: when present, the inventory commands also surface Curios slots.
Spark: when present, the memory checker can trigger a Spark heap dump on emergency.
FTB Chunks: required for the auto-unload section of the config to do anything.