spark es el profiler para servidores de Minecraft. Cuando el servidor va a tirones, spark te dice en segundos si la tasa de ticks se resiente, qué plugins o granjas se comen el tiempo y si la CPU o la memoria están al límite. Esta guía te muestra los tres comandos que realmente necesitas y cómo interpretar las cifras. Las capturas de pantalla proceden de un servidor de pruebas con Paper 1.21.4.

Instalación

spark funciona como plugin en Paper y Spigot, y como mod en Fabric, NeoForge y Forge. En el panel lo encontrarás en Plugins → Navegador. No necesita configuración. Los comandos deben asignarse al grupo de moderación; el nodo correspondiente se llama spark. Cómo asignarlo se explica en LuckPerms: configurar los permisos.

Primer vistazo: TPS y duración de los ticks

/spark tps muestra tres líneas:

Salida de /spark tps: TPS, duración de los ticks y uso de la CPU (Enlarge image)
  • TPS (ticks por segundo) de los últimos 5 segundos, 10 segundos, 1, 5 y 15 minutos. 20,0 es el máximo. Hasta unos 19, los jugadores no notan nada; por debajo de 15, los animales se mueven a saltos, y por debajo de 10, el servidor se vuelve injugable.
  • Duración de los ticks como mínimo, mediana, percentil 95 y máximo en milisegundos. Un tick puede durar hasta 50 ms para mantener 20 TPS. En la imagen, la mediana está en 2,4 ms, así que el servidor tiene mucho margen. Lo decisivo es el percentil 95: si se acerca a 50 ms, habrá tirones aunque la media parezca buena.
  • Uso de la CPU separado en sistema (toda la máquina) y proceso (solo tu servidor). En un servidor alquilado, el valor importante es el del proceso.

/spark healthreport reúne esos mismos valores junto con la memoria y el disco en un solo informe.

El profiler: ¿qué se come el tiempo?

Cuando los TPS caigan, inicia el profiler:

/spark profiler start

spark confirma el inicio y sigue funcionando en segundo plano. Déjalo activo al menos un minuto mientras ocurre el problema y, después, ejecuta:

/spark profiler stop
El profiler se ejecuta en segundo plano; spark muestra los comandos para ver, detener y cancelar (Enlarge image)

Al detenerlo, spark sube el informe a spark.lucko.me y te da un enlace. El informe no contiene nombres de jugadores, direcciones IP ni mensajes de chat, sino árboles de llamadas del proceso Java. /spark profiler open lo abre mientras sigue en marcha y /spark profiler cancel lo descarta sin subirlo.

En el informe, despliega el árbol de arriba abajo. Esto es lo que sueles encontrar:

  • Ticks de entidades de un tipo concreto: una granja con cientos de animales u objetos. Reduce la granja o cálmala con entity-activation-range en paper-world-defaults.yml.
  • Un plugin en un event listener: actualiza el plugin, revisa su configuración o sustitúyelo.
  • Carga de chunks por jugadores que vuelan rápido: reduce la distancia de visión o pregenera el mundo con Chunky.
  • Relojes de redstone: un circuito que nunca se detiene. Pide al jugador que lo apague.

Garbage collection y memoria

/spark gc muestra con qué frecuencia y durante cuánto tiempo se pausa la recolección de basura de Java. Muchas pausas largas indican falta de RAM o una fuga de memoria en un plugin. /spark heapsummary enumera qué tipos de objetos ocupan la memoria. Antes de contratar más RAM, merece la pena echar un vistazo aquí: a menudo, una actualización de un plugin resuelve el problema.

Errores habituales

  • 20 TPS y, aun así, lag. El problema está en el cliente o en la red. /spark ping muestra la latencia de cada jugador.
  • Has olvidado el enlace del profiler. /spark profiler sin argumentos muestra el estado; después de detenerlo, el enlace también aparece en la consola del servidor.
  • Cifras sin comparación. Un valor de TPS por sí solo dice poco. Haz una medición con el servidor vacío para tener una referencia.

Guías relacionadas

Generar un mundo por adelantado libera al servidor de la carga de chunks: Chunky: pregenerar el mundo. Cómo avisa el panel de unos TPS bajos de forma continuada se explica en Lag en servidores de Minecraft: TPS y Watchdog.

Fuentes