NeuroLag

[1.1.0] — 2026-03-14

🎉 Major Release: 18 New Advanced Features!

✨ Added

Feature 1: CPU Throttling Mode

• Monitors server CPU usage (not just TPS)
• Activates automatic optimization when CPU > 80%
• Reduces Bukkit task frequency during critical CPU load
• Disables non-essential block physics updates
• Configuration: cpu-throttling.enabled and cpu-throttling.cpu-threshold

Feature 2: Region-Based Optimization

• Splits world into 16×16 chunk regions
• Disables pathfinding for mobs in far regions
• Smart regional mob optimization instead of global
• Mobs near players always keep full AI
• Configuration: region-optimization.enabled and region-optimization.use-regions

Feature 3: Custom Mob Tier Weights

• Assign different "cost" to different mob types
• Zombies cost 1.0, Endermen cost 2.0, Ender Dragons cost 4.0
• Prevents over-optimization (allows more weak mobs)
• Configuration: mob-weights.weights.* and mob-weights.max-weight-per-chunk
• Result: More realistic mob balance during lag

Feature 4: Animation Freezing

• In CRITICAL state, mobs stop playing animations (head turning, arm swinging)
• Only applies to distant mobs (configurable)
• Reduces visual strangeness of frozen mobs
• Configuration: animation-freezing.enabled and animation-freezing.freeze-distance-chunks

Feature 5: Real-Time Metrics API

• Other plugins can query NeuroLag's current state
• Methods: neurolag.getWorldState(), neurolag.getTPS(), neurolag.getAffectedMobCount()
• Enable plugin ecosystem around NeuroLag
• Configuration: metrics-api.enabled and metrics-api.expose-via-plugin-message

Feature 6: In-Game Dashboard

• Live server health dashboard (BOSSBAR or HOLOGRAM)
• Changes color: BLUE (normal) → YELLOW (MEDIUM) → RED (CRITICAL)
• Updates every 2 seconds
• Configuration: dashboard.type, dashboard.bossbar, dashboard.hologram

Feature 7: Detailed Lag Audit Reports

• Generate comprehensive lag analysis reports
• Include: server specs, plugin list, chunk stats, mob breakdown, player behavior, network stats
• Export to HTML for easy reading
• Configuration: audit-reports.enabled and audit-reports.include
• Result: Deep understanding of what causes lag

Feature 8: Multi-Server Sync (Bungeecord/Velocity)

• Share TPS data across all servers
• Redis or MySQL backend support
• Cascade warnings to all servers if one is in CRITICAL
• Load-balance: suggest players move to less-lagged server
• Configuration: multi-server.enabled, multi-server.backend, multi-server.sync-tps

Feature 9: AI Difficulty Scaling

• Easy mode = aggressive optimization
• Normal mode = balanced
• Hard mode = minimal optimization (players want challenge)
• Hardcore = zero optimization
• Configuration: ai-difficulty-scaling.enabled and ai-difficulty-scaling.scale-with-difficulty
• Result: Respects player expectations

Feature 10: Mobile Web Dashboard

• Access metrics from any browser (phone, tablet, PC)
• Real-time TPS graph, mob count, heap usage
• Send commands remotely (/nlag reload, /nlag toggle)
• Token-based authentication
• Configuration: web-dashboard.enabled, web-dashboard.port, web-dashboard.auth.token
• Result: Monitor and control server on the go 📱

Feature 11: Predictive Lag Prevention

• Learns hourly patterns (6pm = always lag, etc)
• Pre-activates optimization before peak hours hit
• Configuration: predictive-prevention.enabled, predictive-prevention.peak-hours
• Result: Be proactive, not reactive

Feature 12: Custom Zones (WorldGuard Integration)

• Mark important regions as HIGH_PRIORITY via WorldGuard
• Examples: boss arenas, spawn, player shops, farms
• Full mob AI always kept in protected zones
• Aggressive optimization elsewhere
• Configuration: zone-protection.enabled and zone-protection.integrate-worldguard
• Result: Protect what matters most

Feature 13: Entity Grouping & Smart Removal

