Referência de comandos

Cada tabela que você cria ganha seu próprio comando de barra, com o nome da tabela, e estes subcomandos. Troque <table> pelo nome do comando da sua tabela, por exemplo /inventory.

Referência rápida

/<table> addEscrita

/<table> queryLeitura

/<table> updateEscrita

/<table> deleteAdmin

/<table> viewLeitura

/<table> leaderboardLeitura

/<table> saved-viewLeitura

/<table> bulk-updateAdmin

/<table> bulk-deleteAdmin

/<table> add

Escrita

Adiciona uma linha nova. Cada tabela ganha seu próprio comando com o nome da tabela, e cada coluna vira uma opção. As colunas obrigatórias aparecem primeiro e precisam ser preenchidas; as opcionais podem ficar de fora.

Sintaxe

/<table> add <column>:<value> <column>:<value> ...

Exemplo

/inventory add item:Diamond Sword quantity:3 rarity:Epic

•O usuário do Discord que rodou o comando fica salvo com a linha.
•O bot responde com uma confirmação e os valores que foram salvos.
•Cada plano tem um limite de linhas por tabela (100 no Free). O bot avisa quando uma tabela está cheia.

/<table> query

Leitura

Busca em uma tabela. Cada coluna é um filtro opcional; deixe todos de fora para listar as linhas.

Sintaxe

/<table> query [<column>:<value> ...] [limit:<1-25>]

Exemplo

/inventory query rarity:Epic limit:10

•Colunas de texto batem quando o valor contém o que você digitou. Os outros tipos de coluna precisam bater exatamente.
•Mostra 10 resultados por padrão, até 25.

/<table> update

Escrita

Altera uma linha existente. Escolha a linha na lista de preenchimento automático e informe só as colunas que quer mudar.

Sintaxe

/<table> update row:<row> <column>:<new_value> ...

Exemplo

/inventory update row:Health Potion quantity:9

•As colunas que você deixar de fora mantêm os valores atuais.
•Em tabelas com colunas de número, a opção _mode escolhe se os números são definidos, somados ou subtraídos.

/<table> delete

Admin

Exclui uma única linha. O bot pede para você confirmar com um botão antes.

Sintaxe

/<table> delete row:<row>

Exemplo

/inventory delete row:Rope

•As linhas excluídas somem da tabela na hora e são apagadas permanentemente depois de 30 dias.

/<table> view

Leitura

Mostra todas as colunas de uma única linha em um embed.

Sintaxe

/<table> view row:<row>

Exemplo

/inventory view row:Diamond Sword

•Também mostra quem criou a linha, quando ela foi criada e quando foi atualizada pela última vez.

/<table> leaderboard

Leitura

Ranqueia as linhas por uma coluna de número, da maior para a menor. Os três primeiros ganham medalhas.

Sintaxe

/<table> leaderboard column:<number_column> [limit:<1-25>]

Exemplo

/xp leaderboard column:XP limit:10

•Só é adicionado a tabelas com pelo menos uma coluna de número.
•Mostra 10 posições por padrão, até 25.
•Cada pontuação aparece ao lado da primeira coluna de texto ou de membro da linha.

/<table> saved-view

Leitura

Roda uma visualização salva que você configurou para a tabela no painel.

Sintaxe

/<table> saved-view name:<view> [limit:<1-25>]

Exemplo

/inventory saved-view name:Epic items

•Só é adicionado a tabelas com pelo menos uma visualização salva.

/<table> bulk-update

Admin

Altera uma coluna em todas as linhas onde outra coluna bate com um valor. Só nos planos Pro e Max.

Sintaxe

/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>

Exemplo

/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common

•O bot mostra quantas linhas batem e pede confirmação antes de mudar qualquer coisa.

/<table> bulk-delete

Admin

Exclui todas as linhas onde uma coluna bate com um valor. Só nos planos Pro e Max.

Sintaxe

/<table> bulk-delete filter:<column> value:<match>

Exemplo

/inventory bulk-delete filter:rarity value:Common

•O bot mostra quantas linhas batem e pede confirmação antes de excluir.

Comportamento geral dos comandos

Erros efêmeros — Erros de permissão e de validação aparecem só para quem rodou o comando (mensagens efêmeras), deixando os canais limpos.
Preenchimento automático — Colunas de opção mostram suas opções como uma lista de escolhas. As opções de linha e de visualização salva sugerem resultados enquanto você digita.
Limites de uso — Os comandos são limitados a 5 por usuário a cada 10 segundos para evitar abuso. Isso fica bem acima do uso normal.
Embeds — Todas as respostas usam embeds do Discord com formatação limpa. Os dados aparecem em tabelas ou em pares chave-valor, dependendo do comando.
Permissões — Enquanto você não atribuir cargos a uma tabela, todo membro pode rodar todos os comandos dela. Depois que os cargos são definidos, só membros com um dos cargos listados podem usar a tabela: Leitura cobre query, view, leaderboard e saved-view; Escrita adiciona add e update; Admin adiciona delete e os comandos em massa. Administradores do Discord sempre podem rodar tudo.
Comandos globais — /help lista as tabelas do seu servidor, /ping verifica se o bot está online e /delete-my-data exclui as linhas que você criou em todos os servidores.

Tabelas e esquemas Templates