Fjord

Documentação Fjord

Módulos

01

Boas-vindas

Dê as boas-vindas, despeça-se e atribua cargos automaticamente.

Funções incluídas

  • Mensagens personalizadas de boas-vindas e despedida
  • Cartões de boas-vindas com design próprio
  • Cargos automáticos para novos membros
  • Canais separados para entradas e saídas

O que pode ser bem-vindo?

Com Bem-vindo você pode cumprimentar automaticamente novos membros, dizer adeus aos membros que estão saindo e atribuir funções ao ingressar. Todas as três áreas podem ser usadas independentemente umas das outras.

Direitos necessários no Discord

Ver canal Enviar mensagens Anexar arquivos Gerenciar funções Incorporar linksMencionar cargos não disponíveis para todos

O Fjord só precisa desta permissão se o texto normal de uma mensagem de boas-vindas ou despedida tiver de notificar um cargo que nem todos podem mencionar. @everyone e @here estão bloqueados no sistema de boas-vindas e não funcionam nele.

“Anexar arquivos” é necessário para o cartão de boas-vindas. Gerenciar funções só é necessário para funções automáticas.

Configuração

  1. Selecione o servidor que deseja gerenciar.
  2. Abra Bem-vindo.
  3. Ative as mensagens de boas-vindas, as mensagens de despedida ou os cargos automáticos.
  4. Selecione um canal de texto acessível ou pelo menos uma função.
  5. Verifique a pré-visualização e guarde as alterações.

Para funções automáticas, a função Fjord deve estar acima de todas as funções a serem atribuídas.

Mensagem de boas-vindas

O interruptor e o canal podem ser editados separadamente. Desativar mantém o canal escolhido. Nenhum canal apenas limpa a seleção inicialmente, o editor continua acessível. Guardar sem canal desativa o serviço correspondente e fecha o seu editor. Isto aplica-se a boas-vindas e despedida.

A mensagem de boas-vindas é enviada assim que um membro entra no servidor. O canal, o texto da mensagem e o cartão de boas-vindas são salvos juntos. Uma visualização mostra como o texto e o cartão interagem antes de salvar.

Enviar mensagem de boas-vindasOpcional

Ativa ou desativa a saudação automática.

CanalObrigatório na ativação

Determina em qual canal de texto acessível a saudação é publicada.

MensagemOpcional

Contém o texto normal da mensagem. Espaços reservados, funções, canais e emojis de servidor podem ser usados por meio das seleções.

Cartão de boas-vindasOpcional

Adiciona um cartão com imagem personalizado às boas-vindas.

Espaço reservado para mensagens

Espaço reservadoÉ substituído porExemplo
{member.user.name}Nome de utilizador Discord do membrocorvus48
{member.mention}Menção do novo membro@Mira
{member.user.id}ID de usuário do membro no Discord123456789012345678
{member.user.global_name}Nome de exibição global do membroMira
{guild.name}Nome do servidorComunidade Fjord
{guild.member_count}Número atual de membros1.248

Use a seleção de marcadores de posição no editor. Dessa forma, o nome é usado com exatidão e evitam-se erros de digitação entre chaves.

Editores de mensagens e cartões anexados

{guild.icon}Ícone do servidor
{member.avatar}Avatar do membro

Sem configuração guardada, boas-vindas tem o cartão ativo e as incorporações desligadas. Despedida começa com texto normal, sem incorporação nem cartão. Boas-vindas, despedida e cargos de entrada são ativados independentemente. Ambos os editores oferecem V1 e V2, texto e incorporações opcionais. O interruptor do cartão gerado fica no editor de boas-vindas. Texto vazio usa o texto predefinido apresentado.

Conteúdo até 1.800 caracteres, separado do texto das incorporações.

Boas-vindas e despedida têm seletores V1/V2 separados. A mudança exige confirmação e repõe o texto, incorporações, imagens e botões de ligação desse editor. Canal, ativação e desenho separado do cartão mantêm-se. Guardar aplica a mudança. Cancelar recupera o estado guardado anterior.

V1

V1 usa incorporações clássicas do Discord com cor de destaque e áreas fixas. Até dez incorporações. A tabela indica o máximo de caracteres. Autor, título, descrição, rodapé e todos os nomes e valores dos campos podem somar no máximo 6000 caracteres entre todas as incorporações. O texto normal tem um limite separado. Cada incorporação V1 aceita até 25 campos.

