Puissance 4 API

Crée un nouveau compte joueur.

await fetch('/api/auth/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    pseudo: 'Lili_y',
    password: 'MonMotDePasse',
    color: '#ff2d55',
    shape: 'circle'
  })
});

curl -X POST http://localhost:8080/api/auth/register ^
  -H "Content-Type: application/json" ^
  -d "{\"pseudo\":\"Lili_y\",\"password\":\"MonMotDePasse\",\"color\":\"#ff2d55\",\"shape\":\"circle\"}"

Connecte un joueur avec pseudo + mot de passe.

const res = await fetch('/api/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ pseudo: 'Lili_y', password: 'MonMotDePasse' })
});
const data = await res.json();
localStorage.setItem('token', data.token);

curl -X POST http://localhost:8080/api/auth/login ^
  -H "Content-Type: application/json" ^
  -d "{\"pseudo\":\"Lili_y\",\"password\":\"MonMotDePasse\"}"

Crée une session invité locale. Utilisé pour les duels amicaux sans connexion.

const guest = await fetch('/api/auth/guest', { method: 'POST' })
  .then(r => r.json());
localStorage.setItem('token', guest.token);
localStorage.setItem('player', JSON.stringify(guest.player));

curl -X POST http://localhost:8080/api/auth/guest

Réinitialise le mot de passe avec un code envoyé via Discord.

Retourne le profil complet d’un joueur.

{
  "id": 2,
  "pseudo": "Lili_y",
  "elo": 1000,
  "coins": 250,
  "role": "admin",
  "is_vip": 1,
  "is_vip_plus": 0,
  "is_perso": 1,
  "avatar": "...",
  "banner": "...",
  "avatar_decoration": "/decorations/frame.png",
  "shape": "circle",
  "color": "#ff2d55",
  "color_secondary": "#85EBFF",
  "pseudo_color": "#ffffff",
  "pseudo_color_secondary": "#85EBFF",
  "pseudo_font": "barlow",
  "pseudo_format": "bold,underline",
  "pseudo_rgb": 1,
  "elo_curve_color": "#ff2d55",
  "elo_curve_color_secondary": "#85EBFF",
  "elo_curve_rgb": 1,
  "referral_slug": "lili"
}

const player = await fetch('/api/players/2').then(r => r.json());

Retourne la courbe ELO compressée sur 1, 7 ou 15 jours. Les historiques des bots incluent leurs parties contre des humains et contre d’autres bots. Chaque point indique aussi la nature de l’adversaire.

{
  "generatedAt": "2026-05-16T12:00:00.000Z",
  "player": { "id": 2, "pseudo": "Lili_y", "elo": 1012, "wins": 4, "elo_curve_rgb": 1 },
  "days": 7,
  "points": [{
    "gameId": 42,
    "finishedAt": "2026-05-16 12:00:00",
    "beforeElo": 1000,
    "afterElo": 1012,
    "delta": 12,
    "result": "win",
    "opponent": { "id": 7, "pseudo": "P4-Bot-Nova", "isBot": true }
  }],
  "stats": {
    "startElo": 1000, "endElo": 1012, "delta": 12,
    "games": 3, "gamesAgainstHumans": 2, "gamesAgainstBots": 1,
    "averageElo": 1008
  }
}

curl "http://localhost:8080/api/players/2/elo-history?days=7"

Télécharge les données brutes du graphique ELO en JSON ou CSV. Le bouton CSV/JSON du profil utilise cet endpoint.

curl -L "http://localhost:8080/api/players/2/elo-history/export?days=7&format=csv" -o elo-history.csv

const file = await fetch('/api/players/2/elo-history/export?days=15&format=json').then(r => r.json());

Annuaire public des joueurs et bots : ELO, badges, rang, statut online, file et partie active. Utilisé par /players et /bots.

curl "http://localhost:8080/api/players?type=bots"

const bots = await fetch('/api/players?type=bots').then(r => r.json());

