Skip to main content

Guía de Solución de Problemas

El plugin no está optimizando nada​

  • Ejecuta /auroraoptimizer status — confirma que el modo es ACTIVE, no PASSIVE, MANUAL o DISABLED
  • Verifica que los umbrales en config.yml son apropiados para los conteos de entidades y chunks del servidor — los valores demo son demasiado bajos
  • Comprueba que el TPS esté realmente por debajo de los umbrales configurados; si el TPS es 19.5 y el umbral es 17.0, ninguna acción está justificada
  • Ejecuta /auroraoptimizer simulate <jugador> para confirmar que los submotores están generando propuestas
  • Ejecuta /auroraoptimizer policy review para verificar que las políticas están cargadas con los parámetros correctos

El TPS no mejora aunque el plugin esté activo​

  • Ejecuta /auroraoptimizer scan — verifica que el sistema está apuntando a los chunks hotspot reales y no a los adyacentes
  • Revisa /auroraoptimizer history — confirma que las acciones están alcanzando el estado SUCCESS y no REJECTED o ERROR
  • Si las acciones tienen éxito pero el TPS no mejora, la causa raíz puede estar fuera del alcance de AuroraOptimizer (por ejemplo, sobrecarga del tick de otros plugins)
  • Aumenta la agresividad: /auroraoptimizer profile set aggressive
  • Ejecuta /auroraoptimizer dump y revisa los registros de efectividad para identificar qué tipos de acción tienen bajo delta de TPS

Un jugador se queja de distancia de visión reducida​

  • Ejecuta /auroraoptimizer viewdist status <jugador> para identificar qué nivel de prioridad estableció la VD actual
  • Si la fuente es una política automática: el auto-revert la restaurará cuando las condiciones se recuperen — informa al jugador y monitorea
  • Para alivio inmediato: /auroraoptimizer viewdist set player <n> <distancia> (override P8)
  • Para exención permanente: otorga auroraoptimizer.immune o sube el cap .viewdistance.max.* de su grupo

El auto-revert no restaura la configuración​

  • Confirma que auto-revert.enabled: true está en config.yml
  • Verifica que haya transcurrido min-uptime-before-revert-ms — el mínimo predeterminado es 2-3 minutos
  • Comprueba que los umbrales de recuperación no estén configurados de forma irrealista para el rango de TPS normal del servidor
  • Ejecuta /auroraoptimizer history e identifica los eventos de revert — ¿aparecen como NO_OP o REJECTED?

Errores en consola durante el arranque​

Mensaje de ErrorCausaSolución
"ProtocolLib not found"ProtocolLib ausente o con fallo de cargaInstala ProtocolLib 5.3.0+; verifica arranque limpio
"Failed to load policies.hopl"Error de sintaxis YAML en archivo .hoplEjecuta /auroraoptimizer policy test; corrige la línea reportada
"Java version not supported"Versión de JRE inferior a Java 21Actualiza JRE/JDK a Java 21
"API version mismatch"Paper o Folia inferior a 1.21.11Actualiza el software del servidor
"Sub-engine failed to init"Error de inicialización de un submotorRevisa la consola para el nombre del submotor y el stack trace