TPSGuardian - Best Premium Optimization Plugin | More Support!

TPS Guardian continuously monitors your server's TPS and CPU usage. When the server comes under load, it identifies the heaviest chunks and automatically applies temporary mitigations — then releases everything once the server recovers and notifies the chunk owner.

No more manual lag hunting. No more restarting the server to fix lag spikes.


⚙️ Core Throttling

• Chunk Scoring — Each loaded chunk is scored based on entity count, hopper count, projectiles, and items on the ground
• Hopper Throttling — Cancels hopper transfers in laggy chunks with configurable probability
• AI Freeze — Pauses pathfinding for non-hostile mobs in heavy chunks (protects named, tamed, leashed, and boss mobs)
• Entity Stacking — Merges excess same-type entities into a single stack with a visible "×N" nametag (restored when the server recovers)
• Gradual Escalation — Throttling intensifies over time while load persists (3 configurable levels)

Additional Modules

• Entity Caps — Hard per-chunk entity limits that cancel spawns before they happen (monster, animal, ambient, water, misc categories)
• Redstone Limiter — Detects and freezes rapid redstone clocks that monopolize tick time
• Explosion Limiter — Caps TNT chain reactions and optionally disables creeper explosions entirely
• Item Cleaner — Periodically removes old ground items, with recovery via the
  Code (Text):

  /abyss
  command (high-value items get double lifetime)
• Hopper Control — Global hopper transfer rate limiting when the server is under load, with lazy mode for empty hoppers

Owner Tracking & Warnings

• Chunk Ownership — Automatically attributes chunks to the most active player (place, break, interact)
• Player Warnings — Notifies the chunk owner when their chunk is throttled, and again when it recovers
• Cooldowns — Warning spam prevention with configurable cooldown per chunk

Command	Description
Code (Text): /tpsguardian status	View server health (TPS, CPU, throttled chunks)
Code (Text): /tpsguardian list	List all currently throttled chunks
Code (Text): /tpsguardian scan	Force an immediate chunk scan
Code (Text): /tpsguardian info [x z]	Detailed info about a specific chunk
Code (Text): /tpsguardian thaw [world]	Release throttling manually
Code (Text): /tpsguardian force <world> <x> <z>	Manually throttle a specific chunk
Code (Text): /tpsguardian unforce <world> <x> <z>	Release a manually throttled chunk
Code (Text): /tpsguardian clean	Trigger item cleanup immediately
Code (Text): /tpsguardian abyss	Retrieve recovered items
Code (Text): /tpsguardian save	Save owner data to disk
Code (Text): /tpsguardian reload	Reload configuration files

Permission	Description	Default
Code (Text): tpsguardian.admin	Access to all admin commands	op
Code (Text): tpsguardian.bypass	Exempts player from warnings	false
Code (Text): tpsguardian.abyss	Allows using /abyss to retrieve items	true

Everything is configurable in

Code (Text):

config.yml

with sensible defaults. Key settings:

• 
  
  
  • TPS/CPU thresholds for load detection
  • Entity weights per spawn category
  • Hopper cancel chance and escalation rate
  • AI freeze exclusions (named, tamed, leashed, bosses)
  • Entity stacking thresholds and stack limits
  • Per-chunk entity caps
  • Redstone update limits per time window
  • Explosion block limits and TNT cooldowns
  • Item cleanup intervals and exempt types
  • Hopper tick rate and lazy mode

• 
  
  
  • Server: Paper 26.1+ (also works on Purpur and other Paper forks)
  • Java: 25+
  • Folia Ready: Uses the Folia region scheduler for thread-safe chunk operations
  • Self-Healing: Entity stacks restore on chunk load if left over from a restart
  • Auto-Release: All mitigations are automatically released when the server recovers
  • No Data Loss: Cleaned items can be recovered via
    Code (Text):

    /abyss