Recherche par pseudo pour le profil et l’autocomplete. Par défaut, seuls les humains sont retournés. includeBots=1 ajoute les bots et chaque résultat expose is_bot pour afficher son badge.

Transforme un compte non lié Discord en compte bot API. Session joueur obligatoire. Accepte owner, ownerPseudo, ownerId ou creatorId pour associer un créateur humain qui recevra les Cristaux du bot.

Lookup direct par pseudo exact.

Change le pseudo côté joueur.

await fetch('/api/players/2/pseudo', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ token, pseudo: 'Crystal' })
});

curl -X PATCH http://localhost:8080/api/players/2/pseudo ^
  -H "Content-Type: application/json" ^
  -d "{\"token\":\"SESSION_TOKEN\",\"pseudo\":\"Crystal\"}"

Met à jour la couleur principale du pion, et selon le pack la seconde couleur.

Définit la forme active du pion.

Met à jour la couleur, le dégradé, la police et la mise en forme du pseudo. format accepte une liste séparée par des virgules parmi bold, italic, underline, lowercase et uppercase. Minuscules et majuscules sont mutuellement exclusives. rgb active la vague colorée animée.

await fetch('/api/players/2/pseudo-style', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    token, color: '#ffffff', colorSecondary: '#85EBFF',
    font: 'orbitron', format: 'bold,underline', rgb: true
  })
});

Met à jour la couleur du graphique ELO. Le champ rgb active une vague RGB animée, réservée au rang Perso.

await fetch('/api/players/2/elo-curve-style', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ token, color: '#ff2d55', colorSecondary: '#85EBFF', rgb: true })
});

Met à jour le badge Perso directement depuis le profil joueur. Utilise un texte court, un emoji optionnel et une couleur simple ou en dégradé via colorSecondary.

Change l’avatar. Erreurs typiques : fichier trop lourd, GIF non autorisé, cooldown VIP/VIP+ actif.

Change la bannière principale du profil.

Définit l’emoji custom ou l’image emoji selon le pack.

Applique ou retire un curseur PNG 32x32. Fonction réservée au grade Perso, avec token et cursor dans le body.

Applique ou retire un fond personnalisé pour le profil/site. Session joueur obligatoire, payload avec token, image et options de rendu.

Applique une décoration d’avatar depuis la bibliothèque serveur.

Applique une bannière pseudo depuis la bibliothèque serveur.

Liste auto des décorations disponibles.

{ "decorations": ["/decorations/a.png", "/decorations/b.png"] }

Liste publique des pions secrets, modèles, thèmes et taux de spawn : Commun 49 %, Rare 25 %, Épique 12 %, Légendaire 7 %, Mythique 3,5 %, Artefact 1,5 %, QueenPawn 1 %, Fantastique 0,9 % et Inoubliable 0,1 %.

Retourne la collection publique d’un joueur : quantité par pion secret, doublons, progression, copies, regroupements par rareté et par thème.

{
  "collection": {
    "items": [],
    "collectedItems": [],
    "rarities": [{ "key": "rare", "total": 8, "collected": 2, "copies": 3 }],
    "themes": [{ "label": "Prestige", "total": 8, "collected": 1, "copies": 1 }],
    "stats": { "collected": 3, "total": 39, "totalCopies": 4, "duplicates": 1 }
  }
}

Liste auto des bannières pseudo disponibles.

{ "banners": ["/banners/static.png", "/banners/static2.png"] }

Suit un joueur.

Retire un follow.

Retourne l’état de follow entre le joueur courant et le profil ciblé.

Retourne l’état live d’un joueur.

Active le boost premium individuel du joueur courant selon son pack actif.

Retourne l’état du boost premium individuel : actif, multiplicateur, temps restant, cooldown.

Retourne le lien de parrainage du joueur, son parrain actif, ses filleuls et les bonus boutique disponibles.

