Créez votre salon
Commandes, admins et modération
Un routeur de commandes de chat, des admins impossibles à usurper et kick/ban depuis le chat.
Les commandes de chat (!afk, !discord, !kick nom...) sont la façon dont les joueurs et les admins parlent au bot. Le fichier comandos.ts (« commandes ») du projet d'exemple est un petit routeur : vous enregistrez une commande et il s'occupe du reste.
Enregistrer une commande
Dans sala.ts :
this.comandos
.registrar('afk', { ajuda: 'active/désactive l\'AFK', executar: (c) => c.responder(this.pick.alternarAfk(c.id)) })
.registrar('discord', { ajuda: 'lien Discord', executar: (c) => c.responder('rejoignez notre Discord : discord.gg/VOTRE-INVITATION') });(registrar = enregistrer, ajuda = aide, executar = exécuter.) Chaque commande reçoit un contexte c avec :
| Champ | Ce que c'est |
|---|---|
c.id | id de qui a écrit |
c.nome | nom de qui a écrit |
c.args | mots après la commande (!kick ana → ['ana']) |
c.room | le salon, pour appeler kickPlayer, setTeam... |
c.responder(texte) | répond dans le chat (coupe tout seul les textes longs) |
!ajuda (« aide ») liste les commandes que la personne peut utiliser : les admins voient aussi celles d'admin.
Admins : ne jamais se fier au seul nom
Sur bonk.io, les invités peuvent utiliser n'importe quel nom. Si votre bot se fie au seul nom, n'importe qui entre en invité avec le nom du propriétaire et devient admin. D'où la règle de l'exemple : nom dans la liste et compte enregistré.
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());
}Commandes d'admin
Une commande avec soAdmin: true (« admin seulement ») répond « réservé aux admins » aux autres :
.registrar('kick', {
ajuda: 'expulse : !kick nom', soAdmin: true,
executar: (c) => {
const alvo = acharJogador(room, c.args[0] ?? '');
if (alvo === null) return c.responder('joueur introuvable');
room.kickPlayer(alvo);
},
})acharJogador (« trouver un joueur ») cherche par le début du nom, sans tenir compte de la casse : !kick ana trouve Ana_123. Le bot ne se trouve jamais lui-même.
Le code complet
// comandos.ts
import type { BonkRoom } from 'bonktools';
import { config } from './config.js';
export interface Contexto {
room: BonkRoom;
id: number; // qui l'a tapé
nome: string;
args: string[];
responder: (texto: string) => void;
}
interface Comando {
ajuda: string;
soAdmin?: boolean;
executar: (ctx: Contexto) => void;
}
/** Routeur de commandes : "!nom arg1 arg2". Pour créer une commande, il suffit de l'enregistrer. */
export class Comandos {
private readonly lista = new Map<string, Comando>();
registrar(nome: string, comando: Comando): this {
this.lista.set(nome.toLowerCase(), comando);
return this;
}
/** Renvoie true si le message était une commande (déjà traitée). */
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 = nom dans la liste ET compte enregistré. Les invités (guest) peuvent utiliser N'IMPORTE QUEL nom,
* donc ne faites jamais confiance au seul nom d'un invité.
*/
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());
}
/** Trouve un joueur par le début de son nom ("!kick ana" trouve "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;
}Idées de commandes
| Commande | Comment faire |
|---|---|
!mute nom | Gardez l'id dans un Set et, dans le chat() de sala.ts, ignorez (et ne transmettez pas à Discord) les messages de qui y figure |
!placar (score) | Gardez le dernier scores de l'événement score et répondez-le |
!senha nouveau (mot de passe) | room.setRoomPassword(c.args[0] ?? '') (admin seulement) |
!nome Nouveau Nom | room.setRoomName(c.args.join(' ')) (admin seulement) |
!status | Victoires et buts de qui le demande : voir comment les compter dans Enregistrer les matchs |
!bb | room.kickPlayer(c.id) : le joueur sort de lui-même |
Anti-flood
Le chat de bonk.io a une limite de messages par seconde, et le serveur peut bloquer votre salon s'il parle trop. Quelques règles qui évitent des maux de tête :
- Regroupez les messages. Au lieu d'un « bienvenue » pour chaque arrivant, réunissez sur une ligne les noms arrivés dans les 3 dernières secondes.
- Une ligne par événement. L'annonce du pick tient en deux lignes ; un but, en une.
- Limite par joueur. Si quelqu'un envoie 10 commandes en 5 secondes, ignorez les suivantes un moment.