Discord

Exemplo completo de configuração

O sistema de webhooks permite enviar notificações para o Discord quando os clans ganham pontos. Aqui está um exemplo:

options:
  url: ''
  username: 'yLeagues'

embeds:
  earn:
    title: ':mailbox: + Pontos de Liga!'
    thumbnail: ''
    color: '#fff'
    content: ''
    image: ''
    footer:
      text: 'yStore © Todos os direitos reservados'
      image: ''
    fields:
      player:
        inline: false
        header: 'Player'
        content: '```{player}```'
      clan:
        inline: false
        header: 'Clan'
        content: '```{clan_tag}```'
      action:
        inline: false
        header: 'Ação'
        content: '```{action}```'
      points:
        inline: false
        header: 'Pontos'
        content: '```{points}```'

Configuração inicial

options

Configurações gerais do webhook.

url

URL do webhook do Discord.

Como obter:

Vá para as configurações do canal no Discord
Clique em "Integrações"
Clique em "Webhooks"
Clique em "Novo Webhook"
Copie a URL do webhook

Exemplo:

options:
  url: 'https://discord.com/api/webhooks/123456789/ABCDEFGHIJKLMNOP'

Nunca compartilhe sua URL de webhook publicamente! Ela permite que qualquer pessoa envie mensagens para seu canal.

username

Nome de usuário que aparecerá enviando as mensagens.

Exemplo:

options:
  username: 'yLeagues'

Embeds

Mensagens embed que serão enviadas ao Discord.

earn

Embed enviado quando um clan ganha pontos.

title

Título do embed.

Exemplo:

embeds:
  earn:
    title: ':mailbox: + Pontos de Liga!'

Você pode usar emojis do Discord no título. Use o formato :emoji_name: ou copie o emoji diretamente.

thumbnail

URL da imagem pequena no canto superior direito do embed.

Exemplo:

embeds:
  earn:
    thumbnail: 'https://i.imgur.com/exemplo.png'

color

Cor da barra lateral do embed (formato hexadecimal).

Exemplo:

embeds:
  earn:
    color: '#00ff00'  # Verde

Cores comuns:

#ff0000 - Vermelho
#00ff00 - Verde
#0000ff - Azul
#ffff00 - Amarelo
#ff00ff - Magenta
#00ffff - Ciano
#ffffff - Branco
#000000 - Preto

content

Conteúdo de texto acima do embed.

Exemplo:

embeds:
  earn:
    content: '@everyone Um clan ganhou pontos!'

Deixe vazio (content: '') se não quiser texto acima do embed.

image

URL da imagem grande no corpo do embed.

Exemplo:

embeds:
  earn:
    image: 'https://i.imgur.com/exemplo-grande.png'

Rodapé do embed.

text

Texto do rodapé.

Exemplo:

embeds:
  earn:
    footer:
      text: 'yStore © Todos os direitos reservados'

image

Ícone do rodapé (URL).

Exemplo:

embeds:
  earn:
    footer:
      image: 'https://i.imgur.com/icone-pequeno.png'

fields

Campos do embed (seções de informação).

Cada field tem:

inline - Se deve ficar ao lado de outros fields (true/false)
header - Título do campo
content - Conteúdo do campo

Placeholders disponíveis:

{player} - Nome do jogador
{clan_tag} - Tag do clan
{clan_name} - Nome completo do clan
{action} - Ação realizada
{points} - Pontos ganhos/perdidos

Exemplo:

fields:
  player:
    inline: false
    header: 'Jogador'
    content: '```{player}```'
  clan:
    inline: true
    header: 'Clan'
    content: '```{clan_tag}```'
  action:
    inline: true
    header: 'Ação'
    content: '```{action}```'
  points:
    inline: false
    header: 'Pontos Ganhos'
    content: '```+{points}```'

Use ```texto``` para formatar o texto como código no Discord.

Exemplos de configuração

Embed simples

Um embed básico com informações essenciais:

