Bibliothèque

Actions et méthodes

Tout ce que l'hôte peut faire : salon, partie, modération, équipes et hôte.

Toutes les méthodes ci-dessous sont fire-and-forget : elles envoient le paquet au serveur et rendent la main. Pour connaître le résultat, écoutez les événements correspondants (voir État et événements).

Salon

ts
room.setRoomName('Nouveau Nom');
room.setRoomPassword('nouveau_mot_de_passe');  // '' retire le mot de passe
room.chat('Bonjour !');

Partie

ts
room.startGame();              // voir « Parties, IS blob et spectateurs » pour l'état initial
room.stopGame();               // renvoie tout le monde au lobby
room.startCountdown(3);        // compte à rebours de 3 s (par défaut : 3)
room.abortCountdown();

room.setMode('b', 'b');        // engine, mode
room.setRounds(5);
room.setMap(lzStringBlob);     // change la carte du salon
room.setReady(true);           // marque le bot lui-même comme prêt
room.allReadyReset();          // réinitialise le « prêt » de tous

Modération

ts
room.kickPlayer(id);   // expulse sans bannir
room.banPlayer(id);    // bannissement permanent

Équipes et hôte

ts
// équipe : 0 spec · 1 ffa · 2 rouge · 3 bleu · 4 vert · 5 jaune
room.setTeam(id, 3);            // déplace UN AUTRE joueur (hôte uniquement)
room.joinTeam(0);               // déplace le bot LUI-MÊME

room.lockTeams();               // verrouille : les joueurs ne changent pas d'équipe seuls
room.unlockTeams();
room.setTeamsEnabled(true);     // active/désactive le mode équipes

room.giveHost(id);              // cède l'hôte
room.setNoHostSwap(true);       // empêche le changement automatique d'hôte

Plus de détails sur le verrouillage des équipes dans Équipes et verrouillage.

Anti-AFK

ts
room.enableAntiAfk({ thresholdMs: 12_000 });
room.isAfk(playerId);
room.disableAntiAfk();

Voir Anti-AFK.

Déconnecter

ts
room.disconnect();   // idempotent : nettoie timers, listeners internes et état

Limites de débit

Le serveur limite la fréquence de plusieurs commandes (changements d'équipe, verrouillage, changements de mode, compte à rebours). Dans ce cas, vous recevez un status-message avec un code comme rate_limit_tl. La bibliothèque évite déjà les rafales quand elle le peut (par exemple, appeler lockTeams() plusieurs fois n'envoie le paquet qu'une seule fois), mais si vous lancez des commandes dans une boucle, espacez les appels.