Início › Documentação › Personalização · origen_reports

Personalização · origen_reports

custom/
└── server.lua

custom/server.lua

Custom.getIdentifier(source) → string | nil

Devolve o identificador único usado para guardar os reports e as estatísticas da staff. É chamada sempre que um jogador cria um report ou que um membro da staff é resolvido.

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

Devolve true quando o jogador coincide com alguma permissão de Config.StaffFullAccess.

Custom.hasConfigBasicAccess(source) → boolean

Devolve true quando o jogador coincide com alguma permissão de Config.StaffBasicAccess.

Ambas passam pela mesma verificação interna, aplicada a cada permissão da lista:

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

Substitui-as para integrar um sistema de permissões próprio:

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

Resolve o nível de acesso de um jogador a partir das duas funções anteriores. Se coincidirem ambas, prevalece o acesso total. Devolve false quando o jogador não é staff por configuração (ainda assim pode ser staff limitada se tiver sido adicionado com um grupo a partir do painel de administração).

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

Devolve todos os itens registados como { name, label }, ordenados por etiqueta. É usada para preencher o seletor de itens da ação rápida dar itens e a lista de itens permitidos dos grupos de staff.

Para adicionar um inventário, devolve a respetiva tabela de itens através da função auxiliar local mapItemTable:

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

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

Dá um item ao jogador reportado. É chamada pela ação rápida dar itens. Por convenção devolve true em caso de sucesso, embora o recurso não leia o valor devolvido.

qs-inventory e tgiann-inventory verificam primeiro CanCarryItem e devolvem false quando o jogador não o pode transportar. Os inventários sem ramo próprio recorrem à framework: Functions.AddItem em QB/Qbox e addInventoryItem em 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 ao membro da staff o inventário do jogador reportado. É chamada pela ação rápida inventário. Devolve false quando o inventário não é compatível.

Custom.openClothingMenu(source) → boolean

Abre o menu de roupa ao jogador reportado. É chamada pela ação rápida roupa.

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

Custom.revivePlayer(source) → boolean

Reanima o jogador reportado. É chamada pela ação rápida reanimar.

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