STOP FIGHTING LAG. START NEUTRALIZING IT.

CircuitBreaker is a high-performance, 2-in-1 anti-lag plugin for Paper 1.21+. It moves beyond destructive entity killing by providing a tiered, automated response to both Physics Lag and Entity Lag.

Our mission is a perfect 20 TPS without punishing legitimate players.

[HR][/HR]

[COLOR=darkblue][B] SYSTEM 1: Physics Lag (The 3-Strike System)[/B][/COLOR]

This is the core of the plugin, designed to stop redstone/piston lag machines.

• Detection: A dedicated ticker runs every second, measuring every BlockPhysicsEvent in every chunk.
• Strike 1 & 2 (Soft Reset): If a chunk exceeds the lag-threshold, it's "warned" with a Soft Reset—unloading and reloading the chunk to break simple loops.
• Strike 3 (Hard Freeze): If the lag persists, the plugin performs a Hard Freeze, "jailing" the chunk and canceling all future physics events from it. The lag stops instantly.
• The "Forgiveness" Timer: A global timer clears all strikes every 15 minutes (configurable) to ensure fairness.

[HR][/HR]

[COLOR=darkblue][B] SYSTEM 2: Entity Lag (The v2.0 Smart Culler)[/B][/COLOR]

This is a new, optional system (disabled by default) to control entity cramming lag.

• Smart Scanner: A separate, slower-paced scanner runs every 15-30 seconds (configurable) to check for chunks with too many entities.
• Threshold Culling: If a chunk is over the entity-culling.threshold (e.g., 500 entities), the plugin will remove entities... but only unimportant ones.

[COLOR=darkred]What We DON'T Cull (The "Important" List)[/COLOR]

CircuitBreaker WILL NOT remove entities that are:

• On the config whitelist (e.g., "PLAYER", "VILLAGER")
• Named with a Name Tag
• Tamed (e.g., dogs, cats)
• Vehicles (boats, minecarts)

[HR][/HR]