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)

# Time in seconds before entities are cleared (default: 300 seconds)
cleanup-interval: 300

# Time in seconds before entity warnings refresh (default: 60 seconds)
warning-refresh-interval: 60

# Entity limits before sending a warning
entity-thresholds:
  villagers: 50
  items: 100
  primed-tnt: 75
  snowballs: 50
  minecarts: 10

---

🛠 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