Documentación / Intégration ox_lib

Intégration ox_lib

Captura automática de logs de ox_inventory y otros recursos que usan lib.logger.

Recursos como ox_inventory envían movimientos de items, stash, maletero y similares mediante lib.logger de ox_lib. El ox_lib oficial no los reenvía al panel: hay que añadir un bloque al final de su logger. No hace falta set ox:logger en server.cfg: el parche detecta si Adictos_WebLogs está iniciado.

¿Cuándo lo necesitas?

  • Usas ox_inventory y quieres ver en el panel los logs de inventario sin programar nada más.
  • Otros recursos de tu servidor llaman a lib.logger y quieres centralizarlos en WebLogs.
  • Adictos_WebLogs ya está instalado y sincronizado con el panel (requisito previo).

Archivo a editar

Ruta en tu servidor FiveM:

/ox_lib/imports/logger/server.lua

Opción A — Pegar solo el bloque nuevo (recomendado al actualizar ox_lib)

  1. 1Instala o actualiza ox_lib desde GitHub con su server.lua oficial.
  2. 2Abre /ox_lib/imports/logger/server.lua en tu servidor.
  3. 3Copia el bloque siguiente y pégalo justo antes de la línea return lib.logger (al final del archivo).
  4. 4Guarda, reinicia ox_lib y Adictos_WebLogs.

Bloque a añadir

Opción B — Sustituir el archivo completo

Si prefieres copiar y pegar tal cual sin abrir el archivo oficial de ox_lib, sustituye server.lua entero por el contenido de abajo. Está basado en el logger de ox_lib v3.33 con la integración Adictos_WebLogs ya incluida al final.

Si actualizas ox_lib a una versión nueva, comprueba en GitHub si el archivo oficial cambió. En ese caso es más seguro la opción A (volver a pegar solo el bloque).

server.lua completo (copiar y sustituir)

server.cfg y panel

  1. 1En server.cfg, ensure ox_lib debe ir antes de ensure Adictos_WebLogs.
  2. 2Reinicia ambos recursos tras editar el logger.
  3. 3Panel → Mis servidores → Gestionar → pestaña ox_lib → módulo activo.
  4. 4Opcional: ajusta filtros, intervalo de buffer y Discord en esa misma pestaña.
ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure Adictos_WebLogs

Comprobar que funciona

  • En consola, al arrancar WebLogs: mensaje [OX_LIB_LOGS] Arranque OK o similar.
  • Mueve un item en el juego (inventario, stash o maletero).
  • Panel → Logs → GENERAL (o categoría de inventario) — deben aparecer eventos en unos segundos.
ox_inventory (lib.logger)
    │
    ▼
ox_lib/imports/logger/server.lua  ← bloque Adictos al final
    │
    ▼
Adictos_WebLogs (buffer → panel)
    │
    ▼
Panel web (procesamiento + vista Logs)
Sin el parche, WebLogs sigue funcionando para conexiones, vehículos, exports propios, etc. Solo dejarás de recibir los logs automáticos que pasan por lib.logger de ox_lib.