Bots de Discord

Um bot é um projeto do tipo bot: um processo que fica ligado e conversa com o Discord por conta própria. Ele não precisa de porta nem de endereço na internet.

Node.js
TypeScript
Python

Envie o código com o package.json. A Cube roda npm ci quando existe package-lock.json e npm install quando não existe.

const { Client, Events, GatewayIntentBits } = require('discord.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once(Events.ClientReady, (c) => console.log(`Logado como ${c.user.tag}`));

client.login(process.env.TOKEN);

{
  "name": "meu-bot",
  "main": "index.js",
  "dependencies": {
    "discord.js": "^14.16.0"
  }
}

{
  "name": "Meu bot",
  "language": "node",
  "version": "24",
  "command": "node index.js",
  "memoryMb": 100
}

Envie o package-lock.json junto. Com ele, a instalação usa exatamente as versões que você testou.

Não precisa compilar antes de enviar. Se o package.json tem um script build, a Cube roda o build depois de instalar as dependências. O comando de início aponta para o arquivo compilado.

import { Client, Events, GatewayIntentBits } from 'discord.js';

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once(Events.ClientReady, (c) => console.log(`Logado como ${c.user.tag}`));

client.login(process.env.TOKEN);

{
  "name": "meu-bot-ts",
  "scripts": {
    "build": "tsc"
  },
  "dependencies": {
    "discord.js": "^14.16.0"
  },
  "devDependencies": {
    "typescript": "^5.6.0",
    "@types/node": "^22.0.0"
  }
}

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "commonjs",
    "rootDir": "src",
    "outDir": "dist",
    "strict": true,
    "esModuleInterop": true
  }
}

{
  "name": "Meu bot TS",
  "language": "node",
  "command": "node dist/index.js",
  "memoryMb": 100
}

As devDependencies também são instaladas, então o typescript do projeto está disponível no build.
Sem script build, o painel sugere npx -p typescript tsc no campo Comando de build (em Avançado). Você pode trocar à vontade.
Não envie a pasta dist: ela é gerada aqui.
A saída do build aparece em Logs › Instalação. Build com erro deixa o projeto em Com erro e mostra o motivo ali.

Envie o código com o requirements.txt. A Cube cria o ambiente e roda pip install -r requirements.txt.

import os
import discord

intents = discord.Intents.default()
client = discord.Client(intents=intents)


@client.event
async def on_ready():
    print(f"Logado como {client.user}")


client.run(os.environ["TOKEN"])

discord.py==2.4.0

{
  "name": "Meu bot",
  "language": "python",
  "version": "3.12",
  "command": "python main.py",
  "memoryMb": 100
}

O print aparece nos logs na hora (a variável PYTHONUNBUFFERED já vem ligada).
Só o requirements.txt é instalado. Um projeto só com pyproject.toml precisa de um requirements.txt também.
Não envie o venv: ele é criado aqui.

O token do bot

Guarde o token numa variável de ambiente, nunca no código. No painel: Configurações › Variáveis. Pela API: Definir variáveis.

Se o token foi parar num .zip, num repositório ou num print, gere outro no Portal de Desenvolvedores do Discord. Um token vazado dá acesso total ao bot.

Intents privilegiados

Se o bot lê o conteúdo das mensagens ou a lista de membros, ligue os intents Message Content e Server Members no Portal de Desenvolvedores do Discord, em Bot. Sem isso, o bot cai ao entrar com um erro de intents nos logs.

Quando o bot cai

Planos pagos

O bot volta sozinho. Se cair de novo, a espera entre as tentativas cresce (1, 2, 4 e 8 segundos). Depois de 5 quedas seguidas, ele para e fica Em loop de erro, em vez de insistir sem fim. Rodar 60 segundos sem cair zera a contagem.

Plano Free

Sem reinício automático: se o processo cair, o projeto fica Com erro até você iniciar de novo.

Um bot que termina com código 0 (saída normal) fica Parado, sem reinício. Para sair do Em loop de erro, corrija o problema e clique em Iniciar ou Reiniciar.

No projeto com erro ou em loop, o botão Por que caiu? pede um diagnóstico para Cube AI a partir dos seus logs.

Memória

O mínimo de um bot é 100 MB. Comece pequeno e acompanhe o uso real no gráfico de Memória do projeto. A memória reservada é o teto: se o bot passar dela, o processo é encerrado (e, nos planos pagos, volta sozinho). Se o gráfico encosta no limite antes das quedas, aumente em Configurações › Geral, desde que caiba no seu plano.

O console é só leitura

Os logs mostram tudo o que o bot escreve, ao vivo. O processo não recebe comandos digitados: bots que esperam input() ou leem do teclado ficam parados esperando. Use comandos do próprio Discord ou variáveis de ambiente para configurar o bot.

Começando

Hospedagem

Conta e planos

Cube AI

Segurança

O token do bot

Intents privilegiados

Quando o bot cai

Planos pagos

Plano Free

Memória

O console é só leitura

​O token do bot

​Intents privilegiados

​Quando o bot cai

Planos pagos

Plano Free

​Memória

​O console é só leitura

O token do bot

Intents privilegiados

Quando o bot cai

Memória

O console é só leitura