LagBuster Plugin — Setup & Guide

1. What LagBuster Does

• Automatically checks dropped items on a periodic schedule and clears them when a configured threshold is reached.
• Provides a `/lagclear` command to manually clear dropped items and/or passive mobs.
• Provides a `/tps` command that reports recent server TPS (if available on your server build).

2. Installation

1. Build the plugin with Maven: mvn package.
2. Copy the generated JAR from target/novaannouncer-1.0.0.jar to your server's plugins/ folder.
3. Start or restart your server.
4. On first run, LagBuster will create a config file at plugins/LagBuster/config.yml.

3. Configuration

The config file is located at:

plugins/LagBuster/config.yml

By default, it contains:

# LagBuster configuration
# All times are in server ticks (20 ticks = 1 second).

# How often the plugin will auto-clear dropped items (in ticks).
# Set to 0 to disable auto-clearing.
clearIntervalTicks: 6000

# Maximum number of dropped item entities allowed before clear is triggered.
# If the number of dropped items is above this threshold, they will be cleared.
maxDroppedItems: 120

# Whether to also clear passive mobs (e.g., animals) when /lagclear all is used.
# This does not run automatically.
clearMobsWithAll: true

# Log extra debug info to the server log.
debug: false

• clearIntervalTicks — how often the plugin checks item counts (20 ticks = 1 second).
• maxDroppedItems — threshold that triggers an immediate cleanup when reached.
• clearMobsWithAll — controls whether /lagclear all also clears passive mobs.
• debug — when true, the plugin logs extra info to the console.

4. Commands

• /lagclear — clears dropped items (default).
• /lagclear drops — same as /lagclear.
• /lagclear mobs — clears passive mobs (animals, villagers, etc.).
• /lagclear all — clears drops and, if enabled, passive mobs.
• /tps — shows recent server TPS (1m/5m/15m, if supported).

Permissions:

• lagbuster.clear — required to run /lagclear.
• lagbuster.tps — required to run /tps.

5. Notes

• If your server implementation does not expose TPS via the Bukkit API, the /tps command will report that it’s unavailable.
• Clearing mobs can remove passive entities like cows, chickens, and villagers. Use /lagclear all carefully on live servers.

6. Extending LagBuster

Want extra features? Some ideas that pair well with LagBuster:

• Auto-clear based on TPS rather than just item count.
• Per-world/region whitelist or blacklist for clearing.
• Configurable entity type lists for /lagclear mobs.