#
LagLens - The Ultimate Performance Intelligence EngineStop guessing why your server is lagging. Start fixing it.
LagLens is a professional-grade performance monitoring and diagnostic suite designed specifically for modern Minecraft servers (Paper, Purpur, and Folia 1.21.1+). While standard tools tell you that your server is lagging, LagLens tells you exactly why and where, providing actionable intelligence to keep your TPS at a perfect 20.0.
---
##
Core Features### 1. Intelligent Lag Attribution
LagLens identifies the "resource thieves" on your server with millisecond precision:
- Plugin Profiling: Monitor the impact of every plugin by task, event handler, and entity spawn.
- Deep Skript Integration: The only tool that offers per-trigger and per-script analysis, allowing you to find inefficient loops in your
.skfiles instantly. - Entity & Tile Entity Tracking: Real-time monitoring of what is actually sitting in your world.
### 2. Automated Diagnosis Engine (The "Lag Hunter")
The plugin runs background scans to detect common performance bottlenecks:
- Redstone Clock Detection: Automatically identifies high-frequency circuits.
- Hopper Chain Analysis: Finds unoptimized or "clogged" hopper systems.
- Mob Farm & Villager Detection: Spots entity-cramming and villager trading hall bottlenecks before they crash the main thread.
### 3. Performance Timeline & Historical Reporting
Don't miss a lag spike just because you weren't online.
- Rolling History: Keep up to 60 minutes of server health data (configurable).
- Automatic Event Recording: If TPS drops below a threshold, LagLens takes a "snapshot" of the server state for you to review later.
- Data Exports: Export reports in JSON, CSV, or TXT formats for easy sharing with developers.
### 4. Interactive Visual Dashboards
- Admin GUI: Manage everything through a clean, intuitive inventory interface.
- Hotspot Viewer: A visual browser that lets you see which chunks are using the most resources.
- Real-time HUD: Optional on-screen status overlays for staff members.
---
## 🛠 Commands & Permissions
### Primary Commands
/laglens- Open the main GUI Dashboard./laglens report- Generate a full server health analysis./laglens analyze [here]- Run a deep-scan on a specific area or your current location./laglens skripts- Access the dedicated Skript performance menu./laglens timeline- View the history of lag events./laglens fix <here|dump>- Execute administrative remediation actions.
### Essential Permissions
laglens.admin- Full access to all features and commands.laglens.alerts- Receive real-time performance warnings and Discord notifications.laglens.gui- Permission to open the visual dashboards.laglens.report- Permission to generate and view diagnostic reports.
---
##
Integrations & Compatibility- Folia Support: Built to handle multi-threaded region environments.
- PlaceholderAPI: Over 10+ placeholders including
%laglens_mspt%,%laglens_tps_color%, and%laglens_status%. - Discord Webhooks: Get instant alerts in your staff Discord channels with customizable role mentions.
---
##
Why Choose LagLens?Unlike generic profilers, LagLens is built for active remediation. It doesn't just provide raw data; it provides a roadmap to a lag-free server. Whether you are a Network Owner, a Skript Developer, or a Survival Admin, LagLens gives you the tools to teleport to a problem and solve it in seconds.
Requirements:
- Minecraft 1.13 - 1.21.1+
- Paper, Purpur, or Folia (Recommended)
- Optional: Skript, PlaceholderAPI
