NOVO 📢 Black Friday: a oferta de lançamento termina em 30/11. Até 70% de desconto no seu primeiro mês!Ver planos
Black FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 min

Como hospedar um bot Pycord 24/7

Hospedagem de bot do DiscordAtualizado 6/11/202610 min de leitura

Para hospedar um bot Pycord 24/7, rode-o em uma máquina que fique sempre ligada em vez de no seu PC: um VPS Linux com um serviço systemd, se você mesmo hospeda, ou um plano de bots na hospedagem de bots do Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu código, cola o token e clica em Iniciar. Em nosso teste, um bot com Pycord 2.8.1 usou cerca de 51 MB de memória e chegou ao Discord cerca de 1,1 segundo depois de ser iniciado. O Pycord é instalado como py-cord, mas você o importa como discord, o mesmo nome do discord.py, então liste só uma das duas. Os passos na PlayNHost:

  1. Na página de hospedagem de bots do Discord, clique em Criar servidor em um plano. Na janela do pedido, responda Para qual plataforma é o seu bot? com Discord e escolha Python.
  2. Abra seu servidor no painel. O cartão Configurar seu bot na Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve dizer Este bot roda Python Bot.; clique nesse passo para conferir e depois em Continuar.
  3. Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
  4. Em Permissões, marque Meu código usa isto apenas para os intents privilegiados que seu código pede (o bot abaixo não precisa de nenhum), clique em Adicionar a um servidor do Discord e depois em Continuar.
  5. Em Seu código, clique em Enviar arquivos e envie bot.py e um requirements.txt que liste py-cord, ou clique em Conectar o Git.
  6. Se o seu arquivo principal não for bot.py, defina o Arquivo de entrada na página Bot, painel Código, e clique em Salvar.
  7. Clique em Iniciar bot e acompanhe o Console. Quando seu bot imprimir Logged in as ..., o cartão mostra Seu bot está online no Discord.

Os passos gerais de Python (runtime, pacotes, linhas do console) estão em Como hospedar um bot do Discord em Python. Esta página cobre o que muda com o Pycord.

O que medimos

Rodamos cada biblioteca de Discord para Python em nossos próprios servidores, na mesma configuração com Python 3.12 que um plano de bots usa, com limite de memória de 1 GB:

BibliotecaVersãoMemória em repousoDo início à resposta do Discord
Pycord2.8.151 MB1.1 s
discord.py2.7.148 MB1.0 s
nextcord3.2.047 MB1.0 s
disnake2.12.247 MB0.9 s
hikari2.7.061 MB1.3 s
Só o Python3.129 MB

Como: o menor programa que carrega a biblioteca e faz login com um token falso, instalado do jeito que nossos servidores instalam. A memória é a que o processo ocupava 15 segundos depois de o Discord recusar o token, e o tempo de início vai do lançamento até essa resposta, então inclui uma ida ao Discord. Cada valor é a mediana de três execuções após uma execução de aquecimento. É o piso: um bot que já conectou, entrou em servidores e guardou membros em cache usa mais, em uma quantidade que depende do bot.

O que isso significa para o plano: um bot Pycord mínimo ocupa cerca de um décimo do plano STARTER de 0,5 GB. Dimensione o plano pelo que o seu próprio bot guarda na memória, não pela biblioteca.

Um bot Pycord mínimo

Ele responde a /ping com um slash command e imprime uma linha de pronto. Lê o token de DISCORD_TOKEN, o nome que o painel dá ao seu código.

requirements.txt

py-cord>=2.8,<3

bot.py

import os

import discord

bot = discord.Bot()


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
    await ctx.respond("Pong!")


bot.run(os.environ["DISCORD_TOKEN"])

discord.Bot é a classe própria do Pycord para slash commands. Ela registra /ping no Discord sozinha a cada conexão, porque auto_sync_commands vem ativado por padrão, então não há etapa de sincronização para escrever. A linha Logged in as é o que muda o chip na Visão geral para Online no Discord.

Se o token estiver errado

Quando o Discord recusa o token, o Pycord gera este erro (o texto que nosso bot de teste imprimiu):

LoginFailure: Improper token has been passed.

Com bot.run(), um traceback termina com discord.errors.LoginFailure: Improper token has been passed. e o bot para. O painel lê essa linha: o chip mostra Problema no token e um banner diz O Discord não aceitou o token do seu bot. Gere um novo token no Discord Developer Portal: sua aplicação, Bot, Reset Token (ele é mostrado uma única vez). Clique em Substituir o token no banner, depois em Substituir token no painel Discord, cole-o e inicie o bot de novo. Veja Como criar um bot do Discord e obter o token.

