1
Crie a sua conta
Abra o painel e clique em Criar conta. Toda conta nova começa no plano Free, com 100 MB de memória para 1 bot.Depois do cadastro, você cai na Visão geral do painel. Projetos e Chaves de API ficam na barra lateral, à esquerda. Minha conta, Plano e cobrança, Uso e Atividade ficam no menu da conta, que abre ao clicar no seu nome, no pé da barra.
2
Prepare o código
Um bot mínimo com discord.js tem dois arquivos. O token não fica no código: o bot lê da variável de ambiente Não precisa enviar a pasta
TOKEN.node_modules: a Cube instala as dependências do package.json para você.3
Adicione um cube.json (opcional)
Com um Sem
cube.json na raiz, o painel já sabe tudo sobre o projeto. Sem ele, o painel detecta sozinho e você confere antes de enviar.cube.json
memoryMb, o bot entra com o mínimo do plano: 100 MB no Free e 256 MB nos pagos. Veja todas as chaves em O arquivo cube.json.4
Compacte em .zip
Compacte o conteúdo da pasta, sem No Windows, o comando leva só o que está na lista. Acrescente os outros arquivos do seu bot, separados por vírgula (o
node_modules, .git e o seu .env.cube.json, se você criou). Se o bot tem pastas, ponha o nome delas na lista também, como src: o Compress-Archive leva a pasta com o que está dentro. Ou compacte pelo Explorador de Arquivos: selecione o que está dentro da pasta do bot, menos node_modules e o .env, clique com o botão direito e escolha a opção de compactar em ZIP.No Free, o
.zip pode ter até 5 MB; nos planos pagos, até 10 MB. Veja Limites do .zip.5
Envie pelo painel
Em Projetos, clique em Novo projeto e arraste o
.zip na área Arraste o .zip aqui ou clique para escolher.O painel lê o arquivo ali mesmo, antes de enviar, e abre a tela Configure o projeto:- Ambiente detectado: o que o painel achou, em cápsulas: a linguagem e a versão, JavaScript ou TypeScript, como instalar as dependências e se o projeto é publicado na web.
- Publicação na web: desligada num bot (ele roda sem endereço); ligada num site ou API, só com o Subdomínio (o app recebe a porta na variável
PORT). - Versão: Recomendada (a padrão da Cube) ou Mais recente.
- Arquivo principal, com Detectar automaticamente marcado.
- Comando personalizado, desligado: ligue só se o projeto precisa de um comando especial para iniciar ou instalar. Aí aparecem o Comando de início e o Comando de instalação.
- Memória e Variáveis de ambiente (dá para importar um
.env). - Avançado: a linguagem, se a detecção errar, e o comando de build.
- Iniciar assim que terminar, ligado por padrão.
6
Guarde o token
Abra o projeto e vá em Configurações › Variáveis de ambiente. Adicione a variável
TOKEN com o token do bot e salve. O nome da variável é o que o seu código lê: se o seu bot usa process.env.DISCORD_TOKEN, crie a variável como DISCORD_TOKEN.O valor fica cifrado e nunca mais aparece no painel. Se você tiver um arquivo .env, use Importar .env para colar tudo de uma vez.7
Inicie e veja os logs
Clique em Iniciar. O status muda para No ar e, na aba Logs, em Aplicação, aparece a linha:Pronto, o bot está no ar.
E se algo der errado?
As mensagens mais comuns, com o que significam e como corrigir, estão em Solução de problemas. As três de sempre:O status ficou "Com erro" logo depois de instalar
O status ficou "Com erro" logo depois de instalar
Abra Logs › Instalação. Lá aparece a saída do
npm install ou do pip install. Na maioria das vezes é uma dependência com nome errado ou uma versão da linguagem diferente da que o projeto pede.O bot inicia e cai em seguida
O bot inicia e cai em seguida
Abra Logs › Aplicação e procure a última mensagem de erro. Token ausente ou errado é o motivo mais comum: confira a variável
TOKEN em Configurações › Variáveis de ambiente. Você também pode clicar em Por que caiu? e Cube AI explica com base nos seus logs.O painel diz que falta memória
O painel diz que falta memória
A soma da memória de todos os seus projetos não pode passar a do plano. Diminua a memória de outro projeto ou veja os planos.
Próximos passos
Bots de Discord
TypeScript, Python e dicas para bots maiores.
Bot em Python (discord.py)
O mesmo passo a passo com
requirements.txt e main.py.Bot online 24 horas
As formas de deixar um bot ligado e o que mantém o seu no ar.
Envie pela API
Faça o mesmo deploy com um comando, do seu computador ou do CI.

