Documentation / Bannissements

Bannissements

Système hybride : application locale dans FiveM (bans.json) et historique dans le panneau, sans HWID ni IP.

Adictos_WebLogs gère les bans actifs sur le serveur FiveM (fichier bans.json). Le panneau web ne conserve que l’historique pour l’afficher sur le profil du joueur : licence Rockstar, Steam, Discord, motif, dates et staff. Aucun HWID ni IP n’est stocké sur le web.

Dans bans.json (FiveM uniquement), un ban en ligne enregistre le maximum d’identifiants possibles contre le contournement : license/license1/license2, steam, discord, fivem, xbl, live, tokens (HWID), ip/ips, endpoint, identifiers (liste brute), alt_licenses, dates/staff et éventuellement panel_ban_id. À la connexion, la vérification se fait par licence, Steam, Discord, FiveM ID ou HWID, et les champs manquants sont complétés (p. ex. ban hors ligne).

Export BanPlayer

Depuis n’importe quelle ressource du serveur (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')
ParamètreDescription
licenseLicence Rockstar (hex). Accepte le préfixe license: ou non — elle est nettoyée automatiquement. Obligatoire
reasonMotif du ban — obligatoire
minutesDurée en minutes. 0 = permanent
staffNameNom affiché du staff (ex. Anticheat, Admin)
staffSteamIdSteamID64 du staff (optionnel, 0 par défaut)

Exports supplémentaires

-- 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()
Configurez Config.Bans dans config.lua : nom du fichier, intervalle de nettoyage et synchronisation ou non de l’historique avec le panneau (SyncToWeb).