Documentación / Installation WebLogs

Installation WebLogs

Descarga, instala y conecta Adictos_WebLogs con tu panel web.

No uses FileZilla para subir el recurso si tu servidor es Linux: puede corromper permisos. Usa WinSCP o SFTP con modo binario.

Requisitos

  • Framework de personajes (uno de los dos): es_extended (ESX Legacy) o qb-core (QBCore) — WebLogs detecta cuál está activo; no hay que configurarlo
  • oxmysql
  • ox_lib — necesario para que arranque Adictos_WebLogs
  • ox_inventory (opcional) — si lo usas, sigue la guía Integración ox_lib para capturar sus logs automáticamente
  • Acceso al panel web con tu cuenta Steam
  • Servidor registrado en el panel (Mis servidores)
Al arrancar verás en consola Framework detectado: ESX o Framework detectado: QBCore. Asegúrate de que ensure Adictos_WebLogs va después de tu framework (es_extended o qb-core).

Pasos de instalación

  1. 1Entra al panel con Steam → Mis servidores → crea tu servidor o pide acceso al dueño.
  2. 2Pulsa Descargar Adictos_WebLogs y descomprime el ZIP en la carpeta resources/ de tu servidor.
  3. 3Añade ensure Adictos_WebLogs en server.cfg después de tu framework (ESX o QBCore), oxmysql y ox_lib.
  4. 4En el panel: Mis servidores → tu servidor → Detalles → registra la IP:puerto de conexión de FiveM.
  5. 5Reinicia el recurso (ensure Adictos_WebLogs) o el servidor completo. Comprueba en consola que la sincronización con el panel fue correcta.

Ejemplo de orden en server.cfg (ESX)

ensure es_extended
ensure oxmysql
ensure ox_lib
ensure Adictos_WebLogs

Ejemplo de orden en server.cfg (QBCore)

ensure qb-core
ensure oxmysql
ensure ox_lib
ensure Adictos_WebLogs

Logs automáticos de ox_inventory

Si usas ox_inventory u otros recursos que registran con lib.logger, necesitas un pequeño ajuste en ox_lib. Todo el detalle (bloque a pegar, archivo completo y configuración del panel) está en Integración ox_lib.

CK y cambio de licencia (tablas de BD)

El CK y la transferencia de licencia usan las tablas que configures en el panel, no las listas del config.lua del ZIP (esas son solo respaldo si el panel aún no tiene tablas).

  1. 1Panel → Mis servidores → tu servidor → Gestionar.
  2. 2Pestaña CK: tablas y columna que identifica al jugador (identifier, owner, citizenid, license…).
  3. 3Pestaña Transferir licencia: mismas tablas para el cambio de licencia (suele ser un conjunto similar al CK).
  4. 4Guarda y reinicia Adictos_WebLogs (o espera la sincronización). En consola verás CK: N tablas | Transfer: M tablas (panel).
ESX: en Gestionar → Framework activa el prefijo license: si tu ESX lo usa. QBCore se detecta solo. En Gestionar → CKs configura las cuentas a preservar (addon_account_data).

Comprobar que funciona

  • En consola del servidor no debe aparecer error de conexión al panel.
  • En el panel, entra a Logs → GENERAL y verifica que llegan eventos (conexiones, inventario…).
  • Si no llegan logs, revisa que la IP registrada en Mis servidores coincide con la IP pública desde la que FiveM llama al panel.

Actualizar el recurso

Cuando haya una versión nueva, vuelve a Mis servidores → Descargar Adictos_WebLogs, sustituye la carpeta en resources/ y reinicia el recurso. Tus categorías y webhooks siguen en el panel; no se pierden.