EntradaLimite de caracteresEstado
Autor256Opcional
URL do autor512Opcional
Título256Opcional
Link do título (opcional)512Opcional
Descrição4096Opcional
Texto do rodapé2048Opcional
Nome do campo256Obrigatório após adicionar
Valor do campo1024Obrigatório após adicionar

Todas as áreas de apresentação são opcionais. Ao adicionar um campo, o nome e o valor tornam-se obrigatórios. Remova campos não usados. Lado a lado ativa campos em linha, cuja disposição final depende do Discord e da largura do ecrã. Ligação ou ícone de autor exige nome de autor, ligação do título exige título e ícone do rodapé exige texto de rodapé. As ligações opcionais devem ser endereços HTTP(S) completos. A data mostra o momento do envio.

Os seletores de cargos e canais existem no texto normal, descrição V1 e valores de campo. Não estão disponíveis em autor, título, rodapé e nomes de campo. Emojis do servidor podem ser usados nesses textos. URL de autor e ligação do título aceitam apenas URL, sem cargos, canais ou emojis. Menções em incorporações clássicas não notificam.

O Discord só mostra o ícone do autor quando também há um nome de autor. Digite um nome acima para que o ícone apareça na prévia. O Discord só mostra o ícone do rodapé quando também há texto de rodapé. Digite um texto acima para que o ícone apareça na prévia.

V2

Um bloco de imagem pode conter uma galeria de até dez imagens. Use “+ Outra imagem” para adicionar imagens e removê-las individualmente. Cada imagem e miniatura tem uma descrição opcional de até 80 caracteres e uma opção de spoiler. Uma secção permite até três textos de até 4000 caracteres cada. Use “+ Outro texto” para adicionar até dois textos adicionais. Em Acessório, escolha uma miniatura ou um botão de link. O botão exige um rótulo de até 80 caracteres e uma URL HTTP(S) completa de até 512 caracteres. Emoji e desativação são opcionais. Os textos adicionais e o botão acessório contam para o limite de componentes. As imagens individuais de uma galeria não contam como componentes adicionais.

No V2, contêineres e imagens, incluindo miniaturas, podem ser marcados como spoilers. O conteúdo fica oculto até ser clicado.

V2 oferece até dez contentores com cores próprias. Use blocos de texto ou secções com miniatura opcional à direita, cada um com até 4000 caracteres e Markdown. Separadores podem mostrar uma linha ou só espaço, pequeno ou grande. Adicione, copie, remova e ordene blocos com as setas. Blocos de texto e imagem vazios não produzem conteúdo visível. Os textos V2 oferecem seletores de cargos, canais e emojis do servidor.

V2 não tem campos clássicos de autor, entradas de ligação do título, campos em linha, ícones de rodapé ou interruptor de data. Use Markdown para títulos e ligações. O exemplo abaixo cria um rodapé pequeno e o token de tempo uma data. V1 não oferece blocos V2 livremente dispostos. Os dois formatos não se misturam numa mensagem.

-# ... · {time.full}

Contentor

Cores rápidas · 10

Bloco de texto

Markdown · 4000

Secção com miniatura

Markdown · 4000 · Thumbnail ≤ 5 MB

Imagem

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

Separador

Mostrar linha divisória · Pequeno / Grande

V2 tem um limite conjunto de 40 componentes por mensagem. Contentores, textos, secções, miniaturas, galerias, separadores, linhas de ações, botões e menus contam individualmente. Opções de menu não contam separadamente. Separadores e controlos adicionados automaticamente também consomem o limite. Por exemplo, um contentor com texto, imagem, separador e botão com a sua linha usa seis componentes. Os dez contentores não podem ser preenchidos sem limite.

Os seis marcadores de mensagem também funcionam nos textos dos dois formatos. Sem nome global, usa-se o nome de utilizador. A menção do membro não aparece em áreas V1 sem suporte a menções. Para ícone de autor, miniatura, imagem grande e ícone de rodapé V1, e miniaturas e imagens V2, escolha imagem própria, ícone do servidor ou avatar do membro. Sem ícone de servidor, a imagem fica vazia. A pré-visualização usa a sua conta e o envio usa o membro real. Estas fontes dinâmicas são exclusivas de boas-vindas e despedida.

