Abalassembly

Abalone est une marque déposée d'Abalone S.A. (France). Ce projet est une implémentation non officielle, sans lien avec les ayants droit.

Jouer, apprendre et progresser au jeu de stratégie Abalone — entièrement dans un seul fichier HTML, sans serveur, sans dépendance, hors-ligne.

🎮 Jouer maintenant → ocj94.github.io/Abalassembly

Ou : ouvrez index.html dans un navigateur, tout est là.

Sommaire

• Règles en bref
• Mode Enfant
• Ce que contient le fichier
• Échanger des parties
• Choix techniques
• Backend (dormant)
• Développement
• Licence

Règles en bref

Deux joueurs, 14 billes chacun sur un plateau hexagonal. Un tour = déplacer une bille seule ou une colonne de 2-3 billes alignées, d'une case, dans une direction libre. Le premier à éjecter 6 billes adverses hors du plateau gagne.

On ne peut pousser l'adversaire que si on est numériquement supérieur sur la ligne de poussée (un « sumito ») :

Sumito	Faisable ?
⚫⚫⚫ pousse ⚪⚪ (3 contre 2)	✅
⚫⚫⚫ pousse ⚪ (3 contre 1)	✅
⚫⚫ pousse ⚪ (2 contre 1)	✅
⚫⚫ contre ⚪⚪, ⚫⚫⚫ contre ⚪⚪⚪ (égalité)	❌ personne ne pousse
Une seule bille ne pousse jamais	❌

Mode Enfant

Un mode conçu pour laisser un jeune joueur seul devant l'écran.

Où le trouver : menu ☰ → Paramètres → carte « Mode Enfant » → Activer.

Ce qu'il change :

• Plateau allégé — disposition « Découverte », 7 billes par camp au lieu de 14. Moins de matériel à tenir en tête, parties plus courtes.
• Aide au coup — avant toute sélection, le jeu met en évidence toutes les billes qui ont au moins un coup légal. L'enfant ne cherche plus au hasard laquelle peut bouger. Le calcul passe par le moteur réel, il n'est pas approximé.
• Billes aux couleurs vives, skin dédiée.

Ce qu'il masque : le chat, le Labo IA, les paramètres et les liens externes. Si le chat était ouvert, l'affichage bascule sur l'onglet Jeu.

La sortie est verrouillée par une addition à deux termes tirés au hasard. Tant que la réponse est fausse, le mode reste actif.

L'état est conservé. Un rechargement de page ne rouvre rien : le mode se remet en place au démarrage, et il faut toujours répondre à l'addition pour en sortir.

Ce que contient le fichier

Jeu

• Partie contre l'IA (plusieurs niveaux, moteur alpha-bêta + PVS + quiescence dans un Web Worker — l'interface ne gèle jamais ; table de finales 2v2/3v2 consultée pendant la recherche, résultat exact dès qu'une fin de partie résolue est atteinte)
• Mode 2 joueurs sur le même écran
• 18 variantes de position de départ (belge, german daisy, the wall, star…)
• Pendule réelle optionnelle : cadences 5+3, 10+5, 20+10 avec incrément et défaite au temps (mode « libre » par défaut)
• Bots conseillers (Bot Noir / Bot Blanc), duels de bots, skins de billes à débloquer, vue 3D à la demande
• Vue à la première personne : avec les blancs, le plateau se retourne pour que votre camp soit toujours en bas. La notation, elle, reste absolue — e5 désigne e5 quelle que soit l'orientation
• Mode Enfant (voir plus haut) : plateau allégé, aide au coup, sortie protégée
• Mode technique — réglage global qui bascule l'affichage de contenu détaillé (méthode, chiffres bruts, limites) sur les pages qui en ont, sans encombrer la vue joueur par défaut. Pages équipées : Tables de finale, Ouvertures, Labo, Statistiques
• 12 langues au sélecteur — français natif ; anglais et hébreu avec traduction embarquée de la navigation (instantanée, sans réseau) ; les 9 autres s'appuient sur la traduction native du navigateur, avec un guide adapté selon Chrome/Firefox/Safari/Edge. Hébreu en RTL : sidebar, mise en page et menus déroulants basculent à droite ; les flèches directionnelles se retournent nativement (caractères Unicode bidi-mirrored, aucun texte réécrit)

