LagReport




Version 2.3 Changelog
│➜ Slimefun Performance Module: Now monitors the
│➜ real impact of Slimefun 4 machines and tickers,
│➜ identifying bottlenecks by blocks, chunks, and
│➜ sub-plugins.
│➜ Dual Discord Webhooks: Complete channel
│➜ separation.Configure a dedicated Webhook for
│➜ Hardware Audits and a specific one for Slimefun
│➜ reports in config.yml.
│➜ Standalone /sftimings Command: New command to
│➜ trigger Slimefun reports manually, including the
│➜ /sftimings test sub-command for connectivity.
│➜ Automated Slimefun Reporting: Independent hourly
│➜ timer that sends Slimefun status to Discord with
│➜ a smart delay to avoid overlapping hardware
│➜ reports.
│➜ Log4j Core Interceptor: Professional-grade log
│➜ interception ensuring reports arrive full and
│➜ formatted without console abbreviations.
│➜ Centralized Messaging: All new features
│➜ integrated into messages_pt.yml and
│➜ messages_en.yml, supporting
│➜ global prefixes and full translation.

Update: 2.2
A professional performance-driven solution to identify lag sources and protect your server with automated emergency protocols and real hardware audit.



Main Features
│➜ Leash-Aware AI Safety: Unlike other anti-lag plugins,
│➜ LagReport never interferes with leashed entities. This ensures full
│➜ compatibility with plugins like LeashedMobsTeleport, preserving
│➜ the "asleep" or "tethered" state of mobs during and after
│➜ emergencies.
│➜ Multi-Language Core: Native support for English
│➜ (EN) and Portuguese (PT) fully configurable via file.
│➜ Advanced Consumption Analysis: Scans loaded chunks,
│➜ entities, and active redstone powered blocks around players.
│➜ Emergency Mode (Anti-Lag): High-performance protection that
│➜ freezes lag-inducing events when TPS drops below 15.0.
│➜ Emergency Simulation: Built-in 60s sequence to test "Halt"
│➜ mechanics and Discord alerts without a real lag spike.
│➜ Automated Systems Brake: Instantly halts liquid flows, redstone
│➜ clocks, entity spawns, and falling block physics during crises.
│➜ Smart Recovery: Automatically restores server mechanics only
│➜ after the TPS stabilizes back to a healthy 19.5.
│➜ Discord Webhook Integration: Real-time alerts with
│➜ @everyone pings for critical lag and
│➜ detailed performance reports.
│➜ Culprit Identification: Rank-based scoring system to pinpoint
│➜ exactly which player is generating the most server load.
│➜ Optimized Core: Built for Paper 1.21.1 with asynchronous
│➜ webhook handling to ensure no main-thread overhead.

Commands
│➜ lagreport Help command to view all available administrative tools.
│➜ lagreport test Manually triggers a full server analysis and sends
│➜ the report to Discord.
│➜ lagreport simulate Starts a 60-second emergency simulation (for
│➜ testing purposes).
│➜ lagreport reload Hot-reloads the configuration and validates the
│➜ Webhook connection.

Permissions
│➜ lagreport.admin Master permission to manage the plugin and
│➜ receive real-time lag notifications.

Configuration (config.yml)
│➜ webhook-url: Connect your Discord channel by simply pasting
│➜ your Webhook URL.
│➜ Integrated Formatting: Messages automatically adapt with emojis
│➜ and clear status indicators (PROTECTION/NORMAL).

Important Notice
│➜ This plugin is fully compatible with Minecraft 1.21.1 and Java 21.
│➜ Designed specifically for Paper/Purpur servers to utilize native TPS
│➜ and Chunk APIs.
│➜ Audit Logic: Player sums represent cumulative client-side
│➜ processing; Server Status reflects unique hardware-side instances.

Developed with ❤️ by Comonier