⚡ 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

RayLagFix