Apprendre

• 80 puzzles minés dans de vraies parties : 64 offensifs (« trouve le coup qui éjecte ») et 16 défensifs (« pare la menace d'éjection », toutes les parades valides acceptées)
• Défi du jour, mode Storm, tutoriels guidés, académie, règles illustrées
• Analyse de partie coup par coup : chaque erreur du rapport est cliquable et rejoue la position
• Analyse d'après-partie : rejoue les positions réellement traversées avec l'évaluation de l'IA, et indique où la partie a basculé, à quel coup la première bille a été perdue
• Moteur de compréhension (page Analyse) : sur n'importe quelle position, décomposition spatiale, faiblesse de soutien, potentiel de sumito, menaces immédiates, profondeur tactique et mobilité à 2 coups — un résumé court par défaut, le détail chiffré derrière le mode technique. Une recherche ciblée (« menace à N coups ») disponible sur demande, jamais automatique
• Empreinte positionnelle (même page) : vecteur de 12 dimensions par position, invariant au miroir gauche-droite. Capture une position comme référence, compare-la à toute position visitée ensuite (distance affichée, détail par dimension en mode technique). Pas de base de positions historiques pour l'instant — comparaison à la demande, entre positions explicitement choisies
• Puzzle du jour, déterministe par la date et identique pour tout le monde, avec série de jours consécutifs

Plateau réel

• Détection d'un plateau physique par photo (page Détection IA)
• Enregistreur de parties réelles : photographiez le plateau après chaque coup, les coups sont reconstitués automatiquement par le moteur, vérifiés, puis sauvegardés avec joueurs, date et variante — et rejouables dans la bibliothèque

Bibliothèque

• 4 480 parties réelles embarquées (AbalOnline + MIGS), rejouables coup par coup
• Book d'ouvertures miné depuis ces parties
• 2 589 de ces parties republiées en APGN dans games/ — celles du serveur MiGs, fermé le 30 mai 2017, dont il n'existe aucune autre source publique connue

Labo

• Auto-amélioration du moteur : duels SPRT (méthodologie façon Fishtest/Stockfish) et réglage continu SPSA sur 8 poids d'évaluation (centre, cohésion, bord, mobilité, isolement, danger, alignements, forteresse), suivi Elo, exports CSV/JSON
• Impact réel, pas un simple tableau de bord : quand le Labo prouve statistiquement qu'un nouveau jeu de poids bat le champion actuel, il est adopté automatiquement et réécrit en direct le style « équilibré » de l'IA — celui utilisé par défaut tant qu'aucun profil de jeu (agressif/passif) n'est détecté chez l'adversaire humain. Autrement dit : l'IA que vous affrontez peut réellement progresser d'une session à l'autre.
• Réversible et local : interrupteur « Utiliser les poids du Labo » (actif par défaut, désactivable) ; tout vit dans le localStorage du navigateur — chaque exemplaire du jeu apprend pour son propre joueur, rien n'est partagé entre appareils tant que le backend reste dormant (voir plus bas : une variante distribuée du Labo, où plusieurs joueurs alimentent le même test SPRT, existe déjà côté serveur)
• Replay des parties du Labo sur plateau bois avec les vrais skins de billes

Échanger des parties

Partie par code. Une partie en différé, par simple échange de texte : vous jouez, vous copiez le code, vous l'envoyez ; votre adversaire le colle, joue, et vous renvoie le sien. Aucun compte, aucun serveur. Le code porte la partie entière depuis le premier coup, et celui qui le reçoit la rejoue contre le moteur — il la refuse au premier coup illégal plutôt que de faire confiance.

APGN. L'Abalone n'avait pas d'équivalent du PGN des échecs. APGN.md en propose un : en-tête de balises, coups numérotés, résultat. Une partie n'y est valide que si elle rejoue. Le convertisseur tools/to-apgn.js produit le fichier et rejette ce qui ne passe pas.

ecosysteme.html. Une carte interactive de l'écosystème Abalone, dessinée comme une position de jeu : les projets entrent sur le plateau et glissent dans la gouttière quand ils ferment.

Choix techniques

Choix	Pourquoi
Un seul fichier HTML	Distribution triviale : un fichier = tout le site. Fonctionne en file://, sur GitHub Pages, sur clé USB.
Zéro dépendance	Rien à installer, rien qui casse, rien à auditer chez un tiers. (Seule la vue 3D charge Three.js, à la demande.)
Banques compressées	Les 4 480 parties, le book et les sons sont embarqués en deflate + base64, décompressés nativement au chargement (DecompressionStream). Fichier ≈ 7,1 Mo (a grossi avec l'ajout des empreintes historiques, tablebases et graphe de positions). Sur un navigateur ancien, le jeu fonctionne — seules bibliothèque, book et sons sont absents.
Hors-ligne d'abord	Aucune requête réseau nécessaire. Progression, réglages et puzzles résolus vivent dans le localStorage.
IA dans un Worker	La recherche tourne dans un thread séparé ; l'interface reste fluide pendant la réflexion.
Recherche multi-worker adaptative	Sur un appareil à plusieurs cœurs, la recherche se partage entre plusieurs Workers (partage des coups racine, chacun sa propre table de transposition — pas de mémoire partagée, GitHub Pages ne pose pas les en-têtes nécessaires à SharedArrayBuffer). S'adapte via navigator.hardwareConcurrency : jusqu'à 4 workers sur un PC multi-cœurs, 1 seul (comportement identique à avant) sur un téléphone contraint.
Table de transposition plafonnée selon la RAM	Le cache de recherche (TT) s'adapte à navigator.deviceMemory (repli à 4 Go si l'API est indisponible) plutôt que de grossir sans limite — pertinent surtout en mode Minimax (recherche non bornée en temps). Le plafond ne peut jamais changer un résultat, seulement l'efficacité du cache une fois atteint.

Backend (dormant)

Un backend optionnel (comptes, synchronisation, classement mondial) existe dans le dépôt séparé abalassembly-api — Node + Fastify + PostgreSQL + Redis, conçu RGPD-ready (argon2id, JWT révocable, MFA TOTP sans dépendance, purges automatiques). Il inclut aussi un Labo distribué : plusieurs joueurs peuvent alimenter le même test SPRT collectif (méthodologie OpenBench/Fishtest), avec diversité des 5 ouvertures officielles et vérification par rejeu de chaque partie témoin — 54 tests, CI verte. Il n'est pas déployé : le HTML ne l'appelle que si BACKEND.enabled = true, ce qui n'est pas le cas. Tant que ce drapeau est à false, le site ne collecte rien et ne contacte aucun serveur.

Développement

Le fichier est volontairement lisible : sections commentées, code non minifié (seules les données sont compressées). Pour vérifier l'intégrité après modification :

node tests/regression.js   # intégrité, régressions, garde-fous — sort en 1 si ça casse
node tests/nacre.js        # notation des coups latéraux, vérifiée contre le moteur
node tests/gamecode.js     # aller-retour du code de partie, 40 parties rejouées

La suite est versionnée et sans dépendance. Chaque bug corrigé y ajoute un test qui échouait sur l'ancien code. console.assert n'y est jamais utilisé : il n'interrompt rien et laisse un test échoué afficher un succès.

Les puzzles sont minés hors-ligne depuis les banques de parties par un critère vérifiable (menace d'éjection réelle, parades recalculées exhaustivement par le moteur) — aucun puzzle n'est inventé à la main.

Licence

GPL-3.0-or-later. Vous pouvez utiliser, étudier, modifier et redistribuer ce jeu, à condition de conserver la même licence. Les parties de la bibliothèque proviennent de bases publiques (AbalOnline, MiGs) et restent créditées à leurs joueurs. Les relevés de coups sont des suites de faits, non des œuvres ; les parties MiGs republiées dans games/ le sont à des fins de préservation, avec une procédure de retrait explicite.