> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Bots de Discord
> Hospede bots em Node.js (discord.js), TypeScript com build automático e Python (discord.py).
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.
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.
```js index.js theme={"dark"}
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);
```
```json package.json theme={"dark"}
{
"name": "meu-bot",
"main": "index.js",
"dependencies": {
"discord.js": "^14.16.0"
}
}
```
```json cube.json theme={"dark"}
{
"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.
```ts src/index.ts theme={"dark"}
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);
```
```json package.json theme={"dark"}
{
"name": "meu-bot-ts",
"scripts": {
"build": "tsc"
},
"dependencies": {
"discord.js": "^14.16.0"
},
"devDependencies": {
"typescript": "^5.6.0",
"@types/node": "^22.0.0"
}
}
```
```json tsconfig.json theme={"dark"}
{
"compilerOptions": {
"target": "ES2022",
"module": "commonjs",
"rootDir": "src",
"outDir": "dist",
"strict": true,
"esModuleInterop": true
}
}
```
```json cube.json theme={"dark"}
{
"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`.
```python main.py theme={"dark"}
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"])
```
```text requirements.txt theme={"dark"}
discord.py==2.4.0
```
```json cube.json theme={"dark"}
{
"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](/hosting/environment-variables), nunca no código. No painel: **Configurações** › **Variáveis de ambiente**. Pela API: [Definir variáveis](/api-reference/projects/set-variables).
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](https://discord.com/developers/applications), em **Bot**. Sem isso, o bot cai ao entrar com um erro de intents nos logs.
## Quando o bot cai
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.
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](/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](/account/plans).
## 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.