| "ProtocolLib not found" | ProtocolLib JAR absent or failed to load | Install ProtocolLib 5.3.0+ and verify a clean startup |
| "Plugin failed to initialise" | JRE version below Java 21 | Upgrade JRE/JDK to Java 21 |
| "API version mismatch" | Server software below 1.21.11 | Upgrade Paper or Folia to 1.21.11+ |
| "Eye not ready" | The Eye needs ~5 seconds of warm-up | Wait 10 seconds after startup and run /auroraoptimizer status again |
| TPS does not improve | Demo thresholds too low for production load | Apply production thresholds as described in Production Quickstart |
| Sub-engines show less than 9/9 | A sub-engine encountered an initialization error | Check the console for the specific sub-engine name and stack trace |
| "Failed to load policies.hopl" | YAML syntax error in a .hopl file | Run /auroraoptimizer policy test and fix the reported error |