Paper & Purpur Only

SURGICAL
ANTI-LAG.

Stop the lag machine, not the server. CircuitBreaker isolates specific chunks overflowing event checks and freezes them instantly, preserving main thread ticks.

Lab Console Simulator

Toggle the mock lag machine to witness CircuitBreaker's chunk-freezing mechanism in real time.

Control Panel

Status
🔒

Chunk Frozen

Resuming event loop in seconds

Chunk Event Console
Region [10, -8]
Location: Chunk [10, -8]
Events:
TPS: MSPT:

Documentation Hub

Comprehensive setup guides, command permissions, and configuration options. Click on a command row to review mechanics.

Installation & Setup

Compatibility Info

  • Server engine: PaperMC or Purpur (1.16 - 1.21+)
  • Folia Compatibility: Unsupported (Disabled automatically to protect threaded chunk data)
  • Java Version: Java 17 or higher

Installation Steps

  1. Download the compiled jar release file.
  2. Place the file into the /plugins directory of your Paper server.
  3. Start or reboot your server to generate configuration logs.
  4. Open config.yml and adjust thresholds matching your hardware specs.

Config.yml Reference

YAML Syntax
# CircuitBreaker Configuration File
# Core switches and monitoring parameters

# Master toggle for the anti-lag system
enabled: true

# --- Lag Detection Thresholds ---
# Number of block physics updates in 1 second (20 ticks) to register a strike
lag-threshold: 5000

# Number of strikes a chunk accumulates before being frozen
strike-limit: 3

# Minutes of clean performance before strikes are reset
strike-reset-minutes: 15

# --- Action Settings ---
# Duration (in ticks) to apply a soft reset to the chunk (200 ticks = 10s)
soft-reset-duration-ticks: 200

# Duration (in ticks) to hard freeze the chunk (6000 ticks = 5m)
# Set to -1 to freeze permanently until unfrozen by an administrator
freeze-duration-ticks: 6000

Plugin Command Directory

Command Permission Short Description
No commands matched your query.