Documentation / WebLogs Installation

WebLogs Installation

Download, install and connect Adictos_WebLogs to your web panel.

Don’t use FileZilla to upload the resource if your server runs Linux: it can corrupt permissions. Use WinSCP or SFTP in binary mode.

Requirements

  • Character framework (one): es_extended (ESX Legacy), qb-core (QBCore) or qbx_core (Qbox) — WebLogs detects which one is active
  • oxmysql
  • ox_lib — required for Adictos_WebLogs to start
  • ox_inventory (optional) — if you use it, enable the automatic patch under Manage → ox_lib; details in ox_lib Integration
  • Access to the web panel with your Steam account
  • Adictos_WebLogs downloaded from Cfx.re / Tebex (not from the panel ZIP)
On startup the console shows Framework detected: ESX, QBCore or Qbox (qbx_core). ensure Adictos_WebLogs must come after the framework, oxmysql and ox_lib.

Installation steps

  1. 1Download Adictos_WebLogs from Cfx.re / Tebex and place it in resources/.
  2. 2Add ensure Adictos_WebLogs to server.cfg after your framework (ESX, QBCore or Qbox), oxmysql and ox_lib.
  3. 3On startup the console prints a /link/ABC-DEF URL (valid 15 min). Open it with the owner’s Steam account. If you create a new server, choose the name in the box (don’t use FiveM’s coloured hostname). The Free plan doesn’t ask for a Tebex ID.
  4. 4When you confirm, the panel stores the IP:port it saw: the first connection needs no token and no FiveM restart to check logs. The token is stored only in the resource (no setr in server.cfg).
  5. 5Premium: pay on Tebex and paste the tbx-… ID on the same page or under My subscriptions.

Example order in server.cfg (ESX)

ensure es_extended
ensure oxmysql
ensure ox_lib
ensure Adictos_WebLogs

Example order in server.cfg (QBCore)

ensure qb-core
ensure oxmysql
ensure ox_lib
ensure Adictos_WebLogs

Example order in 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

Automatic ox_inventory logs

If you use ox_inventory or other resources that log with lib.logger, enable Install the patch automatically in Get Started (step 2) or under Manage → ox_lib. WebLogs only edits ox_lib/imports/logger/server.lua (like jobs_creator does with ESX). If your hosting doesn’t allow writing, the manual steps are in ox_lib Integration.

CK and licence change (DB tables)

CK and licence transfer use the tables you configure in the panel, not the lists in the resource’s config.lua (those are only a fallback while the panel has no tables yet).

  1. 1Panel → My servers → your server → Manage.
  2. 2CK tab: tables and the column that identifies the player (identifier, owner, citizenid, license…).
  3. 3Transfer licence tab: the same tables for the licence change (usually a set similar to CK).
  4. 4Save and restart Adictos_WebLogs (or wait for the sync). The console will show CK: N tablas | Transfer: M tablas (panel).
Identifier: under Manage → Framework choose automatic or manual (type license/steam/…, prefix and multichar). ESX/QB are detected automatically; the manual override forces the offline format (locker, CK…). The inventory (ox / qb / qs) is also detected and shown on that tab — don’t confuse it with Inventory logs (ox_lib filters). Under Manage → CKs configure the accounts to preserve (addon_account_data).

Check that it works

  • The server console must not show a panel connection error.
  • In the panel, go to Logs → GENERAL and check that events are arriving (connections, inventory…).
  • If no logs arrive, check that the /link pairing finished. No restart is needed: after linking, logs and heartbeat come in via IP:port; the token is stored only in the resource.

Updating the resource

When there is a new version, update the resource from Cfx.re / Tebex, replace the folder in resources/ and restart. The panel no longer auto-updates WebLogs. Your categories and webhooks stay in the panel; nothing is lost.