Inicio › Documentación › Personalización · origen_reports

Personalización · origen_reports

custom/
└── server.lua

custom/server.lua

Custom.getIdentifier(source) → string | nil

Devuelve el identificador único que se usa para guardar los reportes y las estadísticas del staff. Se llama cada vez que un jugador crea un reporte o se resuelve un miembro del staff.

Custom.getIdentifier = function(source)
    local player = getFrameworkPlayer(source)
 
    if Config.Framework == 'qb-core' or Config.Framework == 'qbx_core' then
        return player and player.PlayerData and player.PlayerData.citizenid or nil
    elseif Config.Framework == 'esx' then
        return player and player.getIdentifier and player.getIdentifier() or nil
    end
 
    return GetPlayerIdentifierByType(source, 'license')
end

Custom.hasConfigFullAccess(source) → boolean

Devuelve true cuando el jugador coincide con algún permiso de Config.StaffFullAccess.

Custom.hasConfigBasicAccess(source) → boolean

Devuelve true cuando el jugador coincide con algún permiso de Config.StaffBasicAccess.

Ambas pasan por la misma comprobación interna, aplicada a cada permiso de la lista:

1. ACE <permission> o group.<permission>.
2. qbx_core — exports.qbx_core:HasPermission y GetPermission.
3. qb-core — Framework.Functions.GetPermission.
4. esx — xPlayer.getGroup() == permission.

Sobrescríbelas para integrar un sistema de permisos propio:

Custom.hasConfigFullAccess = function(source)
    return exports['my_admin']:IsAdmin(source)
end
 
Custom.hasConfigBasicAccess = function(source)
    return exports['my_admin']:IsModerator(source)
end

Custom.getStaffLevel(source) → 'full' | 'basic' | false

Resuelve el nivel de acceso de un jugador a partir de las dos funciones anteriores. Si coinciden ambas, prevalece el acceso completo. Devuelve false cuando el jugador no es staff por configuración (aun así puede ser staff limitado si se le añadió con un grupo desde el panel de administración).

Custom.getStaffLevel = function(source)
    local hasBasic = Custom.hasConfigBasicAccess(source)
    local hasFull = Custom.hasConfigFullAccess(source)
 
    if hasBasic and hasFull then
        return 'full'
    end
 
    if hasBasic then
        return 'basic'
    end
 
    if hasFull then
        return 'full'
    end
 
    return false
end

Custom.getItemList() → table

Devuelve todos los objetos registrados como { name, label }, ordenados por etiqueta. Se usa para rellenar el selector de objetos de la acción rápida dar objetos y la lista de objetos permitidos de los grupos de staff.

Para añadir un inventario, devuelve su tabla de objetos a través de la función auxiliar local mapItemTable:

elseif Config.Inventory == 'my_inventory' then
    return mapItemTable(exports['my_inventory']:GetItemList())

Custom.giveItem(source, item, count) → boolean

Da un objeto al jugador reportado. Lo llama la acción rápida dar objetos. Por convención devuelve true si todo va bien, aunque el recurso no lee el valor devuelto.

qs-inventory y tgiann-inventory comprueban primero CanCarryItem y devuelven false cuando el jugador no puede cargarlo. Los inventarios sin rama propia recurren al framework: Functions.AddItem en QB/Qbox y addInventoryItem en ESX.

elseif Config.Inventory == 'my_inventory' then
    if not exports['my_inventory']:CanCarryItem(source, item, count) then return false end
    return exports['my_inventory']:AddItem(source, item, count)

Custom.openPlayerInventory(source, target) → boolean

Abre al miembro del staff el inventario del jugador reportado. Lo llama la acción rápida inventario. Devuelve false cuando el inventario no es compatible.

Custom.openClothingMenu(source) → boolean

Abre el menú de ropa al jugador reportado. Lo llama la acción rápida ropa.

elseif Config.Clothing == 'my_clothing' then
    TriggerClientEvent('my_clothing:client:openMenu', source)
    return true

Custom.revivePlayer(source) → boolean

Reanima al jugador reportado. Lo llama la acción rápida reanimar.

elseif Config.Ambulance == 'my_ambulance' then
    TriggerClientEvent('my_ambulance:client:revive', source)
    return true