Crash Utilities Mod — Guide

Player and Inventory Management

Crash Utilities allows administrators to interact with players even when they are not currently logged into the server.

Remote Inventory Access

The /cu inventory read <player> command generates a clickable list of every item in a player's possession. This includes: * Main Inventory: All 36 standard slots. * Armor Slots: Helmet, Chestplate, Leggings, and Boots. * Offhand: The item held in the offhand. * Curios: Full support for the Curios API, allowing admins to see rings, necklaces, and other accessory slots.

If an item is identified as problematic (e.g., a corrupted item causing crashes), the admin can click the item in the chat log to generate a /cu inventory remove command to delete it safely.

Unstuck and Teleportation

The /cu unstuck command is a fail-safe for players trapped in corrupted chunks or death loops. By sending them to the Overworld spawn, it resets their position safely. The /cu tp command extends standard teleportation by allowing admins to move players across dimensions without the need for the player to be online, which is critical for fixing character-data issues.

Automated Maintenance

The mod includes an automated system to prevent server lag caused by too many items dropped on the ground (e.g., from a broken chest or an overflowing farm).

Ground Item Clearing

This feature is disabled by default and must be enabled in the server configuration. When active, the mod performs the following steps: 1. Check: Every X minutes, it counts the total number of items on the ground across all loaded chunks. 2. Threshold: If the count exceeds the configured limit, the cleanup process begins. 3. Warning: The mod sends warnings to all players in chat at set intervals (e.g., 60 seconds before, 30 seconds before). 4. Removal: All item entities on the ground are deleted to restore server performance.

Administrators can force this check at any time using /cu callItemClear.

Performance Monitoring

The /cu memoryCheck command provides a snapshot of the server's RAM usage. It tracks the allocated, used, and free memory over a period defined in the configuration. This is vital for identifying memory leaks or determining if the server requires more dedicated RAM to handle the current modpack load.

Entity and Tile Entity Management

One of the most powerful features of Crash Utilities is the ability to pinpoint sources of lag caused by excessive entities or complex tile entities (like machines or chests).

Entity Tracking

Using /cu entities list, administrators can see which entity types are most prevalent. Clicking on an entry in the chat output will automatically suggest the /cu entities find <type> command. This second command provides a list of chunks where those entities are located. Clicking the coordinates in the list will teleport the administrator directly to the chunk to investigate or clear the entities.

Tile Entity Tracking

Similar to entity tracking, the /cu tileentities (or /cu te) commands allow admins to find blocks that may be causing tick lag. This is especially useful for identifying "lag machines" or malfunctioning automated farms. The output provides direct teleport links to the specific coordinates of the tile entities.