Custom · origen_reports

custom/
└── server.lua

custom/server.lua

Custom.getIdentifier(source) → string | nil

Returns the unique identifier used to store reports and staff stats. Called whenever a player creates a report or a staff member is resolved.

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

Returns true when the player matches any permission in Config.StaffFullAccess.

Custom.hasConfigBasicAccess(source) → boolean

Returns true when the player matches any permission in Config.StaffBasicAccess.

Both go through the same internal check, applied to each permission of the list:

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

Override them to plug in a custom permission system:

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

Resolves the access level of a player from the two functions above. Full access wins when both match. Returns false when the player is not staff by config (they can still be limited staff if they were added with a group from the admin panel).

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

Returns every registered item as { name, label }, sorted by label. Used to fill the item picker of the give items quick action and the allowed items list of staff groups.

To add an inventory, return its item table through the local mapItemTable helper:

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

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

Gives an item to the reported player. Called by the give items quick action. Returns true on success by convention, although the resource does not read the return value.

qs-inventory and tgiann-inventory check CanCarryItem first and return false when the player cannot carry it. Inventories without a branch fall back to the framework: Functions.AddItem on QB/Qbox and addInventoryItem on 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

Opens the reported player's inventory to the staff member. Called by the inventory quick action. Returns false when the inventory is not supported.

Custom.openClothingMenu(source) → boolean

Opens the clothing menu on the reported player. Called by the clothing quick action.

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

Custom.revivePlayer(source) → boolean

Revives the reported player. Called by the revive quick action.

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