Documentation / Enregistrement d’écran

Enregistrement d’écran

Enregistrez une vidéo ou prenez des captures du joueur et envoyez-les sur Discord depuis le serveur.

Adictos_WebLogs inclut un module ScreenRecord intégré : il capture l’écran du client via NUI (WebGL/MediaRecorder), envoie la vidéo au serveur et la téléverse sur Discord via le proxy du panneau. Idéal pour l’anticheat, les signalements du staff ou les preuves dans les logs.

Prérequis

  • Webhook ScreenRecord dans Mes serveurs → Logs web (actif + URL Discord). La catégorie screenrecord est fixe et ne se modifie plus dans Catégories.
  • Config.WebsiteURL correct (le serveur téléverse la vidéo via screenrecord-upload.php).

Export recordPlayerScreen

Enregistre une vidéo WebM de l’écran du joueur et renvoie l’URL Discord dans le callback :

exports['Adictos_WebLogs']:recordPlayerScreen(source, durationMs, function(success, urlOrError)
    if success then
        print('Video subido: ' .. urlOrError)
        -- urlOrError = URL del attachment en Discord
    else
        print('Error: ' .. tostring(urlOrError))
    end
end, 'Motivo de la grabación')

-- durationMs: por defecto Config.ScreenRecord.DefaultDuration (10000)
-- Máximo: Config.ScreenRecord.MaxDuration (30000)

Export capturePlayerSnapshot

Capture une image JPEG instantanée (plus légère qu’une vidéo) :

exports['Adictos_WebLogs']:capturePlayerSnapshot(source, function(success, urlOrError)
    if success then
        print('Snapshot: ' .. urlOrError)
    end
end, 'Evidencia anticheat')

Autres exports utiles

ExportUtilisation
isScreenRecordReady()true s’il y a un webhook actif
getScreenRecordStatus()ready, reason (message s’il n’est pas prêt)
stopPlayerRecording(src)Arrête un enregistrement en cours
isPlayerBeingRecorded(src)Indique si le joueur est en cours d’enregistrement
spectatePlayer(adminSrc, targetSrc)Spectate en direct (relais vers le panneau web)
stopSpectating(adminSrc)Arrête le spectate

Commandes console / staff

/record <player_id> [duracion_seg] [motivo]
/spectate <admin_id> <target_id>
/spectate <admin_id> stop

Utilisation dans les logs

Si, lors de l’enregistrement d’un log, vous incluez le champ video (durée en millisecondes) avec le server_id du joueur, WebLogs enregistre automatiquement son écran avant d’envoyer le log au panneau. Inutile d’appeler recordPlayerScreen séparément.

exports['Adictos_WebLogs']:Log('anticheat', 'detection', {
    license = licenseClean,
    playerName = name,
    server_id = source,   -- obligatorio para saber a quién grabar
    video = 10000,        -- duración en ms (10 segundos)
    reason = 'Noclip detectado',
}, true)

Le flux interne est le suivant :

  1. 1WebLogs détecte video et lance l’enregistrement du joueur indiqué dans server_id.
  2. 2Le client capture l’écran et envoie la vidéo au serveur FiveM.
  3. 3FiveM la téléverse sur Discord via le webhook ScreenRecord des Logs web (proxy du panneau : screenrecord-upload.php).
  4. 4Discord renvoie l’URL de la pièce jointe (CDN Discord).
  5. 5Cette URL est enregistrée dans video_url et le log est envoyé au panneau avec le lien vers la vidéo.
Pas de webhook, pas de vidéo. Configurez ScreenRecord dans Mes serveurs → Logs web (webhook + actif). La vidéo est stockée sur Discord ; le panneau ne conserve que le lien (video_url).

Configuration

Réglez la résolution, les FPS, la durée maximale et la qualité dans config.lua → Config.ScreenRecord. Le client utilise client/config_client.lua uniquement pour les réglages visuels du spectate.

L’enregistrement nécessite que le joueur ait le client actif et la NUI chargée. En cas d’échec, consultez la console du serveur ([ScreenRecord]) et vérifiez que le webhook de la catégorie est configuré.