| "ProtocolLib not found" | JAR de ProtocolLib ausente o con fallo de carga | Instala ProtocolLib 5.3.0+ y verifica arranque limpio |
| "Plugin failed to initialise" | Versión de JRE inferior a Java 21 | Actualiza JRE/JDK a Java 21 |
| "API version mismatch" | Software de servidor inferior a 1.21.11 | Actualiza Paper o Folia a 1.21.11+ |
| "Eye not ready" | El Eye necesita aprox. 5 segundos de calentamiento | Espera 10 segundos tras el arranque y vuelve a ejecutar /auroraoptimizer status |
| TPS no mejora | Umbrales demo demasiado bajos para carga de producción | Aplica umbrales de producción según la sección Configuración Rápida para Producción |
| Submotores muestran menos de 9/9 | Un submotor encontró un error de inicialización | Revisa la consola para el nombre específico del submotor y el stack trace |
| "Failed to load policies.hopl" | Error de sintaxis YAML en un archivo .hopl | Ejecuta /auroraoptimizer policy test y corrige el error reportado |