AquilApp

Cas client · Jeux et sport

Douze mois dans l’équipe de MetaFight : les interfaces et l’API d’un jeu de cartes web3

MetaFight était un jeu de cartes à collectionner consacré au MMA, dont les cartes étaient des actifs numériques. De décembre 2022 à novembre 2023, nos développeurs ont rejoint son équipe pour refondre le site vitrine et faire avancer la place de marché, la boutique, les écrans de jeu et l’API. Le premier chantier est parti en recette douze jours après le cadrage.

Écran « My Collection » du jeu MetaFight : douze cartes de combattants avec leur rareté, leur score, leur bilan et leur état (inscrit, au repos, disponible, en vente)
Client
MetaFight
Secteur
Jeux et sport
Projet
Renfort d’équipe : interfaces web et API
Période
Décembre 2022 – octobre 2024
Technologies
  • Next.js
  • React
  • Node.js
  • PostgreSQL

En bref

Le défi
Renforcer rapidement l’équipe technique d’un jeu en cours de lancement, réparti sur plusieurs applications web et une API commune, sans ralentir ses sorties.
Notre réponse
Des développeurs AquilApp intégrés aux outils et aux rituels de l’équipe : mêmes dépôts, mêmes tickets, mêmes revues de code, sur les interfaces Next.js comme sur l’API.
Les résultats
Un site vitrine en recette douze jours après le cadrage, puis douze mois de livraisons : ligues fiabilisées, requêtes allégées, paiement par carte, connexion simplifiée.

Pas le temps de tout lire ?

Votre IA résume cette page en un clic, avec les bonnes questions à nous poser.

  • 12 jours

    entre la réunion de cadrage et la mise en recette du nouveau site vitrine, en décembre 2022

  • 12 mois

    dans l’équipe du jeu, sur quatre interfaces et une API, de décembre 2022 à novembre 2023

  • 8 mises à jour

    du jeu annoncées aux joueurs par l’équipe que nous avions rejointe, de mars à novembre 2023

Étude de cas complète

Des cartes de MMA déjà en circulation, une première alpha à sortir

MetaFight était un jeu de cartes à collectionner consacré au MMA : le joueur y réunissait des cartes de combattants, les équipait et les inscrivait dans des ligues où les combats étaient simulés. Les cartes étaient des actifs numériques enregistrés sur une blockchain, que les joueurs achetaient, échangeaient et revendaient.

Fin novembre 2022, l’éditeur nous a exposé son besoin : une place de marché à ouvrir à la revente en décembre, puis une première version jouable, l’alpha, visée pour la mi-janvier 2023. La demande portait d’abord sur le développement d’interfaces. La réunion de cadrage s’est tenue le 8 décembre 2022 ; le jour même, nos développeurs recevaient leurs accès aux dépôts et aux maquettes.

Notre rôle était clair : nous ne pilotions pas le produit. Nous avons développé dans l’équipe de MetaFight, sous la direction de son responsable technique, avec ses outils et ses priorités. Les règles du jeu, la blockchain et les contrats n’étaient pas de notre ressort.

Quatre interfaces et une API à faire avancer ensemble

Le jeu n’était pas une application, mais plusieurs : un site vitrine, une place de marché où s’échangeaient les cartes, une boutique de paquets de cartes et les écrans de jeu eux-mêmes, avec la collection, la salle d’entraînement, les arènes et les classements. Toutes s’appuyaient sur une même API.

Les interfaces étaient écrites avec Next.js et React, en TypeScript. L’API tournait sous Node.js, avec une base PostgreSQL. Nous sommes intervenus sur les deux versants, avec trois contraintes en tête :

  • Un calendrier public : chaque saison était annoncée aux joueurs avec ses dates. Une livraison en retard se voyait.
  • Des cartes qui ont une valeur : une carte inscrite en ligue, mise en vente ou au repos ne devait jamais se trouver dans deux états à la fois.
  • Un public à élargir : au départ, on entrait dans le jeu avec un portefeuille de cryptomonnaie, ce qui écartait les amateurs de MMA peu familiers de ces outils.

Cinq défis, du premier écran à la facture

Être utile dès la deuxième semaine

Le risque
Rejoindre un produit en cours, c’est d’abord découvrir ses dépôts, ses environnements et ses règles de jeu. Pendant ce temps, le site vitrine attendait sa refonte et l’échéance de l’alpha approchait.
Notre réponse
Nous avons commencé par ce chantier, le plus autonome : nouvelles pages, animations, effet d’inclinaison des cartes, adaptation aux écrans mobiles, à partir des maquettes de l’équipe. Les onze premières demandes de fusion du dépôt se sont enchaînées en une semaine.
Résultat
Le nouveau site est parti en recette le 20 décembre 2022, douze jours après la réunion de cadrage. Dans la foulée, nous avons enchaîné sur la place de marché.
Accueil du site MetaFight sur mobile : bandeau « Play MetaFight Alpha 1 » sur fond de cage de combat, puis tuile de la place de marché avec trois cartes de combattants
L’accueil du site vitrine sur mobile : l’invitation à jouer, puis les tuiles qui mènent à la place de marché, à la collection et aux paquets. Écran reconstitué, données fictives.