Personnalise le slug de parrainage. Le lien peut ensuite être résolu par id joueur, pseudo ou slug unique.

await fetch('/api/referral/me', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ token, slug: 'lili' })
});

Lit le message de connexion Crystal du joueur courant : message, emoji, couleur, animation et état d’activation.

Met à jour l’alerte de connexion Crystal affichée une fois à la connexion, pas à chaque changement de page.

Sélectionne la musique de file d’attente active du joueur quand la collection est disponible.

Ferme / supprime un compte joueur (session obligatoire). Ce endpoint existe dans le backend et est utilisé par le profil.

Liste les parties actives visibles sur la page live, y compris les parties contre bots. Le payload expose aussi les spectateurs de la partie sélectionnée.

{
  "games": [{
    "id": 1165,
    "moves": 6,
    "botGame": true,
    "spectators": [
      { "name": "Lili_y", "anonymous": false },
      { "name": "Anonyme", "anonymous": true }
    ]
  }]
}

const live = await fetch('/api/live').then(r => r.json());

Données de base d’une partie.

Liste ordonnée des coups pour reconstruire la grille.

Payload enrichi pour replay.html.

Enregistre l’analyse d’une partie. Erreurs typiques : partie introuvable, payload vide.

Relit l’analyse enregistrée.

Stocke la précision finale côté base.

Calcul bot / ELO bot / résultat IA pour le mode contre l’ordinateur. Les parties bot peuvent être enregistrées comme replay sans polluer les stats des invités amicaux.

Retourne l’état complet de la boutique pour le joueur courant.

{
  "player": { "id": 2, "coins": 4800 },
  "items": { "elo_mini": { "price": 250, "multiplier": 1.05 } },
  "prices": { "elo_mini": 250 },
  "stock": { "elo_mini": 10 },
  "inventory": { "elo_mini": 2, "coin_boost": 1 },
  "limitedOffer": {
    "code": "FLASH20",
    "label": "Pack week-end",
    "expiresAt": 1779120000000,
    "coupon": { "type": "discount", "value": 20 }
  }
}

const shop = await fetch('/api/shop/me?token=' + token)
  .then(r => r.json());

curl "http://localhost:8080/api/shop/me?token=SESSION_TOKEN"

Achète un pack, un booster, le rang Crystal ou offre un item à un autre joueur.

await fetch('/api/shop/buy', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ token, pack: 'elo_mini', giftToId: 12 })
});

curl -X POST http://localhost:8080/api/shop/buy ^
  -H "Content-Type: application/json" ^
  -d "{\"token\":\"SESSION_TOKEN\",\"pack\":\"elo_mini\",\"giftToId\":12}"

Active un booster personnel depuis l’inventaire joueur. Les boosts globaux restent gérés via l’admin.

Valide un coupon boutique avant achat : remise fixe ou pourcentage, expiration, usages restants et compatibilité pack.

Utilise une clé produit créée par le staff et applique ses récompenses au joueur connecté ou à un pseudo cible.

Le pack bot_host_1m s’achète avec currency: "crystals" pour 3000 Cristaux. Le joueur doit posséder au moins un bot associé via bot_owner_id. Les comptes admin peuvent activer ou renouveler ce host gratuitement.

Envoie un duel à un joueur connecté. gameType peut valoir ranked ou friendly.

await fetch('/api/duels/challenge', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    token,
    targetId: 12,
    gameType: 'friendly'
  })
});

curl -X POST http://localhost:8080/api/duels/challenge ^
  -H "Content-Type: application/json" ^
  -d "{\"token\":\"SESSION_TOKEN\",\"targetId\":12,\"gameType\":\"friendly\"}"

Crée un lien de duel partageable de type /duel/:id. En friendly, le lien expire au bout de 15 minutes et peut être créé avec une session invité.

await fetch('/api/duels/link', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ token, gameType: 'ranked' })
});

