Discord webhook

Configuration file: discord.yml. Two rendering modes:

• classic — traditional embed plus link buttons. Universally supported.
• components-v2 — native Discord Components V2 layout (containers, sections, thumbnails, separators, media galleries, buttons). Strongly recommended for new setups.

Tip

Switching modes is a one-line change (mode:). Set up both, A/B test which your community prefers, and roll back instantly if needed.

Setup

discord.yml

webhook:
  enabled: true
  url: "INSERT-WEBHOOK-URL"
  username: "Nautic Studios"
  avatar: "https://i.imgur.com/ip1xV13.png"

  mode: components-v2   # or: classic

Danger

Webhook URLs grant write access to the channel they belong to. Never commit discord.yml to a public repo and rotate the URL immediately if it leaks.

Filters

Applied only to substituted placeholders ({player}, {package}, …). Literal text in the file is never touched.

discord.yml

filters:
  strip-words:
    - kit
    - rank
    - package

  replace:
    vip: "VIP"
    mvp: "MVP"

  multi-package:
    multiline: true
    bullet: "• "
    inline-separator: " • "

Filter	Behavior
strip-words	Removes the listed words (case-insensitive). Kit ASTRO → ASTRO.
replace	Maps raw input → display string.
multi-package.multiline	true = one per line with bullet. false = inline with inline-separator.

Tip

Use replace to fix capitalization once instead of renaming every SKU in your Tebex panel. Keeps Tebex IDs stable while the embed stays polished.

Placeholders

Placeholder	Replaces with
{player}	Buyer name
{package}	Purchased package(s)
{price}	Purchase price
Any customs-args key	Its value

Mode: classic

discord.yml

classic:
  content: ""

  embed:
    enabled: true
    title: "🛒 New Purchase"
    url: ""
    color: "#00FFAA"

    description:
      - "**{player}** purchased **{package}**"

    fields:
      - { name: "Player",  value: "{player}",  inline: true }
      - { name: "Package", value: "{package}", inline: true }
      - { name: "Price",   value: "{price}",   inline: true }

    author:    { name: "Server Store", url: "", icon: "" }
    footer:    { text: "Powered by Nautic Studios", icon: "" }
    image:     ""
    thumbnail: "https://mc-heads.net/avatar/{player}"

  buttons:
    - { label: "Visit Store",  url: "https://store.example.com" }
    - { label: "Join Discord", url: "https://discord.gg/example" }

Field	Description
content	Plain text above the embed (mentions go here).
description	List of lines.
fields[].inline	true lays fields side by side.
thumbnail	Top-right image. Use mc-heads.net/avatar/{player} for the buyer’s head.
buttons	Up to 5 link buttons.

Tip

Need to ping a role? Put <@&ROLE_ID> in content and the role gets pinged above the embed.

Mode: components-v2

discord.yml

components-v2:
  accent: "#00FFAA"

  layout:

    - type: text
      content: "## 🛒 New Purchase"

    - type: separator

    - type: section
      text:
        - "**Player:** `{player}`"
        - "**Package:** `{package}`"
        - "**Price:** `{price}`"
      thumbnail: "https://mc-heads.net/avatar/{player}/128"

    - type: separator
      spacing: 2

    - type: text
      content: "-# Powered by Nautic Studios"

    - type: buttons
      items:
        - { label: "Visit Store",  url: "https://store.example.com" }
        - { label: "Join Discord", url: "https://discord.gg/example" }

accent colors the left bar and wraps the layout in a Discord Container.

Node types

type	Fields
text	content: string or list of strings. Markdown supported.
separator	divider (true / false, default true), spacing (1 / 2).
section	text (list), thumbnail (image URL).
media	items: ["url", ...] — image gallery.
buttons	items: [{ label: "Visit Store", url: "https://store.example.com" }] — max 5 per row.

Node examples

text

- type: text
  content: "## 🛒 New Purchase"

- type: text
  content:
    - "**Player:** `{player}`"
    - "**Package:** `{package}`"

separator

- type: separator
  divider: true
  spacing: 2

section

- type: section
  text:
    - "**Player:** `{player}`"
    - "**Package:** `{package}`"
  thumbnail: "https://mc-heads.net/avatar/{player}/128"

media

- type: media
  items:
    - "https://example.com/banner.png"
    - "https://example.com/logo.png"

buttons

- type: buttons
  items:
    - { label: "Visit Store",  url: "https://store.example.com" }
    - { label: "Join Discord", url: "https://discord.gg/example" }

Tip

A section with the buyer’s head as thumbnail, followed by a separator and a buttons row, gives you a clean store-card layout in 3 nodes.