Des combats à l’heure, un combattant à la fois

Le risque
Une ligue enchaînait inscriptions, attente et combats, puis imposait un temps de repos aux combattants. Deux défauts étaient remontés : des combats qui ne se lançaient pas au moment prévu, et un même combattant inscrit deux fois quand deux demandes arrivaient ensemble.
Notre réponse
Nous avons porté les deux corrections dans l’API en avril 2023, relues par l’équipe de MetaFight avant fusion. L’équipe a ensuite étendu cette logique d’état unique : en juin, une carte mise en vente ne pouvait plus être inscrite, et l’équipement d’un combattant engagé était verrouillé.
Résultat
Les deux correctifs ont été fusionnés le même mois. En octobre et novembre 2023, nous avons encore fait évoluer le calcul des combats et les critères de score qui ouvrent l’accès aux ligues.
Écran d’une arène de MetaFight : quatre ligues avec leurs critères d’entrée, leur coût en points de Fight Session, le nombre d’inscrits et une barre de temps
Une arène et ses ligues : critères d’entrée, coût en points d’énergie, nombre d’inscrits et temps restant avant les combats. Écran reconstitué, données fictives.

Des requêtes qui s’alourdissaient avec les collections

Le risque
Plus un joueur possédait de cartes, plus la requête qui chargeait sa collection croisait de tables : inscriptions en ligue, ordres de vente, temps de repos, bilan des combats. Le sujet était visible des joueurs : la note de mise à jour du 10 mai 2023 signalait la correction d’un défaut d’affichage au-delà de cent cartes.
Notre réponse
En avril 2023, nous avons sorti l’historique dans une table dédiée. En juin et juillet, nous avons passé cinq requêtes de l’API au crible, plans d’exécution à l’appui : statistiques, résultats, cartes, liste des ligues, détail d’une ligue. Nous avons proposé dix index, dont plusieurs limités aux seules lignes actives, et une purge automatique des temps de repos expirés.
Résultat
Les plans d’exécution, avant et après, ont été documentés et remis à l’équipe avec la liste des index à créer. Le même document évalue une base PostgreSQL managée, répartie entre écriture et lecture, et décrit la procédure de bascule.

Passer du portefeuille au compte utilisateur

Le risque
Toute la base de données désignait le joueur par l’identifiant de son portefeuille. Proposer une connexion classique supposait de changer cette clé partout, sans perdre une carte ni un résultat en route.
Notre réponse
En mai 2023, nous avons écrit les migrations et repris le code de l’API pour passer de l’identifiant de portefeuille à un identifiant d’utilisateur. Les tickets de connexion par un compte tiers nous ont été attribués en juin, et les écrans ont suivi.
Résultat
En août 2023, MetaFight annonçait à ses joueurs un accès avec Google, Discord ou Instagram, en plus de l’adresse e-mail et du portefeuille.

Payer par carte bancaire, facture comprise

Le risque
Acheter un paquet de cartes supposait de détenir de la cryptomonnaie. Ajouter la carte bancaire entraînait des obligations nouvelles : informations de facturation, TVA selon le pays de l’acheteur, historique consultable.
Notre réponse
Côté API, nous avons posé la facturation dès avril 2023, puis les prix en dollars. Côté boutique, nous avons intégré le paiement par carte depuis la fiche du paquet, avec son formulaire de facturation. Côté compte, une page liste chaque achat : date, référence de la transaction, prix, montant hors taxes, taux de TVA et pays.
Résultat
Le paiement par carte a été développé en juin et juillet 2023, puis a suivi le circuit de recette de l’équipe. Le montant hors taxes est calculé à partir du taux de TVA du pays de facturation.
Boutique de MetaFight : trois paquets de cartes Bronze, Silver et Gold, et un panneau de paiement avec informations de facturation, choix carte bancaire ou cryptomonnaie, pays et TVA
La boutique : le paquet choisi, les informations de facturation, le pays qui détermine la TVA et le choix entre carte bancaire et cryptomonnaie. Écran reconstitué, données fictives.

Ce que le joueur avait entre les mains

Au fil des versions, nos développements se sont répartis sur l’ensemble du parcours du joueur.

  • Site vitrine : accueil présentant l’alpha, accès à la place de marché, à la collection et aux paquets, feuille de route, page de l’équipe, mentions légales.
  • Place de marché : les cartes en vente, branchées au printemps 2023 sur l’API du jeu, puis dotées de filtres.
  • Boutique : des paquets de trois cartes, du Bronze au Legendary, payables en cryptomonnaie puis par carte bancaire.
  • Écrans de jeu : la collection, la salle d’entraînement, les trois arènes et leurs ligues, les classements.
  • Compte : connexion, solde, et la page des factures.
