Cómo realizar un diagnóstico con Spark Profiler en tu servidor de Minecraft

BoxToPlay-helper · May 29, 2026, 4:48pm

Cómo realizar un diagnóstico con Spark Profiler en tu servidor de Minecraft

Spark es un profiler muy potente que permite identificar exactamente qué está provocando lag en un servidor de Minecraft: mods o plugins pesados, tareas mal configuradas, ticks demasiado largos, etc. En BoxToPlay puedes instalar Spark en pocos clics como mod o plugin directamente desde el panel de BoxToPlay (o manualmente subiendo el archivo por FTP) y lanzar todos los diagnósticos desde la consola en vivo.

A continuación explicamos cómo instalar y utilizar Spark en tu servidor paso a paso.

1. Requisitos previos

Antes de lanzar Spark Profiler en tu servidor de Minecraft:

Un servidor Minecraft en BoxToPlay iniciado y en línea.
El servidor debe ejecutar una versión que admita mods o plugins (Forge, NeoForge, Fabric, Spigot, Paper, Purpur, etc.). Spark también es compatible con proxies (BungeeCord, Velocity).
Acceso a la consola en vivo de BoxToPlay de este servidor con permisos suficientes para ejecutar comandos de Spark.

2. Instalar Spark en el servidor

Spark se adapta a todo tipo de servidores. Según la configuración de tu servidor, tienes dos métodos sencillos para instalarlo:

Opción A: Instalación automática desde el Panel de BoxToPlay

Es el método más rápido y recomendado:

En el menú de tu servidor en el panel de BoxToPlay, haz clic en Instalación de Mods o Instalación de Plugins (según el tipo de tu servidor).
En el campo de búsqueda, escribe spark.
Selecciona el mod o plugin spark.
Elige la versión compatible con tu versión de Minecraft/servidor (por ejemplo Forge, Fabric, Paper/Spigot, etc.).
Haz clic en Instalar y confirma.
Una vez instalado, reinicia el servidor para cargar Spark.

Opción B: Instalación manual (mediante FTP o Gestor de archivos)

Si prefieres instalar el archivo .jar tú mismo o usas una versión específica:

Descarga la versión adecuada de Spark (archivo .jar) desde el sitio web oficial de Spark, Modrinth o CurseForge. Asegúrate de elegir el archivo correspondiente a tu plataforma (Forge, Fabric, Spigot/Paper, BungeeCord, Velocity, etc.) y a tu versión de Minecraft.
Conéctate a tu servidor mediante FTP o utiliza el Gestor de archivos integrado en el panel.
Sube el archivo .jar a la carpeta correcta de tu servidor:
- Para servidores basados en plugins (Spigot, Paper, Purpur…): súbelo a la carpeta plugins/.
- Para servidores basados en mods (Forge, NeoForge, Fabric…): súbelo a la carpeta mods/.
Reinicia el servidor para aplicar la instalación.

3. Verificar que Spark se carga en los logs

Vuelve al Dashboard del servidor y asegúrate de que está En línea.
Haz clic en Registros del servidor desde la cabecera de la consola o abre la página de Todos los logs.
Busca en el último log de arranque entradas que mencionen spark (líneas indicando que Spark se ha inicializado como mod o plugin, versión cargada, etc.).

Si Spark no aparece en el arranque, revisa que:

El archivo .jar esté en la carpeta correcta (mods/ o plugins/) y que el servidor se haya reiniciado.
Para una instalación automática desde el panel, comprueba que el mod/plugin esté activado en la pestaña de gestión de mods/plugins instalados.

4. Ejecutar comandos de Spark (Consola o En el juego)

Puedes ejecutar los comandos de Spark de dos maneras diferentes:

Desde la consola en vivo del panel de BoxToPlay: Ve al Dashboard de tu servidor en el panel e introduce los comandos en la terminal inferior sin barra inicial (por ejemplo, spark profiler start).
Directamente en el juego: Si estás conectado a tu servidor y dispones de los permisos necesarios (OP o nodos de permiso específicos como spark.profiler), puedes ejecutar los comandos directamente desde el chat del juego añadiendo una barra / (por ejemplo, /spark profiler start).

5. Iniciar una sesión de Spark Profiler

Spark ofrece varios modos de profiling según tus necesidades.

Nota: Si usas Spark en un servidor proxy, el comando base cambia según la plataforma: usa sparkb en BungeeCord y sparkv en Velocity (por ejemplo, /sparkb profiler start o /sparkv profiler start). Ten en cuenta que instalar Spark en un proxy solo analiza el rendimiento del propio proxy (gestión de red, plugins del proxy, etc.). Para diagnosticar tus servidores de juego backend (Paper, Fabric, etc.) conectados al proxy, debes instalar Spark en cada servidor de juego de forma individual.

Para un diagnóstico clásico limitado a 120 segundos, usa:

spark profiler start --timeout 120

Spark detendrá automáticamente la captura al final del plazo y generará el enlace del informe. Si quieres detener la captura manualmente antes de que termine, usa:

spark profiler stop

Para monitorizar la sesión de captura sin detenerla, dispones de dos comandos útiles:

Para mostrar los detalles técnicos de la captura actual en la consola/chat (duración, número de muestras, etc.):
```
spark profiler info
```
Para generar un enlace que te permita ver el informe en tiempo real en tu navegador mientras la grabación sigue en curso:
```
spark profiler open
```

