Bibliothek

Anti-AFK

Erkenne inaktive Spieler anhand von Bewegung und Chat, mit 12 s Toleranz.

Anti-AFK markiert einen Spieler als AFK, der 12 Sekunden lang weder bewegt noch geschrieben hat. Jedes der beiden Signale setzt die Uhr zurück.

ts
room.enableAntiAfk();                                  // Standard: 12 s

room.on('player-afk',  (id) => room.kickPlayer(id));   // einmal, wenn er AFK wird
room.on('player-back', (id) => room.chat(`Spieler ${id} ist zurück`));

room.isAfk(playerId);                                  // einmalige Abfrage
room.disableAntiAfk();

Optionen

ts
room.enableAntiAfk({
  thresholdMs: 12_000,     // Ruhezeit, bis er AFK wird
  checkIntervalMs: 1_000,  // Häufigkeit der Prüfung
});

Die Standardzeit steht auch als Konstante AFK_THRESHOLD_MS zur Verfügung.

Wer überwacht wird

Nur Spieler, die während einer Partie in einem Team sind. Zuschauer und der Bot selbst werden ignoriert. Die Uhr startet mit dem Beginn der Partie (oder wenn der Spieler während der Partie einem Team beitritt) und wird beim Ende der Partie verworfen.

Woher die Signale kommen

SignalQuelleEvent
ChatSocket.IOchat-message
BewegungSocket.IO (Paket 7) und WebRTC (Input-Frames)raw-packet / peer-input

Die Bewegung kommt auf zwei Wegen an: über Socket.IO im Paket 7 ([7, id, {i, f, c}], mit Tastenmaske und Frame), was der zuverlässigere ist, und über die WebRTC-Input-Frames. Die Bibliothek nutzt beide. Eine gehaltene Taste zählt als Aktivität: Wer eine Richtung gedrückt hält, wird nicht AFK markiert, nur weil er keine neuen Events erzeugt.

peer-input liefert { playerId, peerID, data }, wobei der Frame bereits dem richtigen Spieler zugeordnet ist. Du kannst es direkt für Aktivitätsstatistiken nutzen.

Wichtige Einschränkungen

  • Braucht den echten Modus. Das Event peer-input existiert nur, wenn der Raum den echten Transport nutzt (mit peerID), wie bei createRoom() und joinRoom(). Bei Tests mit einem Fake-Transport emittiere peer-input manuell.
  • Zuverlässigkeit des Signals. Kommt aus irgendeinem Grund während einer ganzen Partie kein Bewegungs-Frame an, ist das Signal nicht zuverlässig. Der 24/7-Raum ignoriert das automatische AFK in diesem Fall, damit nie alle wegen eines Netzwerkfehlers bestraft werden. Mach es genauso, wenn du Strafen verhängst.

Vollständiges Beispiel

ts
import type { BonkRoom } from 'bonktools';

export function setupAntiAfk(room: BonkRoom): void {
  room.enableAntiAfk();

  const name = (id: number) => room.state.players.get(id)?.userName ?? `#${id}`;

  room.on('player-afk', (id) => {
    room.chat(`${name(id)} ist AFK!`);
    room.kickPlayer(id); // entferne diese Zeile, wenn du nur warnen willst
  });

  room.on('player-back', (id) => room.chat(`${name(id)} ist zurück.`));
}