Excrele's System Booster (ESB)
Excrele's System Booster (ESB) is a Spigot plugin designed for Minecraft server administrators to monitor and optimize server performance. Updated for Spigot 1.21.5, it provides a user-friendly in-game GUI to access tools for server management, including performance metrics, entity and mob scanning, ground clutter management, redstone detection, chunk corruption scanning, and chunk regeneration. This version includes fixes for accurate detection of copper bulb variants in the redstone scan and uses EntityType.ITEM for ground clutter management. All commands and features are protected by permissions, with asynchronous operations to enhance performance.
Features
- Server Information: Displays RAM allocation and usage, CPU utilization (using modern metrics), loaded chunks, entities, mobs, connected players, and server TPS (ticks per second).
- Entity Scan: Identifies the top 5 chunks with the most entities, listing their coordinates and counts (asynchronous).
- Mob Scan: Identifies the top 5 chunks with the most mobs, listing their coordinates and counts (asynchronous).
- Ground Clutter Management: Scans for dropped items (EntityType.ITEM), assigns a 5-minute despawn timer, and displays a countdown above each item.
- Redstone Scan: Identifies the top 5 chunks with the most redstone components, including all copper bulb variants (e.g., COPPER_BULB, EXPOSED_COPPER_BULB) introduced in 1.21 (asynchronous).
- Chunk Corruption Scan: Detects corrupted chunks across loaded worlds with reasons for suspected corruption (asynchronous).
- Chunk Regeneration: Checks if the player’s current chunk is corrupted and regenerates it to its original seed state if necessary (asynchronous).
- GUI Interface: All features are accessible via an intuitive in-game GUI, opened with the /esb command.
- Permission-Based Access: All commands and GUI actions require specific permissions, ensuring only authorized users can perform actions.
Usage
Command
- Command: /esb
- Description: Opens the ESB Control Panel GUI.
- Permission: esb.use (defaults to operators only).
GUI Navigation
After running /esb, a GUI with 27 slots opens, containing the following options:
- Server Information (Paper icon): Displays server metrics like RAM, CPU (using modern metrics), chunks, entities, mobs, players, and TPS.
- Permission: esb.serverinfo
- Scan Entities (Compass icon): Lists the top 5 chunks with the most entities (asynchronous).
- Permission: esb.entityscan
- Scan Mobs (Zombie Head icon): Lists the top 5 chunks with the most mobs (asynchronous).
- Manage Ground Clutter (Dropper icon): Scans for dropped items (EntityType.ITEM) and sets a 5-minute despawn timer with a visible countdown.
- Permission: esb.groundclutter
- Scan Active Redstone (Redstone icon): Lists the top 5 chunks with the most redstone components, including all copper bulb variants (asynchronous).
- Permission: esb.redstonescan
- Scan Chunk Corruption (Barrier icon): Lists all corrupted chunks with reasons for corruption (asynchronous).
- Permission: esb.chunkcorruption
- Regenerate Current Chunk (Grass Block icon): Checks and regenerates the player’s current chunk if corrupted (asynchronous).
- Permission: esb.regeneratechunk
Click an item in the GUI to execute the corresponding action. If you lack the required permission, a message will inform you.
Permissions
The plugin defines the following permissions, all defaulting to op:
- esb.use: Allows use of the /esb command to open the GUI.
- esb.serverinfo: Allows viewing server information.
- esb.entityscan: Allows scanning for entities.
- esb.mobscan: Allows scanning for mobs.
- esb.groundclutter: Allows managing ground clutter.
- esb.redstonescan: Allows scanning for redstone components.
- esb.chunkcorruption: Allows scanning for chunk corruption.
- esb.regeneratechunk: Allows regenerating chunks.