⚡ RayLagFix

RayLagFix is a modern, lightweight, and advanced server lag reduction & optimization plugin for Paper/Purpur Minecraft 1.21+ servers.

Built for server owners who want professional-grade lag control without sacrificing safety, RayLagFix delivers smart automatic cleanup, TPS/MSPT monitoring, emergency performance protection, colorful warnings, bossbar countdowns, admin GUI tools, and deep configuration — all in a clean and optimized package.

---

✨ Why RayLagFix?

If your server struggles with:

• Too many dropped items
• Projectile buildup
• Excessive XP orbs
• Entity overload in chunks
• Random lag spikes
• TPS drops during busy hours
• Old lag plugins that feel outdated or unsafe

Then RayLagFix is designed for exactly that.

It helps reduce lag intelligently, with safe defaults for survival servers and advanced controls for larger networks.

---

🚀 Key Features

🧹 Smart Automatic Cleanup

• Automatic cleanup of:
  • Dropped items
  • Projectiles
  • XP orbs
  • Abandoned vehicles
  • Excess entities (configurable)
• Timed cleanup cycles with configurable intervals
• Designed to reduce clutter without breaking gameplay

🛡️ Safe by Default

RayLagFix is built to be safe for SMP / survival servers.

By default, it can preserve:

• Named mobs
• Tamed pets
• Villagers
• Important entities
• Whitelisted entity types
• Protected worlds

No aggressive “delete everything” behavior unless you enable it.

📊 Real-Time Performance Monitoring

• TPS tracking
• MSPT support (Paper)
• RAM usage overview
• Loaded chunk tracking
• Entity count monitoring
• Dropped item statistics
• Cleanup result reports

🚨 Emergency Lag Protection

When TPS drops too low, RayLagFix can automatically trigger:

• Emergency cleanup
• Performance-safe response actions
• Alert messages
• Rapid lag recovery logic

Perfect for sudden lag spikes caused by farms, grinders, mob piles, or item abuse.

🎨 Modern & Premium Visuals

• Animated countdown warnings
• BossBar cleanup countdown
• ActionBar notifications
• Title warnings
• Sound alerts
• Colorful MiniMessage formatting
• Gradient support
• Polished admin feedback

🖥️ Admin GUI

Manage your server faster with a built-in admin GUI:

• Manual cleanup buttons
• Module toggles
• Performance stats
• Quick status view
• Fast access to common controls

⚙️ Fully Configurable

Includes multiple config files for deep customization:

• config.yml
• messages.yml
• settings.yml
• gui.yml
• worlds.yml

You can customize:

• Cleanup intervals
• Warning timings
• BossBar / ActionBar / Titles
• Sounds
• Protected entities
• Per-world limits
• TPS thresholds
• Emergency mode behavior
• Messages & colors
• GUI layout and visuals

🌍 Per-World Support

Apply different optimization rules per world:

• Survival
• Lobby
• Nether
• End
• Creative
• Minigames

This is especially useful if your lobby needs stricter cleanup than your main world.

🔌 PlaceholderAPI Support

Optional PlaceholderAPI integration with placeholders like:

• %raylagfix_tps%
• %raylagfix_mspt%
• %raylagfix_items%
• %raylagfix_entities%
• %raylagfix_chunks%
• %raylagfix_next_cleanup%

---

📦 Compatibility

Supported Server Software

• ✅ Paper
• ✅ Purpur

Supported Minecraft Versions

• 1.21+
• Tested for modern 1.21.x environments

Java Version

• Java 21+ required

---

🎮 Commands

Main Command

/raylagfix