mri_Qsafezones — Manual

Zonas seguras (greenzones) para FiveM: áreas onde tiro, colisão, dano e velocidade podem ser restringidos, definidas de forma permanente no config ou criadas em runtime por admins.

Sumário

1. Dependências
2. Instalação
3. Permissões (ACE)
4. Configuração
5. Zonas permanentes (Config.GreenZones)
6. Zonas temporárias (admin)
7. Comandos
8. Entrypoints para outros recursos
9. Estrutura de arquivos

Dependências

Não usa banco de dados. As zonas permanentes vivem no config.lua e as temporárias existem apenas em memória.

Instalação

1. Copie a pasta mri_Qsafezones para resources/.
2. Adicione ao server.cfg:

   ensure mri_Qsafezones
3. Edite config.lua para definir suas zonas permanentes em Config.GreenZones (o recurso já vem com a zona hospital de exemplo, ativa).
4. Dê permissão de admin aos grupos que devem poder criar zonas em runtime (ver Permissões (ACE)).

Não há SQL para importar. Não há conflito conhecido com outros recursos — os eventos e callbacks usam o prefixo mri_Qsafezone:.

Permissões (ACE)

Os dois comandos são registrados via lib.addCommand com restricted = 'group.admin'. O ox_lib cria automaticamente as ACEs command.<comando> para o grupo indicado, então basta que o jogador pertença ao grupo admin:

add_principal identifier.license:<licenca_do_admin> group.admin

Para liberar os comandos a outro grupo, altere restricted em server/main.lua ou adicione a ACE manualmente:

add_ace group.moderator command.setzone allow
add_ace group.moderator command.clearzone allow

Os nomes das ACEs acompanham Config.GreenzonesCommand e Config.GreenzonesClearCommand — se você renomear os comandos, os nomes das ACEs mudam junto.

Configuração

Arquivo: config.lua.

Opções globais

Textos das notificações (Notifications)

Zonas permanentes (Config.GreenZones)

Cada entrada de Config.GreenZones é uma zona que existe o tempo todo, criada na inicialização do client. Todos os campos abaixo são lidos por client/main.lua.

Config.GreenZones = {
    ['hospital'] = {
        usePoly = true,
        points = {
            vec3(299.2270, -584.6892, 43.2608),
            vec3(300.2270, -584.6892, 43.2608),
            vec3(300.2270, -585.6892, 43.2608),
            vec3(299.2270, -585.6892, 43.2608)
        },
        coords = vec3(299.2270, -584.6892, 43.2608),
        radius = 100.0,
        disablePlayerVehicleCollision = true,
        enableVehCollisionFX = false,
        enableSpeedLimits = false,
        setSpeedLimit = 30,
        removeWeapons = false,
        disableFiring = true,
        setInvincible = true,
        displayTextUI = true,
        textToDisplay = '**Área** Segura',
        backgroundColorTextUI = '#72E68F',
        textColor = '#2C2C2C',
        displayTextPosition = 'bottom-center',
        displayTextIcon = 'shield',
        blip = false,
        blipType = 'radius',
        enableSprite = false,
        blipSprite = 621,
        blipColor = 2,
        blipScale = 0.7,
        blipAlpha = 100,
        blipName = 'Hospital Greenzone'
    },
}

Forma da zona

Regras aplicadas dentro da zona

TextUI

Blip

Zonas temporárias (admin)

Além das zonas do config, um admin pode criar uma zona temporária em runtime com /setzone. Ela é criada na posição atual do admin, propagada para todos os clients conectados e vive apenas em memória — some no restart do recurso e é substituída se outra for criada.

O comando abre um lib.inputDialog com estes campos:

A zona temporária é sempre circular (não aceita polígono) e não emite as notificações de entrada/saída — apenas o TextUI.

/clearzone pede confirmação em um lib.alertDialog e, ao confirmar, remove a zona, os blips, o TextUI, o limite de velocidade e a invencibilidade de todos os clients.

Comandos

Entrypoints para outros recursos

O recurso não expõe exports. Outros recursos podem, no entanto, disparar os eventos de client que o próprio comando de admin usa, para criar ou limpar a zona temporária em todos os jogadores.

Criar a zona temporária

TriggerClientEvent('mri_Qsafezone:createAdminZone', -1,
    vec3(299.22, -584.68, 43.26), -- zoneCoords
    'Evento',                     -- zoneName (nome do blip)
    'Zona Segura',                -- textUI
    '#ff5a47',                    -- textUIColor
    'top-center',                 -- textUIPosition
    50,                           -- zoneSize (raio)
    true,                         -- disarm (bloqueia disparo)
    true,                         -- invincible
    0,                            -- speedLimit em MPH (0 = sem limite)
    487,                          -- blipID
    1                             -- blipColor
)

Remover a zona temporária

TriggerClientEvent('mri_Qsafezone:deleteAdminZone', -1)

Ambos os eventos são RegisterNetEvent no client, ou seja, precisam ser disparados a partir do servidor. Como só existe um slot de zona temporária, um novo createAdminZone sobrescreve o anterior.

Estrutura de arquivos

mri_Qsafezones/
├── client/
│   └── main.lua       — cria as zonas permanentes e seus blips, aplica as regras (colisão, tiro,
│                        invencibilidade, velocidade, TextUI), diálogos de admin e zona temporária
├── server/
│   └── main.lua       — registra /setzone e /clearzone (restritos a group.admin) e faz o broadcast
│                        de criação/remoção da zona temporária para todos os clients
├── config.lua         — Config.GreenZones (zonas permanentes), nomes dos comandos e textos das notificações
└── fxmanifest.lua