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.
| Forma | Hace | Necesita |
|---|---|---|
| Webhook | Solo envía mensajes (resultados, "sala en línea") | Una URL de webhook |
| Bot | Envía y recibe: chat sala ↔ canal, comandos | Un bot en el Discord Developer Portal |
Forma 1: webhook (5 minutos)
- En Discord: Configuración del canal → Integraciones → Webhooks → Nuevo webhook.
- Copia la URL y ponla en el
.env:DISCORD_WEBHOOK=https://discord.com/api/webhooks/... - 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
- Entra en discord.com/developers/applications → New Application.
- Pestaña Bot → Reset Token y copia el token en
DISCORD_TOKENdel.env. - Todavía en la pestaña Bot, activa Message Content Intent (sin ella el bot no lee el texto de los mensajes).
- Pestaña OAuth2 → URL Generator: marca
boty los permisos View Channels, Send Messages y Read Message History. Abre la URL generada y añade el bot a tu servidor. - 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ónlimpar()("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á
| Idea | Cómo |
|---|---|
Comando /sala que responde el enlace y quién está jugando | Slash commands de discord.js (SlashCommandBuilder) leyendo room.state.players |
| Rol para quien juega mucho | Vincula 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 Discord | Enví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 |