Skip to content

Sending flags to Discord

Chat alerts only reach staff who are online. A webhook mirrors the same flags into a Discord channel, where they stay and can be read after the fact.

Break deniedChat alertflags.logDiscord channel staff holding soma.pace.alertswhen log-to-file is truewhen webhook.enabled is true

The three are independent. Turning the webhook on does not change the other two.

  1. In Discord, open Server Settings, then Integrations, then Webhooks, and create one on the channel you want the flags in.

  2. Copy its URL.

  3. Put it in config.yml and switch the webhook on:

    config.yml
    webhook:
    enabled: true
    url: "https://discord.com/api/webhooks/..."
  4. Apply it:

    /sp reload

The next flag lands in the channel. If nothing arrives, the server log will say why: SomaPace logs the failure rather than retrying silently.

A card titled with the player name and how far off the break was, followed by a table:

RowContains
Block, ToolThe block that was broken and what they held.
Coords, WorldWhere it happened.
Version, PingTheir client version and ping at that moment.
Haste, ProgressTheir haste level and how far the break had really got.

Messages are batched over a five second window, so a burst of flags arrives as one message rather than twenty.

You do not have to. flags.log holds the same information with more detail, and chat alerts cover staff who are online. The webhook is there for teams who already live in Discord and want a record they can scroll back through.