RayLagFix

# ⚡ 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 ```text /raylagfix