KaraDan' Bonneteau

Guide de démarrage — version 1.0.0

Une boule est cachée sous un verre, les verres se mélangent sur la télé, et chaque joueur touche sur son téléphone le verre qui cache la boule. Ceux qui se trompent sont éliminés ; le dernier en jeu gagne. Vous réglez la vitesse du mélange en direct. Tout fonctionne sur le Wi-Fi de la salle : pas de compte, pas d'internet pendant la soirée, et rien à installer sur les téléphones.

1. Installer

Si vous avez reçu une archive .zip, extrayez-la d'abord : clic droit sur l'archive, puis Extraire tout. Ne lancez pas l'application depuis l'intérieur de l'archive.
Placez le dossier obtenu où vous voulez sur l'ordinateur de l'animateur (Documents, Bureau, clé USB…).
Double-cliquez sur KaraDan-Bonneteau.exe. Une fenêtre noire s'ouvre : c'est le moteur de l'application, laissez-la ouverte pendant la soirée. L'écran animateur s'ouvre tout seul et occupe toute la moitié gauche de l'écran (avec Chrome ou Edge, sans barre d'adresse ; sinon il s'ouvre dans votre navigateur habituel). La moitié droite reste libre, par exemple pour l'écran public avant de le glisser sur la télé.
Un raccourci KaraDan' Bonneteau est déposé sur le Bureau : les fois suivantes, lancez l'application par ce raccourci.

Au premier lancement, Windows peut poser deux questions :

« Windows a protégé votre ordinateur » : cliquez sur Informations complémentaires, puis Exécuter quand même.
« Pare-feu Windows » : cochez Réseaux privés puis Autoriser l'accès. Sans cela, les téléphones ne peuvent pas joindre l'ordinateur.

Les téléphones et le pare-feu. Chaque joueur se connecte avec son téléphone à votre ordinateur, par le Wi-Fi. Le pare-feu de Windows peut bloquer ces connexions, surtout si quelqu'un a cliqué sur Annuler dans la fenêtre ci-dessus, ou si le Wi-Fi est classé « réseau public ». L'application le vérifie toute seule. Si besoin, l'écran animateur affiche un bouton Autoriser les téléphones : cliquez dessus une seule fois et répondez Oui à Windows. Cela ouvre uniquement le bonneteau, et seulement aux appareils du même Wi-Fi que l'ordinateur ; rien d'autre n'est modifié. Vous pouvez le faire par précaution, avant votre première soirée.

Si vous supprimez le raccourci, il n'est pas recréé tout seul : le bouton Licence de l'écran animateur, puis Créer le raccourci sur le Bureau, le refait. Si vous déplacez le dossier de l'application, relancez KaraDan-Bonneteau.exe depuis son nouvel emplacement : le raccourci est mis à jour.

Rien d'autre n'est installé dans Windows. Pour désinstaller, fermez la fenêtre noire, puis supprimez le dossier et le raccourci du Bureau.

Sur Mac, ce chapitre est remplacé par la page PREMIER LANCEMENT SUR MAC.html de votre dossier. Tout le reste du guide s'applique tel quel.

2. Dérouler une partie

