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

Personalização · origen_zones

A pasta custom/ contém ficheiros de código aberto excluídos do escrow. Modifica-os para adaptar o recurso à tua framework, ao teu sistema de notificações e à tua lógica de controlo de acesso.

custom/
├── client.lua
└── server.lua

custom/client.lua

notify(msg, type)

Envia uma notificação ao jogador local. É chamada internamente quando o servidor dispara um evento de notificação.

A implementação por omissão usa lib.notify da ox_lib. Substitui o corpo para usares o teu próprio sistema de notificações:

function notify(msg, type)
    -- type = 'inform' or 'error' or 'success'
    lib.notify({
        title       = locale('notify.title'),
        description = msg,
        duration    = 7000,
        position    = 'top',
        type        = type
    })
end

Exemplo: com um recurso de notificações personalizado:

function notify(msg, type)
    TriggerEvent('myNotify:send', msg, type)
end

Hooks de entrada e saída de zona

Estes eventos de rede são disparados sempre que um jogador entra ou sai de qualquer zona. Usa-os para adicionar lógica própria associada às transições de zona.

origen_zones:client:onPlayerEnterZone

Disparado no cliente quando o jogador local entra numa zona.

RegisterNetEvent('origen_zones:client:onPlayerEnterZone', function(zoneName)
    -- zoneName: internal name of the zone entered
    debugPrint('Entered zone ' .. zoneName)
end)

origen_zones:client:onPlayerExitZone

Disparado no cliente quando o jogador local sai de uma zona.

RegisterNetEvent('origen_zones:client:onPlayerExitZone', function(zoneName)
    -- zoneName: internal name of the zone exited
    debugPrint('Exited zone ' .. zoneName)
end)

custom/server.lua

isPlayerStaff(src) → boolean

Devolve true se o jogador for considerado staff. É usada para controlar o acesso ao painel de administração e aos comandos de gestão de zonas.

Verifica contra Config.GroupPermissions usando tanto os grupos da framework como as permissões Ace do FiveM.

Exemplo: adicionar uma verificação de staff personalizada:

function isPlayerStaff(src)
    -- Custom override: check against your own system
    return exports['my_permissions']:IsAdmin(src)
end

getPlayerJobName(src) → string

Devolve o nome do trabalho do jogador em minúsculas. Devolve uma cadeia vazia '' se não foi possível obter o trabalho.

É usada internamente em isPlayerWhitelistedForZone para comparar com a opção whitelistJobs da zona.

isPlayerWhitelistedForZone(src, options) → boolean

Devolve true se o jogador estiver na lista de permissões de uma determinada zona, ignorando assim as regras de aplicação (prevenção de dano, desarmamento, limite de velocidade, etc.).

A permissão é concedida quando pelo menos uma das seguintes condições se verifica:

• options.whitelistStaff == true e isPlayerStaff(src) devolve true
• O nome do trabalho do jogador coincide com uma das entradas de options.whitelistJobs