qbx_radialmenu — Manual

Menu radial do ox_lib com as interações do jogador: portas, janelas, extras, pinturas e assentos do veículo, controle de roupas, opções por job/gangue e o sistema de porta-malas.

Sumário

1. Dependências
2. Instalação
3. Configuração
4. Comandos
5. Menu do veículo
6. Opções por job e gangue
7. Estado de morte
8. Porta-malas
9. Integrações
10. Entrypoints para outros recursos
11. Localização
12. Estrutura de arquivos

Dependências

Os itens padrão do config também apontam para eventos de terceiros (qb-drugs:client:cornerselling, qb-tow:client:TowVehicle, qb-tow:client:ToggleNpc). Se o recurso correspondente não existir, o item simplesmente não faz nada — remova-o do config.

Instalação

1. Copie a pasta qbx_radialmenu para resources/.
2. Adicione ao server.cfg, depois do qbx_core:

   ensure qbx_radialmenu
3. Ajuste config/client.lua com os itens do seu servidor. O arquivo já vem com boa parte dos itens comentados; descomente apenas os que têm o recurso correspondente instalado.
4. Conflitos — não rode junto com o qb-radialmenu. Este recurso registra os mesmos eventos (qb-radialmenu:*, qb-trunk:*) e os mesmos comandos de roupa.

Configuração

Arquivo: config/client.lua.

Formato de um item

{
    id = 'cornerselling',              -- id único
    icon = 'cannabis',                 -- ícone Font Awesome
    label = 'Venda de Esquina',
    event = 'qb-drugs:client:cornerselling',  -- ou serverEvent / command / action / onSelect
    args = nil,                        -- argumento passado ao evento/comando
    -- items = { ... }                 -- se presente, o item vira um submenu
}

Comandos

Porta-malas

Roupas

Registrados a partir das chaves de config.clothingCommands, um comando por chave:

As mesmas ações estão no radial, em Geral > Roupas.

Menu do veículo

O item “Veículo” é montado dinamicamente e reage a entrar/sair do carro (lib.onCache('vehicle')).

Opções por job e gangue

• jobItems[<job>] — o grupo “Interações de trabalho” só aparece se o job do jogador tiver itens e ele estiver em serviço. Sai do menu ao sair de serviço (QBCore:Client:SetDuty) e é recalculado a cada troca de job.
• gangItems[<gangue>] — o grupo “Interações de gangue” aparece para membros da gangue correspondente e é recalculado a cada troca de gangue.

De fábrica, jobItems traz mechanic (reboque) e tow (alternar NPC, reboque); os blocos de polícia, EMS e táxi vêm comentados. gangItems vem vazio.

Estado de morte

O recurso escuta a statebag qbx_medical:deathState (e o evento hospital:server:SetDeathStatus, para compatibilidade com o qb-ambulancejob).

• Jogador caído — o radial é limpo. Se ele for polícia em serviço, sobra apenas o botão de emergência; nos demais casos o radial é desabilitado por completo.
• Jogador recuperado — o menu é reconstruído do zero.

Porta-malas

• /getintrunk coloca o jogador dentro do porta-malas do veículo mais próximo, com câmera externa e texto na tela. O veículo precisa ter o porta-malas aberto, estar vazio e ser de uma classe com allowed = true em trunkClasses.
• Alguns modelos (superesportivos como zentorno, infernus, jester, entre outros) estão em uma lista fixa de bloqueio dentro de client/trunk.lua, mesmo que a classe seja permitida.
• O offset x, y, z de trunkClasses define onde a pessoa é posicionada dentro do porta-malas.
• O servidor guarda o estado “porta-malas ocupado” por placa e responde pelo callback qb-trunk:server:getTrunkBusy, impedindo duas pessoas no mesmo porta-malas.

Integrações

qbx_seatbelt

HasHarness() é consultado antes de trocar de assento. Com cinto de competição, a troca é recusada.

qbx_medical / qb-ambulancejob

Definem quando o jogador está caído, o que reduz ou desabilita o radial. Ver Estado de morte.

Jobs de polícia e EMS

O botão de emergência que aparece para quem está caído dispara police:client:SendPoliceEmergencyAlert (job type leo) ou hospital:server:emergencyAlert (job type ems).

Recursos com menu radial legado (qb-radialmenu)

Os exports AddOption e RemoveOption também são registrados sob o nome qb-radialmenu, então recursos escritos para o menu radial antigo continuam funcionando sem alteração:

exports['qb-radialmenu']:AddOption(data, id)
exports['qb-radialmenu']:RemoveOption(id)

Entrypoints para outros recursos

Adicionar e remover opções (cliente)

-- Retorna o id da opção
local id = exports.qbx_radialmenu:AddOption({
    id = 'minhaOpcao',
    title = 'Minha opção',
    label = 'Minha opção',
    icon = 'star',
    event = 'meu_recurso:client:acao',   -- ou serverEvent / command / action / onSelect
    args = nil,
}, 'minhaOpcao')
 
exports.qbx_radialmenu:RemoveOption('minhaOpcao')

Um item com items vira um submenu radial próprio.

Eventos de cliente

TriggerEvent('qb-radialmenu:client:openDoor', 0)          -- índice da porta
TriggerEvent('qbx_radialmenu:client:toggleWindows', 0)    -- índice da janela
TriggerEvent('radialmenu:client:setExtra', 1)
TriggerEvent('radialmenu:client:setLivery', 1)
TriggerEvent('radialmenu:client:ChangeSeat', 2, 'Passageiro')
TriggerEvent('radialmenu:flipVehicle')
 
-- Roupas
TriggerEvent('qb-radialmenu:ToggleClothing', { 'Top' })
TriggerEvent('qb-radialmenu:ToggleProps', { 'Hat' })
TriggerEvent('qb-radialmenu:ResetClothing')
 
-- Porta-malas
TriggerEvent('qb-trunk:client:GetIn')

Eventos de servidor

TriggerClientEvent('radialmenu:client:deadradial', src, isDead)  -- reduz/restaura o radial
TriggerEvent('qb-trunk:server:setTrunkBusy', plate, true)
TriggerEvent('qb-radialmenu:trunk:server:Door', open, plate, door)

Callback (lib.callback)

local ocupado = lib.callback.await('qb-trunk:server:getTrunkBusy', false, plate)

Localização

Strings via ox_lib locale. Arquivos em locales/:

• cs.json, da.json, de.json, en.json, es.json, et.json, fr.json, it.json, nl.json, pl.json, pt-br.json, pt.json, sv.json, tr.json

Idioma ativo pela convar no server.cfg:

setr ox:locale "pt-br"

Os label dos itens do config/client.lua não passam pelo locale — são texto fixo e devem ser traduzidos direto no config.

Estrutura de arquivos

qbx_radialmenu/
├── client/
│   ├── main.lua       — montagem do radial, menu do veículo, job/gangue, estado de morte, exports
│   ├── clothing.lua   — comandos e eventos de roupas e acessórios
│   └── trunk.lua      — entrar no porta-malas, câmera e sequestro
├── server/
│   ├── main.lua       — statebag de morte e compatibilidade com qb-ambulancejob
│   └── trunk.lua      — estado do porta-malas por placa, sincronização de portas, comandos
├── config/
│   └── client.lua     — itens do radial, veículo, porta-malas e comandos de roupa
├── locales/           — cs, da, de, en, es, et, fr, it, nl, pl, pt-br, pt, sv, tr
└── fxmanifest.lua