Documentación / Bannissements

Bannissements

Sistema híbrido: ejecución local en FiveM (bans.json) e historial en el panel sin HWID ni IP.

Adictos_WebLogs gestiona los bans activos en el servidor FiveM (archivo bans.json). El panel web solo guarda el historial para mostrarlo en el perfil del jugador: licencia Rockstar, Steam, Discord, motivo, fechas y staff. No se almacenan HWID ni IP en la web.

Export BanPlayer

Desde cualquier recurso del servidor (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')
ParámetroDescripción
licenseLicencia Rockstar (hex). Admite prefijo license: o sin él — se sanitiza automáticamente. Obligatorio
reasonMotivo del ban — obligatorio
minutesDuración en minutos. 0 = permanente
staffNameNombre mostrado del staff (ej. Anticheat, Admin)
staffSteamIdSteamID64 del staff (opcional, por defecto 0)

Exports adicionales

-- 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()
Configura Config.Bans en config.lua: nombre del archivo, intervalo de limpieza y si se sincroniza el historial al panel (SyncToWeb).