Server Screenshots

TakeScreenshot

Capture screenshots of specific players or server areas for administrative purposes.

Screenshots are primarily used for evidence collection, monitoring, and documentation purposes. Ensure compliance with your server’s privacy policies.

Syntax

local success, status, screenshotData = exports['zyrix_admin']:TakeScreenshot(staffId, targetId, options)

Parameters

staffId (number): ID of the staff member taking the screenshot
targetId (number): ID of the target player
options (table): Screenshot configuration options

Options

{
    quality = 85,           -- JPEG quality (1-100)
    width = 1920,          -- Screenshot width
    height = 1080,         -- Screenshot height
    includeUI = false,     -- Include game UI elements
    timestamp = true,      -- Add timestamp overlay
    watermark = true,      -- Add server watermark
    reason = "monitoring", -- Reason for screenshot
    autoSave = true,       -- Automatically save to server
    notify = false         -- Notify target player
}

Return Values

success (boolean): Whether the screenshot was taken successfully
status (string): Status message or error description
screenshotData (table): Screenshot information and metadata

Example

local options = {
    quality = 90,
    includeUI = false,
    reason = "suspected cheating",
    timestamp = true
}

local success, status, data = exports['zyrix_admin']:TakeScreenshot(source, targetPlayer, options)

if success then
    print(string.format("Screenshot saved: %s", data.filename))
    print(string.format("File size: %d KB", data.fileSize))
else
    print("Screenshot failed: " .. status)
end

Advanced Examples

Evidence Collection System

local evidenceDB = {}

local function collectEvidence(staffId, targetId, reason, evidenceType)
    local evidenceId = string.format("EV_%d_%d", os.time(), math.random(10000))
    
    local screenshotOptions = {
        quality = 95,
        includeUI = false,
        reason = reason,
        timestamp = true,
        watermark = true,
        autoSave = true
    }
    
    local success, status, screenshotData = exports['zyrix_admin']:TakeScreenshot(staffId, targetId, screenshotOptions)
    
    if success then
        evidenceDB[evidenceId] = {
            staffId = staffId,
            targetId = targetId,
            reason = reason,
            type = evidenceType,
            timestamp = os.time(),
            screenshot = screenshotData,
            status = "active"
        }
        
        -- Log to admin system
        TriggerEvent('zyrix_admin:logAction', staffId, 'evidence_collected', {
            evidenceId = evidenceId,
            targetId = targetId,
            reason = reason
        })
        
        return evidenceId, screenshotData
    else
        return nil, status
    end
end

local function getEvidenceByPlayer(targetId)
    local playerEvidence = {}
    
    for evidenceId, evidence in pairs(evidenceDB) do
        if evidence.targetId == targetId and evidence.status == "active" then
            table.insert(playerEvidence, {
                id = evidenceId,
                staffId = evidence.staffId,
                reason = evidence.reason,
                timestamp = evidence.timestamp,
                screenshot = evidence.screenshot.filename
            })
        end
    end
    
    table.sort(playerEvidence, function(a, b) return a.timestamp > b.timestamp end)
    return playerEvidence
end

RegisterCommand('evidence', function(source, args)
    if #args < 3 then
        TriggerClientEvent('chat:addMessage', source, {
            args = {"[Usage]", "/evidence <player_id> <type> <reason>"}
        })
        return
    end
    
    local targetId = tonumber(args[1])
    local evidenceType = args[2]
    local reason = table.concat(args, " ", 3)
    
    if not targetId or not GetPlayerName(targetId) then
        TriggerClientEvent('notification', source, "Invalid player ID")
        return
    end
    
    local evidenceId, data = collectEvidence(source, targetId, reason, evidenceType)
    
    if evidenceId then
        TriggerClientEvent('notification', source, 
            string.format("Evidence collected: %s", evidenceId)
        )
        
        -- Notify other staff
        TriggerEvent('zyrix_admin:notifyStaff', {
            type = "evidence_collected",
            message = string.format("Evidence collected on %s by %s", 
                GetPlayerName(targetId), GetPlayerName(source)),
            evidenceId = evidenceId
        })
    else
        TriggerClientEvent('notification', source, "Failed to collect evidence: " .. data)
    end
end, true)

RegisterCommand('viewevidence', function(source, args)
    if #args < 1 then
        TriggerClientEvent('chat:addMessage', source, {
            args = {"[Usage]", "/viewevidence <player_id>"}
        })
        return
    end
    
    local targetId = tonumber(args[1])
    local evidence = getEvidenceByPlayer(targetId)
    
    if #evidence == 0 then
        TriggerClientEvent('notification', source, "No evidence found for this player")
        return
    end
    
    TriggerClientEvent('zyrix_admin:showEvidenceUI', source, {
        targetId = targetId,
        targetName = GetPlayerName(targetId),
        evidence = evidence
    })
end, true)

