Antes de começar
Separe estas informações. Com elas em mãos, a configuração inteira leva menos de 20 minutos. O progresso desta lista fica salvo neste navegador.
O link de convite já pede todas. Se você editou permissões depois, confira no cargo do bot: Gerenciar cargos, Gerenciar canais, Gerenciar apelidos, Ver canais, Enviar mensagens, Inserir links, Anexar arquivos, Ver histórico de mensagens, Criar tópicos públicos, Usar comandos de barra e — para as punições — Expulsar membros, Banir membros e Silenciar membros. Para indicações, Gerenciar servidor e Criar convite; para calls temporárias, Mover membros.
Criar o seu bot
O bot é seu: ele leva o nome, a foto e o status da sua cidade em todo lugar, inclusive nas DMs dos jogadores. Para isso você cria o app uma vez no portal do Discord e entrega a chave dele (o token) para a PowerCode. Leva uns 10 minutos.
Privileged Gateway Intents
- Abra o portal e crie o appEntre em
discord.com/developers/applicationscom a sua conta do Discord e clique em New Application, no canto de cima. Escreva o nome da cidade (ex.:Paulistana RP), marque a caixa dos termos e clique em Create. - Foto e descriçãoEm General Information, envie a logo em App Icon (quadrada, PNG ou JPG) e escreva uma descrição curta. Ela aparece no perfil do bot. Clique em Save Changes.
- Desligue o link de instalação do DiscordEm Installation: em Installation Contexts, deixe marcado só Guild Install. Em Install Link, escolha None. Salve. O link de instalação certo é o que a PowerCode te entrega.
- Deixe o bot privadoEm Bot, desligue Public Bot. Assim só você consegue adicionar o bot a um servidor. Se aparecer um erro dizendo que o app privado não pode ter link de instalação, volte ao passo 3.
- Ligue os três interruptoresAinda em Bot, desça até Privileged Gateway Intents e ligue Presence Intent, Server Members Intent e Message Content Intent, como no exemplo acima. Clique em Save Changes. Sem eles, boas-vindas, indicações, bate-ponto, AntiLinks e o histórico dos tickets não funcionam.
- Nome e banner do botNo topo da aba Bot ficam o nome que aparece para os jogadores (Username), o ícone e o banner. Pode usar o mesmo nome da cidade.
- Copie o tokenNa aba Bot, clique em Reset Token e confirme (o Discord pode pedir sua senha ou o código de 2 fatores). Clique em Copy. O token só aparece uma vez: se perder, é só gerar outro.
- Entregue o token na lojaNo Discord da PowerCode, use
/apps→ Configurar token e cole na caixa que abrir. O bot confere na hora se o token funciona e se os três interruptores estão ligados, e diz exatamente o que falta. - Instale no seu servidorCom tudo certo, você recebe o link de instalação. Abra, escolha o servidor da cidade, clique em Autorizar e pronto: digite
/bot confige siga para a Configuração rápida.
Quem tem o token controla o bot. Cole somente na caixa do /apps, nunca no chat, em ticket ou em print. A PowerCode guarda o token criptografado e nunca mostra de volta. Se ele vazar, clique em Reset Token no portal e cadastre o novo no /apps.
Cada plano vale para um servidor. Se o bot for adicionado a um segundo servidor, ele sai sozinho. Mudou de servidor ou o bot foi removido? Use /recuperarbot na loja para gerar um novo link (uma vez a cada 30 dias).
Configuração rápida
Digite /bot config e clique em 🚀 Configuração rápida. Cada tela tem uma ação só e avança sozinha. Isto é o que você vê ao abrir:
- Conectar ao bancoClique em Conectar ao banco, preencha host, usuário, senha e nome do banco. O bot testa na hora e, se conectar, já procura onde estão os jogadores.
- Confirmar onde estão os jogadoresO bot mostra a tabela e as colunas que encontrou (ex.:
users→ ID emidentifier, whitelist emwhitelist). Se estiver certo, Usar esta. - Cargo de liberadoEscolha no seletor o cargo que o jogador recebe ao passar na whitelist (ex.:
@Cidadão). - TicketsEscolha o canal da staff (recebe os históricos) e quem atende. O bot cria os tipos Suporte, Denúncias e Compras sozinho.
- SugestõesEscolha o canal onde as sugestões aparecem para votação.
- Servidor FiveMInforme o
ip:porta. Isso liga o painel de status, o alerta de queda e a campanha de retorno.
A tela inicial mostra 9 categorias, na mesma ordem deste guia. Cada quadradinho é um recurso: 🟩 pronto, 🟨 falta algo, ⬛ não usado. Dentro da categoria, cada item diz o que falta: ✅ pronto, ⚠️ falta algo, ➖ opcional. O último passo da Configuração rápida, Publicar painéis, pergunta em qual canal cada painel deve aparecer.
Servidor novo ou vazio? Um clique monta o Discord da cidade inteiro: cargos (Administração, Moderação, Suporte, VIP, Polícia, Hospital, Mecânica, Cidadão, Visitante), regras, anúncios, bate-papo e voz só para cidadãos, canais das organizações com bate-ponto, área da staff e todos os painéis do bot. Já sai ligado: quem é aprovado vira Cidadão, quem entra ganha Visitante, e os tipos de ticket ficam prontos. Nada é apagado. Depois, Gerar link de modelo cria um link para clonar o servidor.
Cria de uma vez as categorias 📌 INFORMAÇÕES (painéis: todos leem, só o bot escreve) e 🔒 STAFF · LOGS (só a staff vê), com todos os canais que o bot usa, e já publica os painéis prontos. Só cria o que falta, então pode clicar de novo sem medo. Dentro de cada categoria do painel existe Criar canais que faltam só daquela parte.
Confere tudo de uma vez: interruptores do portal, permissões do bot, cada canal configurado, a posição do cargo, o banco e o servidor FiveM. Mostra o que está errado e como corrigir. Também funciona com /bot diagnostico.
Banco de dados
Tudo que o bot faz de especial — liberar ID, mostrar perfil, dar cargo por VIP, convidar quem sumiu — depende de ler o banco do seu servidor. É a mesma base que o FiveM usa; o bot só lê e, na liberação, muda um campo.
- Abra
/bot config→ Banco de dados → Conectar ao bancoTipo (mysql ou postgres),host:porta, usuário, senha e nome do banco. A senha fica guardada no bot e nunca aparece no painel. - Leia o resultadoSe não conectar, o bot explica em português o que conferir: endereço errado, porta fechada (peça ao host para liberar o IP
85.209.93.110), usuário/senha, ou nome do banco. - Encontrar jogadoresO bot reconhece as bases mais comuns (ESX, QBCore/QBox, vRP, Creative) pelos nomes das tabelas e colunas e propõe a configuração. Se a sua for diferente, Escolher outra lista as tabelas e os campos para você apontar.
Se a coluna de whitelist é numérica (0/1), os valores precisam ser números. O bot recusa true/false nesse caso, porque o banco converteria os dois para o mesmo número e a liberação não teria efeito.
Campos do personagem e /perfil
Cada base guarda os dados num lugar: ESX em users.accounts, QBCore em players.money, vRP e Creative em outras. Aqui você diz onde está cada coisa uma vez, e o bot usa isso no /perfil e nas regras de cargo.
- Aplicar uma base
/bot config→ Campos do personagem → seletor Aplicar uma base. O bot sugere a que reconheceu (✨) e preenche só as colunas que existem na sua tabela. - Ajustar um campoSeletor Configurar um campo → escolha a coluna → se o valor estiver dentro de um JSON, Caminho JSON (ex.:
money,job.grade.name) → formato (dinheiro, data, tempo…). - Campo extraPara o que não tem nome pronto (gangue, facção, nível): rótulo livre + coluna + caminho + formato.
- PréviaPrévia do /perfil mostra como fica com um jogador real. Ajuste até ficar certo.
| Base | Tabela sugerida | O que o preset preenche |
|---|---|---|
| ESX | users | nome, sobrenome, dinheiro e banco (accounts → JSON), emprego, cargo, último login |
| QBCore / QBox | players | nome (charinfo), dinheiro (money), emprego (job.label), último login |
| vRP | vrp_users | último login — o resto varia por servidor, configure na mão |
| Creative / outras | — | use Configurar um campo e Campo extra; funciona com qualquer tabela |
Dinheiro, veículos e bans no jogo
A staff entrega dinheiro, dá ou tira veículos e bane direto no banco da cidade, pelo Discord. Serve para premiar evento, repor perda por bug ou punir sem abrir o txAdmin.
- Dinheiro: configure os campos
/bot config→ Base do jogo → Campos do personagem. Os campos de dinheiro (em mãos e no banco) dizem onde fica o saldo (ex.:accounts→moneyno ESX). O mesmo campo do/perfilserve aqui. - Veículos: escolha a sua base
/bot config→ Base do jogo → Comandos do jogo → seletor Molde de veículos da sua base: ESX, QBCore/QBox, vRP ou Creative. O bot preenche tabela, colunas e o molde da linha que é gravada. A tela mostra uma prévia com um ID de exemplo. Veículos (avançado) ajusta tudo à mão. - Banimentos: coluna ou tabelaColuna marca um campo do jogador (ex.:
banned = 1). Tabela grava uma linha embanlist(ESX) oubans(QBCore). Seletor Banimentos, na mesma tela. Os comandos/punire/desbanirpassam a banir na cidade também. - Catálogo (opcional)Botão Catálogo: uma lista
modelo | Nome bonitopor linha. Ela vira sugestão ao digitar o modelo no comando.
Uma linha por coluna, no formato coluna = valor. Use {id}, {modelo}, {placa}, {hash}, {discord}, {motivo}, {expira} ou {col:license} para copiar uma coluna do jogador. Bases diferentes das prontas funcionam editando o molde, sem código.
O bot escreve no banco. Se o jogador estiver na cidade, a base pode sobrescrever o saldo ao salvar. O bot avisa quando o jogador está online, e o ideal é entregar com ele fora.
Backup do banco
Uma cópia .sql.gz do banco da cidade a cada 2 horas (ou o intervalo que você escolher), guardada fora do seu host. Se o banco corromper ou alguém apagar uma tabela, você restaura com o arquivo.
- Ligar
/bot config→ Base do jogo → Backup do banco → Ligar automático. Escolha o intervalo: a cada 2, 6, 12 ou 24 horas. - Tabelas e limiteQuantas cópias guardar (as mais antigas saem sozinhas), limite de tamanho e, se quiser, só algumas tabelas.
- Canal de avisoA staff recebe um aviso a cada backup, ou se algum falhar.
- BaixarFazer agora gera uma cópia na hora. Baixar o último entrega um link privado, válido por 24 horas.
Abra o arquivo no HeidiSQL ou DBeaver e execute, ou rode gunzip -c backup.sql.gz | mysql -u usuario -p banco. Em MySQL/MariaDB o arquivo recria as tabelas com a estrutura completa.
Liberação de ID
Um painel com dois botões. O jogador digita o ID, o bot confere no banco, libera (ou reseta) e dá (ou tira) o cargo. A resposta vai na DM do jogador — o canal fica limpo.
- Escolha o cargo
/bot config→ Liberação de ID → seletor Cargo que o jogador recebe ao ser liberado. - Ajuste os textos (opcional)Textos do painel: título, descrição e cor do cartão.
- PubliqueVá ao canal desejado e clique em Publicar neste canal — ou use Publicar painéis e escolha o canal no seletor.
Em Liberação, o seletor Identificação define o que o jogador digita: ID numérico (passaporte), SteamHex, Código alfanumérico ou Console (só a staff libera). Todos os textos mudam junto — no modo Código, o botão vira Liberar Código e o campo Digite seu Código; nada mostra "ID". A validação também segue o modo (SteamHex ganha o prefixo steam: sozinho).
Quando o jogador libera o ID, o bot passa a saber qual personagem é dele. Isso alimenta o /perfil, os cargos automáticos e a campanha de retorno, sem nenhum passo extra.
Whitelist com formulário
Para servidores que entrevistam antes de liberar. O candidato responde perguntas, a staff recebe um cartão com Aprovar/Reprovar e, ao aprovar, o bot libera no banco, dá o cargo e avisa o jogador — tudo sozinho.
- Canal da staff
/bot config→ Whitelist → seletor Canal da staff. Os formulários chegam ali, com menção aos cargos que analisam. - Quem analisa e cargo ao aprovarDois seletores opcionais. Sem cargo de staff, só administradores decidem.
- PerguntasBotão Perguntas: até 4, uma por linha. O formulário sempre pede o ID primeiro.
- Publique o painelEm Publicar painéis, escolha Whitelist e o canal (ex.:
#whitelist).
Seletor Modelo em Whitelist: Manual (a staff aprova cada pedido), Automática (aprova sozinho ao enviar; as respostas ficam no log da staff) e Entrevista (abre um canal privado com a staff para conversar antes; ao decidir, o canal vira histórico e some). O modelo "Rápida" é o painel de Liberação.
O bot marca o ID como liberado no banco (pode desligar em Liberar no banco), vincula o Discord ao personagem, dá o cargo de aprovado, aplica o apelido Nome | ID se estiver ligado, e manda a DM com o recado da staff. Cada jogador tem um pedido em análise por vez.
Códigos de resgate
Um código libera o jogador na hora — para servidores que vendem ou distribuem a whitelist por código. Os códigos podem ser gerados pelo bot ou já existir no banco do jogo (código de indicação, por exemplo).
- Escolha a fonte
/bot config→ Códigos de resgate → seletor Fonte. Gerados pelo bot: você cria com/codigos gerar quantidade:10 validade:7 usos:1(ou atrelado a um jogador comid:). Banco do jogo: clique em Tabela do jogo e informe a tabela, a coluna do código, a coluna do dono e (opcional) a coluna "usado". - Log e cargo (opcional)Canal onde cada resgate é registrado e cargo dado a quem resgata.
- PubliqueEm Publicar painéis, escolha Códigos de resgate e o canal.
O bot valida o código (validade, usos, já usado), libera o identificador no banco, vincula o Discord ao personagem, dá o cargo e registra no log. Códigos gerados pelo bot ficam em /codigos listar; /codigos remover cancela um.
Vínculo e apelido
O bot liga o Discord de cada jogador ao ID no jogo. Com isso, dá para trocar o apelido no servidor para Nome | ID — a staff identifica todo mundo de bate-pronto.
- Ligar apelido
/bot config→ Vínculo e apelido → Ligar apelido. Precisa da permissão Gerenciar apelidos no cargo do bot. - Formato (opcional)Padrão
{nome} | {id}. O nome vem do personagem no banco (se os campos estiverem configurados) ou do apelido atual. - Aplicar a todosRenomeia de uma vez quem já está vinculado.
O bot não consegue mudar o apelido do dono do servidor nem de quem tem um cargo acima do cargo do bot. O painel mostra quantos não deram e por quê.
Cargos automáticos
Regras do tipo "se campo condição então cargo", conferidas periodicamente para todo jogador vinculado. O Discord fica sempre igual ao jogo: VIP venceu, perde o cargo; virou policial, ganha.
Quando vence, o cargo sai sozinho.
Mudou de emprego, muda o cargo.
Liberou por qualquer caminho, recebe o cargo.
Qualquer campo numérico serve.
- Nova regra
/bot config→ Cargos automáticos → Nova regra: campo → condição → valor (se precisar) → cargo. Três telas, uma escolha em cada. - Sincronizar agoraRoda uma vez e mostra quantos cargos deu e tirou. Use para testar antes de ligar.
- LigarPassa a rodar sozinho a cada 10 minutos. O bot só mexe nos cargos citados nas regras — nunca em outros.
é igual a · é diferente de · contém · é maior que · é menor que · está preenchido · está vazio · é uma data no futuro · é uma data no passado. Os campos vêm de Campos do personagem mais a liberação (whitelist).
Tickets
Um menu com os tipos de atendimento. Ao escolher, o jogador ganha um canal privado com a staff daquele tipo. Ao fechar, a staff recebe o histórico completo em uma página, e o canal some.
- Canal da staff
/bot config→ Tickets → Canal da staff. É onde o histórico chega quando um ticket fecha. - TiposTipos padrão cria Suporte, Denúncias e Compras de uma vez, atendidos pelos cargos que você escolher. Novo tipo cria um a um, com emoji e cargos próprios.
- Categoria (opcional)Uma categoria do Discord onde os canais de ticket nascem, para não bagunçar a lista.
- PubliquePublicar aqui no canal de atendimento.
Assumir marca o atendente e avisa quem abriu na DM. Fechar pede um motivo, gera o histórico e apaga o canal em 5 segundos. Trancar, renomear, adicionar e notificar estão em Atendimento avançado.
Vai para o canal da staff e para a DM do jogador como um botão Abrir histórico — uma página com as mensagens, imagens e horários, válida por 7 dias.
Atendimento avançado e tribunal
Dentro de cada ticket a staff tem uma segunda linha de botões. Tipos de denúncia viram tribunal: antes de abrir, o jogador conta quem acusa, o que houve e as provas.
Quem abriu continua vendo, mas só a staff escreve. Clique de novo para destrancar.
Traz o acusado, uma testemunha ou outro atendente para dentro do canal.
Manda uma DM para quem abriu, com o link do ticket, quando ele some.
Muda o nome do canal. O Discord permite 2 renomes a cada 10 minutos.
- Ligar o tribunal em um tipo
/bot config→ Atendimento → Atendimento avançado → escolha o tipo. Tipos chamados Denúncia ou Tribunal já nascem ligados. - Ranking de atendimentosCada ticket fechado conta para quem assumiu. Veja com
/rankings ver tipo:Atendimentos.
Formulários
Reporte de bug, candidatura à staff, denúncia ou o que você inventar. Não há limite de perguntas: o Discord mostra 5 por vez, e o bot divide em partes com um botão Continuar. As respostas chegam num canal da staff.
- Comece por um modelo
/bot config→ Atendimento → Formulários → Criar a partir de um modelo: bug (5 perguntas), candidatura (7) ou denúncia (4). Ou Novo para criar do zero. - PerguntasUma por linha. Comece a linha com
+para resposta longa e com?para pergunta opcional. Ex.:+O que aconteceu? - Canal das respostasCada formulário pode mandar para um canal diferente (bugs para os devs, candidaturas para a administração).
- PubliqueEscolha o canal no seletor Publicar o painel. O menu se atualiza sozinho quando você cria ou remove formulários.
Avaliação da staff
Quando um ticket fecha, quem abriu recebe na DM um pedido de nota de 1 a 5 estrelas para o atendente, com comentário opcional. Um painel público permite avaliar qualquer membro da staff.
- Canal das avaliações
/bot config→ Atendimento → Avaliação da staff. Notas baixas chegam em vermelho, altas em verde. - Quem pode ser avaliado (opcional)Escolha os cargos da staff para que ninguém avalie um membro comum pelo painel.
- Painel públicoPublique o botão Avaliar alguém da staff. Cada pessoa avalia o mesmo atendente no máximo uma vez a cada 24 horas.
Sugestões com votação
O jogador envia título, descrição e uma imagem opcional. A sugestão aparece no canal com votos ✅/❌ e porcentagem, um tópico de debate e um botão de ações para a staff aprovar, recusar ou marcar como implementada.
- Canal das sugestões
/bot config→ Sugestões → seletor de canal. É onde as sugestões são publicadas para votação. - Staff que decide (opcional)Cargos que podem usar Ações Administrativas. Sem eles, só administradores.
- Publique o painelO botão Enviar Sugestão vai no canal que você escolher em Publicar painéis.
Conexão FiveM
Um cartão fixo com o status do servidor, quantos jogadores estão online e o connect, atualizado a cada minuto. Com botões para o Connect (cfx.re) e o TikTok.
- Informar servidor
/bot config→ Conexão FiveM → nome,ip:porta, link do Connect (https://cfx.re/join/xxxxxx), TikTok e logo. - PubliquePublicar aqui no canal de status. Só existe um painel por servidor; publicar de novo o move.
O bot lê http://ip:porta/dynamic.json, um endereço que todo FiveM expõe. Confira se a porta está aberta para fora e se o firewall do servidor permite o IP 85.209.93.110.
Alerta de servidor
Quando o servidor cai, a staff sabe na hora — e quando volta, sabe quanto tempo ficou fora. Só avisa depois de duas verificações seguidas sem resposta, para não alarmar por um soluço de rede.
- Canal do aviso
/bot config→ Alerta de servidor → seletor de canal (sugestão: o canal privado da staff). - Cargo para marcar (opcional)Ex.:
@Staff. O aviso vem com a menção. - Ligar alertaPronto. Exige o servidor FiveM configurado em Conexão FiveM.
Contador no canal de voz
Um canal de voz que ninguém consegue entrar, no topo da lista, cujo nome mostra a lotação: todo mundo vê quantos estão na cidade sem abrir nada.
- Criar canal contador
/bot config→ Contador no canal de voz → Criar canal contador. O bot cria o canal já travado e no topo. (Ou escolha um canal de voz existente no seletor.) - Formato (opcional)Padrão
🟢 Jogadores: {online}/{max}. O Discord só deixa renomear um canal 2× a cada 10 minutos, então o número atualiza a cada ~5 min.
Em Conexão FiveM, o botão Quem está online adiciona ao cartão de status a lista de nomes conectados, atualizada a cada minuto.
Aviso de reinício
Se o servidor reinicia em horários fixos, o bot avisa antes (ex.: 15, 5 e 1 minuto) e no momento exato, marcando um cargo se você quiser. Horário do Brasil.
- Canal e cargo
/bot config→ Aviso de reinício → seletor de canal e, se quiser, o cargo a marcar. - Horários e avisosBotão Horários e avisos: horários no formato
06:00, 18:00, minutos de antecedência15, 5, 1, e a mensagem (use{min},{horario},{servidor}). - LigarO painel mostra quando é o próximo reinício.
Estatísticas de jogadores
O bot registra a lotação a cada 5 minutos. Com isso você sabe o pico, a média, o horário mais cheio e quanto tempo o servidor ficou no ar — e recebe um relatório toda semana, com comparação com a semana anterior.
- Canal, dia e hora do relatório
/bot config→ Estatísticas → seletores de canal (sugestão: canal da staff), dia da semana e hora. - Ligar relatórioEle chega sozinho toda semana. Ver agora mostra o resumo atual; a staff também pode usar
/estatisticas(comdias:30para o mês).
Mensagens prontas
Avisos que se repetem, como o evento de sexta, as regras ou o reinício, ficam salvos. A staff publica com um clique ou deixa o bot publicar sozinho nos dias e horários marcados.
- Nova mensagem
/bot config→ Servidor e canais → Mensagens prontas → Nova: nome, título, texto, imagem e, se quiser, a agenda. - AgendaEscreva o horário e os dias:
20:00 seg,qua,sex,21h30 todosou18:00 sab. Em branco, a mensagem só sai quando alguém publicar. Horário de Brasília. - Canal e mençãoEscolha o canal e, se quiser, um cargo para mencionar (ex.:
@Eventos). - Publicar na horaPelo botão Publicar agora ou com
/mensagem enviar nome:, que pode mandar para outro canal.
Calls
Dois recursos de voz. Nomes dinâmicos fazem o nome de um canal mostrar um número ao vivo. Calls de interação deixam cada jogador criar a própria call temporária.
🎮 Na cidade: {online} vira 🎮 Na cidade: 87. Também existem {membros}, {humanos}, {emcall}, {boosts} e {cargo:ID} (ex.: quantos policiais). Atualiza a cada 10 minutos, o máximo que o Discord permite.
O botão Criar minha call pede nome e vagas. O dono pode trancar e liberar. A call some quando esvazia, ou em 2 minutos se ninguém entrar.
- Nome dinâmico
/bot config→ Servidor e canais → Calls → escolha o canal → Definir formato. Deixe o formato vazio para parar. - Calls temporáriasEscolha a categoria onde elas nascem, o máximo de vagas e publique o painel Criar minha call.
Punições
A staff registra advertências, silêncios, expulsões e banimentos com /punir. O bot avisa o jogador na DM, aplica no Discord, guarda o histórico e — no banimento — pode marcar um campo no banco do jogo.
- Canal de log e quem pode punir
/bot config→ Punições → seletor de canal e cargos da staff. Sem cargos, só administradores. - OpçõesDM: sim/não (avisar o jogador), Aplicar no Discord: sim/não (silenciar/expulsar/banir de verdade) e Campo no banco (ex.: coluna
banned=1ao banir,0ao desbanir). - Advertências progressivasBotão Advertências: um cargo para a 1ª, a 2ª e a 3ª advertência (o anterior sai) e um limite. Ao atingir o limite, o bot expulsa ou bane sozinho.
/punir tipo:Remover última advertênciadesfaz a última. - No dia a dia
/punir membro tipo motivo [duracao]— silenciar exige duração (30m,2h, até28d)./punicoes membromostra o histórico./desbanir membroreverte. Com bans no jogo configurado, banimento e desbanimento valem também na cidade.
Para aplicar no Discord ele precisa de Expulsar membros, Banir membros e Silenciar membros (timeout). O painel avisa se faltar alguma. O bot não consegue punir quem tem cargo acima do dele.
Permissões por nível
Três níveis de staff, como Suporte, Moderador e Administrador, cada um com seus cargos. Cada ação do bot exige um nível mínimo. Nível maior pode tudo que o menor pode.
| Ação | Nível padrão |
|---|---|
| Aprovar whitelist, atender tickets, decidir sugestões | 1 · Suporte |
/punir, /limpar, /embed, sorteios, rankings, fechar ponto de outros | 2 · Moderador |
Banir e desbanir, /dm, /jogo dinheiro, veículo e ban, /codigos, vendas | 3 · Administrador |
- Cargos de cada nível
/bot config→ Moderação → Permissões por nível → escolha o nível → escolha os cargos. - Ajuste o que quiserEscolha uma ação e o nível exigido. Nomes dos níveis troca "Suporte" pelo nome que a sua equipe usa.
- Ligar níveisEnquanto estiver desligado, cada módulo usa os próprios cargos, como antes. Administradores do Discord sempre podem tudo.
O Discord esconde comandos de staff de quem não tem a permissão padrão. Para liberar um comando a um cargo: Configurações do servidor → Integrações → Bot PowerCode.
Moderação: AntiLinks, chat anônimo e comandos
As ferramentas do dia a dia da staff num lugar só. Os comandos já funcionam ao convidar o bot. AntiLinks e chat anônimo se ligam no painel.
| Comando | O que faz |
|---|---|
/limpar quantidade:50 | Apaga até 100 mensagens recentes. Com membro:, só as dele. O Discord não apaga em massa mensagens com mais de 14 dias. |
/embed | Abre um formulário e publica uma mensagem no visual do servidor: título, texto, cor, imagem e menção. |
/dm membro · /dm cargo | Manda uma mensagem na DM de uma pessoa ou de todos com um cargo, uma por segundo, e mostra quantas foram entregues. |
Apaga links de membros comuns. Convites de outros Discords são sempre bloqueados. Escolha a ação (só apagar, avisar ou castigo por X minutos), os sites liberados (YouTube, TikTok, Twitch…), os cargos e canais livres e o canal de log.
Um botão abre uma caixa de texto e a mensagem sai como Anônimo #K3F9. O autor fica no log da staff para casos de abuso. Limite de uma mensagem por minuto por pessoa.
- AntiLinks
/bot config→ Moderação → Moderação → AntiLinks → configure e Ligar. - Chat anônimoMesmo lugar → Chat anônimo: canal das mensagens, log da staff e canal do botão.
Boas-vindas
Quem entra no Discord recebe uma mensagem com a própria foto, uma imagem do servidor e o número de membro — e já ganha um cargo inicial, se você quiser (ex.: @Visitante até passar na whitelist).
- Canal e cargo inicial
/bot config→ Boas-vindas → seletores. Pode usar só o cargo, só o canal, ou os dois. - Mensagem e imagemUse
{mencao},{nome},{servidor}e{membros}. A imagem é um linkhttps://(banner do servidor). - Testar em mim → LigarVocê recebe o exemplo na DM antes de ligar.
Campanha de retorno
Quem fica dias sem entrar recebe uma DM convidando a voltar, com uma oferta e um código único que a staff honra no ticket. O bot mede quem clicou e quem realmente voltou — e mostra a taxa no painel.
- Canal da staff
/bot config→ Campanha de retorno → seletor. Recebe "fulano clicou em Quero voltar" e "fulano voltou". - Dias sem entrarSeletor de 3 a 30 dias. Padrão: 7.
- Mensagem e ofertaBotão Mensagem e oferta. Use
{nome},{dias},{servidor}e{codigo}. O cooldown evita repetir o convite (padrão 30 dias). - Testar em mimVocê recebe a DM exatamente como o jogador vai receber. Depois, Ligar campanha.
Pelo campo de último login da sua tabela de jogadores (last_seen, last_login, last_updated — ESX, QBCore e vRP têm). O painel mostra qual campo encontrou. O vínculo Discord ↔ personagem vem da liberação, da whitelist ou do /vincular. Só quem ainda está no seu Discord recebe o convite; quem clicar em "Não receber mais" nunca mais recebe.
Recompensa por impulso
Quem der boost no Discord ganha, automaticamente, um cargo, dinheiro e até um veículo na cidade. Se a pessoa ainda não vinculou o ID, o prêmio fica guardado e sai no dia em que ela vincular.
- Prêmios
/bot config→ Comunidade → Impulsos (boost) → Dinheiro e mensagem: valor, conta (banco ou carteira), veículo e a DM de agradecimento. O veículo também pode ser escolhido no seletor, a partir do catálogo. - Cargo, anúncio e logUm cargo extra (opcional, além do cargo de Booster que o Discord já dá), canal de anúncio público e log da staff. O cargo extra sai quando a pessoa para de impulsionar.
- LigarDinheiro e veículo dependem de Comandos do jogo e dos campos de dinheiro estarem configurados.
Indicações
O bot descobre por qual convite cada pessoa entrou e dá o crédito a quem convidou. Cada jogador gera o próprio link pessoal. Quem trouxer mais aparece no ranking e pode ganhar um cargo ao bater uma meta.
- Log e painel
/bot config→ Comunidade → Indicações: canal de log e canal do painel Meu convite. Os links pessoais apontam para esse canal. - Anti-fakeContas criadas há menos de 7 dias (ajustável) não contam. Quem sai e volta não conta duas vezes. Com Desconta saída, quem sai tira o ponto de quem convidou.
- Meta (opcional)Escolha um cargo e o número de indicações. O bot entrega o cargo e avisa na DM.
O cargo do bot precisa de Gerenciar servidor para ler os convites. O bot também precisa do acesso a membros ligado pela PowerCode. O painel mostra se algo falta.
Sorteios
Um comando, um botão. O sorteio encerra sozinho na hora marcada, sorteia e anuncia os ganhadores. Dá para limitar a um cargo (ex.: só VIP) e sortear de novo se alguém não responder.
/sorteio premio duracao [vencedores] [cargo] [canal] [captcha]Ex.:/sorteio premio:Kit VIP 30 dias duracao:2d vencedores:2 captcha:True. Duração de 1 minuto a 30 dias. Comcaptcha, cada pessoa resolve uma conta simples antes de entrar, o que barra contas-robô.- EncerramentoNa hora, o bot fecha o botão, sorteia entre quem participou e anuncia marcando os ganhadores. Cada ganhador também recebe uma DM. O botão Sortear novamente (só staff) escolhe outros, e Participantes mostra a lista para qualquer um conferir.
Bate-ponto
Cada organização, como Polícia, Hospital, Mecânica ou Staff, tem o próprio painel de Entrar em serviço e Sair de serviço. As horas vão para o ranking de ponto, com log de entrada e saída.
- Crie a organização
/bot config→ Equipe e rankings → Bate-ponto → Nova organização: nome, emoji e tolerância em minutos. - Quem pode e o cargo em serviçoCargos que podem bater ponto e, se quiser, um cargo Em serviço, dado ao entrar e tirado ao sair. Ele é útil para mencionar quem está de plantão.
- RegrasExige call: quem sair da call é avisado na DM, e o ponto fecha sozinho depois da tolerância. Exige online faz o mesmo para quem ficar ausente ou invisível.
- Log e painelCanal de log e canal do painel desta organização.
/ponto ver mostra as suas horas. A staff vê as de qualquer um. /ponto abertos lista quem está em serviço em cada organização. /ponto fechar membro: fecha o ponto de alguém que esqueceu.
Tempo em call e rankings da equipe
O bot conta sozinho o tempo de cada membro em call e soma nos rankings da comunidade e da equipe. Cada ranking pode sair automaticamente num canal e zerar a cada ciclo.
| Ranking | De onde vem |
|---|---|
| 🎧 Tempo em call | Minutos em canais de voz. Não contam o AFK, quem está com o fone desligado e, por padrão, quem está sozinho na call. |
| 🕒 Bate-ponto | Minutos em serviço, somando todas as organizações. |
| 🎫 Atendimentos | Tickets fechados por quem assumiu. |
| ⭐ Avaliação da staff | Média das estrelas, com o número de avaliações. |
| 📨 Indicações | Pessoas trazidas por convite pessoal. |
| 📩 Tickets abertos | Quem mais abre ticket. |
- Tempo em call
/bot config→ Equipe e rankings → Tempo em call: canais que não contam, mínimo de pessoas e se fone desligado conta. - Publicação automáticaRankings → escolha o ranking → canal, frequência (todo dia, toda segunda ou todo dia 1, às 9h) e Zera ao publicar para começar um ciclo novo.
- Na mão
/rankings ver tipo:para todos. A staff tem/rankings ajustar,resetareenviar.
Ranking de personagens
/ranking mostra o top do servidor por tempo jogado, dinheiro ou qualquer campo numérico dos Campos do personagem. Quem consulta vê a própria posição. Os rankings da equipe (call, ponto, atendimentos, avaliações, indicações) estão em Tempo em call e rankings.
- Não precisa configurar nada além dos camposTodo campo com formato numérico (tempo, dinheiro, número) em Campos do personagem aparece como opção no
/ranking campo:.
Relatórios
Um resumo para a staff, publicado às 9h: liberações, whitelist, códigos, entradas e saídas, pico de jogadores, tickets e vendas. Cada envio fecha um ciclo, e o próximo começa do zero.
- Canal e frequência
/bot config→ Equipe e rankings → Relatórios. Todo dia cobre o dia anterior, toda segunda a semana anterior e todo dia 1 o mês anterior. - ItensMarque o que entra. Prévia mostra o ciclo atual sem publicar.
- Sob demanda
/relatorio dias:30mostra só para você o resumo dos últimos 30 dias.
Loja com PIX
VIP, dinheiro, carros e cargos vendidos no Discord com PIX do Mercado Pago. O jogador escolhe o produto, paga pelo QR Code, e o bot entrega sozinho assim que o pagamento é aprovado.
- Conecte o Mercado Pago
/bot config→ Loja (PIX) → Vendas (Mercado Pago) → Conectar Mercado Pago e cole o Access Token de produção (Mercado Pago → Seu negócio → Configurações → Credenciais). O bot confere o token na hora e nunca o mostra de novo. - ProdutosNovo produto: nome, preço, descrição, dias do cargo e o que entregar no jogo (ex.:
dinheiro=50000; conta=banco; veiculo=sultan). Depois escolha o produto e o cargo que ele entrega. - Log e textosCanal onde cada venda é registrada, e Textos da loja para título e descrição.
- Publique a lojaEscolha o canal no seletor Canal da loja: ela é publicada na hora, com os produtos e preços.
O bot só entrega depois de confirmar o pagamento direto na API do Mercado Pago, conferindo o pedido e o valor. Um aviso falso não libera nada.
O cargo sai sozinho no fim do prazo. Quem renova antes de vencer soma os dias ao prazo atual.
Se o comprador ainda não vinculou o ID, dinheiro e veículo ficam guardados e saem quando ele vincular.
/vendas listar mostra os últimos pedidos. /vendas verificar consulta um pagamento, e /vendas entregar força a entrega de um pedido pago.
Tema visual
Uma identidade para todos os painéis e mensagens do bot no seu servidor: cor, logo no topo e no rodapé, banner nos painéis principais e um rodapé com a sua marca. Configura uma vez, vale para tudo.
- Editar tema
/bot config→ Tema visual → Editar tema: cor (#RRGGBB), logo (link https, quadrada), banner (link https, largo), nome e rodapé. A própria tela do painel já aparece no tema novo. - Republique os painéisPainéis já publicados só mudam quando republicados (Publicar painéis). Mensagens novas — tickets, sugestões, DMs, alertas — já saem no tema.
Aparência do bot
Dê ao bot a logo e o nome do seu servidor. Vale só no seu Discord — em outros servidores ele continua como está lá.
- Definir logo e nome
/bot config→ Aparência do bot → linkhttps://de uma imagem quadrada (PNG/JPG, até 8 MB) e o apelido. - Painéis têm imagem própriaA logo de cada painel (tickets, sugestões, whitelist, conexão) fica nos Textos de cada módulo.
Comandos
Quase tudo se faz pelo /bot config. Estes são os comandos que os jogadores e a staff usam no dia a dia.
| Comando | Quem usa | O que faz |
|---|---|---|
/bot config | Administrador | Painel único de configuração, com a Configuração rápida. |
/perfil | Todos | Dados do próprio personagem. Staff: /perfil membro:@alguém. |
/vincular id:25644 | Todos | Liga o Discord ao ID no jogo (o bot confere se o ID existe). |
/painel | Gerenciar servidor | Publica o painel de Liberação de ID no canal atual. |
/whitelist-painel | Gerenciar servidor | Publica o painel da whitelist com formulário. |
/ticket-painel | Gerenciar servidor | Publica o painel de tickets. |
/sugestao-painel | Gerenciar servidor | Publica o painel de sugestões. |
/conexao | Gerenciar servidor | Publica o painel de status do FiveM. |
/ranking campo: | Todos | Top jogadores por tempo, dinheiro ou outro campo numérico. |
/punicoes | Todos | Suas punições. Staff: /punicoes membro:@alguém. |
/punir | Staff | Advertência, silenciar, expulsão ou banimento, com motivo e duração. Também remove a última advertência. |
/desbanir | Staff | Reverte um banimento (Discord e banco). |
/sorteio | Gerenciar servidor | Cria um sorteio com botão Participar e encerramento automático. |
/estatisticas | Gerenciar servidor | Pico, média e horários de jogadores (7 dias, ou dias:30). |
/codigos gerar | listar | remover | Gerenciar servidor | Códigos de resgate gerados pelo bot (quantidade, validade, usos, atrelar a um jogador). |
/codigos-painel | Gerenciar servidor | Publica o painel Resgatar código. |
/jogo dinheiro | veiculo | ban | Staff (nível 3) | Dá ou tira dinheiro, veículos e banimentos direto na cidade. |
/vendas listar | verificar | entregar | Staff (nível 3) | Pedidos da loja PIX: ver, conferir no Mercado Pago e forçar a entrega. |
/rankings ver | Todos | Rankings de call, ponto, atendimentos, avaliações, indicações e tickets. Staff: ajustar, resetar, enviar. |
/ponto ver | abertos | fechar | Todos / staff | Horas de bate-ponto, quem está em serviço e fechar o ponto de alguém. |
/convites | Todos | Quantas pessoas alguém trouxe e por qual convite a pessoa entrou. |
/limpar | Gerenciar mensagens | Apaga até 100 mensagens recentes do canal. |
/embed | Gerenciar mensagens | Publica uma mensagem no visual do servidor. |
/dm membro | cargo | Staff (nível 3) | Mensagem na DM de uma pessoa ou de todos com um cargo. |
/mensagem enviar | Gerenciar mensagens | Publica uma mensagem pronta agora. |
/relatorio dias: | Gerenciar servidor | Resumo do servidor nos últimos N dias. |
/configurar … | Administrador | Atalhos avançados. /configurar tabela-auto tem busca de tabelas para bancos grandes. |
Problemas comuns
As respostas cobrem 9 em cada 10 chamados. Se a sua não estiver aqui, mande um print do painel para a PowerCode.
Alguma coisa não funciona e não sei o quê
Rode /bot diagnostico. Ele lista cada problema, como permissão faltando, canal apagado, cargo do bot abaixo ou banco fora do ar, e diz como corrigir. Mande um print dele no suporte se precisar de ajuda.
O bot ficou offline de repente
Quase sempre é o token: alguém clicou em Reset Token no portal, e o antigo parou de valer. A loja avisa na sua DM. Gere um token novo e cadastre em /apps → Configurar token. Se o plano venceu, o bot fica pausado até a renovação (/renovar).
"Não consegui conectar: não encontrei esse endereço"
O host está com uma letra errada ou é um endereço interno do painel do seu provedor. Use o endereço externo do MySQL (o mesmo que você usaria no HeidiSQL ou DBeaver de casa).
"A porta está fechada ou o banco não aceita conexão de fora"
O banco existe, mas bloqueia o bot. Peça ao host para liberar o IP 85.209.93.110 no firewall do MySQL (ou "Remote MySQL" no cPanel). Se o provedor não permitir acesso externo, o bot não consegue ler o banco.
O comando /bot config não aparece
Só administradores veem. Confira em Configurações do servidor → Cargos se o seu cargo tem Administrador. Se o bot acabou de entrar, saia e volte no Discord para atualizar a lista de comandos.
"O bot não tem permissão neste canal"
Canais com @everyone bloqueado (anúncios, whitelist) precisam de uma exceção: Editar canal → Permissões → adicione o cargo do bot com Ver canal, Enviar mensagens e Inserir links.
O bot não dá o cargo ao liberar
O cargo do bot precisa estar acima do cargo que ele vai dar, em Configurações do servidor → Cargos. Arraste o Bot PowerCode para cima.
O painel de status fica 🔴 Offline com o servidor ligado
O bot lê http://ip:porta/dynamic.json. Teste no navegador: se não abrir de fora, a porta não está liberada ou o firewall do servidor bloqueia. Libere o IP 85.209.93.110.
Os botões do /bot config pararam de responder
O painel expira depois de ~15 minutos parado. Digite /bot config de novo — nada se perde.
A campanha de retorno não manda nada
O painel diz por quê: falta o campo de último login na tabela, ninguém está vinculado ainda, ou ninguém passou dos dias configurados. Use Testar em mim para ver a DM independente disso.
O apelido "Nome | ID" não muda para alguns
O Discord não permite que bots mudem o apelido do dono do servidor nem de quem tem cargo acima do bot. Para os demais, confira a permissão Gerenciar apelidos.
Boas-vindas, indicações ou bate-ponto "online" não funcionam
Esses recursos dependem dos três interruptores da aba Bot no portal do Discord (veja Criar o seu bot, passo 5). Ligue, salve e use /apps → Reiniciar na loja. Os painéis de Indicações e Bate-ponto avisam quando algum ainda está desligado.
O PIX foi pago e o jogador não recebeu
O bot confere os pagamentos a cada minuto, mesmo que o aviso do Mercado Pago atrase. Se ainda assim não entregar, use /vendas verificar com o número do pedido. Se o jogador não tinha vinculado o ID, dinheiro e veículo saem assim que ele vincular.
O comando de staff não aparece para a minha equipe
O Discord esconde comandos de moderação de quem não tem a permissão padrão. Libere em Configurações do servidor → Integrações → Bot PowerCode → escolha o comando → adicione o cargo.