KaraDan' Carton Plein

Guide de démarrage — version 1.0.0

Le loto de vos soirées, sans cartons à distribuer : chaque joueur a ses cartons sur son téléphone, vous tirez les numéros sur votre ordinateur, et la télé affiche le tirage. Les cartons se cochent tout seuls et l'application vérifie chaque « Quine ! ». 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

1. 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.
2. Placez le dossier obtenu où vous voulez sur l'ordinateur de l'animateur (Documents, Bureau, clé USB…).
3. Double-cliquez sur Lancer KaraDan-CartonPlein.command. 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é.
4. Un raccourci KaraDan' Carton Plein 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 Carton Plein, 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 Lancer KaraDan-CartonPlein.command 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. Les règles

• Loto à la française : numéros de 1 à 90. Chaque carton a 3 lignes de 5 numéros (15 numéros). Deux cartons ne sont jamais identiques.
• Trois étapes, dans l'ordre : quine (une ligne pleine), double quine (deux lignes), carton plein (les trois lignes). Vous pouvez n'en garder que certaines, et écrire le lot de chaque étape : il s'affiche partout.
• Chaque joueur choisit son nombre de cartons (3 au plus, réglable jusqu'à 6). Il peut en ajouter tant que le tirage n'a pas commencé.

3. Dérouler une partie

1. Ouvrir la soirée : le nom de la soirée, le type de partie, les étapes et leurs lots, le nombre de cartons par joueur.
2. Les joueurs scannent le QR code, tapent leur pseudo et choisissent leur nombre de cartons.
3. Tirer un numéro (ou la barre d'espace) : le numéro sort au hasard et s'affiche partout. Les téléphones le cochent tout seuls et vibrent si le numéro est sur un de leurs cartons.
4. Quand un joueur a sa ligne, il appuie sur le gros bouton « QUINE ! » de son téléphone. L'application vérifie tout de suite : si c'est juste, son carton s'affiche sur votre écran et le tirage se met en pause ; si c'est faux, il reçoit « Pas encore ».
5. Valider le gagnant : la fête s'affiche sur la télé et les téléphones, avec le lot. Un autre joueur a gagné au même numéro ? Validez-le aussi (ex æquo).
6. Passer à la double quine, puis au carton plein. Ensuite, Nouvelle partie : les joueurs restent, et vous choisissez s'ils gardent leurs cartons.

4. Parties spéciales, surnoms et bilan

• Carton plein express : seulement le carton plein, en un nombre de numéros que vous choisissez. La télé et les téléphones comptent les numéros qui restent. Si personne n'a gagné à la fin, Terminer la partie sans gagnant.
• Quine sur une seule ligne : seule la ligne choisie compte (du haut, du milieu ou du bas). Elle est soulignée en jaune sur les cartons.
• Surnoms des numéros : « Le 22, les deux cocottes ! ». Ils s'affichent sous la boule et sont dits à voix haute. Modifier les surnoms : écrivez les vôtres, dans la langue de votre public.
• Bilan de la soirée : les gagnants, les lots, le nombre de joueurs et de parties, à imprimer ou à enregistrer en PDF. Les bilans des soirées précédentes restent consultables.

5. Les écrans

L'ordinateur et les téléphones doivent être sur le même réseau Wi-Fi. Le QR code contient l'adresse de l'ordinateur sur ce réseau : si elle 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' Carton Plein 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, vos surnoms et, dans historique, les numéros et les gagnants de chaque partie (c'est ce qui sert au bilan). 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' Carton Plein 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