Bot Messages

TM 26-06 Clusterfox (Discord Bot)

Bot Messages

Bot Messages are persistent Discord messages managed from the Admin console. Unlike the automatic messages the bot sends in response to events, Bot Messages are manually authored and sent by admins — useful for pinned comms boards, regiment rules posts, or any content that needs to live in a specific channel and be updatable in place.


Message Kinds

Two kinds are available:

Message

A plain text Discord message. Supports standard Discord markdown formatting. You can attach one or more files (images, PDFs, etc.) to a message-type bot message.

Embed

A Discord rich embed. Supports the following fields:

Field Notes
Title Embed heading, optionally linkable to a URL
Description Main body text (markdown supported)
Fields Up to 25 named fields; each field can be inline (side-by-side) or block
Color Left border accent colour (hex integer)
Footer Small text at the bottom, with optional icon URL
Author Name + optional URL and icon above the title
Thumbnail Small image in the top-right corner
Image Large image at the bottom of the embed

Embeds support a single image attachment (type embed_image).


Creating a Bot Message

  1. Go to Admin → Bot Messages → New.
  2. Fill in:
    • Name — Internal label (not shown in Discord)
    • Channel — The Discord channel to send the message to
    • Kind — Message or Embed
  3. Write the message content or build the embed fields.
  4. Click Save to persist the configuration.
  5. Click Send to post the message to Discord.

The message is not posted to Discord until you click Send. Saving only stores the configuration.


Updating and Resending

After a bot message has been sent, you can edit its content in the Admin console at any time. Changes are saved immediately on Save, but the Discord message is not updated until you click Send again.

When you resend:

  • If the original Discord message still exists (same channel, not deleted), the bot edits it in place.
  • If the original message was deleted or the channel changed, the bot posts a new message.

This makes it safe to update the content of a bot message without it moving in the channel.


Example Use Cases

  • Regiment rules — Post and pin a rules embed that can be edited in place if rules change
  • Active-war comms board — A message showing current objectives; update it each war without spamming a new post
  • Supply status — A pinned stockpile summary updated periodically by logi staff
  • Welcome info — A permanent onboarding embed in the welcome channel, separate from the auto-welcome message

Attachments

File attachments are uploaded when the bot message is sent. If you resend with new attachments, the previous attachments are replaced. Attachments are stored in the database and re-uploaded to Discord on each send.