options:
  url: 'https://discord.com/api/webhooks/SEU_WEBHOOK_AQUI'
  username: 'Liga de Clans'

embeds:
  earn:
    title: '📊 Pontos Ganhos!'
    thumbnail: ''
    color: '#00ff00'
    content: ''
    image: ''
    footer:
      text: 'Sistema de Ligas'
      image: ''
    fields:
      player:
        inline: true
        header: 'Jogador'
        content: '{player}'
      points:
        inline: true
        header: 'Pontos'
        content: '+{points}'

Embed detalhado

Um embed com todas as informações:

options:
  url: 'https://discord.com/api/webhooks/SEU_WEBHOOK_AQUI'
  username: 'yLeagues Bot'

embeds:
  earn:
    title: ':trophy: Novo Registro de Pontos!'
    thumbnail: 'https://i.imgur.com/trophy.png'
    color: '#FFD700'
    content: ''
    image: ''
    footer:
      text: 'yStore - Sistema de Ligas | Atualizado agora'
      image: 'https://i.imgur.com/ystore-icon.png'
    fields:
      player:
        inline: false
        header: ':bust_in_silhouette: Jogador'
        content: '```{player}```'
      clan:
        inline: true
        header: ':shield: Clan'
        content: '```{clan_tag}```'
      action:
        inline: true
        header: ':video_game: Ação Realizada'
        content: '```{action}```'
      points:
        inline: false
        header: ':star: Pontos'
        content: '```diff\n+{points} pontos\n```'

Embed com destaque

Um embed que marca o grupo quando há ganhos grandes:

options:
  url: 'https://discord.com/api/webhooks/SEU_WEBHOOK_AQUI'
  username: 'Sistema de Ligas'

embeds:
  earn:
    title: '🎯 Pontos Adicionados!'
    thumbnail: ''
    color: '#00D9FF'
    content: '||@here|| Um jogador contribuiu para seu clan!'
    image: ''
    footer:
      text: 'Continue assim para alcançar o topo!'
      image: ''
    fields:
      summary:
        inline: false
        header: '📋 Resumo'
        content: '**{player}** do clan **{clan_tag}** realizou: **{action}** e ganhou **{points}** pontos!'

Embed minimalista

Um embed limpo e direto:

options:
  url: 'https://discord.com/api/webhooks/SEU_WEBHOOK_AQUI'
  username: 'Ligas'

embeds:
  earn:
    title: 'Pontos de Liga'
    thumbnail: ''
    color: '#36393f'
    content: '{player} ganhou {points} pontos para {clan_tag}'
    image: ''
    footer:
      text: ''
      image: ''
    fields: {}

Ativando o webhook

Depois de configurar o arquivo discord.yml, ative o webhook no config.yml:

general:
  webhook:
    enabled: true
    embed: 'earn'

Testando o webhook

Para testar se seu webhook está funcionando:

Configure a URL do webhook
Ative o webhook no config.yml
Faça um jogador ganhar pontos no jogo
Verifique o canal do Discord

Se a mensagem não aparecer, verifique se a URL do webhook está correta e se o bot tem permissão para enviar mensagens no canal.

Integrando com yDiscordHook

Se você usa o plugin yDiscordHook, configure no config.yml:

general:
  discordhook:
    enabled: true
    channel: 'nome-do-canal'
    embed: 'earn'

E no yDiscordHook, crie um embed chamado earn com os mesmos placeholders.

Escolha entre usar webhook direto (discord.yml) OU yDiscordHook, não os dois ao mesmo tempo para evitar mensagens duplicadas.

Formatação de texto no Discord

Você pode usar formatação markdown do Discord nos campos:

**texto** - Negrito
*texto* ou _texto_ - Itálico
__texto__ - Sublinhado
~~texto~~ - Riscado
`texto` - Código inline
```texto``` - Bloco de código
> texto - Citação
||texto|| - Spoiler

Exemplo:

fields:
  info:
    inline: false
    header: 'Informação'
    content: '**{player}** realizou *{action}* e ganhou __+{points}__ pontos!'

Nesta página