Automated Monitoring System

local monitoringProfiles = {}
local activeMonitoring = {}

local function createMonitoringProfile(name, triggers, screenshotInterval)
    monitoringProfiles[name] = {
        triggers = triggers,
        screenshotInterval = screenshotInterval or 30000, -- 30 seconds
        lastScreenshot = {},
        totalScreenshots = 0
    }
end

local function startMonitoring(staffId, targetId, profileName, duration)
    if not monitoringProfiles[profileName] then
        return false, "Monitoring profile not found"
    end
    
    local monitoringId = string.format("MON_%d_%d", targetId, os.time())
    
    activeMonitoring[monitoringId] = {
        staffId = staffId,
        targetId = targetId,
        profile = profileName,
        startTime = os.time(),
        endTime = os.time() + duration,
        screenshotCount = 0,
        status = "active"
    }
    
    -- Start screenshot interval
    local function takeMonitoringScreenshot()
        if not activeMonitoring[monitoringId] or 
           activeMonitoring[monitoringId].status ~= "active" or
           os.time() > activeMonitoring[monitoringId].endTime then
            return
        end
        
        local options = {
            quality = 75,
            includeUI = false,
            reason = string.format("automated_monitoring_%s", profileName),
            timestamp = true,
            autoSave = true,
            notify = false
        }
        
        local success, status, data = exports['zyrix_admin']:TakeScreenshot(staffId, targetId, options)
        
        if success then
            activeMonitoring[monitoringId].screenshotCount = activeMonitoring[monitoringId].screenshotCount + 1
            monitoringProfiles[profileName].totalScreenshots = monitoringProfiles[profileName].totalScreenshots + 1
            
            TriggerEvent('zyrix_admin:logAction', staffId, 'monitoring_screenshot', {
                monitoringId = monitoringId,
                targetId = targetId,
                screenshotFile = data.filename
            })
        end
        
        SetTimeout(monitoringProfiles[profileName].screenshotInterval, takeMonitoringScreenshot)
    end
    
    takeMonitoringScreenshot()
    return true, monitoringId
end

-- Create default monitoring profiles
createMonitoringProfile("suspicious_activity", {
    "speed_hack_detected",
    "teleport_detected",
    "godmode_detected"
}, 15000)

createMonitoringProfile("rp_monitoring", {
    "staff_duty",
    "event_participation"
}, 60000)

createMonitoringProfile("evidence_collection", {
    "report_filed",
    "rule_violation"
}, 10000)

RegisterCommand('startmonitor', function(source, args)
    if #args < 3 then
        local profiles = {}
        for name, _ in pairs(monitoringProfiles) do
            table.insert(profiles, name)
        end
        
        TriggerClientEvent('chat:addMessage', source, {
            args = {"[Usage]", "/startmonitor <player_id> <profile> <duration_minutes>"}
        })
        TriggerClientEvent('chat:addMessage', source, {
            args = {"[Profiles]", table.concat(profiles, ", ")}
        })
        return
    end
    
    local targetId = tonumber(args[1])
    local profile = args[2]
    local duration = tonumber(args[3]) * 60 -- Convert to seconds
    
    if not targetId or not GetPlayerName(targetId) then
        TriggerClientEvent('notification', source, "Invalid player ID")
        return
    end
    
    if duration > 3600 then -- Max 1 hour
        TriggerClientEvent('notification', source, "Maximum monitoring duration is 60 minutes")
        return
    end
    
    local success, result = startMonitoring(source, targetId, profile, duration)
    
    if success then
        TriggerClientEvent('notification', source, 
            string.format("Monitoring started: %s", result)
        )
        
        TriggerEvent('zyrix_admin:notifyStaff', {
            type = "monitoring_started",
            message = string.format("Monitoring started on %s (%s profile) by %s", 
                GetPlayerName(targetId), profile, GetPlayerName(source))
        })
    else
        TriggerClientEvent('notification', source, "Failed to start monitoring: " .. result)
    end
end, true)

Getting Started

Player Management

Moderation

Vehicle Management

Staff Tools

Server Management

TakeScreenshot

Syntax

Parameters

Options

Return Values

Example

Advanced Examples

Evidence Collection System

Automated Monitoring System

​TakeScreenshot

​Syntax

​Parameters

​Options

​Return Values

​Example

​Advanced Examples

​Evidence Collection System

​Automated Monitoring System

TakeScreenshot

Syntax

Parameters

Options

Return Values

Example

Advanced Examples

Evidence Collection System

Automated Monitoring System