FixLag

FixLag - A Minecraft 1.19+ Anti-Lag Plugin

FixLag is a lightweight yet powerful PaperMC plugin designed to help server administrators reduce lag by periodically removing problematic entities and alerting staff when entity counts exceed predefined thresholds.

📌 Features

✅ Automatic Entity Cleanup

• Removes TNT, Minecarts, Arrows, Snowballs, and Dropped Items every configurable interval (default: 300 seconds).
• Sends warnings at 3 minutes, 1 minute, 30 seconds, and 10 seconds before cleanup.
• Notifies players when cleanup is complete with the total number of removed entities.
• Minecarts with hoppers are ignored to keep farms working

✅ Entity Load Monitoring

• Detects excessive entities and warns players with fixlag.warning permission when any of the following are exceeded:
  • 50+ Villagers
  • 100+ Dropped Items
  • 75+ Primed TNT
  • 10+ Minecarts in one block

✅ Manual Cleanup Command (/fixlag)

• Grants OPs by default the ability to manually trigger entity cleanup.
• Displays a clickable button (&c[Take Action]) in warning messages for fast response.

✅ Fully Configurable

• Adjust cleanup intervals via config.yml.
• Change entity thresholds for warnings.
• Customize permissions (fixlag.warning for alerts, fixlag.command for manual cleanup).

---

📖 How It Works

1️⃣ FixLag continuously monitors entity counts on the server.
2️⃣ If excessive TNT, Minecarts, Villagers, or Items are detected, staff are notified.
3️⃣ A clickable button (&c[Take Action]) allows instant cleanup using /fixlag.
4️⃣ At set intervals, TNT, Minecarts, and Dropped Items are removed, reducing lag.

---

⚙️ Configuration (config.yml)

# List of entity types to delete (case-insensitive, use uppercase Bukkit EntityType names)
entities-to-delete:
  - ITEM
  - ARROW
  - FIREWORK_ROCKET
  - BOAT
  - MINECART
  # Add more entity types as needed

# Interval in seconds between entity deletion checks
deletion-interval-seconds: 180 # 3 min

# Enable sending a warning message to players before entity deletion
enable-warning: true

# Message to send to players before entity deletion.
# Use %time% as a placeholder for the warning time in seconds.
# You can use color codes (e.g., &e for yellow, &6 for gold).
warning-message: "&eEntities will be cleared in &6%time% &eseconds."

# Time in seconds before deletion to send the warning message
warning-time-seconds: 15

# Message to broadcast to all players after entities are cleaned up.
# Use %count% as a placeholder for the number of deleted entities.
# You can use color codes (e.g., &a for light green, &2 for dark green).
cleanup-broadcast-message: "&aCleaned up &2%count% &aunnecessary entities."

# Configuration for overload detection
overload-detection:
  # Radius in blocks to check for targeted entities around a player
  radius: 50
  # Number of targeted entities within the radius that triggers a warning
  critical-entity-count: 40
  # Interval in seconds to check for entity overloads
  check-interval-seconds: 90

---

🛠 Commands & Permissions

Command	Description	Permission	Default
/fixlag	Manually clear entities	fixlag.command	OP only

Feature	Permission	Default
Receive entity load warnings	fixlag.warning	OP only
Execute /fixlag command	fixlag.command	OP only

---

📥 Installation

1. Download the FixLag plugin (FixLag.jar).
2. Place it in your server’s /plugins/ folder.
3. Restart your server to generate the config.yml file.
4. Adjust settings in config.yml as needed.
5. Enjoy a lag-free experience! 🚀

---

📌 Why Use FixLag?

✔ Reduces lag automatically without needing admin intervention. ✔ Warns staff before performance drops occur.
✔ Lightweight and optimized for large servers.
✔ Fully customizable and configurable.

---

🔹 Compatible with Minecraft 1.19+
🔹 Supports PaperMC & it's forks for maximum performance
🔹 Lightweight, no unnecessary overhead

🚀 Get control over server lag today with FixLag! 🚀

FAQ

Q: What happened to legacy?

A: It is terminated due to the lack of demand & difficulty to maintain.

Q: xyz isn't working!

A: Report it in the GitHub issue tracker as I currently do not have a dedicated Discord server for support.

Q: I want xyz in the plugin!

A: Kindly suggest it in the GitHub issue tracker and label it as an "enhancement" so that I can tell between a bug and a suggestion