curl -X POST http://localhost:8080/api/duels/link ^
  -H "Content-Type: application/json" ^
  -d "{\"token\":\"SESSION_TOKEN\",\"gameType\":\"ranked\"}"

Retourne l’état public du duel afin d’afficher la page de validation.

Prépare une session invité uniquement pour les duels friendly. Utilisé automatiquement par duel.html si le visiteur n’est pas connecté.

Valide un duel par lien si l’utilisateur est connecté et disponible, ou après passage en session invité pour un duel amical.

Liste publique des clans avec membres, ELO moyen et état de recrutement.

Classement des clans par activité, victoires et niveau global.

Retourne le clan actuel d’un joueur, son rôle et les permissions associées.

Détail complet d’un clan : profil, membres, stats et paramètres visibles.

Crée un clan. Session joueur obligatoire et contrôles anti-spam via route guard.

Modifie nom, description, visuel, recrutement ou options internes si le joueur possède les droits.

Supprime un clan par son propriétaire ou un admin autorisé.

Historique du chat de clan, paginé et limité aux membres.

Envoie un message dans le salon du clan, aussi relayé en Socket.IO.

Rejoint un clan ouvert ou demande l’accès selon sa configuration.

Quitte le clan actuel du joueur.

Expulse un membre si le rôle du demandeur le permet.

Modifie le rôle interne d’un membre du clan.

Démarre la liaison Discord d’un compte existant.

Connexion ou création de compte directement via Discord.

Démarre le flow de reset mot de passe via Discord.

Callback OAuth. À ne pas appeler manuellement.

Retourne l’état Discord du compte courant.

Resynchronise le profil et les rôles Discord du joueur.

Demande un code de déliaison Discord.

Confirme la déliaison avec le code reçu.

Client Node.js officiel d'exemple : ping, file robot, lecture de grille et coup automatique.

curl -O http://localhost:8080/downloads/p4-bot-client.js
P4_BOT_TOKEN=p4bot_xxx node p4-bot-client.js

Télécharger le bot client JS

Retourne le bot authentifié, son runtime et sa partie active si elle existe.

curl -H "Authorization: Bearer p4bot_xxx" http://localhost:8080/api/bot/me

{ "bot": { "pseudo": "MonBot", "activeGame": null } }

Marque le bot comme en ligne. A appeler toutes les 15-30 secondes depuis le programme local. Pour une activation rapide, status peut etre envoye en query string.

curl.exe -X POST -H "Authorization: Bearer p4bot_xxx" "https://puissance4.croustygame.fr/api/bot/ping?status=seeking"

{ "ok": true, "runtime": { "online": true, "status": "seeking" } }

Entre en file robot. Si un robot est disponible, une partie ranked bot-vs-bot est créée. Peut matcher un bot préconfiguré.

Quitte la file robot.

Retourne la grille, le camp du bot, les colonnes légales, le joueur au trait et les deux joueurs.

Joue un coup pour le bot authentifié.

curl -X POST -H "Authorization: Bearer p4bot_xxx" -H "Content-Type: application/json" -d "{\"col\":3}" http://localhost:8080/api/bot/move

{ "ok": true, "game": { "isMyTurn": false } }

Un bot API peut défier un autre bot disponible. Si la cible est un robot préconfiguré, il jouera automatiquement ; si c’est un bot externe, il doit etre en ligne via /api/bot/ping.

curl -X POST -H "Authorization: Bearer p4bot_xxx" http://localhost:8080/api/bot/challenge/7

{ "ok": true, "game": { "gameId": 42, "isMyTurn": true } }

Endpoint fermé volontairement : les tokens bot ne peuvent pas etre régénérés pour garder une logique stricte de secret affiché une seule fois.

Liste les robots préconfigurés du site avec leur force de jeu et leur état. Ces bots participent aussi à une arène automatique en arrière-plan : ils se défient entre eux tant qu’ils sont libres.

Un joueur connecté lance une partie ranked contre le bot ciblé. Utilisé par le bouton Défier ce bot dans /players.

