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.
| Weg | Macht | Braucht |
|---|---|---|
| Webhook | Sendet nur Nachrichten (Ergebnisse, „Raum ist online“) | Eine Webhook-URL |
| Bot | Sendet und empfängt: Chat Raum ↔ Kanal, Befehle | Einen Bot im Discord Developer Portal |
Weg 1: Webhook (5 Minuten)
- In Discord: Kanaleinstellungen → Integrationen → Webhooks → Neuer Webhook.
- URL kopieren und in die
.enveintragen:DISCORD_WEBHOOK=https://discord.com/api/webhooks/... - 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
- Geh zu discord.com/developers/applications → New Application.
- Reiter Bot → Reset Token und kopiere das Token nach
DISCORD_TOKENin der.env. - Ebenfalls im Reiter Bot: Message Content Intent einschalten (ohne ihn liest der Bot keinen Nachrichtentext).
- Reiter OAuth2 → URL Generator:
botund die Berechtigungen View Channels, Send Messages und Read Message History anhaken. Die erzeugte URL öffnen und den Bot zu deinem Server hinzufügen. - In Discord den Entwicklermodus einschalten (Einstellungen → Erweitert), Rechtsklick auf den Kanal → ID kopieren und in
DISCORD_CANALeintragen.
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 Funktionlimpar()(„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
| Idee | Wie |
|---|---|
Befehl /sala, der den Link und die Spieler nennt | Slash-Commands von discord.js (SlashCommandBuilder), die room.state.players lesen |
| Rolle für Vielspieler | Das bonk-Konto mit Discord verknüpfen: der Bot schickt einen 6-stelligen Code privat, der Spieler tippt ihn im Raum (!vincular 123456) |
| Replays auf Discord | Die .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 |