Configuration · origen_zones

All settings live in sh_config.lua.

General

Variable	Default	Description
`Config.Debug`	`false`	Enable debug logging to the console
`Config.Language`	`'en'`	UI language — `'en'` \| `'es'`. Add more languages in `locales/*.json`
`Config.enableHudIndicator`	`true`	Show a HUD indicator when the player enters a secure zone
`Config.hudIndicatorPosition`	`'center-right'`	Position of the HUD indicator on screen
`Config.ZoneThickness`	`1000`	Default vertical thickness in meters used when a zone has no explicit height

Valid values for Config.hudIndicatorPosition:

text

top-left | top-center | top-right
center-left | center | center-right
bottom-left | bottom-center | bottom-right

Framework triggers

Overrides the player-loaded events used for each framework. Useful if your setup uses non-standard event names.

lua

Config.Triggers = {
    ['ESX'] = {
        load = 'esx:playerLoaded',
    },
    ['QB'] = {
        load = 'QBCore:Client:OnPlayerLoaded',
    },
}

The framework is auto-detected at startup. Config.Triggers only needs to be modified if your server uses custom event names.

Permissions

Groups allowed to open the admin panel. Validates against framework groups and FiveM Ace Permissions.

lua

Config.GroupPermissions = {
    'god',
    'admin',
    'superadmin',
}

Commands

Variable	Default	Description
`Config.Commands.panel`	`'zones'`	In-game command to open the zone management panel (staff only)

Logs

Discord webhook logging for zone management actions.

lua

Config.Logs = {
    enabled    = false,
    botName    = 'Origen Zones',
    embedColor = 5793266,
    webhooks = {
        default          = '',
        zone_created     = '',
        zone_edited      = '',
        zone_deleted     = '',
        panel_opened     = '',
        permission_denied = '',
    }
}

Field	Description
`enabled`	Set to `true` to enable Discord logging
`botName`	Name displayed on Discord embeds
`embedColor`	Decimal color for the embed sidebar
`webhooks.default`	Fallback webhook used when a specific one is not set
`webhooks.zone_created`	Webhook for zone creation events
`webhooks.zone_edited`	Webhook for zone edit events
`webhooks.zone_deleted`	Webhook for zone deletion events
`webhooks.panel_opened`	Webhook when an admin opens the panel
`webhooks.permission_denied`	Webhook when a non-staff player attempts a restricted action

Blips

Configure the map blips shown for each zone type.

lua

Config.Blips = {
    safezone = {
        sprite         = 47,
        color          = 2,
        scale          = 0.8,
        useSharedLabel = true,
        sharedLabel    = 'Safe Zone',
    },
    redzone = {
        sprite         = 161,
        color          = 1,
        scale          = 0.8,
        useSharedLabel = true,
        sharedLabel    = 'Red Zone',
    },
}

Field	Description
`sprite`	GTA V blip sprite ID
`color`	GTA V blip color index
`scale`	Blip scale on the map
`useSharedLabel`	If `true`, all zones of this type share the same label (`sharedLabel`) instead of their individual zone label
`sharedLabel`	Label shown on the map when `useSharedLabel` is `true`

Set useSharedLabel = false to display each zone's own label on the map instead of a shared one.