Como se tornar administrador no FiveM: add_ace, add_principal, group.admin

Você inicia seu próprio servidor, entra nele, e os comandos de admin não fazem nada: sem menu, sem /car, o framework diz que você não tem permissão. Você é o dono do servidor, mas o servidor ainda não sabe disso. Você precisa dizer a ele quem você é.

FiveM tem um sistema de permissão chamado ACE. Este guia mostra como se colocar no grupo admin, como encontrar seu identificador e o que configurar em ESX e QBCore além disso.

#Como o ACE funciona

ACE (Access Control Entries) é integrado ao FiveM. Duas coisas importam:

• add_ace dá uma permissão a um grupo ou pessoa, por exemplo "o grupo admin pode executar qualquer comando".
• add_principal coloca uma pessoa, ou um grupo, em outro grupo.

O padrão usual é: definir o que o grupo admin pode fazer, depois adicionar jogadores a ele com seu identificador. Tudo vai em server.cfg.

#Passo 1: definir o grupo admin

add_ace group.admin command allow
add_ace group.admin command.quit deny

A primeira linha permite que o grupo admin execute todos os comandos. A segunda remove um comando perigoso, então um admin não pode parar o servidor com quit. Você pode adicionar mais linhas deny para comandos que você não quer no grupo.

#Passo 2: adicione-se ao grupo

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Substitua o longo valor pelo seu próprio identificador. Você pode adicionar mais de um jogador, uma linha para cada:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.discord:123456789012345678 group.admin

O tipo de identificador vai antes dos dois-pontos, e você pode usar qualquer um deles. Eles todos apontam para a mesma pessoa, então uma linha por pessoa é suficiente.

#Passo 3: encontre seus identificadores

Você precisa do seu identificador do ponto de vista do servidor, então entre no servidor uma vez primeiro.

• No txAdmin: abra a página Players, clique no seu nome, e abra as informações do jogador. Os IDs são listados lá (license, fivem, discord, steam e outros).
• No console do servidor: digite status. Ele lista todo jogador conectado com seus identificadores.

Qual usar:

• license: vinculada à license da Rockstar do jogador. Presente para todos, então esta é a escolha segura.
• fivem: vinculada à conta Cfx.re. Estável e boa para staff que usa vários PCs.
• discord: vinculada à conta Discord, e apenas presente quando o aplicativo Discord está aberto no PC do jogador quando ele se conecta. Não confie nela sozinha.

Atenção: copie o identificador da página do jogador do txAdmin, não de uma captura de tela que alguém lhe enviou. Um identificador errado ou antigo dá admin a uma pessoa diferente ou a ninguém.

#Passo 4: aplicar

server.cfg é lido quando o servidor inicia, então reinicie o servidor. Você também pode colar as linhas no console do servidor para aplicá-las sem reiniciar:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Reconecte ao servidor depois disso, porque suas permissões são verificadas quando você entra.

Para testar, execute um comando que precise de permissão, ou no console F8 use um comando que você sabe que é restrito. Se conseguir usá-lo, a regra funciona.

#Admin no ESX

ACE controla comandos. ESX também tem seus próprios grupos de jogadores, armazenados na coluna group da tabela users no seu banco de dados. Um jogador é user por padrão, e um admin é admin.

No console do servidor você pode defini-lo com:

setgroup 1 admin

onde 1 é seu ID do servidor (veja a lista de jogadores no txAdmin). Você também pode editar a coluna group diretamente com uma ferramenta de banco de dados, depois reconecte. Alguns scripts de admin leem o grupo ACE, alguns leem o grupo ESX, então defina ambos se um deles não funcionar.

#Admin no QBCore

QBCore lê suas permissões de ACE. O server.cfg padrão no QBCore define grupos como qbcore.god, qbcore.admin e qbcore.mod. Adicione-se ao que você quer:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd qbcore.god

Se você não vê essas linhas de grupo no seu server.cfg, verifique a que veio com qb-core e copie-a. Reinicie e reconecte, depois tente um comando de admin.

No QBox, as permissões também são baseadas em ACE. Siga o exemplo na documentação de qbx_core ou seu server.cfg padrão, e use a mesma forma de add_principal com seu identificador.

#Se ainda não funcionar

• Nenhum efeito: a linha está em um server.cfg que o servidor não carrega, ou está comentada. Verifique o caminho no topo do console do txAdmin.
• Um erro de digitação no identificador: compare-o caractere por caractere com a página do jogador do txAdmin.
• Você não reconectou: as permissões são aplicadas quando você entra.
• Prefixo errado: é identifier.license: com um ponto, não identifier:license: ou license:.
• O framework ainda diz não: defina o grupo ESX ou QBCore também, como acima.

Para acesso ao próprio painel txAdmin, esse é um login separado, veja txAdmin esqueceu a senha.

#Checklist