curl -X POST -H "x-session-token: SESSION" -H "Content-Type: application/json" -d "{\"token\":\"SESSION\"}" http://localhost:8080/api/bots/7/challenge

{ "ok": true, "gameUrl": "/game/42" }

Lance une partie automatique entre deux robots préconfigurés libres.

Retourne les bots associés au joueur connecté, son solde de Cristaux, le prix Host et l’état de chaque host.

Envoie le code JS du bot dans le panel host. Le host doit être actif. Taille maximale : 256 Ko. Le front peut remplir ce code depuis un fichier .js, .cjs ou .mjs avant transfert.

Télécharge le code stocké pour ce bot, depuis le profil du propriétaire.

Actions panel : start, restart, stop. Le serveur lance un process Node host avec P4_BASE_URL, P4_API_URL, P4_BOT_TOKEN, P4_BOT_ID et capture stdout/stderr dans les logs.

Retourne les logs du panel host pour le bot appartenant au joueur connecté.

Retourne les métriques host du bot : statut, uptime, redémarrages, activité récente et informations utiles au panel.

Ouvre la documentation API officielle : endpoints HTTP, Socket.IO, erreurs et exemples.

Miroir Discord de GET /api/players/by-pseudo/:pseudo et GET /api/players/:id. Retourne rang, ELO, coins, badges, stats, follow et dernier match.

Carte Discord enrichie et francisée : identité, plateforme, serveur, rôles, permissions, activités, médias et liaison Puissance 4.

Top ELO rapide, compatible avec GET /api/leaderboard.

Classement officiel par elo ou victoires, relié à /api/leaderboard et /api/leaderboard/wins.

Vue Discord des stats globales : présence, parties, comptes, coins et boosts. Relié à /api/stats/overview et /api/site-stats.

Lit GET /api/system-status et affiche maintenance, message serveur et présence.

Affiche boost ELO global, boost coins global et nombre de boosts premium individuels actifs.

Liste rapide des bibliothèques /api/decorations, /api/profile-banners ou /api/musics.

Résumé d’une partie officielle avec joueurs, deltas ELO, vainqueur, durée et lien vers /replay/:id.

Génère un lien de duel ranked ou friendly valable 15 minutes. Cette commande utilise la même logique que POST /api/duels/link et demande un compte Discord lié.

Crée un giveaway avec bouton de participation, tirage au sort et attribution automatique si le gagnant est lié à Puissance 4.

Crée un drop instantané : le premier membre qui clique reçoit la récompense si son Discord est lié.

Affiche les parties actives, relié à GET /api/live.

Lien vers la boutique coins / boosters.

Génère les rôles Discord de rang ELO sans les recréer s’ils existent déjà. Retourne un résumé trouvés / manquants / créés.

Give, retire ou prolonge le rang Crystal d’un joueur depuis Discord avec durée optionnelle.

Commandes staff protégées par mot de passe admin + rôle Discord. Actions disponibles : stats, player, mute, unmute, ban, unban, coins, gems, elo, give-item, crystal, boost-elo, boost-coins, backups, maintenance-on, maintenance-off, reload.

Connexion admin / modération. Erreurs typiques : mot de passe invalide, droits insuffisants.

Liste enrichie des joueurs pour le panel admin.

Retourne l’état de la session admin courante.

Retourne l’état de la protection anti-raid : compteurs actifs, inscriptions récentes et derniers événements anonymisés.

Retourne le mot de passe du panel admin pour les comptes autorisés.

Ajoute des coins à un joueur.

Ajoute ou retire des gemmes au joueur. Les gemmes sont surtout visibles si le compte est lié Discord.

Ajoute ou retire des Cristaux bot au créateur humain d’un bot. Refuse les comptes robots et les joueurs sans bot associé.

Active ou coupe la capacité bot API d’un compte robot.