Ouvrir le bonneteau : le nom, le lot du gagnant, le nombre de verres (3 à 6), la vitesse de départ et le temps pour choisir.
Les joueurs scannent le QR code et tapent leur pseudo. Ils apparaissent sur la télé.
Lancer la 1re manche (ou la barre d'espace). Tout s'enchaîne seul : la télé soulève le verre qui cache la boule, puis les verres se mélangent ; « Faites vos jeux ! » : les joueurs touchent un verre sur leur téléphone, avec un compte à rebours ; « Rien ne va plus… » : la télé montre combien de joueurs ont choisi chaque verre, puis soulève les verres un par un, le bon en dernier.
Les joueurs qui se sont trompés, ou qui n'ont pas choisi à temps, sont éliminés : leur téléphone le leur dit.
Lancer la manche suivante, et ainsi de suite : chaque manche ajoute 2 échanges. Quand il ne reste qu'un joueur, il gagne : la fête s'affiche sur la télé et sur son téléphone, avec le lot.
Nouvelle partie : tous les joueurs reviennent en jeu.

3. Les règles

Si personne n'a trouvé, personne n'est éliminé : on rejoue une manche.
Un joueur qui arrive après la 1re manche regarde en spectateur et joue à la partie suivante.
Plusieurs joueurs encore en jeu et la soirée doit avancer ? Terminer : les joueurs en jeu gagnent (deux clics).
Les téléphones ne reçoivent jamais la place de la boule avant la révélation : personne ne peut tricher.

4. Les réglages

Réglage	Ce qu'il fait
Vitesse des verres	De 1 à 6, avec les boutons 🐢 et 🐇 de l'écran animateur, ou les flèches ↑ et ↓ du clavier. Le changement compte tout de suite, même en plein mélange. Le mélange dure environ 3 à 4 secondes à la 1re manche, quelle que soit la vitesse : plus c'est rapide, plus il y a d'échanges.
Nombre de verres	3 verres : plus facile à suivre ; 6 verres : beaucoup plus dur. 4 est un bon début.
Temps pour choisir	De 6 à 20 secondes. Si tout le monde a choisi, la révélation arrive 2 secondes plus tard. Révéler maintenant arrête le compte à rebours.
Annuler cette manche	En cas de souci dans la salle : la manche s'arrête et personne n'est éliminé (deux clics).
Voir où est la boule	Sur l'écran animateur seulement. Ne l'ouvrez pas si votre écran est visible de la salle.
Annoncer à voix haute	L'ordinateur dit « Regardez bien la boule ! », « Faites vos jeux ! », « Rien ne va plus ! », puis le résultat.

5. Les écrans

Écran	Pour qui
Animateur	Vous. Il ne s'ouvre que sur l'ordinateur de l'animateur ; un petit aperçu y montre ce que voit la télé.
Écran public	La télé : les verres, le mélange, le compte à rebours, la révélation et les éliminés. Le bouton Écran public l'ouvre dans une fenêtre à part : glissez-la sur la télé, puis double-cliquez dedans pour le plein écran. Il ne s'ouvre que sur l'ordinateur de l'animateur, car il connaît la place de la boule.
Joueurs	Les téléphones, sur le même Wi-Fi que l'ordinateur. Rien à installer : le QR code ouvre une page.
Affiche QR code	Une feuille A4 à imprimer et à poser sur les tables.

L'ordinateur et les téléphones doivent être sur le même réseau Wi-Fi. Si l'adresse de l'ordinateur change (autre salle, autre box), réimprimez l'affiche ; le QR code de l'écran public, lui, est toujours le bon.

6. Licence

Sans clé, l'application fonctionne entièrement pendant 14 jours. Ensuite, elle reste utilisable, mais chaque partie est limitée à 5 joueurs. Pour l'activer : bouton Licence de l'écran animateur, collez la clé reçue par e-mail quand vous vous êtes abonné, puis Activer la licence. La clé est à votre nom ; conservez-la, elle vous sera redemandée si vous changez d'ordinateur.

Votre abonnement

KaraDan' Bonneteau est compris dans les formules Complète et Blind test : la clé est la même que pour les autres applications de votre formule (blind test, et karaoké avec la formule Complète). La formule et la date de fin de l'abonnement sont affichées dans la fenêtre Licence. Vous gardez la même clé d'un renouvellement à l'autre : rien à retaper.

Après chaque échéance, l'application a besoin d'internet une fois, dans les jours qui suivent, pour lire le renouvellement. Elle le fait toute seule dès que l'ordinateur est connecté (chez vous, ou avec le partage de connexion de votre téléphone). Pour le faire tout de suite : Licence, puis Vérifier mon abonnement. Vos soirées, elles, se passent d'internet.
Si l'abonnement s'arrête, l'application repasse en mode limité (des parties limitées à 5 joueurs). Rien n'est effacé : vos parties et vos réglages restent sur votre ordinateur, et tout repart avec la même clé le jour où vous reprenez.

Sur combien d'ordinateurs ?

L'activation passe par internet, une seule fois par ordinateur. Faites-la tranquillement avant la soirée. Ensuite l'application n'a plus besoin d'internet : la licence est reconnue sur place à chaque démarrage.
Votre clé fonctionne sur le nombre d'ordinateurs prévu par votre formule : l'ordinateur des soirées et un ordinateur de secours, par exemple. Sur un ordinateur de plus, l'activation est refusée et l'application y reste en version d'essai.
Vous changez d'ordinateur ? Sur l'ancien : Licence, puis Désactiver cet ordinateur (avec internet). La place est libérée ; activez ensuite votre clé sur le nouveau.
L'ancien ordinateur est en panne, volé ou réinstallé ? Sur le nouveau, entrez votre clé : la liste des ordinateurs activés s'affiche, avec Libérer cet ordinateur et activer ici.
Ces déplacements sont possibles quelques fois par an. Au-delà, ou en cas de souci, écrivez à l'éditeur : il peut libérer un ordinateur pour vous.
Recopier le dossier de l'application sur un autre ordinateur ne transporte pas la licence : elle est liée à l'ordinateur où elle a été activée.

Le nom inscrit dans la clé est affiché en petit sur l'écran animateur, l'écran public, les téléphones des joueurs et l'affiche (« Licence accordée à … »).

7. Vos données

Tout est enregistré dans le dossier donnees, à côté de l'application (l'emplacement exact est affiché dans Licence, rubrique À propos) : la partie en cours et, dans historique, le déroulé et les gagnants de chaque partie. Pour changer d'ordinateur, copiez ce dossier et déplacez la licence (chapitre 6). Rien de ce qui concerne vos soirées ou vos joueurs ne part sur internet ; seule l'activation de la licence contacte le serveur de l'éditeur (votre clé, une empreinte anonyme et le nom de l'ordinateur). Les joueurs ne donnent qu'un pseudo : ni nom, ni numéro de téléphone, ni compte. Détails dans CONFIDENTIALITE.txt.

