Skip to main content
Um template é um projeto pronto, mantido pela Cube. Você escolhe, dá um nome, preenche o que ele pede (como o token do bot) e a Cube instala e inicia. O código vem inteiro nos arquivos do projeto, com um README.md explicando cada parte, para você mudar como quiser.

Os templates

  • Bot discord.js e Bot discord.py: o comando /ping, pronto para você criar os seus.
  • Bot de música: /tocar toca um link direto de áudio (mp3, ogg, wav…) ou de uma rádio online no seu canal de voz, e /parar sai. O FFmpeg já vem instalado. Toque só o que você tem direito de tocar.
  • Bot com PostgreSQL: /anotar guarda uma anotação e /notas mostra as suas 10 últimas. O banco de dados é criado junto e a conexão chega pronta na variável DATABASE_URL. Precisa de um plano com banco (a partir do Stack) e de memória livre para os dois.
  • API Express e API FastAPI: GET / e GET /health em JSON, num endereço https://<nome>.cubehost.dev. No FastAPI, a documentação interativa fica em /docs.
  • Site estático: HTML e CSS sem dependência nenhuma. Troque a pasta public pelo seu site.
Os bots rodam em qualquer plano, inclusive no Free: lá, a memória é cortada no que cabe no plano (100 MB). Os sites e APIs são dos planos pagos.

Usar um template

1

Escolha o template

No painel, clique em Templates na barra lateral e em Usar este template. Ou abra Novo projeto e escolha a aba Template.
2

Confira e preencha

Dê um nome, ajuste a memória (a sugerida já vem marcada) e, num site, escolha o subdomínio. Cole o valor de cada variável que o template pede: o link Como pegar ao lado do nome ensina onde achar.
3

Criar projeto

A Cube instala as dependências e, com Iniciar assim que terminar ligado, o projeto sobe sozinho.
Sem uma variável obrigatória, como o DISCORD_TOKEN, o projeto instala e fica parado: sem o token, o bot só cairia. Ele também não inicia depois, até a variável ter valor. O painel pede o que falta no fim do Novo projeto e no topo da aba Projeto. Cole o valor e clique em Salvar e iniciar.
Depois de criado, o projeto é como qualquer outro: edite o código na aba Arquivos e clique em Aplicar mudanças, troque as variáveis de ambiente e acompanhe tudo em Logs e métricas. Se você trocar o código por outro .zip ou pelo GitHub, o projeto deixa de ser do template, e a Cube para de pedir as variáveis dele.

Como pegar o token do bot

1

Crie o aplicativo

Entre no Portal de Desenvolvedores do Discord e clique em New Application. Dê um nome e aceite os termos.
2

Gere o token

No menu Bot, clique em Reset Token e copie o valor. Ele aparece uma vez só: cole direto no campo DISCORD_TOKEN da Cube.
3

Convide o bot

Em OAuth2 › URL Generator, marque bot e applications.commands, escolha as permissões (para o bot de música, Connect e Speak), abra o link gerado e escolha o seu servidor.
O token dá acesso total ao bot. Guarde só nas variáveis de ambiente, nunca no código nem em print. Se ele vazar, gere outro no mesmo lugar e troque na Cube.
Os templates usam só os intents padrão: não precisa ligar Message Content nem Server Members. Os comandos de barra aparecem no servidor logo depois de o bot entrar; se demorar, feche e abra o Discord.

Bot com PostgreSQL

O painel cria o banco antes do projeto, com o nome que você escolher (sugerido: discord-postgres-db), e liga a conexão na variável DATABASE_URL. Ao iniciar, o bot espera o banco aceitar conexões e cria a tabela notes se ela ainda não existe. O banco aparece em Bancos de dados, com a conexão, o uso e o backup diário. A memória do banco sai do plano junto com a do bot: no Stack (2 GB), o banco de 512 MB e o bot de 192 MB deixam o resto livre para outros projetos.

Pela API

A lista, com o que cada template pede, está em Listar templates (GET /templates, sem chave). Para criar, mande template no lugar do file em Criar um projeto, com as variáveis em variables:
A resposta traz missingVariables: as obrigatórias que não vieram. Com alguma, o projeto instala e fica stopped mesmo com start=true, e iniciar responde 409 missing_variables até ela ter valor. Defina depois em Definir variáveis e inicie. Sem memoryMb, vale a memória sugerida do template, cortada no que sobra no plano (nunca abaixo de 100 MB num bot): no Free, o Bot discord.js entra com 100 MB. Para escolher, mande memoryMb. Para o Bot com PostgreSQL, crie o banco antes e mande o id dele em databaseId: a conexão entra na DATABASE_URL antes da primeira subida.