Para investigar picos de lag aislados, empieza activando el monitor de ticks:

spark tickmonitor --threshold-tick 50

Cuando hayas detectado ticks anormalmente largos, lanza después un perfil dirigido. Por ejemplo, para recopilar solo ticks que superen 150 ms:

spark profiler start --only-ticks-over 150 --timeout 120

Para diagnósticos más avanzados, Spark te permite modificar el alcance o el tipo de datos analizados:

Analizar todos los hilos (threads) (en lugar de limitarse solo al hilo principal del servidor): útil si el lag está provocado por tareas asíncronas, conexiones de red u otros procesos ejecutándose en segundo plano.
```
spark profiler start --thread * --timeout 120
```
Analizar la asignación de memoria (en lugar del uso de CPU): rastrea la creación de objetos en la RAM para identificar el origen de fugas de memoria o sobrecargas del recolector de basura (Garbage Collector).
```
spark profiler start --alloc --timeout 120
```

Adapta siempre la sintaxis exacta a lo que muestre la ayuda de tu versión de Spark (spark o spark help) en la consola.

Buenas prácticas durante el profiling:

Elige un momento representativo: lanza el perfil durante un periodo de juego normal o de carga alta, no justo después del arranque.
Evita reiniciar o parar el servidor mientras el perfil está en curso.
Intenta reproducir el lag que estás investigando mientras Spark está activo.
Una duración de 60 a 180 segundos suele ser suficiente para obtener datos útiles.

6. Esperar al análisis y recuperar el enlace

Tras lanzar el comando de profiling, Spark confirmará en la consola que la captura ha comenzado.
Deja que el servidor funcione con normalidad hasta que Spark muestre el mensaje de finalización.
Al terminar, Spark genera una URL (enlace al informe de profiling) y la imprime directamente en la consola.
Copia este enlace desde la consola en vivo.

Ese enlace es la clave de tu análisis: guárdalo para consultarlo o compartirlo más tarde.

Esta sección de cabecera del informe resume la salud general de tu servidor de un vistazo:

TPS (Ticks Per Second): El número de ticks de juego procesados por segundo. El valor ideal es 20.00. Una caída sostenida de los TPS se traduce directamente en lag visible para los jugadores.
MSPT (Milliseconds Per Tick): El tiempo (en milisegundos) empleado en procesar un solo tick. Para mantener unos TPS perfectos de 20.00, este valor debe permanecer por debajo de 50.00 ms. Si el MSPT medio o mediano supera los 50 ms, el servidor no podrá seguir el ritmo y los TPS bajarán.
CPU: El porcentaje de procesador consumido por el proceso de tu servidor.
Memory: La cantidad de memoria RAM utilizada actualmente sobre el total máximo asignado al servidor.

7. Interpretar el informe de Spark Profiler

Cuando abras el enlace de Spark en tu navegador, verás un informe interactivo. Las secciones más importantes son:

Línea temporal de ticks / TPS
- Muestra el tiempo de tick medio y los TPS durante la grabación.
- Busca picos por encima de 50 ms por tick (lag severo) o periodos largos por debajo de 20 TPS.

Principales contribuyentes al tiempo de tick
- Lista qué mods o plugins, entidades o sistemas consumen más tiempo de tick.
- Identifica:
  - Mods o plugins pesados (generación de mundo, automatización compleja, plugins mal optimizados…).
  - Dimensiones o zonas problemáticas.
  - Tareas que se ejecutan en cada tick y tardan demasiado.
Schedulers / tareas programadas
- Spark muestra las tareas programadas (repetitivas, temporizadores, tareas asíncronas).
- Vigila tareas que se ejecutan demasiado a menudo (cada tick) o que duran mucho.
Información del Garbage Collector (GC)
- Revisa el tiempo invertido en pausas de GC y la curva de uso de memoria.
- Pausas frecuentes o largas suelen indicar:
  - Demasiadas asignaciones de memoria por parte de mods o plugins.
  - Falta de RAM para la carga actual del servidor.
Rutas calientes de CPU (en perfiles de CPU)
- Los flame graphs muestran qué métodos consumen más CPU.
- Concéntrate en las pocas pilas superiores; suelen apuntar exactamente a la mecánica, el plugin o el mod que causa el lag.

Con esta información puedes decidir qué cambiar: reducir la distancia de visión, ajustar configuraciones, eliminar o sustituir un mod/plugin problemático o reprogramar tareas pesadas.

8. Volver a perfilar tras los cambios

Cada vez que modifiques la configuración o añadas/elimines mods o plugins, es recomendable ejecutar un nuevo perfil con Spark para confirmar que el rendimiento ha mejorado.

Guarda varios enlaces de perfil con etiquetas (antes/después del cambio).
Compara tiempos de tick, comportamiento del GC y principales contribuyentes.

Conclusión y próximos pasos con BoxToPlay

Spark Profiler es una de las herramientas más eficaces para entender qué ocurre dentro de tu entorno de servidor Minecraft. Gracias a la instalación simplificada de mods y plugins y a la consola en vivo integradas en el panel de BoxToPlay, puedes instalar Spark, perfilar tu servidor y actuar sobre los resultados en pocos minutos.

Si quieres probar estos pasos en tu propio mundo, puedes crear un servidor Minecraft en BoxToPlay y experimentar con Spark sin compromiso. Prueba gratis tu servidor y comienza a optimizar tu experiencia de juego.