Instala ExyliaAnalytics
El jar del loader en un servidor, un proxy o una red entera, la licencia, los archivos que escribe el agente y cómo decide su papel.
En unos cinco minutos el jar está en tu servidor y muestra el código que lo vincula al panel. ExyliaAnalytics se distribuye
como un solo archivo, Exylia-Analytics-Loader.jar. Contiene el loader de Paper y el de Velocity uno al lado del otro, y
cada plataforma lee solo su propio descriptor, así que el mismo archivo va en un proxy y en un servidor. El loader
comprueba tu licencia y después descarga el agente.
Antes de empezar#
- Paper o Spigot 1.17 o superior, o Velocity 3, con Java 21. Mira la Introducción.
- HTTPS saliente desde la máquina hacia
analytics-ingest.exylia.net. El agente nunca escucha en un puerto. - El jar de tu compra en BuiltByBit. La licencia va dentro: no hay ninguna clave que poner.
Pasos#
Coloca el jar
Pon Exylia-Analytics-Loader.jar en plugins/. No hace falta nada más.
Arranca el servidor
El loader comprueba la licencia, escribe loader.yml en la carpeta del plugin y descarga el agente.
Deja que arranque
El agente escribe config.yml y una carpeta data/ y, como aún no está vinculado, muestra un código de vinculación
en la consola.
Vincúlalo
Introduce ese código en el panel. Mira Conecta tu servidor.
Comprueba que funciona#
Ejecuta /analytics status en la consola (/analyticsv status en Velocity). Antes de vincular muestra el código; después
muestra el papel del servidor y que está enviando. El servidor aparece entonces en Servidores en el panel.
Para ir más lejos#
Instalar en una red#
Instala el mismo jar en el proxy Velocity y en cada backend, y vincula cada uno. Cada instalación es su propio servidor en el panel, con su propio código y su propio token.
Primero el proxy
El proxy es el único que ve quién se conectó, desde qué hostname y país, con qué cliente. Sin él, una red no tiene sesiones y la mayor parte del panel se queda vacía.
Después cada backend
Cada backend informa de quién estuvo en él, cuánto tiempo, el tiempo AFK, TPS y MSPT, la economía y los placeholders. Vincúlalos todos al mismo espacio de trabajo que el proxy.
Confirma el mapeo del proxy
El proxy envía su lista de servidores. En Servidores → Mapeo del proxy el panel sugiere qué backend es cada entrada, por puerto; confirma cada una. Mira Servidores y rendimiento.
No hay agente para BungeeCord ni Waterfall. Los backends detrás de uno se siguen detectando como backends (por
settings.bungeecord en spigot.yml), pero sin agente en el proxy nadie informa de las sesiones de red. Forzar
mode: standalone en los backends hace que cada uno abra sus propias sesiones, a costa de que cambiar de servidor cuente
como una sesión nueva.
El papel del servidor#
Al iniciar, el agente decide qué es:
| Detectado | Cuándo |
|---|---|
proxy | Se ejecuta en Velocity. Siempre. |
backend | Paper o Spigot con el reenvío de Velocity activado (proxies.velocity.enabled en paper-global.yml, o velocity-support en Paper 1.17–1.18), o settings.bungeecord: true en spigot.yml. |
standalone | Cualquier otro caso. |
mode en config.yml anula la detección en Paper y Spigot, y solo se aplica tras
reiniciar. El papel aparece en la página Servidores como el tipo del servidor (standalone se muestra como
independiente), y /analytics status lo muestra.
Copiar la carpeta de un servidor#
Una carpeta plugins/ copiada se lleva data/credentials.json con ella, y dos servidores acaban enviando con un mismo
token. El ingest solo deja que un proceso en marcha tenga un token: el segundo es rechazado, registra una vez "Another
running server holds this token (a copied plugin folder?)" y guarda sus eventos en disco, reintentando cada minuto.
/analytics status lo muestra como Waiting.
En la copia, ejecuta /analytics unlink (o borra data/credentials.json con el servidor parado), después
/analytics link y aprueba el nuevo código: pasa a ser un servidor propio.
Actualizar#
El loader descarga la versión actual del agente al arrancar, así que reiniciar es actualizar. El jar del loader solo hay que sustituirlo cuando una versión lo pide, por ejemplo cuando la consola dice "The installed loader is outdated: the economy API is disabled until it is updated", lo que significa que el loader es anterior a la API de economía que llaman los plugins.
El panel marca una actualización del agente en cada gráfico temporal cuando un servidor arranca con una versión nueva.
Archivos que escribe el agente
Paper y Spigot guardan todo en plugins/ExyliaAnalytics/, Velocity en plugins/exyliaanalytics/.
| Archivo | Contenido |
|---|---|
loader.yml | Lo escribe el loader. Una compra de BuiltByBit no necesita nada en él: la licencia va en el jar. |
config.yml | Los pocos ajustes que el servidor decide antes de poder llegar al panel: el papel, los valores de PlaceholderAPI, el envoltorio de Vault y el registro de depuración. Mira Configuración. |
data/credentials.json | El token del servidor y el espacio de trabajo al que pertenece, escrito cuando se aprueba una vinculación. En Linux solo lo puede leer el usuario del servidor. |
data/remote-config.json | Los últimos ajustes que envió el panel, para que el agente empiece a recoger antes de que la red esté disponible. |
data/spool/ | Lotes de eventos pendientes de entrega, un archivo .json.gz cada uno. |
El token se guarda fuera de config.yml a propósito, porque las configuraciones acaban en capturas y en tickets de
soporte. Quien tenga credentials.json puede enviar eventos a tu espacio de trabajo como ese servidor hasta que lo
revoques.
¿Falta algo en esta página? Dínoslo en Discord