Crie sua sala
Integração com o Discord
Avisos por webhook, chat nos dois sentidos com um bot e boas práticas de segurança.
Ligar a sala ao Discord da sua comunidade traz as pessoas de volta: avisos de partida, resultado, o link da sala e até conversar com quem está jogando. O discord.ts do projeto de exemplo mostra os dois jeitos.
| Jeito | Faz | Precisa de |
|---|---|---|
| Webhook | Só manda mensagens (resultados, "sala no ar") | Uma URL de webhook |
| Bot | Manda e recebe: chat sala ↔ canal, comandos | Um bot no Discord Developer Portal |
Jeito 1: webhook (5 minutos)
- No Discord: Configurações do canal → Integrações → Webhooks → Novo webhook.
- Copie a URL e coloque no
.env:DISCORD_WEBHOOK=https://discord.com/api/webhooks/... - Pronto. A sala de exemplo avisa o resultado de cada partida.
ts
export async function avisarWebhook(url: string, texto: string): Promise<void> {
await fetch(url, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
});
}Jeito 2: bot com chat nos dois sentidos
Criar o bot
- Entre em discord.com/developers/applications → New Application.
- Aba Bot → Reset Token e copie o token para
DISCORD_TOKENno.env. - Ainda na aba Bot, ligue Message Content Intent (sem ela o bot não lê o texto das mensagens).
- Aba OAuth2 → URL Generator: marque
bote as permissões View Channels, Send Messages e Read Message History. Abra a URL gerada e adicione o bot ao seu servidor. - No Discord, ative o Modo desenvolvedor (Configurações → Avançado), clique com o botão direito no canal → Copiar ID e coloque em
DISCORD_CANAL.
O que o exemplo faz
- Toda mensagem do chat da sala vai para o canal:
**Ana**: gg - Toda mensagem do canal vai para a sala:
[discord] Bruno: boa partida - O resultado de cada partida e o link da sala (quando ela sobe) vão para o canal.
O pedaço que liga as duas pontas, no sala.ts:
ts
this.discord = await PonteDiscord.conectar(token, canal);
this.discord.aoReceber = (autor, texto) => falar(this.room, `[discord] ${autor}: ${texto}`);
this.discord.enviar(`sala no ar: ${this.room.shareLink}`);O código completo
ts
// discord.ts
import { Client, Events, GatewayIntentBits, type SendableChannels } from 'discord.js';
/** Forma mais simples: só AVISAR no Discord (sem bot). Crie o webhook em Canal > Editar > Integrações. */
export async function avisarWebhook(url: string, texto: string): Promise<void> {
await fetch(url, {
method: 'POST',
headers: { 'content-type': 'application/json' },
// allowed_mentions vazio: ninguém consegue marcar @everyone escrevendo o nome no jogo
body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
}).catch((err) => console.error('[discord] webhook falhou', err));
}
/** Bot de verdade: chat nos dois sentidos (sala <-> canal) e comandos. */
export class PonteDiscord {
private canal: SendableChannels | null = null;
/** Mensagens que chegam do canal do Discord (o bot ignora as dele e as de outros bots). */
aoReceber: (autor: string, texto: string) => void = () => {};
private constructor(private readonly client: Client) {}
static async conectar(token: string, canalId: string): Promise<PonteDiscord> {
const client = new Client({
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages, GatewayIntentBits.MessageContent],
});
const ponte = new PonteDiscord(client);
client.on(Events.MessageCreate, (msg) => {
if (msg.channelId !== canalId || msg.author.bot || !msg.content) return;
ponte.aoReceber(msg.member?.displayName ?? msg.author.username, msg.content);
});
await client.login(token);
const canal = await client.channels.fetch(canalId);
if (!canal?.isSendable()) throw new Error('canal do Discord não encontrado ou sem permissão de enviar');
ponte.canal = canal;
return ponte;
}
enviar(texto: string): void {
this.canal?.send({ content: texto.slice(0, 2000), allowedMentions: { parse: [] } }).catch((err) => console.error('[discord]', err));
}
destroy(): void {
void this.client.destroy();
}
}
/** Tira formatação do Discord do que veio do jogo (nome "**admin**" não vira negrito, `@` não vira menção). */
export const limpar = (t: string) => t.replace(/[\*_~`|>@#]/g, (c) => `\${c}`);Segurança e bom senso
- Escape o que vem do jogo. Nomes e mensagens dos jogadores podem ter
**,`,@... A funçãolimpar()coloca\antes desses caracteres para nada virar formatação ou menção. - Ignore bots no canal (inclusive o seu), senão as mensagens fazem eco infinito.
- Limite o tamanho. O Discord aceita até 2000 caracteres por mensagem; o chat do bonk, cerca de 95 por linha.
- Ponte em mão única para moderar. Se o canal for público, pense em só mandar sala → Discord e deixar o caminho Discord → sala para um cargo de staff.
Indo além
| Ideia | Como |
|---|---|
Comando /sala que responde o link e quem está jogando | Slash commands do discord.js (SlashCommandBuilder) lendo room.state.players |
| Cargo para quem joga muito | Vincule a conta do bonk ao Discord com um código de 6 dígitos que o bot manda no privado e o jogador digita na sala (!vincular 123456) |
| Replays no Discord | Envie o .bkrp como anexo (files: [{ attachment: caminho }]) ao fim de cada partida |
| Vários processos (sala e bot separados) | A sala abre uma pequena API HTTP local (só 127.0.0.1, com token) com /status e um fluxo de eventos; o bot do Discord consome. Foi assim nas salas da BonkTools: um bot para várias salas |