?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
NeuroLag

NeuroLag

A smart, resource-aware optimization plugin that dynamically adjusts Mob AI based on server TPS and RAM to ensure a lag-free SMP experience

756downloads
6followers
756downloads
6followers

Tags

Creators

Details

Licensed Apache-2.0
Published 8 months ago
Updated 5 months ago
All versions

1.2.0

Release
NeuroLag 1.2.07 months ago 20
Download

Compatibility

Minecraft: Java Edition
1.21.x
Platforms
Bukkit
Paper
Purpur
Spigot

Changes

[1.2.0] — 2026-03-14

🎉 All 18 Advertised Features — Now Fully Implemented

Every feature listed in the README and CHANGELOG since v1.1.0 now has real working code.

New Java Classes (15 new files)

Class Feature
CpuMonitor.java F1 — CPU throttling via com.sun.management.OperatingSystemMXBean
RegionOptimizer.java F2 — 16×16 chunk region grid, HOT/COLD classification
MobWeightManager.java F3 — Per-type weight budget per chunk
DashboardManager.java F6 — Live BossBar (BLUE→YELLOW→RED) for all operators
AuditManager.java F7 — Full HTML audit report (specs, plugins, mobs, chunks)
MultiServerSync.java F8 — Redis Jedis pub/sub + MySQL JDBC upsert
WebDashboard.java F10 — Embedded HTTP server (JDK HttpServer), live JS chart, JSON API
PredictiveScheduler.java F11 — Per-hour TPS pattern tracking + peak-hour config
ZoneManager.java F12 — Cuboid zone list + WorldGuard region soft-depend
ProfileManager.java F14 — Instant profile switching (critical-tps / medium-tps / max-entities)
AlertManager.java F15 — Sound + particle + chat alerts for CRITICAL enter/leave
StressTestManager.java F16 — Mob spawning stress test with auto-cleanup and report
ConfigValidator.java F17 — Range/sanity checks for all config fields
BackupManager.java F18 — Periodic backup + purge + restore
NeuroLagAPI.java F5 — Static public API + plugin messaging channel neurolag:metrics

Features Integrated into Existing Classes

Feature Location
F4 — Animation Freezing (velocity zeroing for distant AI-disabled mobs) LagEngine.applyAiBatched()
F9 — AI Difficulty Scaling (getDifficulty() → TPS offset) LagEngine.applyDifficultyScaling()
F13 — Smart Group Culling (type-aware, min-count guard, POOF particles) LagEngine.cull()
F1 TPS penalty integration LagEngine.tick()
F2 region check in optimization path LagEngine.applyAiBatched()
F3 weight-sorted culling LagEngine.cull()
F7 audit on critical event LagReporter.onCriticalStart()
F12 zone protection skip LagEngine.applyAiBatched()
F11 predictive penalty LagEngine.tick()
F15 alert on state change LagEngine.updateWorld()

New Commands

  • /nlag dashboard [off] — toggle BossBar
  • /nlag audit — generate HTML audit report
  • /nlag zone — show loaded zone count
  • /nlag profile [name|clear] — switch config profile
  • /nlag validate — validate config with detailed errors/warnings
  • /nlag backup [list|restore] — manage backups
  • /nlag stresstest [count] [minutes] — run stress test
  • /nlag sync — show Redis/MySQL peer server states

pom.xml Changes

  • Jedis 5.0.0 (Redis) — shaded and relocated
  • mysql-connector-j 8.3.0 — shaded and relocated
  • WorldGuard 7.0.12 — provided/optional (soft-depend)
  • Maven Shade plugin configured with relocation rules

plugin.yml Changes

  • softdepend: [WorldGuard] added

config.yml Changes

  • dashboard.enabled and dashboard.update-interval added
  • audit-reports.generate-on-critical added
  • multi-server.mysql.* section added
  • zone-protection.zones list added
  • config-profiles.profiles.*.medium-tps key added
  • alerts.enabled top-level flag added
  • stress-test.auto-generate-report added

Language Files

  • All 7 language files updated to v1.2.0 header
  • New keys: dashboard-bar, alert-critical, alert-recovery, sync-no-peers, sync-peer