Lots et mises. KaraDan' Bonneteau est une animation. Si vous faites payer la participation et que vous offrez des lots, les règles sur les jeux d'argent et de hasard s'appliquent (en France, notamment pour les lotos : cercle restreint, but non lucratif, mises modestes). Elles relèvent de l'organisateur de la soirée. Une animation gratuite, avec des lots offerts, ne pose en général pas de question.

8. En cas de problème

Symptôme	À vérifier
Le QR code n'ouvre rien sur les téléphones	Le téléphone est-il sur le même Wi-Fi que l'ordinateur, et pas en données mobiles ? Le pare-feu a-t-il été autorisé ? Cliquez sur Autoriser les téléphones sur l'écran animateur, s'il s'affiche (chapitre 1). L'adresse de l'ordinateur a-t-elle changé depuis l'impression de l'affiche ? Certains Wi-Fi publics isolent les appareils entre eux : utilisez alors une box ou un partage de connexion.
L'écran animateur ne s'ouvre pas	Double-cliquez à nouveau sur `KaraDan-Bonneteau.exe` : si l'application tourne déjà, elle rouvre simplement l'écran.
« Connexion perdue »	Si le moteur de l'application s'arrête par accident, il redémarre tout seul en quelques secondes et les écrans se reconnectent. Si le message reste, la fenêtre noire a été fermée : relancez l'application par le raccourci du Bureau. Dans les deux cas, la partie et les points sont conservés.
Le PC a redémarré en pleine manche	Relancez l'application : la partie et les joueurs sont toujours là, la manche interrompue est annulée et personne n'est éliminé.
Un joueur a fermé sa page	Il rescanne le QR code : il retrouve sa place.
Un téléphone affiche une ancienne version de la page	Rechargez la page sur le téléphone.
« Impossible de joindre le serveur d'activation »	L'ordinateur a-t-il internet à cet instant (ouvrez un site dans le navigateur) ? Un pare-feu ou un antivirus bloque-t-il `KaraDan-Bonneteau.exe` ? Votre clé reste enregistrée : Licence, puis Réessayer l'activation. En attendant, l'application fonctionne en version d'essai.
« Cette licence est déjà activée sur … »	Libérez une place : Désactiver cet ordinateur sur un ancien ordinateur, ou Libérer cet ordinateur et activer ici dans la liste affichée (chapitre 6).
« Ton abonnement s'est terminé le … »	Le renouvellement n'a pas encore été lu, ou l'abonnement n'a pas été renouvelé. Connectez l'ordinateur à internet, puis Licence, puis Vérifier mon abonnement. Si le message reste, écrivez à l'éditeur. En attendant, l'application fonctionne en mode limité et rien n'est perdu.
« Cette clé ne comprend pas cette application »	KaraDan' Bonneteau fait partie des formules Complète et Blind test. Avec une formule Basic ou Pro (karaoké seul), écrivez à l'éditeur pour changer de formule : vous garderez la même clé.
L'application est repassée en version d'essai	La licence a été désactivée pour cet ordinateur depuis un autre ordinateur (ou par l'éditeur), ou le système a été réinstallé : entrez de nouveau votre clé dans Licence.