Accueil › Documentation › Personnalisation · origen_reports

Personnalisation · origen_reports

custom/
└── server.lua

custom/server.lua

Custom.getIdentifier(source) → string | nil

Renvoie l’identifiant unique utilisé pour enregistrer les signalements et les statistiques du staff. Appelée chaque fois qu’un joueur crée un signalement ou qu’un membre du staff est résolu.

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

Renvoie true lorsque le joueur correspond à une permission de Config.StaffFullAccess.

Custom.hasConfigBasicAccess(source) → boolean

Renvoie true lorsque le joueur correspond à une permission de Config.StaffBasicAccess.

Les deux passent par la même vérification interne, appliquée à chaque permission de la liste :

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

Remplace-les pour brancher un système de permissions personnalisé :

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

Détermine le niveau d’accès d’un joueur à partir des deux fonctions précédentes. Si les deux correspondent, l’accès complet l’emporte. Renvoie false lorsque le joueur n’est pas staff par configuration (il peut tout de même être staff limité s’il a été ajouté avec un groupe depuis le panneau d’administration).

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

Renvoie tous les items enregistrés sous la forme { name, label }, triés par libellé. Utilisée pour remplir le sélecteur d’items de l’action rapide donner des items et la liste des items autorisés des groupes de staff.

Pour ajouter un inventaire, renvoie sa table d’items via la fonction utilitaire locale mapItemTable :

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

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

Donne un item au joueur signalé. Appelée par l’action rapide donner des items. Renvoie true en cas de succès par convention, bien que la ressource ne lise pas la valeur renvoyée.

qs-inventory et tgiann-inventory vérifient d’abord CanCarryItem et renvoient false lorsque le joueur ne peut pas le porter. Les inventaires sans branche dédiée se rabattent sur le framework : Functions.AddItem sur QB/Qbox et addInventoryItem sur 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

Ouvre au membre du staff l’inventaire du joueur signalé. Appelée par l’action rapide inventaire. Renvoie false lorsque l’inventaire n’est pas pris en charge.

Custom.openClothingMenu(source) → boolean

Ouvre le menu de vêtements au joueur signalé. Appelée par l’action rapide vêtements.

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

Custom.revivePlayer(source) → boolean

Réanime le joueur signalé. Appelée par l’action rapide réanimer.

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