Blood bot

Configure first blood announcements to Discord and Telegram.

Last updated Jul 16, 2026

The blood bot announces the first teams to solve each challenge in Discord, Telegram, or both.

Configuration

1
bloodBot:
2
  bloodsCount: 3
3
  destinations:
4
    - provider:
5
        name: messages/discord
6
        options:
7
          url: https://discord.com/api/webhooks/123456/abcdef
8
      bloodEmojis:
9
        - '<:rank1:1008801500736266261>'
10
        - '<:rank2:1008801501776449738>'
11
        - '<:rank3:1008801503080874056>'
12
    - provider:
13
        name: messages/telegram
14
        options:
15
          botToken: '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11'
16
          chatId: '-1001234567890'

Field	Type	Default	Description
`bloodsCount`	`number`	`1`	Number of blood tiers to announce (1-3)
`destinations`	`array`	-	At least one destination required
`destinations[].bloodEmojis`	`string[]`	`[]`	Optional blood emoji for that destination

Set bloodsCount to 1 for first blood only or 3 for the first three solves.

Message providers

Posts announcements through a Discord webhook.

Option	Description
`url`	Discord webhook URL

In Discord, open Server Settings > Integrations > Webhooks > New Webhook and copy its URL.

Posts announcements through a Telegram bot.

Option	Description
`botToken`	Telegram bot token (from @BotFather)
`chatId`	Target chat or group ID
`threadId`	Message thread ID for forum/topic channels (optional)

Custom message templates

Each destination can have a custom messageTemplate:

1
bloodBot:
2
  bloodsCount: 3
3
  destinations:
4
    - provider:
5
        name: messages/discord
6
        options:
7
          url: https://discord.com/api/webhooks/...
8
      bloodEmojis:
9
        - '<:rank1:1008801500736266261>'
10
        - '<:rank2:1008801501776449738>'
11
        - '<:rank3:1008801503080874056>'
12
      messageTemplate: '{{bloodEmoji}} {{bloodNumTitle}} solve for challenge "**{{challengeName}}**" goes to **{{teamName}}**!'

Emojis are configured per destination, so Discord can use custom emoji markup while Telegram uses Unicode or a different template.

Template variables

Variable	Description	Example
`{{teamName}}`	Team display name	`SuperHackers`
`{{teamUrl}}`	URL to team profile	`https://ctf.example.com/profile/abc123`
`{{bloodEmoji}}`	Emoji configured for this blood number	`<:rank1:1008801500736266261>`
`{{bloodNumber}}`	Numeric blood position	`1`
`{{bloodNumOrdinal}}`	Ordinal blood position	`1st`
`{{bloodNumSentence}}`	Ordinal blood position, kept for templates	`1st`
`{{bloodNumWord}}`	Word blood position	`first`
`{{bloodNumTitle}}`	Title-cased word blood position	`First`
`{{challengeCategory}}`	Challenge category	`web`
`{{challengeName}}`	Challenge name	`SQL Injection 101`

Default templates

Without a custom template, rCTF uses the following defaults.

The Discord default is {{#bloodEmoji}}{{bloodEmoji}} {{/bloodEmoji}}Congratulations to [`{{teamName}}`]({{teamUrl}}) for {{bloodNumSentence}} blood on `{{challengeCategory}}/{{challengeName}}`!.

The Telegram default is {{#bloodEmoji}}{{bloodEmoji}} {{/bloodEmoji}}Congratulations to [*{{teamName}}*]({{teamUrl}}) for {{bloodNumSentence}} blood on `{{challengeCategory}}/{{challengeName}}`\!.

The Telegram template uses MarkdownV2 syntax and escapes the ! character, which the Telegram API requires.