Com incorporações desligadas, o cartão de boas-vindas ativo é enviado como imagem separada com texto normal. Com incorporações ligadas, ocupa a imagem grande da primeira incorporação V1 ou entra no primeiro contentor V2. Não pode substituir esse espaço com a sua imagem grande. Outras incorporações e blocos de imagem V2 adicionais aceitam imagens próprias. Após reordenar, o cartão pertence à nova primeira incorporação. O desenho do cartão é independente de V1/V2.

Os limites de imagem são por ficheiro. Em V1, ícone de autor, miniatura e ícone de rodapé aceitam 5 MB cada. A imagem grande tem o limite dos blocos V2 indicado abaixo. São aceites PNG, JPG/JPEG, WebP e GIF. Escolher ficheiro substitui a imagem, Remover limpa o espaço. Ícones de autor e rodapé não aparecem sem o texto correspondente.

Inserir conteúdo nas mensagens

O editor de mensagens tem suas próprias seleções para espaços reservados, funções, canais e emojis de servidor. Uma entrada selecionada é inserida na posição de escrita atual.

SeleçãoUso
Marcador de posiçãoInsere informações dinâmicas de membro ou servidor da tabela acima.
FunçõesNavegue pelas funções do servidor e insira a menção da função desejada. @todos não está disponível para seleção.
CanaisNavegue pelos canais disponíveis e defina um link de canal.
Emojis de servidorNavegue pelos emojis do próprio servidor e insira um emoji de servidor estático ou animado.

Você pode abrir as seleções usando os botões do editor. Enquanto escreve, @ abre a seleção de função, # abre a seleção de canal e : abre a seleção de emoji do servidor. Outros caracteres inseridos filtram a respectiva lista.

As mensagens de boas-vindas e de despedida podem conter no máximo 1.800 caracteres cada. As entradas inseridas contam como parte do conteúdo da mensagem.

Criar cartão de boas-vindas

O editor de cartões oferece Conteúdo, Disposição, Superfície, Anel e Texto.

Conteúdo

Conteúdo inclui imagem de fundo, fundo colorido opcional, título, subtítulo e fontes com pesquisa, pré-visualizações e páginas.

Layout

Disposição oferece Esquerda ou Centrado.

Área

Superfície oferece opacidade normal de 0–100 % ou camada Liquid opcional com cor, opacidade de 0–100 % e desfoque de 0–64 px. Liquid desativa o controlo de opacidade normal.

Anel

Anel oferece cor base, intensidade de 0–100 % e shader opcional com cor, força de 0–100 % e ângulo de 0–360°.

Texto

Texto oferece cor base, intensidade e shader opcional com cor, força e posição de 0–100 %.

Não há controlos livres de tamanho do avatar, tamanhos individuais de fonte ou posições arbitrárias de texto.

Repor recupera o desenho predefinido. Guardar ou Cancelar usa a barra comum.

Use o fundo predefinido, uma cor uniforme ou uma imagem própria. Mova e amplie a imagem no editor de recorte. Área oferece também uma camada líquida com cor, opacidade e desfoque.

PropriedadeNotacompatível
Tamanho do arquivoMáximo de 10 MBArquivos maiores não podem ser salvos como plano de fundo.
Formatos de imagemPNG, JPG/JPEG, WebP e GIFO formato real do arquivo é verificado com base no conteúdo da imagem.
Formato do cartão1200 × 600 pixelsA imagem selecionada será cortada nesta seção do cartão no editor.
AnimaçõesResultado estáticoO cartão finalizado é salvo como PNG. Portanto, as animações de arquivos GIF ou WebP não são retidas.

Título ≤ 120 · Subtítulo ≤ 160

Marcadores do cartão

{member.user.name} · {guild.name} · {guild.member_count}

O cartão tem 1200 × 600 píxeis e é gerado como PNG estático. A pré-visualização usa a sua conta e dados de exemplo do servidor escolhido. Na entrada, são utilizados os dados do membro. A pré-visualização no navegador requer uma ligação válida ao painel.

Mensagem de despedida

O interruptor e o canal podem ser editados separadamente. Desativar mantém o canal escolhido. Nenhum canal apenas limpa a seleção inicialmente, o editor continua acessível. Guardar sem canal desativa o serviço correspondente e fecha o seu editor. Isto aplica-se a boas-vindas e despedida.

A mensagem de despedida é enviada quando um membro sai do servidor. Pode usar um canal de destino diferente e seu próprio texto. As menções nem sempre podem ser resolvidas após a saída. Por isso, prefira usar {member.user.global_name}.

