UltClearLagg

---

Overview

UltClearLagg is a complete server optimization plugin built for modern Minecraft servers running Paper/Purpur 1.21+.

Unlike basic clear lag plugins that only remove ground items, UltClearLagg provides a modular optimization system that includes:

• Automatic item cleanup
• Projectile cleanup
• Mob culling systems
• Mob stacking
• TPS and MSPT monitoring
• Chunk unloading
• Physics optimization
• Anti-redstone-lag detection
• Illegal/crash item protection
• Bedrock GUI compatibility
• ActionBar + BossBar notifications
• Performance dashboards
• AI freezing during low TPS situations
• Configurable world filtering
• Advanced MiniMessage formatting support

The plugin protects important entities such as:

• Named mobs
• Villagers
• Tamed pets
• Valuable items
• Important worlds

---

Features

Smart Automatic Cleanup

Automatically clears:

• Ground items
• Stuck projectiles
• Excess mobs
• Idle entities

Supports scheduled warnings before cleanup using:

• Chat messages
• ActionBars
• BossBars

Warnings are fully customizable inside messages.yml.

---

TPS & MSPT Monitoring

Real-time performance monitoring system.

Displays:

• 1m TPS
• 5m TPS
• 15m TPS
• MSPT
• RAM usage
• Max memory

Useful for detecting:

• Lag spikes
• Entity overload
• Memory pressure
• Redstone abuse
• Chunk problems

---

Entity Management System

Ground Item Cleanup

Supports:

• Whitelist mode
• Blacklist mode
• Valuable item protection
• Permission bypasses

Example protected items:

• Diamonds
• Netherite
• Totems
• Player heads

---

Projectile Cleanup

Removes lag-causing projectiles such as:

• Arrows
• Tridents
• Snowballs
• Eggs
• Spectral arrows

Supports preserving named tridents.

---

Mob Culling

Prevents mob overload by enforcing:

• Per-chunk limits
• Per-world limits

Can protect:

• Named mobs
• Tamed pets
• Villagers
• Iron golems
• Traders

---

Mob Stacking

Combines nearby mobs into optimized stacks.

Benefits:

• Lower entity count
• Better TPS
• Reduced CPU load
• Cleaner farms

Fully configurable stack radius and stack sizes.

---

Physics Optimization

Includes systems to reduce:

• Falling block lag
• Physics spam
• Excessive updates
• Redstone lag machines

Useful for:

• SMP servers
• Survival servers
• Factions
• Skyblock
• Large public servers

---

Anti-Lag Module

Advanced lag protection systems.

Includes:

• AI freezing during low TPS
• Garbage collection hints
• Chunk unloading
• Redstone clock detection
• Crash item protection

---

Bedrock Edition GUI Support

Integrated Floodgate compatibility.

Bedrock players can interact with menus and dashboards through forms.

Optional dependencies:

• Floodgate
• ProtocolLib

---

MiniMessage Support

All plugin messages support MiniMessage formatting.

Examples:

<gradient:#FF6B35:#FFD700>UltClearLagg</gradient>

<click:run_command:'/ucl tps'>Check TPS</click>

<hover:show_text:'Server TPS'>TPS</hover>

Supports:

• RGB colors
• Gradients
• Hover text
• Click events
• Formatting
• Animations

---

Commands

Main Command

/ucl

Aliases:

/clearlagg
/cl

---

Available Subcommands

TPS Monitor

/ucl tps

Displays:

• TPS
• MSPT
• RAM usage
• Performance statistics

---

Manual Cleanup

/ucl clear

Forces an immediate cleanup cycle.

---

Reload Configuration

/ucl reload

Reloads:

• config.yml
• messages.yml

Without restarting the server.

---

Kill Mobs

/ucl killmobs

Kills excessive mobs instantly.

---

Admin Dashboard

/ucl admin

Opens the administrative optimization dashboard.

---

Permissions

Permission	Description	Default
ultclearlagg.use	Basic plugin usage	true
ultclearlagg.admin	Full admin access	op
ultclearlagg.notify	Receive cleanup warnings	true
ultclearlagg.bypass.items	Prevent dropped items from being cleared	false
ultclearlagg.bypass.mobs	Protect player tamed mobs	false

---

Installation

Requirements

• Java 21+
• Paper 1.21+
• Purpur 1.21+

Recommended:

• Floodgate
• ProtocolLib

---

Setup Steps

1. Download UltClearLagg.jar
2. Place it inside your server plugins/ folder
3. Start the server
4. Configure files inside:

/plugins/UltClearLagg/

1. Restart or reload using:

/ucl reload

---

Configuration

World Filter

world-filter:
  mode: BLACKLIST
  worlds:
    - creative_world
    - minigames

Modes:

• BLACKLIST = plugin works everywhere except listed worlds
• WHITELIST = plugin only works in listed worlds

