Discord

Exemplo completo de configuração

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

options:
  tempmute:
    url: ''
    username: 'yPunish - Mutado temporariamente'
  mute:
    url: ''
    username: 'yPunish - Mutado permanentemente'
  ban:
    url: ''
    username: 'yPunish - Banido permanentemente'
  tempban:
    url: ''
    username: 'yPunish - Banido temporariamente'
  kick:
    url: ''
    username: 'yPunish - Kickado'
  warn:
    url: ''
    username: 'yPunish - Avisado'
  unban:
    url: ''
    username: 'yPunish - Desbanido'
  unbanip:
    url: ''
    username: 'yPunish - Desbanido'
  unmute:
    url: ''
    username: 'yPunish - Desmutado'

embeds:
  mute:
    title: ':mailbox: Um novo jogador foi mutado permanentemente'
    thumbnail: 'https://minotar.net/body/{player}/100.png'
    color: '#fff'
    content: ''
    footer:
      text: 'yStore © Todos os direitos reservados'
      image: ''
    fields:
      id:
        inline: true
        header: 'Punição Nº'
        content: '```#{id}```'
      player:
        inline: true
        header: 'Player'
        content: '```{player}```'
      sender:
        inline: true
        header: 'Staff'
        content: '```{sender}```'
      reason:
        inline: true
        header: 'Motivo'
        content: '```{reason}```'
      proof:
        inline: true
        header: 'Prova'
        content: '```{proof}```'
      duration:
        inline: true
        header: 'Término'
        content: '```Nunca```'

Opções disponíveis na configuração

options

Configurações de webhooks para cada tipo de punição.

Estrutura básica

Cada tipo de punição possui configurações de URL do webhook e nome de usuário:

options:
  [tipo]:
    url: ''
    username: 'yPunish - [Descrição]'

tempmute

Configuração do webhook para mutes temporários.

Exemplo:

options:
  tempmute:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Mutado temporariamente'

mute

Configuração do webhook para mutes permanentes.

Exemplo:

options:
  mute:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Mutado permanentemente'

ban

Configuração do webhook para banimentos permanentes.

Exemplo:

options:
  ban:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Banido permanentemente'

tempban

Configuração do webhook para banimentos temporários.

Exemplo:

options:
  tempban:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Banido temporariamente'

kick

Configuração do webhook para expulsões.

Exemplo:

options:
  kick:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Kickado'

warn

Configuração do webhook para avisos.

Exemplo:

options:
  warn:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Avisado'

unban

Configuração do webhook para desbanimentos.

Exemplo:

options:
  unban:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Desbanido'

unbanip

Configuração do webhook para desbanimentos de IP.

Exemplo:

options:
  unbanip:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Desbanido'

unmute

Configuração do webhook para desmutes.

Exemplo:

options:
  unmute:
    url: 'https://discord.com/api/webhooks/...'
    username: 'yPunish - Desmutado'

embeds

Configuração dos embeds enviados para o Discord.

Estrutura de um embed

Cada embed possui os seguintes componentes:

embeds:
  [tipo]:
    title: 'Título do embed'
    thumbnail: 'URL da imagem'
    color: '#hexcolor'
    content: 'Conteúdo adicional'
    footer:
      text: 'Texto do rodapé'
      image: 'URL da imagem do rodapé'
    fields:
      [campo]:
        inline: true/false
        header: 'Nome do campo'
        content: 'Conteúdo do campo'

title

Define o título do embed.

Exemplo:

title: ':mailbox: Um novo jogador foi mutado permanentemente'

Você pode usar emojis do Discord usando a sintaxe :emoji:.

thumbnail

Define a imagem em miniatura do embed.

Exemplo:

thumbnail: 'https://minotar.net/body/{player}/100.png'

Placeholders disponíveis: {player}, {sender}, {id}

color

Define a cor da barra lateral do embed.

Exemplo:

color: '#ff0000'  # Vermelho
color: '#00ff00'  # Verde
color: '#0000ff'  # Azul
color: '#fff'     # Branco

content

Conteúdo adicional do embed (texto acima dos campos).

Exemplo:

content: '@everyone Um jogador foi punido!'

Configuração do rodapé do embed.

Exemplo:

footer:
  text: 'yStore © Todos os direitos reservados'
  image: 'https://exemplo.com/logo.png'

fields

Campos personalizados do embed.

Exemplo:

fields:
  id:
    inline: true
    header: 'Punição Nº'
    content: '```#{id}```'
  player:
    inline: true
    header: 'Player'
    content: '```{player}```'
  sender:
    inline: true
    header: 'Staff'
    content: '```{sender}```'
  reason:
    inline: true
    header: 'Motivo'
    content: '```{reason}```'
  proof:
    inline: true
    header: 'Prova'
    content: '```{proof}```'
  duration:
    inline: true
    header: 'Término'
    content: '```{expire_date} às {expire_hour}```'

inline: Define se o campo será exibido na mesma linha que outros campos inline.

Placeholders disponíveis: {id}, {player}, {sender}, {reason}, {proof}, {expire_date}, {expire_hour}, {server}

Configurando webhooks

Crie um webhook no Discord

Vá para as configurações do seu servidor Discord
Acesse "Integrações" > "Webhooks"
Clique em "Novo Webhook"
Configure o canal de destino e copie a URL do webhook

Configure a URL no plugin

Cole a URL do webhook no campo url do tipo de punição desejado:

options:
  ban:
    url: 'https://discord.com/api/webhooks/123456789/abcdefghijklmnopqrstuvwxyz'
    username: 'yPunish - Banido permanentemente'

Personalize o embed

Customize o título, cor, campos e outros elementos do embed:

embeds:
  ban:
    title: ':hammer: Novo banimento aplicado'
    color: '#ff0000'
    fields:
      player:
        inline: true
        header: 'Jogador Punido'
        content: '```{player}```'

Teste a configuração

Execute uma punição de teste para verificar se o webhook está funcionando corretamente.

Mantenha suas URLs de webhook seguras! Não compartilhe publicamente.

Nesta página