Dokumentation / Bildschirmaufnahme

Bildschirmaufnahme

Nimm Videos oder Momentaufnahmen des Spielers auf und lade sie vom Server zu Discord hoch.

Adictos_WebLogs enthält ein integriertes ScreenRecord-Modul: Es erfasst den Bildschirm des Clients per NUI (WebGL/MediaRecorder), sendet das Video an den Server und lädt es über den Panel-Proxy zu Discord hoch. Ideal für Anticheat, Team-Meldungen oder Beweise in Logs.

Voraussetzungen

  • ScreenRecord-Webhook unter Meine Server → Web-Logs (aktiv + Discord-URL). Die Kategorie screenrecord ist fest und wird nicht mehr unter Kategorien bearbeitet.
  • Korrekte Config.WebsiteURL (der Server lädt das Video über screenrecord-upload.php hoch).

Export recordPlayerScreen

Nimmt ein WebM-Video vom Bildschirm des Spielers auf und gibt die Discord-URL im Callback zurück:

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

Erstellt ein sofortiges JPEG-Bild (leichter als ein Video):

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

Weitere nützliche Exports

ExportVerwendung
isScreenRecordReady()true, wenn ein Webhook vorhanden und aktiv ist
getScreenRecordStatus()ready, reason (Meldung, falls nicht bereit)
stopPlayerRecording(src)Stoppt eine laufende Aufnahme
isPlayerBeingRecorded(src)Gibt zurück, ob der Spieler gerade aufgenommen wird
spectatePlayer(adminSrc, targetSrc)Live-Spectate (Weiterleitung an das Webpanel)
stopSpectating(adminSrc)Beendet das Spectate

Konsolen- / Team-Befehle

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

Verwendung in Logs

Wenn du beim Erfassen eines Logs das Feld video (Dauer in Millisekunden) zusammen mit der server_id des Spielers angibst, zeichnet WebLogs automatisch dessen Bildschirm auf, bevor der Log an das Panel gesendet wird. recordPlayerScreen muss nicht separat aufgerufen werden.

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)

Der interne Ablauf ist wie folgt:

  1. 1WebLogs erkennt video und startet die Aufnahme des in server_id angegebenen Spielers.
  2. 2Der Client erfasst den Bildschirm und sendet das Video an den FiveM-Server.
  3. 3FiveM lädt es über den ScreenRecord-Webhook der Web-Logs zu Discord hoch (Panel-Proxy: screenrecord-upload.php).
  4. 4Discord gibt die URL des Anhangs zurück (Discord-CDN).
  5. 5Diese URL wird in video_url gespeichert und der Log mit dem Link zum Video an das Panel gesendet.
Ohne Webhook kein Video. Konfiguriere ScreenRecord unter Meine Server → Web-Logs (Webhook + aktiv). Das Video wird auf Discord gespeichert; das Panel speichert nur den Link (video_url).

Konfiguration

Passe Auflösung, FPS, maximale Dauer und Qualität in config.lua → Config.ScreenRecord an. Der Client nutzt client/config_client.lua nur für die optischen Spectate-Einstellungen.

Die Aufnahme setzt voraus, dass der Client des Spielers aktiv und die NUI geladen ist. Schlägt sie fehl, prüfe die Serverkonsole ([ScreenRecord]) und ob der Webhook der Kategorie konfiguriert ist.