Pular para o conteúdo principal

​
Visão geral

Uma mensagem com páginas é uma única mensagem do Petto que guarda até 25 páginas, com botões embaixo para ir de uma a outra. Serve para regras divididas em seções, um guia, uma lista de cargos ou qualquer coisa longa demais para um só embed. !pagination (também !pn e !pages) é um comando de prefixo. Ele precisa de Gerenciar mensagens no canal da mensagem, e reset precisa de Administrador.
Só as mensagens que o Petto enviou podem ter páginas: um bot não pode editar as mensagens de outros bots ou membros. Publique uma nova com !pagination create, ou use uma enviada com !embed send.
Onde um comando pede <message>, dê qualquer um destes:
  • O link da mensagem (clique com o botão direito ou toque e segure na mensagem, depois Copiar link da mensagem).
  • #canal seguido do ID da mensagem.
  • Só o ID da mensagem, quando a mensagem está no canal em que você está digitando.
  • Nada, quando você responde à mensagem com o comando.

​
Configuração

1

Comece a mensagem

Publique uma mensagem nova com a primeira página, aqui ou em outro canal:
Sintaxe
Ou transforme uma mensagem que o Petto já enviou na página 1, do jeito que ela está agora:
Sintaxe
Exemplo
liam usa !pagination create no canal de regras com regras_gerais e o Petto responde que publicou a mensagem, com o comando add para usar depois

No Discord: !pagination create publica a página 1 e diz como adicionar a próxima.

liam usa !pagination set com o link de uma mensagem e o Petto confirma que agora é a página 1 de uma paginação

No Discord: !pagination set transforma uma mensagem que o Petto enviou na página 1.

2

Adicione as próximas páginas

Cada página vai para o final. Repita para cada página que quiser, até 25.
Sintaxe
Exemplo
liam adiciona a página 2 com um embed salvo e a página 3 com um código, e o Petto confirma cada uma

No Discord: !pagination add com um embed salvo e depois com um código de embed.

3

Mude uma página

Coloca outro embed ou código em uma página pelo número dela. edit funciona igual a update.
Sintaxe
Exemplo
liam muda a página 2 e o Petto responde que a página 2 mudou

No Discord: !pagination update coloca outro embed na página 2.

4

Remova uma página

Tira uma página pelo número dela. A única página que sobra não pode ser removida: use delete para parar a paginação.
Sintaxe
Exemplo
liam remove a página 3 e o Petto diz que restam 2 páginas

No Discord: !pagination remove tira a página 3 e diz quantas restam.

kira tenta remover a única página e o Petto responde em vermelho com o comando delete para usar no lugar

No Discord: a única página não pode ser removida: o Petto indica delete.

Depois de qualquer mudança a mensagem volta para a página 1, com o novo número de páginas.

​
Comandos relacionados

Os botões saem e a mensagem fica com a página que está mostrando. Adicione --message para apagar a mensagem também. del funciona igual a delete.
Sintaxe
liam para uma paginação e o Petto diz que a mensagem não tem mais páginas e fica com a que mostrava

No Discord: !pagination delete tira os botões; a mensagem fica com sua página.

liam usa !pagination delete com --message e o Petto confirma que a mensagem foi apagada

No Discord: com --message a mensagem também é apagada.

Só administradores. O Petto pergunta antes com um botão Parar todas; as mensagens ficam com a página que mostram.
Sintaxe
liam usa !pagination reset e o Petto pergunta em vermelho se para as 2 mensagens com páginas, com botões para parar e cancelar

No Discord: !pagination reset pergunta antes, com um botão para parar todas.

A pergunta muda para Pronto: 2 mensagens com páginas paradas

No Discord: depois do clique: todas as paginações param.

Todas as mensagens com páginas do servidor com o canal, o número de páginas, se são privadas e um link, 10 por página.
Sintaxe
O Petto lista duas mensagens com páginas: regras com 3 páginas e guia-do-servidor com 7 páginas privadas

No Discord: !pagination list: cada mensagem com o canal, as páginas, se é privada e um link.

As páginas em ordem (o embed salvo de cada uma, ou que é um código), o tipo e se é compartilhada ou privada. show e info funcionam igual a view.
Sintaxe
O Petto mostra as 4 páginas de uma mensagem: três embeds salvos e um código, compartilhadas

No Discord: !pagination view: as páginas em ordem e o tipo.

Sintaxe
Exemplo
liam move a página 5 para o lugar 2 e o Petto confirma

No Discord: !pagination move: a página 5 vira a página 2.

Veja Compartilhado ou privado.
Sintaxe
liam deixa uma paginação privada e o Petto explica o que isso faz

No Discord: !pagination mode private: cada clique mostra a página só para quem clicou.

Mostra de novo a página 1 com os botões, para quando eles foram tirados ou a mensagem foi mudada com outra coisa (como !editembed). restorereactions e rr funcionam igual a restore.
Sintaxe
liam restaura uma paginação e o Petto diz que os botões voltaram, mostrando a página 1

No Discord: !pagination restore coloca os botões de volta na página 1.

​
Como os botões funcionam

O Petto usa botões, não reações, então não precisa de Adicionar reações, a página atual sempre aparece e os botões continuam funcionando depois que o Petto reinicia.
A primeira página de regras do Petto com os botões voltar, Página 1/3 e próxima embaixo

No Discord: três páginas: ◀ Página 1/3 ▶.

A mesma mensagem agora mostra a página de canais de voz e Página 2/3

No Discord: um clique em ▶ passa a mensagem para a página 2 para todos.

Um guia de 7 páginas com os botões primeira, voltar, Página 1/7, próxima e última, e o menu de pular aberto com as 7 páginas

No Discord: sete páginas: botões de primeira e última, e o menu para pular para uma página.

