Skip to main content

Scenario: Unexplained Lag Diagnosis

Problem: The server experiences periodic TPS drops without a single obvious cause. Standard profiling tools show the tick is slow but do not isolate the specific responsible system.

Step 1 — Enable Analysis Mode​

# observability.hopl
analysis:
  enabled: true

Restart. Allow 30–60 minutes of representative player activity under normal load.

Step 2 — Disable Analysis Mode and Read the Report​

# observability.hopl
analysis:
  enabled: false

# Review the generated report:
# plugins/auroraoptimizer/analysis-report.txt

Step 3 — Manual Investigation​

/auroraoptimizer scan world 10                   # Identify hotspot chunks by radius
/auroraoptimizer watch SuspectedPlayer           # Monitor player near the suspected source
/auroraoptimizer simulate SuspectedPlayer        # See what actions the system would take right now
/auroraoptimizer eye                             # Open the live telemetry GUI

Step 4 — Apply Targeted Intervention​

/auroraoptimizer optimize SuspectedPlayer aggressive  # Force an aggressive optimization cycle
/auroraoptimizer trigger pause_mob_ai pause=true radius=8  # Manual AI pause if needed
/auroraoptimizer history 20                             # Verify executed actions and their effect