Bots personalizados | Documentação do Noxyr

O que é um bot personalizado

Um bot personalizado é o Noxyr rodando com um token de bot que você possui. Os membros veem o seu nome e o seu avatar, mas o código, as configurações e o banco de dados são do Noxyr - uma mudança feita no painel vale para os dois bots, e nada é duplicado.

O Noxyr hospeda o bot para você em um dos seus nós. Exatamente um bot é dono de cada servidor: onde o seu bot personalizado está presente, o Noxyr sai de cena e para de responder; onde ele não está, o Noxyr continua como antes. Uma conta do Discord tem direito a um bot personalizado, e você pode usar esse mesmo bot em quantos servidores quiser gerenciar.

O que você precisa

Um voto no Top.gg: Votar no Noxyr desbloqueia o formulário de configuração por 12 horas. Esse é todo o custo - não existe plano pago.
Seu próprio aplicativo: Crie um no Portal de Desenvolvedores do Discord. O token do Noxyr é recusado, e um token de usuário também.
Dois intents privilegiados: Os intents de Membros do Servidor e de Conteúdo de Mensagem precisam estar ativados em Bot → Privileged Gateway Intents. O painel verifica isso antes de aceitar o token.
O Noxyr no servidor: Seu bot personalizado roda com as configurações e o banco de dados do Noxyr, então o Noxyr precisa continuar em todos os servidores que ele atende.
Administrador: Só quem consegue abrir o servidor no painel pode configurar um bot personalizado para ele.

Como configurar

Vote no Noxyr no Top.gg e depois abra Bot personalizado no painel do servidor.
No Portal de Desenvolvedores, clique em Nova Aplicação e dê o nome que o bot deve ter. Na aba Bot, defina o avatar e ative os dois intents privilegiados.
Clique em Redefinir token, copie-o uma vez e cole-o na página Bot personalizado. Ele é armazenado criptografado; só o site e o nó que executa o seu bot podem lê-lo.
Escolha um host (Automático escolhe o nó mais rápido com espaço) e clique em Start my bot.
Use o link de convite que a página fornece. O bot fica online em cerca de vinte segundos e registra os comandos do Noxyr com o seu nome.

Só a pessoa que colou o token pode substituí-lo depois. Outros administradores do servidor podem ver o bot, mas não podem trocar por outro token em seu nome.

Janela de voto, período de carência e lembretes

Um voto mantém o bot personalizado desbloqueado por 12 horas, que também é a frequência com que o Top.gg permite votar. Quando essa janela fecha, começa um período de carência de 74 horas: o bot continua rodando, mas a página Bot personalizado fica bloqueada até você votar de novo.

Um lembrete por DM chega 24 horas após o seu último voto - 12 horas dentro do período de carência - com uma contagem regressiva até o corte. Se o período de carência também acabar, o bot fica offline e os comandos dele são removidos do servidor. Nada é apagado: o token, as configurações e todos os tickets, produtos e faturas continuam exatamente onde estavam, e um voto liga tudo de novo.

Janela de voto: 12 horas a partir do voto. Os dois cronômetros aparecem em contagem regressiva ao vivo na página Bot personalizado.
Período de carência: 74 horas após a janela fechar. Bot ligado, painel bloqueado.
Lembrete por DM: Enviado uma vez por janela, 24 horas após o voto.
Desligado: Depois do período de carência. Vote de novo e o bot reinicia sozinho.

Mais tempo sem votar

Votos não são a única forma de manter um bot personalizado rodando. Cada opção abaixo soma horas ao tempo que você ainda tem, então nada se perde, e a página Mais tempo (Bot personalizado → Mais tempo) mostra sua contagem regressiva, como você está em cada opção e todas as horas que foram creditadas a você.

Noxyr Rush: Um minijogo no navegador, no site. Faça 3,000 pontos em uma partida e ganhe 12 horas. Você pode guardar até 12 horas de jogo de cada vez; quando elas acabarem, pode ganhar mais. Só contas que rodam um bot personalizado ganham tempo, e o servidor verifica cada partida.
Convide um amigo: Compartilhe seu link de indicação na página Mais tempo. Quando o amigo configurar o primeiro bot personalizado dele, vocês dois ganham 12 horas. Conta uma vez por amigo, a conta do Discord dele precisa ter pelo menos 30 dias, e você pode ganhar com até 10 amigos a cada 30 dias.
Relatos de bugs e sugestões: Envie um pelo Centro de Suporte. Quando a equipe do Noxyr aprovar, você ganha 12 horas, uma vez por relato.
Da equipe: A equipe do Noxyr pode adicionar tempo diretamente, por exemplo depois de uma queda.

Se o Noxyr for removido do servidor

Como o bot personalizado depende da presença do Noxyr, expulsar o Noxyr faz o bot personalizado parar naquele servidor em cerca de um minuto. O bot envia DM para quem removeu o Noxyr e, se for outra pessoa, também para o dono do bot, com um link de convite.

Convide o Noxyr de volta e o bot personalizado começa de novo sozinho. Enquanto estiver parado por esse motivo, a sua janela de voto fica pausada em vez de ser gasta, desde que nenhum outro bot seu ainda esteja rodando.

Passando sua janela de voto para outra pessoa

Quem vota e a pessoa dona do bot não precisam ser a mesma conta. Pela página Bot personalizado você pode passar sua janela restante para outro usuário do Discord pelo ID dele, seja toda ela ou um número de horas.

O tempo é somado ao que a pessoa já tem, então uma transferência nunca a deixa em pior situação. Você mantém seu período de carência, assim o seu próprio bot não para no meio. Os dois recebem uma DM dizendo o que foi movido.

Só uma janela ativa pode ser transferida - quando você está no período de carência não há mais nada para dar. Transferências de menos de cinco minutos são recusadas.

Solução de problemas

"O Discord rejeitou este token" (código de gateway 4004): O token foi redefinido no Portal de Desenvolvedores, então o antigo não funciona mais. O bot fica desligado até você clicar em Redefinir token de novo e colar o novo na página Bot personalizado.
"O Discord recusou a conexão" (código de gateway 4013 / 4014): Um intent privilegiado foi desativado depois da configuração. Ative de novo os intents de Membros do Servidor e de Conteúdo de Mensagem e depois ligue o bot novamente pelo painel.
"Vote no Top.gg primeiro": Sua janela de voto acabou. Vote e tente de novo - a página é desbloqueada na hora.
"Esse bot já é o bot personalizado do servidor de outra pessoa": Uma aplicação pertence a um único dono. Crie uma nova aplicação para você.
"Você já tem …": Uma conta, um bot personalizado. Use o bot existente também neste servidor (a página oferece essa opção) ou exclua-o antes.
Mudar de nó está desativado: Cada mudança exige um novo login no Discord, então há um intervalo de cinco minutos entre as mudanças.
O status mostra "suspenso": Ou o voto e o período de carência acabaram, ou o Noxyr foi removido do servidor. A mensagem de status na página indica qual dos dois.