Eigener Raum

Discord-Integration

Benachrichtigungen per Webhook, Chat in beide Richtungen mit einem Bot und Sicherheitstipps.

Den Raum mit dem Discord deiner Community zu verbinden, bringt die Leute zurück: Spielankündigungen, Ergebnisse, der Link zum Raum und sogar Gespräche mit denen, die gerade spielen. Die Datei discord.ts im Beispielprojekt zeigt beide Wege.

WegMachtBraucht
WebhookSendet nur Nachrichten (Ergebnisse, „Raum ist online“)Eine Webhook-URL
BotSendet und empfängt: Chat Raum ↔ Kanal, BefehleEinen Bot im Discord Developer Portal

Weg 1: Webhook (5 Minuten)

  1. In Discord: Kanaleinstellungen → Integrationen → Webhooks → Neuer Webhook.
  2. URL kopieren und in die .env eintragen: DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
  3. Fertig. Der Beispielraum meldet das Ergebnis jedes Spiels.
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: [] } }),
  });
}

Weg 2: Bot mit Chat in beide Richtungen

Den Bot erstellen

  1. Geh zu discord.com/developers/applications → New Application.
  2. Reiter Bot → Reset Token und kopiere das Token nach DISCORD_TOKEN in der .env.
  3. Ebenfalls im Reiter Bot: Message Content Intent einschalten (ohne ihn liest der Bot keinen Nachrichtentext).
  4. Reiter OAuth2 → URL Generator: bot und die Berechtigungen View Channels, Send Messages und Read Message History anhaken. Die erzeugte URL öffnen und den Bot zu deinem Server hinzufügen.
  5. In Discord den Entwicklermodus einschalten (Einstellungen → Erweitert), Rechtsklick auf den Kanal → ID kopieren und in DISCORD_CANAL eintragen.

Was das Beispiel macht

  • Jede Nachricht im Raum-Chat geht in den Kanal: **Ana**: gg
  • Jede Nachricht im Kanal geht in den Raum: [discord] Bruno: gutes Spiel
  • Das Ergebnis jedes Spiels und der Raum-Link (beim Start) gehen in den Kanal.

Das Stück, das beide Enden verbindet, in 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 = Discord-Brücke, aoReceber = beim Empfangen, enviar = senden.)

Der vollständige Code

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

/** Am einfachsten: nur auf Discord BENACHRICHTIGEN (ohne Bot). Webhook unter Kanal > Bearbeiten > Integrationen anlegen. */
export async function avisarWebhook(url: string, texto: string): Promise<void> {
  await fetch(url, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    // leeres allowed_mentions: niemand kann @everyone über seinen Spielnamen erwähnen
    body: JSON.stringify({ content: texto.slice(0, 2000), allowed_mentions: { parse: [] } }),
  }).catch((err) => console.error('[discord] webhook falhou', err));
}

/** Ein echter Bot: Chat in beide Richtungen (Raum <-> Kanal) und Befehle. */
export class PonteDiscord {
  private canal: SendableChannels | null = null;
  /** Nachrichten aus dem Discord-Kanal (der Bot ignoriert seine eigenen und die anderer 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();
  }
}

/** Entfernt Discord-Formatierung aus Spieltext (ein Name "**admin**" wird nicht fett, `@` wird keine Erwähnung). */
export const limpar = (t: string) => t.replace(/[\*_~`|>@#]/g, (c) => `\${c}`);

Sicherheit und gesunder Menschenverstand

  • Escape, was aus dem Spiel kommt. Spielernamen und -nachrichten können **, `, @... enthalten. Die Funktion limpar() („säubern“) setzt ein \ vor diese Zeichen, damit nichts zu Formatierung oder Erwähnung wird.
  • Ignoriere Bots im Kanal (auch deinen eigenen), sonst entsteht ein endloses Echo.
  • Begrenze die Länge. Discord akzeptiert bis zu 2000 Zeichen pro Nachricht; der bonk-Chat etwa 95 pro Zeile.
  • Einbahnstraße zum Moderieren. Ist der Kanal öffentlich, sende eventuell nur Raum → Discord und erlaube Discord → Raum nur einer Staff-Rolle.

Weiterführend

IdeeWie
Befehl /sala, der den Link und die Spieler nenntSlash-Commands von discord.js (SlashCommandBuilder), die room.state.players lesen
Rolle für VielspielerDas bonk-Konto mit Discord verknüpfen: der Bot schickt einen 6-stelligen Code privat, der Spieler tippt ihn im Raum (!vincular 123456)
Replays auf DiscordDie .bkrp am Ende jedes Spiels als Anhang senden (files: [{ attachment: pfad }])
Mehrere Prozesse (Raum und Bot getrennt)Der Raum öffnet eine kleine lokale HTTP-API (nur 127.0.0.1, mit Token) mit /status und einem Ereignisstrom; der Discord-Bot nutzt sie. So funktionierten die BonkTools-Räume: ein Bot für mehrere Räume