Eigener Raum
Befehle, Admins und Moderation
Ein Router für Chatbefehle, Admins, die man nicht nachahmen kann, und Kick/Bann über den Chat.
Chatbefehle (!afk, !discord, !kick name...) sind der Weg, wie Spieler und Admins mit dem Bot reden. Die Datei comandos.ts („Befehle“) im Beispielprojekt ist ein kleiner Router: Du registrierst einen Befehl und er erledigt den Rest.
Einen Befehl registrieren
In sala.ts:
this.comandos
.registrar('afk', { ajuda: 'AFK an/aus', executar: (c) => c.responder(this.pick.alternarAfk(c.id)) })
.registrar('discord', { ajuda: 'Discord-Link', executar: (c) => c.responder('komm auf unseren Discord: discord.gg/DEINE-EINLADUNG') });(registrar = registrieren, ajuda = Hilfe, executar = ausführen.) Jeder Befehl bekommt einen Kontext c mit:
| Feld | Was es ist |
|---|---|
c.id | ID dessen, der getippt hat |
c.nome | Name dessen, der getippt hat |
c.args | Wörter nach dem Befehl (!kick ana → ['ana']) |
c.room | der Raum, um kickPlayer, setTeam... aufzurufen |
c.responder(text) | antwortet im Chat (teilt lange Texte selbst) |
!ajuda („Hilfe“) listet die Befehle, die die Person nutzen darf: Admins sehen auch die Admin-Befehle.
Admins: Verlass dich nie nur auf den Namen
Auf bonk.io können Gäste jeden beliebigen Namen nutzen. Vertraut dein Bot nur dem Namen, kann jeder als Gast mit dem Namen des Besitzers beitreten und Admin werden. Deshalb lautet die Regel im Beispiel: Name auf der Liste und registriertes Konto.
export function ehAdmin(room: BonkRoom, id: number): boolean {
const p = room.state.players.get(id);
return !!p && !p.guest && config.admins.includes(p.userName.toLowerCase());
}Admin-Befehle
Ein Befehl mit soAdmin: true („nur Admin“) antwortet allen anderen mit „nur für Admins“:
.registrar('kick', {
ajuda: 'wirft raus: !kick name', soAdmin: true,
executar: (c) => {
const alvo = acharJogador(room, c.args[0] ?? '');
if (alvo === null) return c.responder('Spieler nicht gefunden');
room.kickPlayer(alvo);
},
})acharJogador („Spieler finden“) sucht nach dem Anfang des Namens, ohne Groß-/Kleinschreibung: !kick ana findet Ana_123. Der Bot findet nie sich selbst.
Der vollständige Code
// comandos.ts
import type { BonkRoom } from 'bonktools';
import { config } from './config.js';
export interface Contexto {
room: BonkRoom;
id: number; // wer es getippt hat
nome: string;
args: string[];
responder: (texto: string) => void;
}
interface Comando {
ajuda: string;
soAdmin?: boolean;
executar: (ctx: Contexto) => void;
}
/** Befehlsrouter: "!name arg1 arg2". Für einen neuen Befehl genügt es, ihn zu registrieren. */
export class Comandos {
private readonly lista = new Map<string, Comando>();
registrar(nome: string, comando: Comando): this {
this.lista.set(nome.toLowerCase(), comando);
return this;
}
/** Gibt true zurück, wenn die Nachricht ein Befehl war (und erledigt ist). */
tratar(room: BonkRoom, id: number, mensagem: string, responder: (t: string) => void): boolean {
if (!mensagem.startsWith('!')) return false;
const [nomeCmd = '', ...args] = mensagem.slice(1).trim().split(/\s+/);
const cmd = this.lista.get(nomeCmd.toLowerCase());
if (!cmd) return false;
const nome = room.state.players.get(id)?.userName ?? '';
if (cmd.soAdmin && !ehAdmin(room, id)) {
responder('esse comando é só para admins');
return true;
}
cmd.executar({ room, id, nome, args, responder });
return true;
}
ajuda(admin: boolean): string {
return [...this.lista].filter(([, c]) => admin || !c.soAdmin).map(([n]) => `!${n}`).join(' ');
}
}
/**
* Admin = Name auf der Liste UND registriertes Konto. Gäste können JEDEN Namen verwenden,
* vertraue also nie nur dem Namen eines Gastes.
*/
export function ehAdmin(room: BonkRoom, id: number): boolean {
const p = room.state.players.get(id);
return !!p && !p.guest && config.admins.includes(p.userName.toLowerCase());
}
/** Findet einen Spieler über den Namensanfang ("!kick ana" findet "Ana_123"). */
export function acharJogador(room: BonkRoom, busca: string): number | null {
const b = busca.toLowerCase();
for (const [id, p] of room.state.players) if (id !== room.state.myId && p.userName.toLowerCase().startsWith(b)) return id;
return null;
}Befehlsideen
| Befehl | Wie |
|---|---|
!mute name | Die ID in einem Set merken und in chat() von sala.ts Nachrichten von allen darin ignorieren (und nicht an Discord weiterleiten) |
!placar (Spielstand) | Das letzte scores aus dem Ereignis score merken und damit antworten |
!senha neu (Passwort) | room.setRoomPassword(c.args[0] ?? '') (nur Admin) |
!nome Neuer Name | room.setRoomName(c.args.join(' ')) (nur Admin) |
!status | Siege und Tore der fragenden Person: wie man sie zählt, steht in Spiele aufzeichnen |
!bb | room.kickPlayer(c.id): der Spieler geht von selbst |
Anti-Flood
Der bonk.io-Chat hat ein Limit an Nachrichten pro Sekunde, und der Server kann deinen Raum sperren, wenn er zu viel redet. Ein paar Regeln, die Ärger ersparen:
- Nachrichten bündeln. Statt eines „Willkommen“ für jeden, der beitritt, fasse die Namen der letzten 3 Sekunden in einer Zeile zusammen.
- Eine Zeile pro Ereignis. Die Pick-Ansage passt in zwei Zeilen, ein Tor in eine.
- Limit pro Spieler. Schickt jemand 10 Befehle in 5 Sekunden, ignoriere die nächsten eine Weile.