Tabelas e esquemas

As tabelas são o coração do CordBase. Cada tabela define um esquema que gera automaticamente comandos de barra para os membros do seu servidor.

Tipos de coluna

Toda coluna tem um tipo que define como os dados são validados, guardados e mostrados no Discord.

Texto

Texto livre. Use para nomes, descrições, anotações ou qualquer dado em texto.

No Discord:Um campo de texto padrão no comando de barra.
Exemplos:Espada de Diamante, Descrição da missão, Anotações do jogador

Número

Valores inteiros ou decimais. As colunas de número alimentam o comando de ranking e podem ser somadas com update. Ideal para pontuações, preços, quantidades e XP.

No Discord:Um campo de número com validação. Valores que não são números são recusados.
Exemplos:100, 3.5, -20

Data

Uma data, digitada como AAAA-MM-DD. Útil para prazos e datas de eventos.

No Discord:Um campo de texto com o formato AAAA-MM-DD indicado.
Exemplos:2026-03-27, 2026-12-31

Sim/não

Uma chave de verdadeiro/falso. Ótima para status como concluído, ativo, verificado ou pago.

No Discord:Uma escolha entre True e False.
Exemplos:true, false

Opção

Uma lista de opções predefinidas que você define ao criar a coluna. Perfeita para categorias, raridades, status e funções.

No Discord:Uma lista fixa de escolhas com as opções que você definiu (o Discord mostra até 25).
Exemplos:Comum / Raro / Épico / Lendário

Membro

Uma referência a um usuário do Discord. Fica salva como ID de usuário e aparece com o nome de usuário. Use para dono e atribuições.

No Discord:O seletor de usuários nativo do Discord, com preenchimento automático.
Exemplos:@Neo, @Player1

Configurações da coluna

  • Obrigatório — Quando ativado, o comando de barra exige este campo. Quando desativado, o campo é opcional e pode ficar em branco.

Editando o esquema de uma tabela

Você pode editar uma tabela depois de criada pelo painel. Abra a tabela e clique em Editar tabela.

  • Adicionar colunas — Colunas novas entram no fim do esquema. As linhas existentes ficam com valor nulo na coluna nova até serem atualizadas.
  • Renomear colunas — Muda o nome exibido no painel e nas respostas do bot. O nome da opção que os membros digitam continua o mesmo.
  • Remover colunas — Remove a coluna da tabela e dos comandos de barra dela.

As chaves e os tipos das colunas existentes ficam travados depois que a tabela é criada. Para mudar o tipo de uma coluna, adicione uma coluna nova e remova a antiga.

Depois que você salva as alterações, o CordBase registra de novo os comandos de barra no Discord. Isso leva alguns segundos para propagar.

Permissões por cargo

Cada tabela tem três níveis de permissão que podem ser atribuídos a cargos do Discord:

  • Leitura — Pode usar query, view, saved-view e leaderboard para ver os dados.
  • Escrita — Inclui as permissões de Leitura, mais add e update em qualquer linha.
  • Admin — Acesso total, incluindo delete, bulk-update e bulk-delete. Os comandos em massa exigem um plano Pro ou Max.

Enquanto você não atribuir cargos a uma tabela, todo membro pode rodar todos os comandos dela, inclusive delete. Assim que você atribuir qualquer cargo, membros sem um dos cargos listados não conseguem usar a tabela, então dê Leitura a um cargo que todo membro tem se a tabela deve continuar pública. Administradores do Discord sempre podem rodar tudo.