Inicio › Documentación › Personalización · origen_zones

Personalización · origen_zones

La carpeta custom/ contiene ficheros de código abierto excluidos del escrow. Modifícalos para adaptar el recurso a tu framework, tu sistema de notificaciones y tu lógica de control de acceso.

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

custom/client.lua

notify(msg, type)

Envía una notificación al jugador local. Se llama internamente cuando el servidor dispara un evento de notificación.

La implementación por defecto usa lib.notify de ox_lib. Sustituye el cuerpo para usar tu propio sistema de notificaciones:

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

Ejemplo: usando un recurso de notificaciones personalizado:

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

Hooks de entrada y salida de zona

Estos eventos de red se disparan cada vez que un jugador entra o sale de cualquier zona. Úsalos para añadir lógica propia ligada a las transiciones de zona.

origen_zones:client:onPlayerEnterZone

Se dispara en el cliente cuando el jugador local entra en una zona.

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

origen_zones:client:onPlayerExitZone

Se dispara en el cliente cuando el jugador local sale de una 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

Devuelve true si el jugador se considera staff. Se usa para controlar el acceso al panel de administración y a los comandos de gestión de zonas.

Comprueba contra Config.GroupPermissions usando tanto los grupos del framework como los permisos Ace de FiveM.

Ejemplo: añadir una comprobación de staff personalizada:

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

getPlayerJobName(src) → string

Devuelve el nombre del trabajo del jugador en minúsculas. Devuelve una cadena vacía '' si no se pudo obtener el trabajo.

Se usa internamente en isPlayerWhitelistedForZone para comparar con la opción whitelistJobs de la zona.

isPlayerWhitelistedForZone(src, options) → boolean

Devuelve true si el jugador está en la lista blanca de una zona determinada, con lo que se salta las reglas de aplicación (prevención de daño, desarme, límite de velocidad, etc.).

La lista blanca se concede cuando se cumple al menos una de estas condiciones:

• options.whitelistStaff == true y isPlayerStaff(src) devuelve true
• El nombre del trabajo del jugador coincide con una de las entradas de options.whitelistJobs