ModsJava
TPSGuardian - Best Premium Optimization Plugin | More Support!
Java mod listed for Minecraft 1.16–26.x. Downloads from the MC Java Mods app on Android.
️ TPS Guardian ️ Dynamic Performance & Chunk Culler for Paper 26.1+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ❓ What does it…
⬇ Download on Spigot️ TPS Guardian ️
Dynamic Performance & Chunk Culler for Paper 26.1+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❓ What does it do?
No more manual lag hunting. No more restarting the server to fix lag spikes.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
⚙️ 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
command (high-value items get double lifetime)Code (Text):/abyss
- 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⌨️ Commands
| 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 |
️ Permissions
| 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 |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Configuration
Everything is configurable in
⚙️ Configuration
Code (Text):
config.yml
- 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Requirements & Notes
✅ Requirements & Notes
- 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Created by YKStudios
Created by YKStudios
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
TPSGuardian - Best Premium Optimization Plugin | More Support! is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 28 times (via Spigot). Download it and open it directly in the game.