Crée un coupon boutique : code, type de remise, valeur, nombre d’utilisations et expiration optionnelle.

Liste les coupons existants avec leurs usages et leur statut.

Supprime ou désactive un coupon boutique ciblé.

Ajoute des boosters ELO / coins à l’inventaire d’un joueur.

await fetch('/api/admin/players/2/shop-item', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'x-admin-token': adminToken
  },
  body: JSON.stringify({ itemKey: 'elo_classic', quantity: 3 })
});

curl -X PATCH http://localhost:8080/api/admin/players/2/shop-item ^
  -H "Content-Type: application/json" ^
  -H "x-admin-token: ADMIN_TOKEN" ^
  -d "{\"itemKey\":\"elo_classic\",\"quantity\":3}"

Ajoute manuellement un pion secret à la collection d’un joueur depuis le panel admin.

Modifie rôle, VIP, VIP+, Perso et durée VIP.

Attribue, prolonge ou retire le rang Crystal avec durée optionnelle. Synchronise les avantages Crystal côté profil et boutique.

Définit le badge custom d’un profil Perso.

Force un changement de pseudo côté admin.

Force / reset l’ELO d’un joueur.

Mute standard ou custom en minutes.

Ban / unban un joueur.

Marque ou retire le flag suspicious d’un joueur.

Liste des parties pour le panel admin.

Revert d’une partie. Restaure les ELO d’avant match.

Lit le boost ELO global actif.

Active ou retire le boost ELO global.

Lit le boost coins global actif.

Active le boost coins global entre x1 et x10 avec durée custom.

Crée ou met à jour une offre limitée boutique avec coupon automatique, timer et nombre d’utilisations maximum.

await fetch('/api/admin/limited-pack', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-admin-token': adminToken
  },
  body: JSON.stringify({
    code: 'FLASH20',
    value: 20,
    maxUses: 25,
    durationHours: 12,
    label: 'Pack week-end'
  })
});

curl -X POST http://localhost:8080/api/admin/limited-pack ^
  -H "Content-Type: application/json" ^
  -H "x-admin-token: ADMIN_TOKEN" ^
  -d "{\"code\":\"FLASH20\",\"value\":20,\"maxUses\":25,\"durationHours\":12,\"label\":\"Pack week-end\"}"

Liste les boosts premium individuels actifs (VIP / VIP+ / Perso).

Liste les bases / sauvegardes exportables depuis le panel admin.

Télécharge un backup ciblé (ex. base principale, WAL, SHM).

Retourne le bundle i18n utilisé par /i18n.js : langue active, fallback français, textes source, traductions manuelles et liste des langues disponibles.

const bundle = await fetch('/api/i18n?lang=de')
  .then(r => r.json());

console.log(bundle.languages.map(l => l.code));

{
  "language": "de",
  "fallbackLanguage": "fr",
  "provider": "libretranslate",
  "translationConfigured": true,
  "languages": [{ "code": "fr" }, { "code": "de" }],
  "source": { "common.save": "Enregistrer" },
  "translations": {}
}

Traduit les textes visibles d’une page en une seule requête navigateur. Le backend utilise LibreTranslate en batch, protège la marque Puissance 4, puis cache les résultats dans data/i18n-machine-cache.json.

const res = await fetch('/api/i18n/translate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    language: 'de',
    texts: ['Connexion', 'Mot de passe', 'Se connecter']
  })
});
const data = await res.json();

{
  "language": "de",
  "provider": "libretranslate",
  "translations": {
    "Connexion": "Anmeldung",
    "Mot de passe": "Passwort"
  },
  "stats": { "total": 3, "translated": 3, "failed": 0 },
  "errors": []
}

Sauvegarde la langue préférée du joueur connecté. Le menu global l’utilise après validation de l’autocomplete.

await fetch('/api/players/2/language', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'x-session-token': token
  },
  body: JSON.stringify({ language: 'de' })
});

