Download File

## Version 26.2 ### Major Architecture and Modernization - **Native Paper Plugin Migration** - Fully converted to `paper-plugin.yml` and Paper 1.21+ Lifecycle Brigadier Command API. - **Folia Multi-Threading Support** - Complete regional threading compatibility using `Bukkit.getGlobalRegionScheduler()`, `Bukkit.getAsyncScheduler()`, and `Bukkit.getRegionScheduler().execute(...)` with zero cross-region blocking. - **Okaeri Configs Engine** - Migrated configuration (`config.yml`) and message handling (`messages.yml`) to Okaeri Configs with automatic `.bk` safety backups on startup. - **Modrinth Integration** - Updated the update notifier to use the official Modrinth API (`project ID: 5UOt11Yc`) with non-blocking asynchronous checks. - **Contributor Attribution** - Merged performance optimizations and hotspot clustering from PR #2 with official contributor credit to `paradoxnafi`. ### Minecraft 1.21+ Component Support - **Modern Redstone Components** - Added monitoring support for Crafters (`Material.CRAFTER`), Copper Bulbs (all oxidation and waxed states), Calibrated Sculk Sensors, and Chiseled Bookshelves. - **Piston Velocity and 0-Tick Interception** - Added `BlockPistonExtendEvent` and `BlockPistonRetractEvent` listeners to catch 0-tick loops and rapid push/pull lag engines. ### Intelligent Detection and Farm Protection - **Periodicity Clock Fingerprinting** - Analyzes interval deltas and variance between consecutive pulses to distinguish true lag machines from bursty contraptions. - **100% Farm Immunity** - Implemented Sustained Consecutive Violation Detection to ensure sugarcane farms, iron farms, melon/pumpkin harvesters, and hopper sorting halls never trigger false removals. - **Adaptive Performance Scaling** - Dynamically scales thresholds based on Paper's real-time average tick time (`Bukkit.getAverageTickTime()`) and TPS, providing 1.5x headroom during healthy performance and tightening under load. - **Player Proximity Throttling** - Enforces stricter limits on unattended contraptions running in chunkloaded areas without nearby players. ### Non-Destructive Mitigation - **Tiered Freezing and Auto-Resume** - Added non-destructive `FREEZE` as the default removal action, pause-throttling high-frequency clocks for a configurable duration (default: 15s) before escalating to block removal. - **Chunk Lockdown (EMP)** - Temporarily disables all redstone activity in a chunk for a configurable duration when severe lag machines are tripped. ### Diagnostic Tools and Visuals - **Live Adventure BossBar Inspector (`/arl inspect`)** - Real-time BossBar HUD displaying Chunk UPS, MSPT, and Server TPS with dynamic color grading (Green, Yellow, Red) and visual particle trails. - **3D Forensic Snapshots and Lag Replay (`/arl snapshot`)** - Automatically records 3D bounding box scans (7x7x7), trigger metrics, culprit player name/UUID, and component breakdown upon detecting lag machines. Includes in-game reports and direct teleportation (`/arl snapshot tp`). - **Hotspot Cluster Analysis (`/arl hotspots`)** - Adjacent-chunk BFS clustering with activity-weighted centers, interactive teleport suggestions, and file export (`/arl hotspots export`). ### Integrated ClearLagg Engine (`/arl clear`) - **Folia-Safe Entity Cleaner** - Ground item and entity cleanup with support for manual and automatic scheduled clears. - **Conditional Entity Rules** - Rule parser supporting tags such as `onGround`, `!isMounted`, `hasName`, `isTamed`, `isLeashed`, `isBaby`, `liveTime>X`, and `inWater`. - **SMP Entity Whitelist** - Default immunity for Villagers, Iron Golems, Allays, Armor Stands, Item Frames, Display entities, named mobs, tamed pets, and leashed animals. - **Valuable Item Blacklist** - Spares dropped Netherite gear, Elytras, Totems of Undying, Diamonds, and Beacons from deletion. - **Multi-Mode Countdown Broadcasts** - Configurable countdown warnings supporting Chat, Action Bar, Title, Subtitle, All, or None. ### Bug Fixes and Usability - **Fixed Hex Color Formatting** - Resolved issue where `&#RRGGBB` color codes rendered as raw text in chat and console. - **Eliminated Notification and Snapshot Spam** - Added a 60-second snapshot cooldown per block and instant signal cancellation on frozen components. - **Smart Culprit Resolution** - Added nearby player proximity scanning (within 48 blocks) when the original block placer is not in memory. - **Fixed Brigadier Tab Completion** - Full support for empty and partial argument completion across all subcommands.