send_discord_webhook

Sends a message to a Discord channel via a webhook URL.

Categories: chat

Required arguments

Key(s)DescriptionType
webhook_urlThe Discord webhook URL to send the message to.STRING
textThe message content to send to the webhook.STRING

Optional arguments

Key(s)DescriptionTypeDefault
usernameThe display name to use for the webhook message.STRING
avatar_urlA URL to an image to use as the webhook avatar.STRING
ttsWhether to send the message as text-to-speech.BOOLEANfalse
embedsA list of embed objects to include in the webhook message.ANY

Example

effects:
  - id: send_discord_webhook
    args:
      webhook_url: https://discord.com/api/webhooks/123456789012345678/abcDEF-token
      text: %player_name% just found a legendary item!
      username: <value> # ← Optional
      avatar_url: https://example.com/avatar.png # ← Optional
      tts: true # ← Optional
      embeds: 
        key: <value> # ← Optional

Behaviour

SettingValue
Run orderNORMAL
Supports delaytrue
Reloads on plugin reloadtrue
Permanentfalse