Salle d’entraînement de MetaFight : carte d’un combattant, statistiques techniques et personnelles, équipement verrouillé pendant la ligue, bilan et liste des combats passés
La salle d’entraînement : statistiques du combattant, équipement, bilan et combats passés. Écran reconstitué, données fictives.

En juin 2023, la recette de l’alpha 4 a remonté des points très concrets sur ces écrans : défilement des cartes dans la salle d’entraînement, écrans vides quand un combattant n’avait pas d’équipement, statut du combattant au moment de l’inscrire. Un jeu se juge à ces détails, corrigés version après version.

Page « My bills » du compte MetaFight : tableau des achats avec date, référence de transaction, prix, montant hors taxes, taux de TVA et pays
La page des factures du compte : chaque achat avec son montant hors taxes, son taux de TVA et son pays. Écran reconstitué, données fictives.

Quatre choix techniques qui ont rendu ce rythme tenable

Un paquet de composants partagé

Quatre interfaces auraient pu vivre chacune avec ses boutons et ses cartes. Le projet reposait au contraire sur un paquet de composants commun, publié et versionné, que chaque interface installait : thème, mise en page, carte de combattant, accès à l’API. Une carte s’affichait de la même façon partout, et une correction se propageait par simple montée de version.

Trois environnements, une prévisualisation par changement

Chaque changement passait par trois étapes : développement, préproduction, production. Chaque demande de fusion générait une version consultable en ligne : l’équipe validait sur un écran réel, pas sur une description. Les erreurs de production remontaient dans un outil de suivi, ouvert à nos développeurs dès janvier 2023.

Des index limités aux lignes utiles

Dans une table d’inscriptions, seules celles en attente intéressent l’écran d’un joueur. Un index partiel, restreint à ces lignes, reste petit et rapide quand l’historique grossit. C’est la première réponse que nous avons proposée, avant toute question de dimensionnement du serveur.

Des animations en CSS

Sur le site vitrine, les tuiles de l’accueil s’animent au survol par de simples transformations et transitions d’opacité, avec une image dédiée aux petits écrans. Aucune bibliothèque d’animation n’alourdit la page.

Dans l’équipe : mêmes dépôts, mêmes tickets, mêmes revues

Un jeu vit de ses rendez-vous : nouvelle ligue, événement, saison. L’équipe travaillait en versions d’alpha successives, chacune avec sa recette. Entre mars et juillet 2023, plus de 300 tickets ont été créés dans son tableau de production, tous contributeurs confondus.

Nous avons suivi ses rituels : points d’équipe, revue de code croisée, tickets attribués par MetaFight. Certains jours, nous relisions le code de l’équipe ; d’autres, elle relisait le nôtre. Selon les périodes, jusqu’à trois développeurs AquilApp ont contribué aux dépôts.

Les joueurs étaient tenus informés par des notes de mise à jour publiques : huit ont paru entre le 7 mars et le 13 novembre 2023. Elles donnent la mesure du rythme : ligues à récompenses en avril, ligues dynamiques en mai, nouvel algorithme de combat en juin, ligues aléatoires en octobre.

Douze mois de livraisons, du site vitrine à la dernière saison

  • Décembre 2022 : site vitrine en recette douze jours après le cadrage, puis premières livraisons sur la place de marché.
  • Avril – mai 2023 : combats à l’heure, inscriptions sans doublon, table d’historique, passage à l’identifiant d’utilisateur.
  • Juin – juillet 2023 : alpha 4 du 20 juin au 18 juillet, paiement par carte dans la boutique, analyse des requêtes et dix index proposés.
  • Août – septembre 2023 : saison d’été du 1er août au 11 septembre, avec la connexion par Google, Discord ou Instagram.
  • Octobre – novembre 2023 : calcul des combats et critères de score des ligues ; nos dernières contributions datent des 21 et 22 novembre, pendant la dernière saison de l’alpha.

Nous ne publions ni audience ni volume de ventes : ces chiffres appartiennent à l’éditeur. Ce bilan s’en tient à ce que nous avons livré et à ce que l’équipe a annoncé publiquement.

La collaboration s’est poursuivie en 2024 sur des sujets plus ponctuels, dont un socle PrestaShop 8 préparé en octobre pour l’offre MetaFight Experience.

Ce que nous en retenons

  • Un renfort réussi adopte les outils de l’équipe : mêmes dépôts, mêmes tickets, mêmes revues. Le client garde la main sur son produit.
  • Commencer par un chantier autonome : le site vitrine nous a permis de livrer en douze jours, le temps d’apprendre les règles du jeu.
  • La technologie ne doit pas filtrer les joueurs : un compte classique et une carte bancaire abaissent la marche d’entrée pour ceux qui viennent pour le sport.

Votre équipe a besoin de renfort sur un produit en cours ? Découvrez nos autres projets dans le secteur des jeux.

Réponse sous 24 h ouvrées

Un projet comparable ?

Parlez-nous de votre contexte : nous cadrons ensemble la prochaine étape, sans engagement.

Autres réalisations

Tous nos cas clients