---

Cleanup Schedule

cleanup-schedule:
  enabled: true
  interval: 300
  warnings:
    - 60
    - 30
    - 10
    - 5

This example:

• Runs cleanup every 5 minutes
• Warns players before cleanup

---

Item Protection

item-clear:
  list-mode: BLACKLIST
  items:
    - DIAMOND
    - NETHERITE_INGOT

BLACKLIST mode:

• Keeps listed items
• Removes everything else

WHITELIST mode:

• Removes only listed items

---

Mob Culling

mob-culling:
  per-chunk-limit: 10
  per-world-limit: 500

Prevents entity overload automatically.

---

Mob Stacking

mob-stacking:
  enabled: true
  stack-radius: 5
  max-stack-size: 50

Combines nearby identical mobs.

---

Messages Configuration

All plugin messages are stored inside:

messages.yml

Features:

• MiniMessage support
• RGB colors
• Gradients
• Hover events
• Click events
• Placeholder support

Example:

warning: "<yellow>⚠ Cleanup in <red>{0}</red> seconds!"

---

Performance Recommendations

Small Servers (1-20 players)

cleanup-schedule:
  interval: 600

mob-culling:
  per-world-limit: 300

---

Medium Servers (20-80 players)

cleanup-schedule:
  interval: 300

mob-culling:
  per-world-limit: 500

---

Large Servers (80+ players)

cleanup-schedule:
  interval: 180

mob-culling:
  per-world-limit: 800

Enable:

• Mob stacking
• AI freezing
• Chunk unloading
• Projectile cleanup

---

Included Systems

Core Systems

• CleanupTask
• TPSMonitor
• ModuleManager
• NotificationManager
• ConfigManager
• GUIManager

---

Modules

EntityModule

Handles:

• Item cleanup
• Projectile cleanup
• Mob culling
• Mob stacking

---

PhysicsModule

Handles:

• Physics lag reduction
• Falling block control
• Redstone optimization

---

WorldModule

Handles:

• Chunk management
• World cleanup
• Entity scans

---

AntiLagModule

Handles:

• AI freezing
• Emergency optimization
• Lag spike response

---

Safety Notes

Some settings can be aggressive.

Be careful when modifying:

• Hopper tick systems
• Mob limits
• Physics controls
• AI freezing
• Chunk unloading

Always:

• Backup your worlds
• Test on a local server first
• Increase limits slowly
• Monitor TPS after changes

---

Compatibility

Fully Supported

• Paper
• Purpur
• Pufferfish

---

Soft Dependencies

Plugin	Purpose
Floodgate	Bedrock GUI support
ProtocolLib	Packet optimization features

---

Technical Information

Built With

• Java
• Paper API
• Adventure API
• MiniMessage

---

API Version

api-version: '1.21'

---

Example Use Cases

Survival SMP

• Reduce farm lag
• Clear projectiles
• Prevent mob overflow
• Monitor TPS

---

Factions

• Stop cannon lag
• Reduce redstone abuse
• Clear entity spam
• Improve combat performance

---

Skyblock

• Limit mob grinders
• Stack entities
• Reduce hopper lag
• Control chunk overload

---

Minigames

• Fast cleanup cycles
• Projectile removal
• Better arena performance

---

Troubleshooting

Plugin Not Working

Check:

• Server version is 1.21+
• Java version is correct
• Plugin loaded successfully
• Config syntax is valid

---

TPS Still Low

Possible causes:

• Too many plugins
• Massive redstone systems
• Large mob farms
• World corruption
• Insufficient RAM

Try:

• Lowering entity limits
• Enabling mob stacking
• Reducing view distance
• Using Paper/Purpur

---

Bedrock GUI Not Opening

Install:

• Floodgate

Then restart the server.

---

Developer Information

Main Package

com.ultclearlagg

---

Important Classes

Class	Purpose
UltClearLagg	Main plugin bootstrap
CleanupTask	Cleanup scheduler
TPSMonitor	Performance monitor
CommandHandler	Command system
NotificationManager	Warning notifications
GUIManager	Inventory GUIs
AdminDashboard	Admin GUI
BedrockFormHandler	Bedrock forms

---

Credits

Created by:

geturplugins

Discord:

https://discord.gg/xctckUQukB

---

Support

Need help?

Join the Discord server for:

• Bug reports
• Support
• Suggestions
• Updates
• Feature requests

Discord:

https://discord.gg/xctckUQukB

Showcase video :-

---

Final Notes

UltClearLagg is designed for server owners who want a modern, configurable, and aggressive optimization solution without sacrificing important gameplay systems.

Whether you're running:

• SMPs
• Factions
• Skyblock
• Lifesteal
• Minigames
• Public networks

UltClearLagg provides the tools needed to keep your server smooth and stable under heavy load.