Fila DBD

English | Português

---

English

A website to manage Dead by Daylight character requests during Twitch streams.

Made with love for the Dead by Daylight community, especially MandyMess 🫶

Use our Discord or GitHub to send feedback, suggest features, and report bugs.

How it works

1. Connects to Twitch chat in real time
2. Detects character requests from multiple sources configured by the streamer (donations, resubs, chat commands)
3. Automatically identifies the mentioned character, using AI when needed
4. Displays an ordered queue with character portraits

How to use

1. Go to the website and click Start my queue to connect with your Twitch account
2. Your queue will open automatically
3. Configure your request sources

You need to keep the site open to receive requests.

Notifications: we only show a small notice on the page when a new request is received. Enable browser notifications to get alerts when there's an issue.

Request sources

Source	How it works
Donations	Detects messages from donation bots (LivePix, StreamElements, etc.). Filters by minimum amount
Resubs	Captures resub messages via Twitch IRC USERNOTICE
Chat	Configurable command (default: !fila) for subscribers. Filters by minimum tier
Manual	Manual character entry

Request queue

• Click a request to mark it as done
• Drag to reorder manually
• Select request ordering by arrival order or by priority
• + button adds a manual request

Sources panel

Enable/disable each source individually at any time:

• Donations: configure minimum amount
• Chat: configure command and minimum subscriber tier (e.g. only Tier 2 and 3 can request)
• Resubs: resubscription messages

Drag the priority pills to define the order in which new requests enter the queue.

---

Installation

Install Bun and run:

bun install
bun dev  # Local server with frontend + API + PartyKit

Deploy

The service is designed to be deployed on Cloudflare Workers and PartyKit.

Required GitHub secrets:

• CLOUDFLARE_API_TOKEN - token with Workers permission
• PARTYKIT_TOKEN and PARTYKIT_LOGIN - obtained with bunx partykit@latest token generate

Cloudflare secrets (via wrangler secret put):

• TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET - Twitch app
• JWT_SECRET - any secure string
• INTERNAL_API_SECRET - shared secret between Worker and PartyKit

KV Namespace (via wrangler kv namespace create CACHE):

• Create the namespace and update the id in wrangler.toml

D1 Database (via wrangler d1 create fila-dbd):

• Create the database and update the database_id in wrangler.toml
• Apply migrations: wrangler d1 migrations apply fila-dbd

Cloudflare Pages environment variables:

• VITE_TWITCH_CLIENT_ID - same Twitch app Client ID (used by frontend for OAuth redirect)
• VITE_API_URL - Production Worker URL

PartyKit secrets (via bunx partykit env add):

• JWT_SECRET - same value as Cloudflare
• INTERNAL_API_SECRET - same value as Cloudflare
• API_URL - Production Worker URL (e.g. https://dbd-tracker.<account>.workers.dev)

Debug

Add #debug to the URL to activate the debug panel. Example: http://localhost:5173/meriw_/#debug.

• Test extraction: tests character identification on a message
• Re-identify all: reprocesses all requests in the queue
• Replay VOD: replays VOD chat for testing (requires VOD ID, which can be found in the video URL)

Console (DevTools)

dbdDebug.chat('User', 'msg')                      // chat sub tier 1
dbdDebug.chat('User', 'msg', { tier: 2 })         // chat sub tier 2
dbdDebug.chat('User', 'msg', { sub: false })      // chat non-sub
dbdDebug.donate('Donor', 50, 'msg')               // donate R$50 (LivePix format)
dbdDebug.resub('User', 'msg')                     // resub
dbdDebug.raw('@tags... PRIVMSG #ch :msg')         // raw IRC

To test StreamElements format:

dbdDebug.raw('@display-name=StreamElements :streamelements!streamelements@streamelements.tmi.twitch.tv PRIVMSG #ch :Donor mandou 5.00 e disse: Huntress')

License

MIT (LICENSE)

All Dead by Daylight rights belong to Behaviour Interactive.

Acknowledgments

• MandyMess - for inspiring me to create this project
• Dead by Daylight Wiki - character database and images
• MaChInEgUn3 - added support for GGPix via StreamElements

---

Português

Site para gerenciar pedidos de personagens de Dead by Daylight durante streams na Twitch.

Feito com carinho para a comunidade brasileira 🇧🇷 de Dead by Daylight, em especial MandyMess 🫶

Use o nosso Discord ou o próprio GitHub para mandar feedback, sugerir funcionalidades e reportar bugs.

Como funciona

1. Conecta ao chat da Twitch em tempo real
2. Detecta pedidos de personagens de múltiplas fontes que o streamer configura (donates, resubs, comandos de chat)
3. Identifica automaticamente o personagem mencionado, usando IA quando necessário
4. Exibe fila ordenada com retratos dos personagens

Como usar

1. Acesse o site e clique em Começar minha fila para conectar com sua conta da Twitch
2. Sua fila será aberta automaticamente
3. Configure as fontes de pedidos

É preciso estar com o site aberto para receber pedidos.

Notificações: só mostramos um pequeno aviso na página quando um novo pedido é recebido. Ative as notificações do navegador para receber alertas quando houver algum problema.

Fontes de pedidos

Fonte	Como funciona
Donates	Detecta mensagens de bots de doação (LivePix, StreamElements, etc.). Filtra por valor mínimo
Resubs	Captura mensagens de resub via USERNOTICE do Twitch IRC
Chat	Comando configurável (padrão: !fila) para inscritos. Filtra por tier mínimo
Manual	Entrada manual de personagens

Fila de pedidos

• Clique em um pedido para marcar como feito
• Arraste para reordenar manualmente
• Selecione a ordenação de pedidos por fila de chegada ou por prioridade
• Botão + adiciona pedido manual

Painel de fontes

Ative/desative cada fonte individualmente e a qualquer momento:

• Donates: configure valor mínimo
• Chat: configure comando e tier mínimo de inscrito (ex: só Tier 2 e 3 podem pedir)
• Resubs: mensagens de reinscrição

Arraste os pills de prioridade para definir ordem que os novos pedidos entram na fila.