Référence

Erreurs et dépannage

Symptômes courants, causes et solutions.

Les joueurs ne peuvent pas bouger pendant la partie

Symptôme : la partie démarre, mais les disques restent immobiles au spawn (pâles et sans nom).

Cause courante : le salon est verrouillé (lockTeams()) et le démarrage de la partie a été envoyé avec gs.tl = false.

Solution : utilisez la version 0.1.4 ou supérieure, qui envoie gs.tl selon l'état réel du verrou. Si vous construisez TRIGGER_START à la main, renseignez gs.tl avec la valeur de room.state.teamsLocked.

Un joueur qui arrive pendant la partie reste bloqué au lobby

Cause : l'hôte a envoyé INFORM_IN_LOBBY puis INFORM_IN_GAME (ou l'inverse). Le client n'accepte qu'un paquet de données initiales.

Solution : depuis la 0.1.2, la bibliothèque n'envoie que INFORM_IN_GAME quand une partie démarrée avec startGame({ is }) est active. Si vous démarrez les parties autrement, passez le is pour que le salon sache qu'une partie est en cours.

La partie démarre, mais les joueurs n'apparaissent pas sur le terrain

Cause : l'IS blob est vide ou ne correspond pas à la carte/au nombre de joueurs.

Solution : capturez un blob pour chaque combinaison (voir Parties, IS blob et spectateurs) et utilisez un bal explicite.

rate_limit_tl, rate_limit_cot et autres

Cause : trop de commandes en peu de temps. Le serveur refuse et prévient par un status-message.

Solution : espacez les appels. Un lockTeams() répété n'envoie qu'une seule fois et réessaie tout seul en cas de refus.

Le lien du salon ne s'ouvre pas

Cause : dans les versions antérieures à la 0.1.3, les ids de salon de moins de 6 chiffres arrivaient sans zéros à gauche (par exemple 6813vnxpi au lieu de 006813vnxpi).

Solution : mettez la bibliothèque à jour ; room.shareLink arrive désormais complet.

RoomCreationTimeoutError ou RoomJoinTimeoutError

Le serveur n'a pas répondu à temps (par défaut : 10 s). Vérifiez le réseau et les identifiants, puis réessayez. Augmentez timeoutMs sur les réseaux lents.

room-dead avec status-room_full

Quand le bot n'était pas encore dans le salon, cela signifie qu'il est plein (terminal). S'il y était déjà, l'avis indique seulement qu'un autre joueur a été refusé.

Erreurs TypeScript venant de node_modules/bonktools

Si vous compilez avec skipLibCheck: false, le index.d.ts du paquet peut afficher des erreurs sur socket.io-client et eventemitter3. Laissez skipLibCheck: true (la valeur par défaut de tsc --init) ; avec lui, les types fonctionnent pleinement.

L'anti-AFK marque tout le monde

Le mouvement vient des frames d'input via WebRTC. Si les onglets des joueurs sont en arrière-plan, ou si WebRTC ne s'est pas connecté, aucune frame n'arrive. Voir les limites de l'anti-AFK et vérifiez que peer-input est bien émis.

Les joueurs ne bougent pas après le départ de certains et l'arrivée d'autres

Cause : blob capturé avec les ids d'une autre session (l'IS blob contient un disque par id de joueur).

Solution : utilisez la version 0.2.0 ou supérieure et générez l'état avec ScoreTracker.buildInitialState (ou remapInitialStatePlayers pour un blob solo capturé).

Le jeu ne s'affiche parfois pas (écran sombre) au démarrage

Cause : l'is a été encodé avec LZString.compressToBase64. Le client décode avec decompressFromEncodedURIComponent et tronque l'état quand / ou = apparaissent (RangeError: Illegal offset dans PSON).

Solution : mettez à jour vers la 0.2.0 (encodeInitialState utilise le bon alphabet) et n'envoyez pas de blobs encodés par un autre outil en base64 classique.

Le perdant va en spec au lieu de rejouer

Cause courante : il a été marqué AFK pour 12 s sans appuyer sur une touche à la fin de la partie. Solution : en 0.2.0 une touche maintenue compte comme de l'activité et, dans les parties terminées aux points, l'inactivité finale est ignorée. En test, utilisez BONK_DEBUG=1 pour désactiver l'AFK automatique.

Le salon joue en 1v1 même avec beaucoup de joueurs

Cause : sans BONK_MAXTEAMSIZE dans le .env, l'ancienne appli supposait 1. Solution : définissez BONK_MAXTEAMSIZE=2 (la valeur par défaut est maintenant 2).

Questions fréquentes

Faut-il un compte bonk.io ? Pour héberger des salons 24h/24, oui : utilisez un compte enregistré.

Sur quels systèmes ça tourne ? C'est du Node.js (20.18.1 ou plus récent), sans navigateur ni dépendances natives du jeu. Le développement et les tests ont été faits sous Windows.

Puis-je faire tourner plusieurs salons ? Oui, avec BonkSession. Un seul compte peut maintenir plusieurs salons, en respectant le throttle.

Est-ce officiel ? Non. C'est un projet indépendant, sans affiliation avec bonk.io.

Où signaler un problème ? Ouvrez une issue dans le dépôt de la bibliothèque.