Discord

Exemplo completo de configuração

Aqui está um exemplo de como configurar a integração com Discord:

options:
  url: ''
  username: 'yVips'

embeds:
  activated:
    title: ':mailbox: Um novo VIP foi ativado'
    thumbnail: 'https://minotar.net/body/{player}/100.png'
    color: '#fff'
    content: ''
    footer:
      text: 'yStore © Todos os direitos reservados'
      image: ''
    fields:
      player:
        inline: true
        header: 'Player'
        content: '```{player}```'
      vip:
        inline: true
        header: 'VIP'
        content: '```{vip}```'
      time:
        inline: true
        header: 'Duração'
        content: '```{time}```'
      date_activated:
        inline: true
        header: 'Ativado em'
        content: '```{activation_date} às {activation_hour}```'
      date_expire:
        inline: true
        header: 'Expira em'
        content: '```{expire_date} às {expire_hour}```'

Configuração básica

options

Configurações globais do webhook.

url

URL do webhook do Discord.

options:
  url: ''

Para obter a URL do webhook:

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

username

Nome que aparecerá como autor das mensagens.

options:
  username: 'yVips'

Embeds

Configuração das mensagens embed enviadas ao Discord.

activated

Embed enviada quando um VIP é ativado.

Estrutura básica

embeds:
  activated:
    title: ':mailbox: Um novo VIP foi ativado'
    thumbnail: 'https://minotar.net/body/{player}/100.png'
    color: '#fff'
    content: ''

Propriedades:

title: Título da embed (aceita emojis do Discord)
thumbnail: URL da imagem em miniatura
color: Cor da borda lateral (formato hexadecimal)
content: Conteúdo extra fora dos campos

Placeholders disponíveis para thumbnail: {player} - Nome do jogador

Rodapé da embed.

footer:
  text: 'yStore © Todos os direitos reservados'
  image: ''

Propriedades:

text: Texto do rodapé
image: URL de uma imagem pequena para o rodapé

fields

Campos de informação da embed.

fields:
  player:
    inline: true
    header: 'Player'
    content: '```{player}```'
  vip:
    inline: true
    header: 'VIP'
    content: '```{vip}```'
  time:
    inline: true
    header: 'Duração'
    content: '```{time}```'
  date_activated:
    inline: true
    header: 'Ativado em'
    content: '```{activation_date} às {activation_hour}```'
  date_expire:
    inline: true
    header: 'Expira em'
    content: '```{expire_date} às {expire_hour}```'

Propriedades de cada campo:

inline: Se true, o campo aparece ao lado de outros; se false, ocupa linha inteira
header: Título do campo
content: Conteúdo do campo

Use ``` (três crases) para formatar o conteúdo como código no Discord.

Placeholders disponíveis

Os seguintes placeholders podem ser usados nos campos:

Placeholder	Descrição
`{player}`	Nome do jogador
`{vip}`	Tipo do VIP
`{time}`	Duração do VIP
`{activation_date}`	Data de ativação
`{activation_hour}`	Hora de ativação
`{expire_date}`	Data de expiração
`{expire_hour}`	Hora de expiração

Configurando embeds por VIP

Cada VIP pode ter sua própria configuração de embed. Isso é configurado no arquivo vips.yml:

vips:
  iron:
    # ... outras configurações ...
    discord:
      # Integração com yDiscordHook
      discordhook:
        enable: true
        # ID do embed para envio no privado
        dm-embed: ''
      # Webhook direto
      webhook:
        enable: true
        # ID do embed configurado em discord.yml
        chat-embed: 'activated'

O chat-embed: 'activated' referencia a embed activated configurada em discord.yml.

Criando uma nova embed

Escolha um identificador

Escolha um ID único para a embed (ex: vip_premium, first_vip).

Configure a estrutura

Adicione a nova embed no arquivo discord.yml:

embeds:
  activated:
    # ... embed existente ...
  
  vip_premium:
    title: ':star2: VIP Premium Ativado!'
    thumbnail: 'https://minotar.net/body/{player}/100.png'
    color: '#FFD700'
    content: ''
    footer:
      text: 'Obrigado por apoiar o servidor!'
      image: ''
    fields:
      player:
        inline: true
        header: 'Jogador'
        content: '```{player}```'
      vip:
        inline: true
        header: 'VIP'
        content: '```{vip}```'

Referencie no VIP

Configure o VIP para usar esta embed em vips.yml:

vips:
  premium:
    # ... outras configurações ...
    discord:
      webhook:
        enable: true
        chat-embed: 'vip_premium'

Teste a integração

Ative o VIP e verifique se a mensagem aparece no Discord.

Cores sugeridas

Aqui estão algumas cores em hexadecimal para usar em suas embeds:

Cor	Código	Uso sugerido
Vermelho	`#FF0000`	VIPs básicos
Laranja	`#FFA500`	VIPs intermediários
Amarelo	`#FFD700`	VIPs avançados
Verde	`#00FF00`	VIPs premium
Azul	`#0080FF`	VIPs diamante
Roxo	`#8000FF`	VIPs ultimate
Branco	`#FFFFFF`	Neutro/Geral

Formatação do Discord

Markdown suportado

**Negrito**: Negrito
*Itálico*: Itálico
__Sublinhado__: Sublinhado
~~Tachado~~: ~~Tachado~~
`Código`: Código
```Bloco de código```:

Bloco de código

Emojis do Discord

Use emojis do Discord no título e campos:

title: ':star2: VIP Ativado! :tada:'

Alguns emojis comuns:

:star: - ⭐
:star2: - 🌟
:tada: - 🎉
:crown: - 👑
:gem: - 💎
:rocket: - 🚀
:fire: - 🔥
:mailbox: - 📫

Desabilitando webhooks

Para desabilitar completamente os webhooks do Discord:

Deixe a URL vazia em discord.yml:

options:
  url: ''

Ou desabilite em cada VIP individualmente em vips.yml:

discord:
  webhook:
    enable: false

Após alterar as configurações do Discord, reinicie o servidor para aplicar as mudanças.

Certifique-se de que a URL do webhook está correta e que o bot tem permissões para enviar mensagens no canal.

Nesta página