Permissões ACE no FiveM: Identificadores Explicados (steam:, license:, xbl:)

O sistema Access Control Entries (ACE) do FiveM gerencia comandos administrativos, cargos de moderação e privilégios de recursos no arquivo server.cfg. Os jogadores são identificados por prefixos de contas como steam:, license:, discord: e xbl:.

Compreender o papel de cada identificador impede falhas de segurança e acessos indevidos no seu servidor. A seguir, explicamos os formatos disponíveis e como utilizá-los corretamente.

O que são identificadores do FiveM no sistema ACE? #

Um identificador do FiveM é um texto que associa uma conta externa a uma vaga de jogador ativa no FXServer. Quando um usuário se conecta, o cliente envia todos os identificadores disponíveis para o servidor.

O servidor cruza essas informações com as regras estabelecidas no server.cfg. Se o identificador pertencer a um grupo administrativo, o servidor concede os comandos cadastrados para aquele jogador.

Como detalhamos em nosso guia de Steam Hex para FiveM, cada serviço possui um prefixo específico seguido de dois-pontos.

Todos os identificadores do FiveM explicados #

O FXServer reconhece sete tipos principais de identificadores:

1. `license:` e `license2:` (Rockstar Games) #

Identifica a posse legítima de GTA V junto à Rockstar Games. Como o FiveM não inicia sem o jogo original, todos os jogadores possuem uma licença. A Cfx.re indica o uso de license: como o padrão mais confiável para comandos de staff.

2. `steam:` (Steam Hex) #

Representa o SteamID64 do usuário em notação hexadecimal. Estruturas populares de roleplay (como ESX e QBCore) utilizam steam: como identificador principal em tabelas SQL. Para obter essa chave, use nosso Conversor SteamID.

3. `discord:` (ID de Usuário do Discord) #

Permite que recursos verifiquem a presença do jogador na sua comunidade do Discord para atribuir permissões ou cargos VIP de forma automatizada.

Como configurar permissões ACE no `server.cfg` #

A configuração de regras ACE utiliza dois comandos essenciais: add_principal e add_ace.

• add_principal associa um identificador a um grupo (por exemplo, group.admin).
• add_ace autoriza ou bloqueia comandos para aquele grupo.

Exemplo funcional para o seu server.cfg:

# ===================================================
# Configuração de Permissões ACE no FiveM (server.cfg)
# ===================================================

# 1. Vincular Identificadores aos Grupos
# Método A: Por Licença da Rockstar (Recomendado)
add_principal identifier.license:1234567890abcdef1234567890abcdef12345678 group.admin

# Método B: Por Steam Hex ID
add_principal identifier.steam:1100001000056ba group.admin

# Método C: Por ID do Discord
add_principal identifier.discord:198273645123456789 group.moderator

# 2. Definir Hierarquia de Grupos
# O grupo admin herda todas as permissões do grupo moderator
add_principal group.admin group.moderator

# 3. Conceder Permissões aos Grupos
# Permitir que moderadores usem comandos de kick e ban
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Liberar todos os comandos para administradores
add_ace group.admin command allow

# Bloquear o comando de encerrar o servidor pelo chat
add_ace group.admin command.quit deny

Por que usar `license:` em vez de `steam:` para administradores? #

A documentação da Cfx.re orienta o uso de license: por dois motivos:

1. Continuidade de acesso: Se um administrador entrar no FiveM com a Steam fechada, as permissões associadas apenas a steam: não funcionarão nessa sessão.
2. Segurança de conta: Trocar de perfil da Steam é mais simples do que alterar a licença instalada da Rockstar Games.

Contudo, para salvar dados de personagens em tabelas SQL, o uso de steam: continua indispensável. Veja mais em nosso guia sobre como colocar jogadores na whitelist pelo Steam Hex.

Erros comuns ao configurar o ACE #

• Esquecer o termo identifier.: Usar add_principal steam:1100001... group.admin é inválido. É obrigatório escrever identifier.steam:.
• Inverter a herança: add_principal group.admin group.moderator faz o administrador herdar o cargo de moderador. Fazer o inverso dará poderes totais aos moderadores.
• Espaços no texto: Não inclua espaços junto aos dois-pontos.
• Letras maiúsculas: Sempre use caracteres minúsculos em strings hexadecimais.

Perguntas Frequentes #

Qual a diferença entre os identificadores steam: e license: no FiveM? #

O identificador steam: é gerado a partir do SteamID64 e requer a Steam aberta. O identificador license: vem da Rockstar Games e é transmitido em todas as conexões sem exceção.

Como consultar os identificadores de um jogador conectado no FiveM? #

Digite status no console do servidor ou abra o painel txAdmin na lista de jogadores. O FiveM exibe todos os identificadores ativos como license, steam, discord e IP.

Os jogadores conseguem falsificar o identificador steam: no FiveM? #

Não. O FXServer autentica o ticket da Steam diretamente na API da Valve durante o processo de conexão. Não é possível forjar um Steam Hex.

Qual o melhor identificador para permissões de administração no FiveM? #

A equipe Cfx.re recomenda o uso de license: ou license2: para permissões administrativas, pois a licença da Rockstar fica fixada permanentemente ao jogo.

Deseja converter a conta de um candidato em Steam Hex para o seu server.cfg? Utilize o nosso Conversor SteamID gratuito para obter qualquer dado com rapidez.

Última atualização: outubro de 2026