Documentación / Instalación de WebLogs

Instalación de 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): es_extended (ESX Legacy), qb-core (QBCore) o qbx_core (Qbox) — WebLogs detecta cuál está activo
  • oxmysql
  • ox_lib — necesario para que arranque Adictos_WebLogs
  • ox_inventory (opcional) — si lo usas, en Gestionar → ox_lib activa el parche automático; detalle en Integración ox_lib
  • Acceso al panel web con tu cuenta Steam
  • Adictos_WebLogs descargado desde Cfx.re / Tebex (no desde el ZIP del panel)
Al arrancar verás en consola Framework detected: ESX, QBCore o Qbox (qbx_core). ensure Adictos_WebLogs debe ir después del framework, oxmysql y ox_lib.

Pasos de instalación

  1. 1Descarga Adictos_WebLogs en Cfx.re / Tebex y colócalo en resources/.
  2. 2Añade ensure Adictos_WebLogs en server.cfg después de tu framework (ESX, QBCore o Qbox), oxmysql y ox_lib.
  3. 3Al arrancar, la consola imprime una URL /link/ABC-DEF (15 min). Ábrela con el Steam del dueño. Si creas un servidor nuevo, elige el nombre en el recuadro (no uses el hostname con colores de FiveM). El plan Free no pide ID de Tebex.
  4. 4Al confirmar, el panel guarda la IP:puerto vista: la primera conexión no necesita token ni reiniciar FiveM para comprobar logs. El token se guarda solo en el recurso (sin setr en server.cfg).
  5. 5Premium: paga en Tebex y pega el ID tbx-… en la misma página o en Mis suscripciones.

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

Ejemplo de orden en server.cfg (Qbox)

ensure qbx_core
# o el bridge qb-core de Qbox, según tu plantilla
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, activa Instalar automáticamente el parche en Primeros pasos (paso 2) o en Gestionar → ox_lib. WebLogs edita solo ox_lib/imports/logger/server.lua (como jobs_creator con ESX). Si el hosting no deja escribir, el detalle manual 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 recurso (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).
Identifier: en Gestionar → Framework elige automático o manual (tipo license/steam/…, prefijo y multichar). ESX/QB se detectan solos; el override manual fuerza el formato offline (taquilla, CK…). El inventario (ox / qb / qs) también se detecta y se muestra en esa pestaña — no lo confundas con Logs inventario (filtros ox_lib). 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 el emparejamiento /link terminó. No hace falta reiniciar: tras vincular, logs y heartbeat entran por IP:puerto; el token se guarda solo en el recurso.

Actualizar el recurso

Cuando haya una versión nueva, actualiza el recurso desde Cfx.re / Tebex, sustituye la carpeta en resources/ y reinicia. El panel ya no auto-actualiza WebLogs. Tus categorías y webhooks siguen en el panel; no se pierden.