laglens

# LagLens Quick Usage Guide ## Getting Started ### Installation 1. Drop `laglens-1.0.0.jar` into your `plugins/` folder 2. Restart your server 3. LagLens will auto-generate `plugins/LagLens/config.yml` ### First Steps ``` /laglens ``` This shows your server's current performance status including TPS, memory usage, and any detected lag sources. ## Essential Commands ### Performance Overview ``` /laglens ``` **Shows:** - Current TPS (color-coded: green = good, yellow = warning, red = critical) - Memory usage percentage - Number of loaded chunks - Online player count - Server health status - Count of active lag sources ### Scan for Lag Sources ``` /laglens scan ``` **Features:** - Lists all chunks exceeding thresholds - Color-coded severity (yellow = warning, red = critical) - For players: **clickable buttons** to jump directly to problems - Shows detailed breakdown of entity types, redstone activity, and more ### Teleport to Problematic Chunks ``` /laglens tp 100 50 # Current world /laglens tp 100 50 world_nether # Specific world ``` - Teleports you to the center of the specified chunk - Auto-adjusts height for safety - Shows chunk information on arrival - Great for investigating lag sources found in scans ### Clear Boats and Bubble Elevators ``` /laglens clear boats # Default radius (64 blocks) /laglens clear boats 128 # Medium clear radius /laglens clear boats 256 # Large clear radius /laglens clear boats 512 # MASSIVE clear radius ``` **Features:** - Removes all boats in the specified radius around you - **Optionally clears soul sand and magma blocks** (configurable in config.yml) - Perfect for clearing stuck bubble elevators - Shows detailed removal count results - **Maximum radius of 512 blocks** for massive boat accumulations - **Default radius increased to 64 blocks** for better coverage ### Clear Minecarts and Rail Systems ``` /laglens clear minecarts # Default radius (32 blocks) /laglens clear minecarts 64 # Medium clear radius /laglens clear minecarts 128 # Large clear radius /laglens clear minecarts 256 # MASSIVE clear radius ``` **Features:** - Removes all types of minecarts in the specified radius around you - **Optionally clears rail blocks** (configurable in config.yml) - Perfect for clearing minecart cramming issues - Supports all minecart types: chest, hopper, furnace, TNT, spawner, command minecarts - Shows detailed removal count results - **Maximum radius of 256 blocks** for large transport systems - **Default radius of 32 blocks** for targeted clearing ### Configuration Management ``` /laglens reload ``` Reloads config.yml without restarting the server - perfect for tweaking thresholds on the fly. ## Key Configuration Options ### Essential Thresholds (config.yml) ```yaml thresholds: entities: warning: 50 # Total entities per chunk critical: 100 mobs: warning: 30 # Living entities (excluding players) critical: 60 minecarts: warning: 10 # Minecart lag sources critical: 25 boats: warning: 15 # Boat entities critical: 30 dropped_items: warning: 50 # Items on ground critical: 150 entity_cramming: warning: 8 # Entities in same block space critical: 15 minecart_cramming: warning: 5 # Minecarts clustered in 3x3x3 area critical: 10 bubble_boats: warning: 3 # Boats on bubble columns (scanned in radius!) critical: 8 redstone: warning: 40 # Redstone components (MUCH less strict!) critical: 100 hoppers: warning: 8 # Hopper count critical: 20 ``` ### Monitoring Frequency ```yaml monitoring: scan_interval: 20 # Check every 20 ticks (1 second) chunks_per_tick: 10 # Scan 10 chunks per tick (prevent scan lag) bubble_boat_scan_radius: 1 # Check 1 chunk around each chunk (reduced spam) # WARNING SPAM PREVENTION warning_cooldown: 60 # Wait 1 minute between warnings for same chunk+lagtype warn_once_per_chunk: true # Only warn once per chunk+lagtype until issue is resolved ``` ### Clear Boats Settings ```yaml clear_boats: default_radius: 64 # Default radius for clear command (increased!) max_radius: 512 # Maximum allowed radius for massive clearing clear_soul_sand: true # Also remove soul sand when clearing boats clear_magma_blocks: true # Also remove magma blocks when clearing boats # Clear Minecarts Settings clear_minecarts: default_radius: 32 # Default radius for clear command max_radius: 256 # Maximum allowed radius for large systems clear_rails: false # Also remove regular rails when clearing minecarts clear_powered_rails: false # Also remove powered rails when clearing minecarts clear_detector_rails: false # Also remove detector rails when clearing minecarts ``` ### Discord Integration ```yaml discord: enabled: false # Enable Discord webhook alerts webhook_url: "YOUR_WEBHOOK_URL