Documentation / Player bans

Player bans

Hybrid system: local enforcement in FiveM (bans.json) and history in the panel, without HWID or IP.

Adictos_WebLogs manages active bans on the FiveM server (bans.json file). The web panel only stores the history to show it on the player profile: Rockstar licence, Steam, Discord, reason, dates and staff. No HWID or IP is stored on the web.

In bans.json (FiveM only), an online ban stores as many identifiers as possible for anti-evasion: license/license1/license2, steam, discord, fivem, xbl, live, tokens (HWID), ip/ips, endpoint, identifiers (raw list), alt_licenses, dates/staff and optionally panel_ban_id. On connect it checks by licence, Steam, Discord, FiveM ID or HWID, and fills in any missing fields (e.g. offline ban).

BanPlayer export

From any server resource (anticheat, jobs, admin…):

-- license: hex de Rockstar (con o sin prefijo license:, se sanitiza solo)
-- minutes: 0 = permanente
exports['Adictos_WebLogs']:BanPlayer(license, reason, minutes, staffName, staffSteamId)

-- Ejemplos:
exports['Adictos_WebLogs']:BanPlayer('abc123def4567890', 'Uso de hacks', 60, 'Anticheat')
exports['Adictos_WebLogs']:BanPlayer('abc123def4567890', 'Cheats', 0, 'Anticheat')  -- Permaban
exports['Adictos_WebLogs']:BanPlayer('abc123def4567890', 'Speed hack', 1440, 'Anticheat', '76561198058635060')
ParameterDescription
licenseRockstar licence (hex). Accepts the license: prefix or not — it is sanitised automatically. Required
reasonBan reason — required
minutesDuration in minutes. 0 = permanent
staffNameDisplayed staff name (e.g. Anticheat, Admin)
staffSteamIdStaff SteamID64 (optional, defaults to 0)

Additional exports

-- Comprobar si una licencia está baneada (con tokens opcionales)
local banned, message = exports['Adictos_WebLogs']:CheckPlayerBan(license, tokens)

-- Limpiar bans expirados manualmente
exports['Adictos_WebLogs']:PurgeExpiredBans()
Configure Config.Bans in config.lua: file name, cleanup interval and whether history is synced to the panel (SyncToWeb).