• Remove mobs intelligently during culling
• Never remove single mob types (won't inactivate farms)
• Remove in groups (visually less obvious)
• Particle effect on removal
• Configuration: smart-culling.enabled, smart-culling.cull-in-groups, smart-culling.min-type-before-cull

Feature 14: Configuration Profiles

• Create multiple config profiles (survival, minigame, peaceful, etc.)
• Switch instantly with /nlag profile <n>
• Each profile can have different TPS triggers and entity limits
• Configuration: config-profiles.enabled and config-profiles.profiles.*
• Result: Perfect for multi-mode servers

Feature 15: Audio & Visual Alerts

• Sound alerts when entering/leaving CRITICAL
• Particle warnings around admin
• Chat notifications to all ops
• Customizable sounds (default: bass drop for CRITICAL, pling for recovery)
• Configuration: alerts.enable-sound-alerts, alerts.alert-sounds.*, alerts.enable-particle-warnings
• Result: Immediate awareness without checking commands

Feature 16: Stress Test Mode

• Simulate heavy server load without real players
• Spawn fake mobs (configurable count)
• Test for X minutes and auto-generate report
• Configuration: stress-test.enabled, stress-test.spawn-fake-mobs, stress-test.fake-mob-count
• Result: Safe testing environment 🧪

Feature 17: Configuration Validator

• /nlag validate checks config syntax and values
• Warns about invalid settings
• Suggests optimizations
• Configuration: config-validator.enabled
• Result: Prevent config errors before they cause problems

Feature 18: Automatic Config Backup

• Auto-backup config every X minutes (default: 60)
• Keep last N backups (default: 10)
• Auto-restore if invalid config detected
• Configuration: auto-backup.enabled, auto-backup.backup-interval-minutes, auto-backup.keep-backups
• Result: Never lose your config

🌍 Multilingual Support (Added)

• English (EN) — Default
• Tiếng Việt (VI) — Vietnamese
• Español (ES) — Spanish
• Français (FR) — French
• Deutsch (DE) — German
• 日本語 (JA) — Japanese
• 中文 (ZH) — Chinese (Simplified)

Set language in config.yml: settings.language: EN

📝 Documentation

• Completely rewritten README with all 18 features documented
• Multilingual documentation in README (7 languages)
• Comprehensive CHANGELOG (this file)
• Detailed config.yml with all features documented

🔧 Command Enhancements

New commands added:

• /nlag dashboard — Show in-game dashboard
• /nlag audit — Generate audit report
• /nlag zone — Zone management
• /nlag profile <n> — Switch config profiles
• /nlag validate — Validate configuration
• /nlag backup — Manage config backups
• /nlag stresstest — Run stress test

🔐 Permission Enhancements

New permissions added:

• neurolag.stresstest — Run stress tests
• neurolag.dashboard — View dashboard
• neurolag.audit — View audit reports
• neurolag.zone — Manage zones
• neurolag.profile — Switch profiles
• neurolag.validate — Validate config
• neurolag.backup — Manage backups
• neurolag.web — Access web dashboard
• neurolag.api — Access metrics API

📊 Configuration Changes

• Added 18 new configuration sections (one per feature)
• All features can be individually enabled/disabled
• Backward compatible with v1.0.6 configs
• Old config keys still work (will be migrated automatically)

🎯 Performance Improvements

• CPU throttling reduces unnecessary task execution
• Region-based optimization replaces global optimization
• Smart culling reduces entity processing
• Predictive prevention prevents lag spikes before they happen

🐛 Bug Fixes (from v1.0.6)

• ✅ Tick-rate throttling properly activates in MEDIUM state
• ✅ Manual override (/nlag toggle) now truly pauses monitoring
• ✅ Simulate mode no longer throws errors on invalid input
• ✅ Recovery notifications always fire (not suppressed by cooldown)
• ✅ Stale cooldown timestamps cleared on reload

📈 Version Info

• Version: 1.1.0
• Target: Paper 1.21+, Java 21+
• Release Date: 2026-03-14
• Total Features: 18 (from 16 in v1.0.6)
• Supported Languages: 7
• New Files: None (all backwards compatible)

---