Crea tu sala

Comandos, admins y moderación

Un enrutador de comandos de chat, admins que no se pueden suplantar y kick/ban por el chat.

Los comandos de chat (!afk, !discord, !kick nombre...) son la forma en que jugadores y admins hablan con el bot. El comandos.ts del proyecto de ejemplo es un enrutador pequeño: registras un comando y él se encarga del resto.

Registrar un comando

En sala.ts:

ts
this.comandos
  .registrar('afk', { ajuda: 'entra/sale del AFK', executar: (c) => c.responder(this.pick.alternarAfk(c.id)) })
  .registrar('discord', { ajuda: 'enlace de Discord', executar: (c) => c.responder('entra a nuestro Discord: discord.gg/TU-INVITACION') });

(registrar = registrar, ajuda = ayuda, executar = ejecutar.) Cada comando recibe un contexto c con:

CampoQué es
c.idid de quien escribió
c.nomenombre de quien escribió
c.argspalabras después del comando (!kick ana → ['ana'])
c.roomla sala, para llamar a kickPlayer, setTeam...
c.responder(texto)responde en el chat (parte los textos largos solo)

!ajuda ("ayuda") lista los comandos que la persona puede usar: los admins ven también los de admin.

Admins: nunca confíes solo en el nombre

En bonk.io, los invitados pueden usar cualquier nombre. Si tu bot confía solo en el nombre, cualquiera entra como invitado con el nombre del dueño y se vuelve admin. Por eso la regla del ejemplo es: nombre en la lista y cuenta registrada.

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

Un comando con soAdmin: true ("solo admin") responde "solo para admins" a quien no lo es:

ts
.registrar('kick', {
  ajuda: 'expulsa: !kick nombre', soAdmin: true,
  executar: (c) => {
    const alvo = acharJogador(room, c.args[0] ?? '');
    if (alvo === null) return c.responder('jugador no encontrado');
    room.kickPlayer(alvo);
  },
})

acharJogador ("encontrar jugador") busca por el comienzo del nombre, sin distinguir mayúsculas: !kick ana encuentra Ana_123. El bot nunca se encuentra a sí mismo.

El código completo

ts
// comandos.ts
import type { BonkRoom } from 'bonktools';
import { config } from './config.js';

export interface Contexto {
  room: BonkRoom;
  id: number; // quien lo escribió
  nome: string;
  args: string[];
  responder: (texto: string) => void;
}

interface Comando {
  ajuda: string;
  soAdmin?: boolean;
  executar: (ctx: Contexto) => void;
}

/** Enrutador de comandos: "!nombre arg1 arg2". Para crear un comando nuevo, basta registrarlo. */
export class Comandos {
  private readonly lista = new Map<string, Comando>();

  registrar(nome: string, comando: Comando): this {
    this.lista.set(nome.toLowerCase(), comando);
    return this;
  }

  /** Devuelve true si el mensaje era un comando (y ya se trató). */
  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 = nombre en la lista Y cuenta registrada. Los invitados (guest) pueden usar CUALQUIER nombre,
 * así que nunca confíes solo en el nombre de un invitado.
 */
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());
}

/** Encuentra a un jugador por el comienzo del nombre ("!kick ana" encuentra "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;
}

Ideas de comandos

ComandoCómo hacerlo
!mute nombreGuarda el id en un Set y, en el chat() de sala.ts, ignora (y no reenvíes a Discord) los mensajes de quien esté en él
!placar (marcador)Guarda el último scores del evento score y respóndelo
!senha nueva (contraseña)room.setRoomPassword(c.args[0] ?? '') (solo admin)
!nome Nuevo Nombreroom.setRoomName(c.args.join(' ')) (solo admin)
!statusVictorias y goles de quien lo pidió: ver cómo contarlos en Grabar partidas
!bbroom.kickPlayer(c.id): el jugador sale solo

Anti-flood

El chat de bonk.io tiene un límite de mensajes por segundo, y el servidor puede bloquear tu sala si habla demasiado. Algunas reglas que evitan dolores de cabeza:

  • Agrupa mensajes. En lugar de un "bienvenido" para cada uno que entra, junta en una sola línea los nombres que entraron en los últimos 3 segundos.
  • Una línea por evento. El anuncio del pick cabe en dos líneas; el gol, en una.
  • Límite por jugador. Si alguien manda 10 comandos en 5 segundos, ignora los siguientes por un rato.