{
  "ok": true,
  "language": "de",
  "player": { "id": 2, "language": "de" }
}

Variables à renseigner sur le serveur Puissance 4 pour activer la traduction automatique.

TRANSLATION_PROVIDER=libretranslate
LIBRETRANSLATE_URL=http://IP_OU_HOST_LIBRETRANSLATE:5000
LIBRETRANSLATE_KEY=

libretranslate --host 0.0.0.0 --port 5000 \
  --load-only fr,en,es,de,it,pt,nl,pl,ro,sv,tr,ru,uk,ar,zh,ja,ko,el,cs,hu,id,hi \
  --disable-web-ui

État manuel du serveur : maintenance / redémarrage / message flottant.

Met à jour l’alerte serveur affichée en front.

Retourne les stats globales rapides : joueurs en ligne, visiteurs, total de présence, parties live, boost global.

Vue agrégée complète utilisée par stats.html : joueurs, visiteurs, parties, coins, boosters, Elo moyen, précision moyenne, suspicions, bot games, etc.

Rythme hebdomadaire sur 2 semaines : inscriptions, parties, parties terminées, joueurs actifs et moyenne quotidienne.

Classement ELO principal.

Classement alternatif par victoires.

Classement spécifique des bots API et bots préconfigurés.

Retourne l’ID du bot joueur utilisé côté site.

Identifie la socket avec playerId + token.

socket.emit('identify', {
  playerId: myPlayer.id,
  token: localStorage.getItem('token')
});

Réponse après identification réussie. Contient le joueur sanitizé.

Annonce une présence anonyme sur le site pour distinguer les visiteurs des comptes connectés.

Heartbeat de présence utilisé hors partie pour maintenir le statut online / live.

Alerte compacte en bas à gauche quand un membre Crystal vient de se connecter, avec message, emoji, couleur et animation.

Notifie les pages ouvertes qu’un profil ou un rôle a changé : ELO, rang, badges, Crystal, Discord ou cosmétique.

Push live des compteurs de présence : joueurs identifiés, visiteurs et total présent sur le site.

Rejoint le salon temps réel d’un clan puis envoie un message interne.

Push de message clan ou erreur ciblée : permissions, clan introuvable ou message invalide.

Rejoint la file ranked classique.

Confirmation d’entrée en file avec position.

Confirmation de sortie de file.

Quitte la file ranked.

Match trouvé, payload de partie à charger sur /game.

Invitation de duel reçue côté cible et accusé d’envoi côté expéditeur.

Accepte ou refuse un duel en attente.

Cycle complet de vie du duel avant le lancement d’une partie.

Erreur ciblée sur un duel: joueur hors ligne, duel expiré, joueur déjà occupé, etc.

Joue un coup en envoyant une colonne.

Envoie un message de tchat à l’adversaire pendant la partie.

Message de tchat diffusé aux deux joueurs de la partie.

Propose une nulle puis accepte ou refuse. Si accepté, la partie finit avec agreement_draw.

Abandon volontaire. La partie se termine avec ELO appliqué et result_reason = resignation.

Demande de revanche après la partie, acceptée ou refusée en temps réel.

Notifications communes pour nulle, revanche, refus, abandon et erreurs d’action.

Un coup a été joué. Sert à mettre à jour la grille.

Partie terminée. Résultat final, deltas ELO, coins, boosts, etc.

Rejoint une partie active après refresh ou reconnexion.

Réponse complète contenant l’état de la partie après rejoin.

Signaux de présence de l’adversaire pendant une partie.

Mise à jour live d’une couleur de pion.

Inscrit la socket au salon live pour recevoir les refreshs de parties.

Inscrit ou retire un spectateur d’une partie précise. Les connectés affichent leur pseudo, les autres apparaissent en Anonyme.

Demande au client de relire /api/live.

Mise à jour push de l’alerte système / redémarrage.

Erreur générique temps réel.

{ "message": "Session invalide. Reconnecte-toi." }