Introducción
Qué es ExyliaAnalytics: el agente de Exylia Analytics, un solo jar para Paper, Spigot, Folia y Velocity que envía datos al panel de analytics.exylia.net.
ExyliaAnalytics es el agente de Exylia Analytics, un panel web que responde a una
pregunta sobre un servidor o una red de Minecraft: ¿está creciendo o decayendo, y por qué? El agente se ejecuta dentro
de tus servidores y de tu proxy, observa jugadores que entran y salen, que se quedan AFK, lag, baneos, votos, rangos y
dinero que se mueve, y lo envía en lotes de eventos a analytics-ingest.exylia.net. El panel los convierte en gráficos,
cohortes, perfiles de jugador y un informe de la economía.
En unos diez minutos puedes tener un servidor instalado, vinculado y dibujando sus primeros gráficos. El agente no tiene servidor web, no abre ningún puerto y no necesita ningún otro plugin: todo sale por HTTPS, y nada se conecta nunca hacia dentro.
Antes de empezar#
| Necesitas | Detalle |
|---|---|
| Java | 21, para el que está compilado el loader. |
| Servidor | Paper o Spigot 1.17 o superior. Folia es compatible con los límites de las preguntas frecuentes. |
| Proxy | Velocity 3. BungeeCord y Waterfall no son compatibles como proxy. |
| Red | HTTPS saliente hacia analytics-ingest.exylia.net. Ningún puerto entrante. |
| Cuenta | Una cuenta de Discord para entrar en el panel. |
Plugins como LuckPerms, LiteBans, Vault o PlaceholderAPI son opcionales: cada uno se usa si está y se ignora si no. Mira Conecta otros plugins.
Pasos#
Instala el jar
Pon Exylia-Analytics-Loader.jar en plugins/ del proxy y de cada servidor. Comprado en BuiltByBit, la licencia va
dentro del jar: no hay ninguna clave que poner. Mira Instalación.
Vincula cada servidor
Un agente sin vincular muestra un código en la consola. Escríbelo en analytics.exylia.net/link y apruébalo en tu
espacio de trabajo. El agente recoge un token y empieza a enviar. Mira
Conecta tu servidor.
Lee el panel
Los gráficos se llenan en menos de un minuto. Qué se recoge, cada cuánto y si un servidor recoge o no se decide desde el panel, sin reiniciar.
Comprueba que funciona#
Tu servidor aparece en el panel en Servidores y su Resumen empieza a llenarse. /analytics status (o
/analyticsv status en Velocity) en la consola te dice lo mismo desde el lado del servidor. Si no, mira
Problemas comunes.
Para ir más lejos#
Dos mitades#
| Dónde se ejecuta | Qué hace | |
|---|---|---|
| El agente | Tu proxy y tus servidores, como plugin | Recoge eventos, los guarda en disco hasta entregarlos y toma sus ajustes del panel. |
| El panel | https://analytics.exylia.net, en el navegador | Te identifica con Discord, guarda tu espacio de trabajo (una red), vincula servidores a él y dibuja cada gráfico. |
Un jar, tres papeles#
El mismo jar del loader va en un proxy Velocity y en un servidor Paper o Spigot. Cada instalación es un servidor en el panel, y cada uno cumple uno de tres papeles:
| Papel | Qué es | Qué envía |
|---|---|---|
proxy | Un proxy Velocity. | La sesión de red: quién se conectó, desde qué dirección y hostname, con qué cliente, y a qué backend pasó. Latidos, CPU y memoria del proxy, la lista de servidores del proxy. |
backend | Un servidor Paper/Spigot detrás de un proxy. | La presencia: quién estuvo en este servidor, cuánto tiempo, cuánto de él AFK y qué hizo allí. TPS, MSPT, entidades y chunks. Economía y valores de PlaceholderAPI. |
standalone | Un servidor Paper/Spigot al que los jugadores entran directamente. | Todo lo anterior: es dueño de la sesión de red y de la presencia. |
El papel se detecta al iniciar y se puede forzar en config.yml; mira
Instalación.
Qué envía, y desde dónde
| Área | Fuente |
|---|---|
| Sesiones, hostnames, marca del cliente, idioma, versión del protocolo | El propio servidor; ViaVersion para la versión del cliente en un servidor Paper independiente. |
| Java o Bedrock | Floodgate, o la forma del UUID del jugador. |
| Tiempo AFK y contadores de actividad (chat, comandos, muertes, asesinatos de jugadores, logros) | El propio servidor. Solo recuentos, nunca contenido. |
| TPS, MSPT, CPU, memoria, entidades, chunks, disponibilidad, reinicios, caídas | El propio servidor. |
| Sanciones | LiteBans, LibertyBans o AdvancedBan. |
| Votos | NuVotifier (o el Votifier clásico en Paper). |
| Cambios de rango y el grupo principal | LuckPerms. |
| Cualquier valor que muestre un placeholder | PlaceholderAPI, para los placeholders que indiques. |
| Dinero creado, destruido y en manos de los jugadores | ExyliaLib, Vault, VaultUnlocked, PlayerPoints, ExcellentEconomy y cualquier plugin que llame a la API. |
| Fechas de juego anteriores y tiempo de juego total | Los propios archivos de jugadores del servidor, leídos una vez tras vincular. |
| Avisos de anticheat | Vulcan, Grim, Matrix, Spartan, Intave o LightAntiCheat. |
| Cuentas de Discord vinculadas | DiscordSRV o EssentialsX Discord Link. |
| Operaciones y anuncios de mercado | Plugins de mercado, con ExyliaAnalytics.trade(...). |
| Tus propios eventos | Otros plugins, con ExyliaAnalytics.track(...). |
La lista completa, evento por evento, está en Datos recogidos; lo que nunca sale del servidor, en Privacidad.
¿Falta algo en esta página? Dínoslo en Discord