Enviar mensagem de despedidaOpcional

Ativa ou desativa a despedida automática.

CanalObrigatório na ativação

Determina em qual canal de texto acessível a mensagem de despedida será publicada.

MensagemOpcional

Contém o texto de despedida com até 1.800 caracteres e os recursos de inserção disponíveis.

Funções automáticas

O Fjord pode atribuir diversas funções a novos membros imediatamente após a adesão. As funções gerenciadas pelo Discord e as funções acima da função Fjord não podem ser atribuídas.

Funções automáticasOpcional

Ativa ou desativa a atribuição de funções ao ingressar.

FunçõesObrigatório na ativação

Navegue na seleção de funções e selecione pelo menos uma e no máximo 25 funções.

  1. Verifique em Configurações do servidor → Funções se a função Fjord está acima das funções alvo.
  2. Ative a atribuição automática de funções e selecione as funções desejadas.
  3. Salve a seleção.

Funções com amplos direitos administrativos não devem ser atribuídas automaticamente. O Fjord exibe apenas funções que geralmente podem ser atribuídas.

Corrigir erros

ProblemaVerificação
Nenhuma mensagem é enviada.O serviço está ativado, o canal ainda está disponível e o Fjord tem permissão para vê-lo e escrever nele?
O cartão está faltando.O cartão está ativado e o Fjord tem os “Anexar arquivos” diretamente no canal de destino?
Uma função não foi atribuída.A função do Fjord está acima da função de destino e o Fjord tem a função “Gerenciar funções”, certo?
Um espaço reservado permanece inalterado.Ele foi inserido usando a seleção de espaço reservado e a ortografia e os colchetes estão corretos?
As alterações não aparecem.Guarde as alterações pendentes na barra comum, aplica as alterações de mensagens e cartão em conjunto.

V2 agrupa até cinco botões de ligação numa linha de ações. Aplica-se o limite total de componentes em vez das cinco linhas de V1.

Botões de ligação abrem páginas web e não atribuem cargos. Cada botão adicionado exige rótulo de até 80 caracteres e URL HTTP(S) completo de até 512 caracteres. Emoji opcional. Podem ser ordenados e removidos. V1 mostra-os abaixo das incorporações com cinco botões por linha e cinco linhas no total, até 25 botões. V2 coloca-os no contentor respetivo e conta botões e linhas no orçamento de 40.

Botões de ligação só são enviados com incorporações ativas.

Requisitos e limites

Uma apresentação válida não exige todas as áreas opcionais. Só cor ou blocos vazios não fornecem conteúdo visível para publicar. A pré-visualização não envia mensagens nem substitui um teste no canal. Nenhum editor oferece sondagens, stickers, formulários ou ações programáveis. Dados e opções de edição dependem também das permissões concedidas no painel.

Pré-visualização, spoilers e ficheiros de imagem

Na pré-visualização V2, uma imagem de galeria mantém a sua proporção. Várias imagens formam uma grelha com recortes iguais de 16:9. Duas ou quatro imagens usam duas colunas, três e entre cinco e dez usam três colunas. A miniatura aparece à direita do texto da secção. A descrição fornece texto alternativo, não uma legenda visível adicional.

Os interruptores de spoiler de imagem e contentor pertencem ao editor V2. As imagens de galeria e miniaturas podem ser ocultadas separadamente. Um spoiler de contentor oculta o conteúdo, mantendo a moldura exterior visível. Um clique revela a pré-visualização sem alterar a definição guardada. Os membros também podem revelar spoilers com um clique no Discord.

As imagens de mensagens aceitam PNG, JPG/JPEG, WebP e GIF. O tipo de ficheiro deve corresponder ao conteúdo. Alterar a extensão de um ficheiro HTML ou SVG não o transforma numa imagem suportada. Os limites das tabelas continuam a aplicar-se a cada ficheiro. Se uma imagem local for rejeitada ou deixar de poder ser lida, selecione novamente o ficheiro original e volte a guardar.

As áreas de texto Markdown aceitam ligações web e de correio eletrónico. A pré-visualização abre ligações HTTP(S) e mailto, mas não ficheiros locais nem endereços Blob. Ligações de autor, título e botões de ligação exigem URL HTTP(S) completos. A pré-visualização não publica mensagens. Verifique o resultado guardado no Discord, cuja apresentação pode variar com o cliente e a largura do ecrã.