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:

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:

CampoO que é
c.idid de quem digitou
c.nomenome de quem digitou
c.argspalavras depois do comando (!kick ana → ['ana'])
c.rooma 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.

ts
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 é:

ts
.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

ts
// 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

ComandoComo fazer
!mute nomeGuarde o id num Set e, no chat() do sala.ts, ignore (e não repasse ao Discord) mensagens de quem está nele
!placarGuarde o último scores do evento score e responda
!senha novaroom.setRoomPassword(c.args[0] ?? '') (só admin)
!nome Novo Nomeroom.setRoomName(c.args.join(' ')) (só admin)
!statusVitórias e golos de quem pediu: veja como contar em Gravar partidas
!bbroom.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.