qbx_adminmenu — Manual

Menu administrativo do Qbox construído em cima do ox_lib: gerência de jogadores, servidor, veículos, reports e ferramentas de desenvolvimento, com permissões por ACE.

Sumário

1. Dependências
2. Instalação
3. Permissões (ACE)
4. Configuração
5. Comandos
6. Menu
7. Reports
8. Integrações
9. Entrypoints para outros recursos
10. Localização
11. Estrutura de arquivos

Dependências

Instalação

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

   ensure qbx_adminmenu
3. A tabela bans usada pelo ban do menu é a do qbx_core — nenhum SQL adicional é necessário se o core já estiver instalado.
4. Configure as ACEs (veja abaixo). Sem elas ninguém abre o menu.
5. Conflitos — não rode junto com o qb-admin. Ambos registram /admin, /names, /blips e /admincar.

Permissões (ACE)

Todo o recurso é protegido por IsPlayerAceAllowed. Os nomes das permissões vêm de config/server.lua e usam, por padrão, os grupos do qbx_core:

add_ace group.mod mod allow
add_ace group.admin admin allow
add_ace group.god god allow

Os grupos são hierárquicos no qbx_core, então um admin também satisfaz um gate de mod.

Configuração

Arquivo: config/server.lua (retorna uma tabela).

Comandos

O comando /noclip existe em server/commands.lua mas está comentado; a permissão commandPerms.noclip continua no config para quando ele for reativado.

Menu

Aberto com /admin. Navegação por lib.registerMenu (canto superior direito).

O submenu Admin Options (noclip, revive próprio, invisível, godmode, names, blips, godmode de veículo, trocar ped, munição infinita, dar todas as armas de uma categoria, algemar) está implementado em client/admin.lua, mas sua entrada no menu principal está comentada em client/main.lua. Para usá-lo, descomente a linha label1 das opções do menu principal.

Reports

• Qualquer jogador abre um report com /report [mensagem].
• Todo staff com a permissão commandPerms.reportReply recebe uma notificação de novo report.
• No submenu Pending Reports, o staff vê a fila (id, quem enviou, mensagem, quem reivindicou), responde por chat ([REPORT #id] [nome] mensagem enviado ao autor) e apaga o report.
• O primeiro staff que responder passa a constar como claimed e todos os demais são avisados.
• A fila fica em memória (tabela REPORTS no servidor) e é perdida em restart do recurso.

Integrações

mri_Qcarkeys

No spawn de veículo pelo menu, se GetResourceState('mri_Qcarkeys') == 'started', as chaves são entregues por exports.mri_Qcarkeys:GiveTempKeys(source, plate). Caso contrário cai no exports.qbx_vehiclekeys:GiveKeys(source, plate).

pma-voice

Alimenta duas opções: “Get Radio List” (lista quem está em uma frequência, via getPlayersInRadioChannel) e “Mute” nos extras do jogador (toggleMutePlayer).

qb-weathersync

As opções de clima e hora do menu de servidor disparam qb-weathersync:server:setWeather e qb-weathersync:server:setTime. Sem o recurso, essas opções não têm efeito.

qbx_medical

A opção “Revive” dispara qbx_medical:client:playerRevived no alvo.

qb-clothing

A opção “Give Clothing Menu” dispara qb-clothing:client:openMenu no alvo.

ox_inventory

A opção “Open Inventory” chama exports.ox_inventory:openInventory('player', id). O “Pull Stash” do menu de servidor usa os eventos de compatibilidade inventory:server:OpenInventory / inventory:client:SetCurrentStash.

Entrypoints para outros recursos

O recurso não expõe exports. A interação com ele é por eventos e callbacks — todos protegidos por ACE no lado servidor.

Abrir o menu em um jogador

TriggerClientEvent('qbx_admin:client:openMenu', source)

Outros eventos de cliente

TriggerClientEvent('qbx_admin:client:setModel', source, 'a_m_m_soucent_04')
TriggerClientEvent('qbx_admin:client:names', source)   -- alterna nomes
TriggerClientEvent('qbx_admin:client:blips', source)   -- alterna blips
TriggerClientEvent('qbx_admin:client:copyToClipboard', source, 'coords4')
TriggerClientEvent('qbx_admin:client:killPlayer', source)

Eventos de servidor

TriggerServerEvent('qbx_admin:server:playerOptionsGeneral', opcao, jogadorSelecionado, input)
TriggerServerEvent('qbx_admin:server:playerAdministration', opcao, jogadorSelecionado, input)
TriggerServerEvent('qbx_admin:server:changePlayerData', campo, jogadorSelecionado, input)
TriggerServerEvent('qbx_admin:server:giveAllWeapons', 'pistol', playerId)
TriggerServerEvent('qbx_admin:server:sendReply', report, mensagem)
TriggerServerEvent('qbx_admin:server:deleteReport', report)

Callbacks (lib.callback)

lib.callback.await('qbx_admin:server:canUseMenu', false)
lib.callback.await('qbx_admin:server:getPlayers', false)
lib.callback.await('qbx_admin:server:getPlayer', false, playerId)
lib.callback.await('qbx_admin:server:getReports', false)
lib.callback.await('qbx_admin:server:spawnVehicle', false, model)
lib.callback.await('qbx_admin:server:clothingMenu', false, targetId)
lib.callback.await('qbx_admin:callback:getradiolist', false, frequencia)

Localização

Strings via ox_lib locale. Arquivos em locales/:

• cs.json, da.json, de.json, en.json, es.json, fr.json, it.json, pt-br.json, pt.json, sv.json

Idioma ativo pela convar no server.cfg:

setr ox:locale "pt-br"

Estrutura de arquivos

qbx_adminmenu/
├── client/
│   ├── main.lua      — menu principal e navegação entre submenus
│   ├── admin.lua     — noclip, godmode, invisível, munição infinita, dar armas, algemar
│   ├── player.lua    — lista de jogadores e submenus por jogador (geral, administração, extras)
│   ├── server.lua    — clima, hora, lista de rádio, abrir stash
│   ├── vehicle.lua   — spawn por categoria, fix, admincar, dv, troca de placa
│   ├── dev.lua       — coordenadas na tela e telemetria de veículo
│   ├── reports.lua   — fila de reports: ver, responder, apagar
│   └── vectors.lua   — cópia de vector2/3/4 e heading para a área de transferência
├── server/
│   ├── main.lua      — permissões, reports, ban/kick, edição de dados, callbacks
│   └── commands.lua  — /report, /admin, /names, /blips, /admincar, /setmodel, /vec*, /heading
├── config/
│   └── server.lua    — permissões ACE por comando e por evento, lista de armas por categoria
├── locales/          — cs, da, de, en, es, fr, it, pt-br, pt, sv
└── fxmanifest.lua