Script de Admin FiveM — Painel e Ferramentas de Moderação

O módulo de Admin fornece todas as ferramentas necessárias para moderar e gerenciar o seu servidor FiveM. Através do menu de admin e comandos de console, você controla jogadores, aplica punições, consulta logs e realiza ações de manutenção diretamente em jogo.

Funcionalidades

Menu de admin acessível via tecla configurável
Sistema de ban (temporário e permanente) com identificadores
Kick com mensagem personalizada
Teleporte para jogadores e coordenadas
Modo invisível e noclip para admins
Logs de ações exportáveis para webhook do Discord
Visualização de identificadores de jogadores
Ferramentas de spawn de veículos e objetos
Compatível com o sistema de ACE nativo do FiveM

Configuração de Permissões

Defina grupos de administração no config.lua. Cada grupo recebe um conjunto de permissões que determinam quais ações seus membros podem executar. Você pode criar quantos grupos precisar (ex: 'head_admin', 'trial_mod').

config.lua

Config.AdminGroups = {
    ['superadmin'] = {
        label             = 'Super Admin',
        canBanPermanent   = true,
        canBanTemp        = true,
        canKick           = true,
        canSpawnVehicle   = true,
        canTeleport       = true,
        canViewLogs       = true,
        canManagePlayers  = true,
    },
    ['moderator'] = {
        label             = 'Moderador',
        canBanPermanent   = false,
        canBanTemp        = true,    -- Bans temporários permitidos para este grupo
        canKick           = true,
        canSpawnVehicle   = false,
        canTeleport       = true,
        canViewLogs       = true,
        canManagePlayers  = false,
    },
}

O menu de admin é aberto com F10 por padrão. Altere a tecla conforme a preferência da equipe:

config.lua

Config.AdminMenuKey = 'F10'  -- Tecla para abrir o menu de admin

Através do menu você acessa:

Lista de jogadores online com ações rápidas (kick, ban, teleporte)
Histórico de bans ativos e ferramentas para desbanir
Spawner de veículos e objetos
Painel de logs das ações recentes

Configuração de Logs

Os logs registram todas as ações administrativas e podem ser enviados automaticamente para um canal do Discord via webhook.

config.lua

Config.Logs = {
    enabled    = true,
    logToFile  = true,    -- Salva logs em arquivo na pasta do recurso
    webhookURL = 'https://discord.com/api/webhooks/SEU_ID/SEU_TOKEN',
    logActions = {
        ban       = true,
        kick      = true,
        spawn     = true,
        teleport  = false,  -- Desativado por padrão para evitar excesso de entradas
    },
}

Nunca compartilhe a URL do webhook do Discord publicamente. Com ela, qualquer pessoa pode enviar mensagens para o canal sem autenticação. Mantenha o config.lua fora de repositórios públicos.

Comandos de Moderação

Punições de Jogadores

Comando	Permissão	Descrição
`/kick [id] [motivo]`	`admin.kick`	Expulsa um jogador do servidor
`/ban [id] [tempo] [motivo]`	`admin.ban`	Bane um jogador (ex: `1d`, `7d`, `perm`)
`/unban [identificador]`	`admin.ban`	Remove um ban pelo identificador
`/freeze [id]`	`admin.moderate`	Congela um jogador no lugar
`/spectate [id]`	`admin.moderate`	Entra em modo espectador para observar um jogador

Ferramentas Administrativas

Comando	Permissão	Descrição
`/tp [id]`	`admin.teleport`	Teleporta você até outro jogador
`/tphere [id]`	`admin.teleport`	Teleporta outro jogador até você
`/coords`	`admin.teleport`	Exibe suas coordenadas atuais no mapa
`/noclip`	`admin.noclip`	Ativa ou desativa o voo livre
`/invis`	`admin.invis`	Ativa ou desativa invisibilidade
`/adminmenu`	`admin.menu`	Abre o menu de admin manualmente

API — Integrações via Exports e Eventos

Verificar se jogador é admin (servidor)

local isAdmin = exports['admin']:IsPlayerAdmin(source)
-- Retorna true se o jogador tiver qualquer grupo de admin configurado

Obter grupo do jogador (servidor)

local group = exports['admin']:GetPlayerGroup(source)
-- Retorna a chave do grupo (ex: 'superadmin', 'moderator') ou nil

Registrar ação no log (servidor)

exports['admin']:LogAction(source, 'custom_action', 'Descrição da ação realizada')
-- Parâmetros: source (admin que agiu), tipo (string), descrição (string)

Evento disparado ao banir jogador (servidor)

AddEventHandler('admin:onPlayerBanned', function(adminId, targetId, duration, reason)
    print('Admin ' .. adminId .. ' baniu ' .. targetId .. ' por: ' .. reason)
end)

Resolução de Problemas

Problema	Causa provável	Solução
Comando de admin não funciona	Jogador sem grupo de admin configurado	Verifique a atribuição de grupo via ACE ou `Config.AdminGroups`
Logs não aparecem no Discord	URL de webhook incorreta ou desativada	Confirme a URL no `config.lua` e verifique se `enabled = true`
Menu de admin não abre	Tecla conflitante com outro recurso	Altere `Config.AdminMenuKey` para uma tecla não usada
Ban temporário não expira	Formato de tempo inválido	Use o formato correto: `1d` (1 dia), `7d` (7 dias), `24h` (24 horas)

Introdução

Guias

Scripts

Referência

Suporte

Script de Admin FiveM — Painel e Ferramentas de Moderação

Funcionalidades

Configuração de Permissões

Configuração do Menu de Admin

Configuração de Logs

Comandos de Moderação

Punições de Jogadores

Ferramentas Administrativas

API — Integrações via Exports e Eventos

Verificar se jogador é admin (servidor)

Obter grupo do jogador (servidor)

Registrar ação no log (servidor)

Evento disparado ao banir jogador (servidor)

Resolução de Problemas

​Funcionalidades

​Configuração de Permissões

​Configuração do Menu de Admin

​Configuração de Logs

​Comandos de Moderação

​Punições de Jogadores

​Ferramentas Administrativas

​API — Integrações via Exports e Eventos

​Verificar se jogador é admin (servidor)

​Obter grupo do jogador (servidor)

​Registrar ação no log (servidor)

​Evento disparado ao banir jogador (servidor)

​Resolução de Problemas

Funcionalidades

Configuração de Permissões

Configuração do Menu de Admin

Configuração de Logs

Comandos de Moderação

Punições de Jogadores

Ferramentas Administrativas

API — Integrações via Exports e Eventos

Verificar se jogador é admin (servidor)

Obter grupo do jogador (servidor)

Registrar ação no log (servidor)

Evento disparado ao banir jogador (servidor)

Resolução de Problemas