O botão Página X/Y só mostra onde você está e não pode ser clicado. Qualquer pessoa que vê a mensagem pode passar as páginas.

​
Compartilhado ou privado

  • Compartilhado (o padrão): um clique passa a página da própria mensagem, para todos. As variáveis de uma página compartilhada são preenchidas com o membro que criou a paginação, então a mensagem não muda a cada pessoa que clica. Bom para uma mensagem que um moderador apresenta.
  • Privado (--private em create ou set, ou !pagination mode <message> private): um clique mostra a página só para quem clicou, como uma mensagem que só essa pessoa vê, com as variáveis preenchidas para ela. Os botões dela continuam passando essa cópia, e a mensagem do canal fica na página 1. Bom para regras ou um guia que muita gente lê ao mesmo tempo.
O guia no canal fica na página 1 enquanto Mia recebe a página 2 como uma mensagem que só ela vê

No Discord: em uma mensagem privada um clique responde com uma cópia que só aquele membro vê.

​
O que uma página pode ser

Onde um comando pede <embed or code>:
  • O nome de um embed salvo, como regras_gerais (uma só palavra, veja Embeds). Ele é desenhado toda vez que a página aparece, então as variáveis são preenchidas nessa hora e uma mudança no embed salvo aparece na página na mesma hora.
  • Um código de embed, como {embed}$v{title: ...}$v{description: ...}, lido do mesmo jeito que em !embed create e !editembed. O que não pode ser usado é avisado.
  • Um código p2., um design Components V2 copiado do dashboard ou do Embed Builder.
Com !pagination set, a página 1 é o que a mensagem já mostra.
Um só tipo por mensagem. O Discord não consegue transformar uma mensagem clássica (texto e embeds) em uma de Components V2 nem o contrário, então todas as páginas de uma mensagem são embeds clássicos ou todas são designs V2, conforme a primeira página. O Petto recusa uma página do outro tipo. Se um embed salvo usado por uma página for mudado depois para o outro tipo, essa página mostra um erro até você mudá-la com update.
liam adiciona rules_v2 a uma mensagem de embeds e o Petto responde em vermelho que uma mensagem não pode misturar os dois tipos

No Discord: um design V2 recusado em uma mensagem de embeds clássicos.

Uma página clássica mantém no máximo 3 linhas dos próprios botões de link, porque os botões de página e o menu para pular ocupam as outras duas.

​
Limites

Quando um servidor chega ao número dele, create e set avisam; pare uma com delete para abrir espaço. Veja Premium.
liam tenta criar mais uma e o Petto diz que o servidor tem suas 25 mensagens com páginas, e o Premium dá 50

No Discord: um servidor grátis com suas 25 mensagens com páginas.

​
Dashboard

No dashboard, a página Embeds tem uma seção Mensagens com páginas embaixo do editor.
  • A lista mostra cada mensagem com páginas com o canal, as páginas em ordem, uma etiqueta Privado ou V2 e Abrir no Discord. Cada uma tem Colocar os botões de volta, Parar (tira os botões, a mensagem fica) e Apagar mensagem (apaga do Discord).
  • Nova mensagem com páginas cria uma a partir de embeds salvos: escolha um Canal, escolha o embed salvo de cada página em Páginas, em ordem (com Adicionar uma página, Subir, Descer e remover), marque Páginas privadas se quiser e aperte Publicar.
Três mensagens com páginas: regras com 4 páginas, guia-do-servidor com 7 páginas privadas e uma V2 em anúncios, cada uma com Colocar os botões de volta, Parar e Apagar mensagem

Dashboard → Design → Embeds → Mensagens com páginas: cada mensagem com o canal, as páginas e as etiquetas, e seus três botões.

O construtor com o canal guia-do-servidor, três páginas em ordem com botões de mover e remover, a caixa Páginas privadas e o botão Publicar

Dashboard → Design → Embeds → Nova mensagem com páginas: o canal, o embed salvo de cada página, Páginas privadas e Publicar.

O dashboard precisa do mesmo Gerenciar mensagens que o comando. Códigos de embed, códigos p2. e mudar uma página de cada vez são feitos com o comando.

​
Problemas comuns

A mensagem foi enviada por um membro, um webhook ou outro bot. Envie de novo com !embed send e depois use !pagination set, ou comece com !pagination create.
kira usa !pagination set na própria mensagem e o Petto responde em vermelho que só pode adicionar páginas às próprias mensagens

No Discord: uma mensagem de um membro não pode ter páginas.

O Petto precisa de Ver canal e Ver histórico de mensagens no canal da mensagem, e para publicar uma nova com create também de Enviar mensagens e Inserir links. A resposta diz quais faltam. Você precisa de Gerenciar mensagens nesse canal.
O Petto responde em vermelho que precisa de Ler histórico de mensagens nesse canal

No Discord: a resposta diz qual permissão falta ao Petto.

Apagar uma mensagem com páginas, ou o canal dela, também remove as páginas do Petto, então ela deixa de contar para o limite. Um comando que aponta para ela avisa que as páginas foram removidas.
O Petto responde que a mensagem não existe mais, então as páginas foram removidas

No Discord: uma mensagem apagada: as páginas também foram removidas.

Alguém editou a mensagem com outra coisa. Use !pagination restore <message>, ou Colocar os botões de volta no dashboard. Se a paginação foi parada com delete, as páginas não existem mais: comece de novo com !pagination set e adicione-as outra vez.
O embed salvo dela foi apagado, ou mudado para o outro tipo (clássico ou V2). Dê outro embed para a página com !pagination update.
Abaixo da mensagem de regras o Petto diz para Mia, só para ela, que o embed salvo daquela página foi apagado e como mudar a página

No Discord: o embed salvo da página 2 foi apagado: o clique responde com o erro.