# \u26a1 RayLagFix<\/p>\n
**RayLagFix** is a modern, lightweight, and advanced **server lag reduction & optimization plugin** for **Paper\/Purpur Minecraft 1.21+** servers.<\/p>\n
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** \u2014 all in a clean and optimized package.<\/p>\n
—<\/p>\n
## \u2728 Why RayLagFix?<\/p>\n
If your server struggles with:<\/p>\n
– Too many dropped items
\n– Projectile buildup
\n– Excessive XP orbs
\n– Entity overload in chunks
\n– Random lag spikes
\n– TPS drops during busy hours
\n– Old lag plugins that feel outdated or unsafe<\/p>\n
Then **RayLagFix** is designed for exactly that.<\/p>\n
It helps reduce lag **intelligently**, with **safe defaults** for survival servers and **advanced controls** for larger networks.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Key Features<\/p>\n
### \ud83e\uddf9 Smart Automatic Cleanup
\n– Automatic cleanup of:
\n – Dropped items
\n – Projectiles
\n – XP orbs
\n – Abandoned vehicles
\n – Excess entities (configurable)
\n– Timed cleanup cycles with configurable intervals
\n– Designed to reduce clutter without breaking gameplay<\/p>\n
### \ud83d\udee1\ufe0f Safe by Default
\nRayLagFix is built to be safe for SMP \/ survival servers.<\/p>\n
By default, it can preserve:
\n– Named mobs
\n– Tamed pets
\n– Villagers
\n– Important entities
\n– Whitelisted entity types
\n– Protected worlds<\/p>\n
No aggressive \u201cdelete everything\u201d behavior unless **you** enable it.<\/p>\n
### \ud83d\udcca Real-Time Performance Monitoring
\n– TPS tracking
\n– MSPT support (Paper)
\n– RAM usage overview
\n– Loaded chunk tracking
\n– Entity count monitoring
\n– Dropped item statistics
\n– Cleanup result reports<\/p>\n
### \ud83d\udea8 Emergency Lag Protection
\nWhen TPS drops too low, RayLagFix can automatically trigger:
\n– Emergency cleanup
\n– Performance-safe response actions
\n– Alert messages
\n– Rapid lag recovery logic<\/p>\n
Perfect for sudden lag spikes caused by farms, grinders, mob piles, or item abuse.<\/p>\n
### \ud83c\udfa8 Modern & Premium Visuals
\n– Animated countdown warnings
\n– BossBar cleanup countdown
\n– ActionBar notifications
\n– Title warnings
\n– Sound alerts
\n– Colorful MiniMessage formatting
\n– Gradient support
\n– Polished admin feedback<\/p>\n
### \ud83d\udda5\ufe0f Admin GUI
\nManage your server faster with a built-in admin GUI:
\n– Manual cleanup buttons
\n– Module toggles
\n– Performance stats
\n– Quick status view
\n– Fast access to common controls<\/p>\n
### \u2699\ufe0f Fully Configurable
\nIncludes multiple config files for deep customization:
\n– `config.yml`
\n– `messages.yml`
\n– `settings.yml`
\n– `gui.yml`
\n– `worlds.yml`<\/p>\n
You can customize:
\n– Cleanup intervals
\n– Warning timings
\n– BossBar \/ ActionBar \/ Titles
\n– Sounds
\n– Protected entities
\n– Per-world limits
\n– TPS thresholds
\n– Emergency mode behavior
\n– Messages & colors
\n– GUI layout and visuals<\/p>\n
### \ud83c\udf0d Per-World Support
\nApply different optimization rules per world:
\n– Survival
\n– Lobby
\n– Nether
\n– End
\n– Creative
\n– Minigames<\/p>\n
This is especially useful if your lobby needs stricter cleanup than your main world.<\/p>\n
### \ud83d\udd0c PlaceholderAPI Support
\nOptional PlaceholderAPI integration with placeholders like:
\n– `%raylagfix_tps%`
\n– `%raylagfix_mspt%`
\n– `%raylagfix_items%`
\n– `%raylagfix_entities%`
\n– `%raylagfix_chunks%`
\n– `%raylagfix_next_cleanup%`<\/p>\n
—<\/p>\n
## \ud83d\udce6 Compatibility<\/p>\n
### Supported Server Software
\n– \u2705 **Paper**
\n– \u2705 **Purpur**<\/p>\n
### Supported Minecraft Versions
\n– **1.21+**
\n– Tested for modern **1.21.x** environments<\/p>\n
### Java Version
\n– **Java 21+ required**<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
### Main Command
\n“`text
\n\/raylagfix<\/p>\n","protected":false},"excerpt":{"rendered":"
A modern, lightweight, and advanced lag reduction plugin for Paper\/Purpur 1.21+ servers \u2014 smart cleanup, TPS monitoring, emergency mode, admin GUI, and highly configurable performance optimization.<\/p>\n","protected":false},"featured_media":129346,"template":"","meta":{"_minecraft_slug":"raylagfix","_minecraft_project_id":"cgzaDQyr","_minecraft_author":"RayAstra","_minecraft_license":"MIT","_minecraft_downloads":55,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"raylagfix.zip","_minecraft_size_bytes":60928,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:55:40.144924Z","_minecraft_date_created":"2026-04-02T00:58:27.777467Z","_minecraft_date_modified":"2026-03-31T11:23:14.835859Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/raylagfix","_minecraft_icon_attachment_id":129346,"_minecraft_imported_at":"2026-06-07T14:48:21+00:00","_minecraft_import_hash":"3959a70bb61d066ddb825357cce2da2d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-129345","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n