Menu de admin e permissões

Os dois níveis de staff

As permissões são ACE normal do FiveM. A partir do server.cfg:

# staff tier
add_ace group.admin command.zombiemenu allow
add_ace group.admin bs.admin allow

# owner tier
add_ace group.superadmin bs.superadmin allow
add_ace group.superadmin bs.owner allow
add_ace group.superadmin command allow
add_principal group.superadmin group.admin   # superadmin gets everything admin has

O bs_core lê-as de Config.Permissions (bs_core/config/config.lua):

adminAces      = { 'bs.admin', 'command.zombiemenu' },
superAdminAces = { 'bs.superadmin' },

Outros ACEs usados na framework:

ACE	Para
bs.admin	menu F10, consola F1, comandos de staff
bs.superadmin	coisas destrutivas: kick, dar dinheiro, apagar construções/inventário, atribuir/revogar VIP
bs.owner	apagar perfis F1
bs.guard.bypass	saltar as verificações de anti-cheat sem ser staff

Adicionar o teu staff

Coloca o identificador deles num grupo no fim do server.cfg. Steam hex ou licença, ambos servem, adiciona os dois se não tiveres a certeza de qual o FiveM vai resolver:

add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.superadmin
add_principal identifier.steam:11000010xxxxxxx group.admin

Remove os principals de exemplo da config distribuída antes de abrires ao público. São meus.

Menu de admin F10

bs_admin, tecla F10 (Admin.Settings.openKey = 57), comando /adminmenu.

Simples e Avançado

O botão no topo alterna entre duas vistas.

• Simples tem três separadores, QUICK, PLAYER e SERVER, com o que fazes todos os dias: escolher um jogador, curar, reviver, teletransportar, arranjar-lhe o carro, dar um item, anunciar, mudar o tempo e a hora. Os botões destrutivos pedem um segundo clique em 3 segundos.

• Avançado mostra todos os separadores:

• SELF - noclip, curar e outras coisas para ti

• PLAYERS - goto, bring, spectate e o resto, mais o interruptor TESTER que dá a um jogador o menu de tester F4

• SKILLS - definir níveis e skills

• ITEMS - seletor de itens com separadores (boosters, gadgets, equipamento, drogas, munições…)

• WEAPONS, CLOTHING, VEHICLE

• WORLD - predefinições de hora e meteorologia

• DEBUG

• SANCTIONS - as sanções globais de fações e a prisão de admin

• GUARD - registo do anti-cheat (vê Anti-cheat)

Cada botão é uma ação de servidor que volta a verificar as permissões de staff, por isso um cliente modificado não a consegue saltar. As ações em Admin.Settings.superAdminOnly (kick, ban, unban, kill, givemoney, takemoney, wipeBuilds, wipeInventory, grantvip, revokevip) precisam de superadmin mesmo dentro do menu.

Os comandos de chat como /dv, /dz, /ann, /weather, /time, /tpc e /giveitem estão em Comandos de staff.

vMenu

O vMenu existe só para staff em F11, vmenu_menu_staff_only true. As suas permissões estão em resources/vMenu/config/permissions.cfg, executado antes de ensure vMenu. O seu próprio group.admin herda do teu group.admin, por isso não declaras o staff duas vezes.