Crie a sua sala
Comandos, admins e moderação
Um roteador de comandos de chat, admins que não podem ser imitados e kick/ban pelo chat.
Comandos de chat (!afk, !discord, !kick nome...) são a forma de os jogadores e admins conversarem com o bot. O comandos.ts do projeto de exemplo é um roteador pequeno: você regista um comando e ele cuida do resto.
Registar um comando
No sala.ts:
this.comandos
.registrar('afk', { ajuda: 'entra/sai do AFK', executar: (c) => c.responder(this.pick.alternarAfk(c.id)) })
.registrar('discord', { ajuda: 'link do Discord', executar: (c) => c.responder('entre no nosso Discord: discord.gg/SEU-CONVITE') });Cada comando recebe um contexto c com:
| Campo | O que é |
|---|---|
c.id | id de quem digitou |
c.nome | nome de quem digitou |
c.args | palavras depois do comando (!kick ana → ['ana']) |
c.room | a sala, para chamar kickPlayer, setTeam... |
c.responder(texto) | responde no chat (quebra textos longos sozinho) |
O !ajuda lista os comandos que a pessoa pode usar: admins veem também os de admin.
Admins: nunca confie só no nome
No bonk.io, convidados podem usar qualquer nome. Se o seu bot confiar só no nome, qualquer um entra como convidado com o nome do dono e vira admin. Por isso a regra do exemplo é: nome na lista e conta registada.
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());
}Comandos de admin
Um comando com soAdmin: true responde "só para admins" a quem não é:
.registrar('kick', {
ajuda: 'expulsa: !kick nome', soAdmin: true,
executar: (c) => {
const alvo = acharJogador(room, c.args[0] ?? '');
if (alvo === null) return c.responder('jogador não encontrado');
room.kickPlayer(alvo);
},
})acharJogador procura pelo começo do nome, sem diferenciar maiúsculas: !kick ana acha Ana_123. O bot nunca acha a si mesmo.
O código completo
// comandos.ts
import type { BonkRoom } from 'bonktools';
import { config } from './config.js';
export interface Contexto {
room: BonkRoom;
id: number; // quem digitou
nome: string;
args: string[];
responder: (texto: string) => void;
}
interface Comando {
ajuda: string;
soAdmin?: boolean;
executar: (ctx: Contexto) => void;
}
/** Roteador de comandos: "!nome arg1 arg2". Para criar um comando novo, basta registrar. */
export class Comandos {
private readonly lista = new Map<string, Comando>();
registrar(nome: string, comando: Comando): this {
this.lista.set(nome.toLowerCase(), comando);
return this;
}
/** Devolve true se a mensagem era um comando (e já foi tratada). */
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 = nome na lista E conta registrada. Convidados (guest) podem usar QUALQUER nome,
* então nunca confie só no nome de um convidado.
*/
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());
}
/** Acha um jogador pelo começo do nome ("!kick ana" acha "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;
}Ideias de comandos
| Comando | Como fazer |
|---|---|
!mute nome | Guarde o id num Set e, no chat() do sala.ts, ignore (e não repasse ao Discord) mensagens de quem está nele |
!placar | Guarde o último scores do evento score e responda |
!senha nova | room.setRoomPassword(c.args[0] ?? '') (só admin) |
!nome Novo Nome | room.setRoomName(c.args.join(' ')) (só admin) |
!status | Vitórias e golos de quem pediu: veja como contar em Gravar partidas |
!bb | room.kickPlayer(c.id): o jogador sai sozinho |
Anti-flood
O chat do bonk.io tem limite de mensagens por segundo, e o servidor pode barrar a sua sala se ela falar demais. Algumas regras que evitam dor de cabeça:
- Agrupe mensagens. Em vez de "bem-vindo" para cada um que entra, junte os nomes que entraram nos últimos 3 segundos numa linha só.
- Uma linha por evento. O anúncio do pick cabe em duas linhas; o golo, em uma.
- Limite por jogador. Se alguém manda 10 comandos em 5 segundos, ignore os próximos por um tempo.