Crea tu sala

Integración con Discord

Avisos por webhook, chat en ambos sentidos con un bot y buenas prácticas de seguridad.

Conectar la sala al Discord de tu comunidad trae a la gente de vuelta: avisos de partida, resultados, el enlace de la sala y hasta hablar con quien está jugando. El discord.ts del proyecto de ejemplo muestra las dos formas.

FormaHaceNecesita
WebhookSolo envía mensajes (resultados, "sala en línea")Una URL de webhook
BotEnvía y recibe: chat sala ↔ canal, comandosUn bot en el Discord Developer Portal

Forma 1: webhook (5 minutos)

  1. En Discord: Configuración del canal → Integraciones → Webhooks → Nuevo webhook.
  2. Copia la URL y ponla en el .env: DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
  3. Listo. La sala de ejemplo avisa el 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: [] } }),
  });
}

Forma 2: bot con chat en ambos sentidos

Crear el bot

  1. Entra en discord.com/developers/applications → New Application.
  2. Pestaña Bot → Reset Token y copia el token en DISCORD_TOKEN del .env.
  3. Todavía en la pestaña Bot, activa Message Content Intent (sin ella el bot no lee el texto de los mensajes).
  4. Pestaña OAuth2 → URL Generator: marca bot y los permisos View Channels, Send Messages y Read Message History. Abre la URL generada y añade el bot a tu servidor.
  5. En Discord, activa el Modo desarrollador (Configuración → Avanzado), haz clic derecho en el canal → Copiar ID y ponlo en DISCORD_CANAL.

Qué hace el ejemplo

  • Cada mensaje del chat de la sala va al canal: **Ana**: gg
  • Cada mensaje del canal va a la sala: [discord] Bruno: buena partida
  • El resultado de cada partida y el enlace de la sala (cuando arranca) van al canal.

La pieza que une las dos puntas, en 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}`);

(PonteDiscord = puente a Discord, aoReceber = al recibir, enviar = enviar.)

El código completo

ts
// discord.ts
import { Client, Events, GatewayIntentBits, type SendableChannels } from 'discord.js';

/** Forma más simple: solo AVISAR en Discord (sin bot). Crea el webhook en Canal > Editar > Integraciones. */
export async function avisarWebhook(url: string, texto: string): Promise<void> {
  await fetch(url, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    // allowed_mentions vacío: nadie puede mencionar a @everyone escribiéndolo como nombre en el juego
    body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
  }).catch((err) => console.error('[discord] webhook falhou', err));
}

/** Bot de verdad: chat en ambos sentidos (sala <-> canal) y comandos. */
export class PonteDiscord {
  private canal: SendableChannels | null = null;
  /** Mensajes que llegan del canal de Discord (el bot ignora los suyos y los de otros 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();
  }
}

/** Quita el formato de Discord de lo que viene del juego (un nombre "**admin**" no queda en negrita, `@` no se vuelve mención). */
export const limpar = (t: string) => t.replace(/[\*_~`|>@#]/g, (c) => `\${c}`);

Seguridad y sentido común

  • Escapa lo que viene del juego. Nombres y mensajes de los jugadores pueden tener **, `, @... La función limpar() ("limpiar") pone \ antes de esos caracteres para que nada se vuelva formato o mención.
  • Ignora bots en el canal (incluido el tuyo); si no, los mensajes hacen eco infinito.
  • Limita el tamaño. Discord acepta hasta 2000 caracteres por mensaje; el chat de bonk, unos 95 por línea.
  • Puente de una sola vía para moderar. Si el canal es público, considera enviar solo sala → Discord y dejar el camino Discord → sala para un rol de staff.

Yendo más allá

IdeaCómo
Comando /sala que responde el enlace y quién está jugandoSlash commands de discord.js (SlashCommandBuilder) leyendo room.state.players
Rol para quien juega muchoVincula la cuenta de bonk a Discord con un código de 6 dígitos que el bot envía por privado y el jugador escribe en la sala (!vincular 123456)
Replays en DiscordEnvía el .bkrp como adjunto (files: [{ attachment: ruta }]) al final de cada partida
Varios procesos (sala y bot separados)La sala abre una pequeña API HTTP local (solo 127.0.0.1, con token) con /status y un flujo de eventos; el bot de Discord la consume. Así funcionaban las salas de BonkTools: un bot para varias salas