O que um host precisa saber sobre o Pycord

  • O nome de instalação e o de importação são diferentes. Você instala py-cord e escreve import discord. O discord.py instala um módulo com o mesmo nome, discord, então os dois não podem coexistir. O guia do próprio Pycord manda desinstalar o discord.py primeiro e avisa que desinstalar o discord.py depois de instalar o py-cord pode causar problemas.
  • Mover um servidor do discord.py para o Pycord. Nossos servidores instalam pacotes em uma pasta .local e nunca removem um que você tira do requirements.txt, então o discord.py ficaria ao lado do Pycord. Em Files, apague a pasta .local e o arquivo .pnh/packages.state e depois clique em Iniciar: tudo que está no requirements.txt é instalado de novo, sem o discord.py.
  • Versão do Python. O Pycord 2.8.1 oferece suporte ao Python 3.10 a 3.14. O Runtime no painel Código oferece exatamente essas versões, com 3.12 como padrão, então qualquer escolha funciona.
  • Intents. discord.Bot() usa os intents padrão, que não incluem nenhum privilegiado, e os slash commands não precisam de nenhum. Comandos com prefixo, como !ping, precisam de intents.message_content = True no seu código e do Message Content Intent ativado no Developer Portal. Se o seu código o pede enquanto ele está desativado no Portal, o Discord recusa o login. Veja Corrigir "Used disallowed intents" no seu bot do Discord.
  • Deixe o on_connect livre. O registro automático roda no on_connect do próprio bot. Se você definir on_connect por conta própria, a documentação do Pycord manda chamar await bot.sync_commands() dentro dele, ou seus comandos deixam de ser atualizados. Coloque o código de inicialização em on_ready, como acima.
  • O logging fica desligado a menos que você o ligue. O run() do Pycord não configura o logging, então o Python mostra só os avisos e erros da biblioteca, não as linhas de informação dela, como o login. Imprima sua própria linha de pronto, como acima, ou chame logging.basicConfig(level=logging.INFO) para ver o que a biblioteca está fazendo.
  • Voz. Para canais de voz, escreva py-cord[voice] no requirements.txt em vez de py-cord.

Hospede você mesmo em um VPS Linux

No Debian ou no Ubuntu, instale o Python, crie um usuário e uma pasta para o bot e instale o Pycord em um ambiente virtual:

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt

Coloque o token em um arquivo que só o root possa ler. Crie /etc/pycord-bot.env com sudo nano /etc/pycord-bot.env, escreva uma linha, DISCORD_TOKEN= seguido do seu token, salve e execute sudo chmod 600 /etc/pycord-bot.env.

Depois crie /etc/systemd/system/pycord-bot.service:

[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target

[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-bot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Inicie-o agora e a cada boot, e depois acompanhe a saída:

sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f

PYTHONUNBUFFERED=1 faz o print() chegar ao journal na hora, em vez de só quando um buffer enche. Para atualizar o bot, copie os novos arquivos, execute a linha do pip install de novo e sudo systemctl restart pycord-bot.

Hospedagem própria ou plano de bots

Seu próprio VPSUm plano de bots da PlayNHost
PythonA versão que a sua distribuição traz; você instala e atualizaEscolha de 3.10 a 3.14 em Runtime
PacotesVocê executa pip install a cada mudançaInstalados em uma inicialização depois que requirements.txt ou a versão do Python mudam, e na primeira inicialização um dia após a última instalação
ReiníciosSua unidade systemdIniciado de novo após uma falha; deixado parado, com o motivo, se falhar outra vez em menos de um minuto
O tokenUm arquivo que você protege por conta própriaGuardado criptografado, verificado no Discord quando você o cola e entregue ao seu código como DISCORD_TOKEN
ErrosVocê lê o journalO banner do console indica a causa, como um token errado ou um intent ausente
Atualizações do sistema, firewall, SSHFicam por sua contaNão é tarefa sua

Perguntas frequentes

Posso ter o Pycord e o discord.py no mesmo bot?

Não. Os dois instalam o módulo discord, então um sobrescreve o outro. Mantenha só o py-cord no requirements.txt. Se o servidor rodava o discord.py antes, apague .local e .pnh/packages.state em Files para que os pacotes sejam instalados de novo do zero.

Por que o /ping não aparece no meu servidor?

Confira se o bot foi adicionado com Adicionar a um servidor do Discord e se o console mostra a linha Logged in as: o Pycord registra o comando quando se conecta. Enquanto você testa, passe debug_guilds=[your_server_id] para discord.Bot(): os comandos são então criados só nesse servidor e, segundo a documentação do Discord, comandos de servidor são atualizados na hora.

O Pycord é o mesmo que o discord.py?

Não. O Pycord começou como um fork do discord.py e mantém boa parte da API dele, como discord.Client e discord.ext.commands, mas os slash commands são diferentes: @bot.slash_command e ctx.respond() no Pycord, app_commands e uma chamada de sincronização no discord.py. O código escrito para um nem sempre roda no outro.

Um bot Pycord cabe no menor plano?

Sim. Com cerca de 51 MB em nosso teste, um bot Pycord mínimo usa cerca de um décimo do plano STARTER de 0,5 GB. Suba de plano quando o seu bot precisar: servidores grandes cujos membros ele guarda em cache, arquivos ou imagens que ele processa, ou dados que ele mantém na memória.

Pronto para rodar o seu? Escolha um plano na hospedagem de bots do Discord e envie seu bot Pycord.

Seu bot já está em outro lugar? Traga-o para nós

NOSSOS ÚLTIMOS ARTIGOS