AdvancedWebhook

AdvancedBanDiscordWebhooks connects your Minecraft server to Discord!
This plugin automatically sends Discord webhook embeds whenever a punishment is issued via AdvancedBan.

✨ Features

• Instant punishment logs to Discord:
  • Ban / TempBan
    
    
  • Mute / TempMute
    
    
  • Warn
• Separate webhook section per punishment type in config.yml
  
  
• Fully customizable Discord embeds:
  • Color, title, description, fields
    
    
  • Thumbnail, author, footer + footer icon
    
    
  • Webhook username/avatar
    
    
  • Optional timestamp
• Async sending (no main-thread lag)

️ Images

Requirements

• Paper/Spigot 1.21.x (tested on Paper 1.21.10)
  
  
• Newest version of AdvancedBan installed

Placeholders (examples)
{player}, {staff}, {reason}, {duration}, {hex_id}, {server_version}, {end_local}, {start_local}

Default config.yml

webhooks:
  ban:
    enabled: true
    #Webhook URL. You can use a separate link for each webhook.
    url: "https://discordapp.com/api/webhooks/1468406820308517049/LxbIWO-xP37GgZK25eEuBISnypdjEOjvik9AiVRfqiWlp1bGtg0Q23oAdCSkFYd9qtnQ"
    #Webhook Username
    username: "Watchdog"
    #Avatar of the Webhook. You can also use a link from your server, webspace or discord either.
    avatar_url: "https://i.imgur.com/E2kWSgC.png"
    #If you want a message above the embed. You can deactivate it, by just leaving it blank -> "" <- like this.
    content: ""
    #Embed Settings
    #Enable or disable the embed. Default = true
    #Change the color of the embed by using hex codes. Default = #ff2d2d (red)
    #Change the title. You can use emojis and placeholders. Default = {player} has been banned
    #The default description is showing the staff member, the reason and the ban-id.
    #For the thumbnail_url, you can use your own pictures or like default the mc-heads.net avatars.
    #Author name and icon can be changed aswell. Footer text and icon too.
    #The timestamp will be shown in the footer.
    #Placerholders:
    #{player} - Name of the banned player
    #{staff} - Name of the staff member
    #{reason} - Showing the ban reason
    #{hex_id} - Showing the ban id
    #{duration} - Duration of a ban or mute. Only for tempban and tempmute
    embed:
      enabled: true
      color: "#ff2d2d"
      title: "{player} has been banned"
      description: "**Banned by:** {staff}\n**Reason:** {reason}\n**Ban-ID:** {hex_id}"
      thumbnail_url: "https://www.mc-heads.net/avatar/{player}"
      author:
        name: "⛔Punishment Log"
        icon_url: "https://i.imgur.com/9GVFdx4.png"
      footer:
        text: "Ban-ID: {hex_id}"
        icon_url: "https://i.imgur.com/81myZfy.png"
      timestamp: true
      #You can deactivate the fields by just removing the lines and remove the # in front of the [ ].
      fields: #[ ]
        - name: "Server"
          value: "`{server_version}`"
          inline: false
        - name: "Player"
          value: "`{player}`"
          inline: false

  mute:
    enabled: true
    url: "https://discordapp.com/api/webhooks/1468406820308517049/LxbIWO-xP37GgZK25eEuBISnypdjEOjvik9AiVRfqiWlp1bGtg0Q23oAdCSkFYd9qtnQ"
    username: "Watchdog"
    avatar_url: "https://i.imgur.com/E2kWSgC.png"
    content: ""
    embed:
      enabled: true
      color: "#ffb000"
      title: "{player} has been muted"
      description: "**Muted by:** {staff}\n**Reason:** {reason}"
      thumbnail_url: "https://www.mc-heads.net/avatar/{player}"
      author:
        name: "⛔Punishment Log"
        icon_url: "https://i.imgur.com/9GVFdx4.png"
      footer:
        text: "{time_local}"
        icon_url: "https://i.imgur.com/81myZfy.png"
      timestamp: true
      fields: [ ]

  tempban:
    enabled: true
    url: "https://discordapp.com/api/webhooks/1468406820308517049/LxbIWO-xP37GgZK25eEuBISnypdjEOjvik9AiVRfqiWlp1bGtg0Q23oAdCSkFYd9qtnQ"
    username: "Watchdog"
    avatar_url: "https://i.imgur.com/E2kWSgC.png"
    content: ""
    embed:
      enabled: true
      color: "#d14cff"
      title: "{player} has been temporarily banned"
      description: "**Banned by:** {staff}\n**Duration:** {duration}\n**Until:** {end_local}\n**Reason:** {reason}"
      thumbnail_url: "https://www.mc-heads.net/avatar/{player}"
      author:
        name: "⛔Punishment Log"
        icon_url: "https://i.imgur.com/9GVFdx4.png"
      footer:
        text: "ID: {hex_id}"
        icon_url: "https://i.imgur.com/81myZfy.png"
      timestamp: true
      fields: [ ]

  tempmute:
    enabled: true
    url: "https://discordapp.com/api/webhooks/1468406820308517049/LxbIWO-xP37GgZK25eEuBISnypdjEOjvik9AiVRfqiWlp1bGtg0Q23oAdCSkFYd9qtnQ"
    username: "Watchdog"
    avatar_url: "https://i.imgur.com/E2kWSgC.png"
    content: ""
    embed:
      enabled: true
      color: "#42a5ff"
      title: "{player} has been temporarily muted"
      description: "**Muted by:** {staff}\n**Duration:** {duration}\n**Until:** {end_local}\n**Reason:** {reason}"
      thumbnail_url: "https://www.mc-heads.net/avatar/{player}"
      author:
        name: "⛔Punishment Log"
        icon_url: "https://i.imgur.com/9GVFdx4.png"
      footer:
        text: "ID: {hex_id}"
        icon_url: "https://i.imgur.com/81myZfy.png"
      timestamp: true
      fields: [ ]

  warn:
    enabled: true
    url: "https://discordapp.com/api/webhooks/1468406820308517049/LxbIWO-xP37GgZK25eEuBISnypdjEOjvik9AiVRfqiWlp1bGtg0Q23oAdCSkFYd9qtnQ"
    username: "Watchdog"
    avatar_url: "https://i.imgur.com/E2kWSgC.png"
    content: ""
    embed:
      enabled: true
      color: "#ffee58"
      title: "{player} has been warned"
      description: "**Warned by:** {staff}\n**Reason:** {reason}"
      thumbnail_url: "https://www.mc-heads.net/avatar/{player}"
      author:
        name: "⛔Punishment Log"
        icon_url: "https://i.imgur.com/9GVFdx4.png"
      footer:
        text: "ID: {hex_id}"
        icon_url: "https://i.imgur.com/81myZfy.png"
      timestamp: true
      fields: [ ]

Coming soon

• Webhooks for Unban / Unmute