Contenido generado con IA — puede contener errores.

ExyliaAnalytics/EmpezarActualizada en v1.2.0

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.

Página 2 de 285 min de lectura

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.

BungeeCord y Waterfall

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:

DetectadoCuándo
proxySe ejecuta en Velocity. Siempre.
backendPaper 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.
standaloneCualquier 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/.

ArchivoContenido
loader.ymlLo escribe el loader. Una compra de BuiltByBit no necesita nada en él: la licencia va en el jar.
config.ymlLos 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.jsonEl 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.jsonLos ú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.
No compartas credentials.json

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