🛠️ FixLag - Ultimate Server Performance & Optimization

FixLag is a modern, lightweight, and highly configurable Minecraft server optimization plugin. It goes beyond simple entity clearing by offering reactive lag prevention, mob stacking, detailed performance monitoring, and a unique safety net for accidental item deletions.

✨ Key Features

🧹 Smart Entity Cleanup

Automated Schedules: Configurable interval to remove ground items, arrows, and other entities to keep your server clean.

Reactive "Smart Clear": Automatically triggers an emergency cleanup if the server TPS (Ticks Per Second) drops below a defined threshold (e.g., 16.0 TPS).

Customizable Whitelists: Fully control which entities are removed and which are ignored.

Name Tag Protection: Automatically ignores items or mobs that have been renamed (via Anvil or Name Tag) to protect player valuables.

♻️ Item Recovery System (Undo)

Safety Net: Did the cleaner run while someone dropped some valuables on the ground? You don't have to be annoyed by these support tickets again!

GUI Retrieval: Use /fixlag retrieve to open a GUI and recover items deleted in the last cleanup.

Auto-Expiry: The recovery chest automatically clears itself after a short period to prevent memory leaks.

📦 Efficient Mob Stacking

Performance Boost: Automatically stacks nearby mobs of the same type to drastically reduce entity counts without affecting gameplay rates.

Seamless Integration: Mobs unstack one by one upon death.

Visual Indicators: Customizable display names show stack sizes (e.g., Zombie x5).

📊 Performance Monitoring

Server Info: Get real-time stats including TPS (1m, 5m, 15m), RAM usage, CPU load, and average ping with /serverinfo.

Garbage Collection: View detailed JVM memory and Garbage Collector statistics via /gcinfo to diagnose deeper performance issues.

⚠️ Overload Detection

Proactive Warnings: Detects when a specific area or player has an abnormal amount of entities nearby.

Staff Alerts: Notifies online staff members of potential lag sources so they can investigate before the server crashes.

💻 Commands

Command

Permission

Description

/fixlag

fixlag.command

Manually triggers the entity deletion task immediately.

/fixlag retrieve

fixlag.retrieve

Opens a GUI to recover items deleted in the last batch.

/serverinfo

fixlag.serverinfo

Displays TPS, RAM, CPU, and World entity counts.

/gcinfo

fixlag.gcinfo

Displays detailed Java Garbage Collection and Heap stats.

🛡️ Permissions

Permission Node

Default

Usage

fixlag.command

OP

Allow manual cleanup triggering.

fixlag.retrieve

OP

Allow access to the item recovery menu.

fixlag.serverinfo

OP

Allow viewing server performance stats.

fixlag.gcinfo

OP

Allow viewing JVM/GC stats.

fixlag.notify.update

OP

Receive login alerts when a new update is available.

fixlag.overload.notify

OP

Receive alerts when an entity overload is detected.

fixlag.overload.exempt

False

Players with this permission won't trigger overload warnings.

⚙️ Configuration

FixLag is designed to be plug-and-play, but almost every aspect is configurable in config.yml.

Highlights:

MiniMessage Support: Use modern RGB formatting (e.g., <#ff0000>) in all messages.

Cooldowns: Prevent "Smart Clear" from triggering too often.

Mob Stack Rules: Define specific radii and max stack sizes.

# Example Configuration Snippet
smart-clear:
  enabled: true
  tps-threshold: 16.0
  check-interval-seconds: 10
  cooldown-seconds: 300

mob-stacking:
  enabled: true
  radius: 10
  max-stack-size: 50
  allowed-entities:
    - ZOMBIE
    - SKELETON

Fixing lag without breaking farms! 🚀