[COLOR=darkblue][B]️ ADMIN GUIDE & COMMANDS[/B][/COLOR]
You have 100% control. All admin actions (like ignoring chunks) are saved to data.yml and persist through server restarts.[COLOR=darkred]Permissions[/COLOR]
- circuitbreaker.admin: Grants access to all /cb commands.
- antilag.notify: Receives alerts when a chunk is frozen or when an entity cull occurs.
[COLOR=darkred]Commands (Alias: /cb)[/COLOR]
| COMMAND | FUNCTION |
| /cb status | Checks the status (Normal, Watched, Frozen, Ignored) of the chunk you are standing in. |
| /cb ignore | (Most Important) Whitelists your current chunk permanently. It will be ignored by BOTH the physics lag and entity lag systems. |
| /cb unignore | Removes your current chunk from the permanent ignore list. |
| /cb unfreeze | Manually unfreezes a (physics-lag) frozen chunk. |
[HR][/HR]
[COLOR=darkblue][B] FULL CONFIGURATION (v2.0)[/B][/COLOR]
This file is generated in /plugins/CircuitBreaker/config.yml
Code (YAML):
# ------------------------------
# CircuitBreaker Config v2.0
# ------------------------------
# --- v1.0: Physics Lag Detector ---
# Set to false to disable the 3-strike physics lag system.
enabled : true
# How many block physics events in 1 second (20 ticks)
# will trigger a "lag" warning? (v1.1 Tuned Value)
lag-threshold : 20000
# How many "strikes" a chunk gets before it is frozen.
strike-limit : 3
# How many minutes of no lag before a chunk's strike count is reset.
strike-reset-minutes : 15
# How long (in ticks) to "soft reset" a chunk for.
# 200 ticks = 10 seconds
soft-reset-duration-ticks : 200
# How long (in ticks) to "hard freeze" a chunk for.
# 6000 ticks = 5 minutes
# Set to -1 to freeze chunks permanently (requires admin /cb unfreeze).
freeze-duration-ticks : 6000
# Send a broadcast message to admins when a chunk is frozen OR culled?
notify-admins : true
# ------------------------------
# v2.0: Entity Culling Settings
# ------------------------------
entity-culling :
# Set to true to enable this new entity-culling feature.
# This is disabled by default.
enabled : false
# How often (in seconds) to scan all loaded chunks.
# This is a HEAVY task. Do not set this too low!
scan-interval-seconds : 15
# How many entities must be in a *single chunk* to trigger a cull.
threshold : 500
# A list of entity types to *NEVER* kill (case-insensitive).
whitelist :
- "PLAYER"
- "VILLAGER"
- "IRON_GOLEM"
- "ARMOR_STAND"
- "ITEM_FRAME"
- "PAINTING"
- "MINECART"
- "BOAT"
- "CHEST_BOAT"
[COLOR=darkblue][B] COMPATIBILITY[/B][/COLOR]
- Requires: Paper 1.21+ (or forks like Purpur, Pufferfish).
- Folia: This plugin is NOT COMPATIBLE with Folia. It includes a safety check and will disable itself if Folia is detected, logging a clear message to your console.
Resource Information
Author:
----------
Total Downloads:
11
First Release:
Nov 11, 2025
Last Update:
Nov 16, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings