Customization

Using Editable Files

The resource includes editable.lua files for both client and server that allow developers to add custom functionality without modifying escrowed files.

Client-Side Customization

Edit client/editable.lua to:

1. Override Notification Function:

-- Override SendNotification for custom notifications
local originalSendNotification = SendNotification
function SendNotification(message)
    -- Your custom notification code here
    exports.ox_lib:notify({title = 'AFK Warning', description = message})
    originalSendNotification(message) -- Call original if needed
end

1. Add Custom Whitelist Checks:

-- Extend whitelist functionality
local originalIsWhitelisted = isWhitelisted
function isWhitelisted()
    -- Check custom conditions
    if IsPlayerInCustomGroup() then
        return true
    end
    return originalIsWhitelisted() -- Call original function
end

1. Add Custom Event Handlers:

-- Listen for custom events
RegisterNetEvent('myCustomEvent', function()
    -- Reset AFK timer on custom event
    timeSinceLastMovement = 0
end)

Server-Side Customization

Edit server/editable.lua to:

1. Custom Kick Handler:

-- Override kick event with custom logic
AddEventHandler("luaBeans:afk:kick", function()
    local src = source
    local playerName = GetPlayerName(src)
    
    -- Log to Discord
    exports.discord:logAFKKick(playerName)
    
    -- Kick player
    DropPlayer(src, Config.Messages.AFKtimeKick)
end)

1. Add Admin Commands:

-- Custom admin command
RegisterCommand("afkstatus", function(source, args, rawCommand)
    local src = source
    if IsPlayerAdmin(src) then
        -- Check AFK status logic
        TriggerClientEvent('chat:addMessage', src, {
            color = {255, 255, 0},
            args = {"[AFK]", "AFK system is active"}
        })
    end
end, false)

1. Integration with Other Resources:

-- Integrate with logging systems
AddEventHandler("luaBeans:afk:kick", function()
    local src = source
    exports.logging:log({
        type = "afk_kick",
        source = src,
        timestamp = os.time()
    })
end)

Advanced Customization

Custom Detection Methods

While the main detection is in the escrowed client.lua, you can add additional checks in client/editable.lua:

-- Add custom AFK detection
Citizen.CreateThread(function()
    while true do
        Citizen.Wait(5000)
        
        -- Check if player is in menu (custom check)
        if IsPauseMenuActive() then
            -- Don't count menu time as AFK
            timeSinceLastMovement = 0
        end
    end
end)

Database Integration

You can log AFK kicks to a database in server/editable.lua:

-- MySQL integration example
AddEventHandler("luaBeans:afk:kick", function()
    local src = source
    local identifier = GetPlayerIdentifiers(src)[1]
    
    MySQL.Async.execute(
        'INSERT INTO afk_logs (identifier, timestamp) VALUES (@identifier, @timestamp)',
        {
            ['@identifier'] = identifier,
            ['@timestamp'] = os.time()
        }
    )
    
    DropPlayer(src, Config.Messages.AFKtimeKick)
end)