# CircuitBreaker v2.5-Vanguard ### What's New: - **DeMalware-RETRO verification:** Added startup validation loops to inspect if DeMalware-RETRO is active, alerting the administrator if protection is missing. - **Cross-linking updates:** Linked suite packages directly inside readme documentation profiles.

# CircuitBreaker v2.4-Aegis This release introduces the **AEGIS** (*Async Event Gate and Isolation Sentinel*) engine update, featuring surgical player alerts when chunks are frozen to keep players fully informed. ### What's New: - **Chunk Frozen Chat Announcement:** All players inside a frozen chunk area receive a warning message letting them know the chunk has been isolated, labeled with author attributions. - **Configurable Warning Message:** Define a custom warning message using `chunk-frozen-message` in `config.yml`. - **All Rights Reserved License:** Transitioned under a custom All Rights Reserved Software License Agreement.

Advanced Sentinel Panel & Webhook Release v2.3 - **In-Game GUI Control Panel (`/cb gui`):** A custom interactive chest GUI dashboard allowing admins to view server health, list/teleport/unfreeze frozen chunks, and manage whitelists. - **Discord Webhook Alerts:** Sends rich, customizable embed alerts to your Discord channels when lag machines are neutralized. - **Server TPS Sentinel:** Asynchronously monitors TPS/MSPT and broadcasts warning reports to admins and Discord when sustained server resource drops occur. - **Automatic Updater:** Asynchronously downloads official plugin releases into the server's update folder for seamless, crash-free restarts. - **Countdown Unfreeze Timers:** Displays the remaining freeze duration of active frozen chunks dynamically inside the GUI panel.

Advanced Sentinel Release v2.2.1 - **Physics Events Defused Counter:** Added tracking and persistent saving of total physics events blocked in frozen chunks. - **bStats Custom Charts:** Added a live line chart tracking `physics_events_defused` to show real-time performance impacts on the bStats dashboard.

Advanced Sentinel Release v2.2 - **Dynamic Threshold Scaling:** Automatically adjusts physics event thresholds based on live TPS and MSPT load averages. - **3x3 Chunk Freezing:** When a chunk triggers Strike 3 (Hard Freeze), a 3x3 grid centered around that chunk is frozen to catch machines spanning chunk borders. - **Clickable Chat Alerts:** Broadcasts interactive admin alerts with built-in [TP], [UNFREEZE], and [IGNORE] actions. - **Improved `/cb unfreeze` command:** Supports optional radius (e.g. `/cb unfreeze 3`) and falls back to a 10x10 block area unfreeze if omitted. - **`/cb top` subcommand:** Real-time diagnostics command showing top 5 chunks with highest block physics activity. - **Packet Spam Sentinel:** Dynamically injects into player Netty connection pipeline to throttle packet-spam crash exploit clients.

Optimization & Update Checker Release v2.1.1 - **Optimized Physics Checks:** Replaced expensive Bukkit `event.getBlock().getChunk()` calls inside `LagListener` with fast bit-shifted coordinates (`block.getX() >> 4`). - **Memory Leak Prevention:** Decoupled chunk tracking maps from strong `org.bukkit.Chunk` references using a custom `ChunkKey` class, allowing unloaded chunks to be GC'd. - **Load-Spreading Scanner:** The entity culler now spreads its chunk scanning workload across ticks (processing batches of 50 per tick) to eliminate main-thread TPS micro-stuttering. - **Update Checker:** Integrated an asynchronous update checker checking GitHub releases.

Optimization & Update Checker Release v2.1 - **Optimized Physics Checks:** Replaced expensive Bukkit `event.getBlock().getChunk()` calls inside `LagListener` with fast bit-shifted coordinates (`block.getX() >> 4`). - **Memory Leak Prevention:** Decoupled chunk tracking maps from strong `org.bukkit.Chunk` references using a custom `ChunkKey` class, allowing unloaded chunks to be GC'd. - **Load-Spreading Scanner:** The entity culler now spreads its chunk scanning workload across ticks (processing batches of 50 per tick) to eliminate main-thread TPS micro-stuttering. - **Update Checker:** Integrated an asynchronous update checker checking GitHub releases.

v2.1: Integrated bStats telemetry tracking (ID 32242) with custom metrics for total player playtime, number of lag machines stopped, and configuration state flags.

# 🚀 v2.0: The Performance Suite Update This is a major feature update that introduces the **Entity Culling System**, transforming CircuitBreaker from a specialized physics-lag tool into an all-in-one server performance suite. --- ## ✨ New Feature: Entity Culling System A new, **optional** system has been added to detect and clear excessive entity build-ups. This runs completely separately from the v1.0 physics lag detector. * **Fully Configurable:** The entire feature is **disabled by default**. You can enable it and configure it in the new `entity-culling` section of your `config.yml`. * **New Scanner:** A new, slower, and server-friendly scanner (`startEntityScanner`) runs on its own configurable timer (`scan-interval-seconds`) to check for entity-crammed chunks. * **Threshold Culling:** If the number of entities in a single chunk exceeds the `entity-threshold`, the plugin will perform a "cull". * **Admin Notifications:** When a cull occurs, a message is sent to the console and to all in-game admins (with the `antilag.notify` permission) detailing how many entities were removed and from which chunk. --- ## 🧠 Smart Culling: No More Deleting Pets! The biggest feature of the new system is its "smart" culling logic. The plugin **will NOT remove** entities that are considered "important." An entity is considered **important** (and will be skipped) if it: * Is on the new `entity-culling.whitelist` in the config (e.g., "PLAYER", "VILLAGER"). * Has a **custom name**. * Is a **tamed pet**. * Is a **vehicle**. --- ## 🎨 Quality of Life & Fixes * **Console Color Fix:** All console messages (startup, shutdown, and warnings) have been updated to use `Bukkit.getConsoleSender().sendMessage()` for proper, sexy "blood-red" color rendering that avoids `§c` artifacts. * **Code Cleanup:** Cleaned up various classes and fixed minor bugs from v1.1.

fine tune