⚔️ Arène V2
Un projet de première année en Java, réécrit dix ans plus tard en jeu de combat
au tour par tour jouable dans un navigateur : solo contre l'IA, classé en ligne,
matchs privés entre amis, construction d'équipe et progression.
Les sources d'origine sont conservées telles quelles dans legacy/ —
c'est de là que viennent les dés, les sorts et l'humour de vie étudiante.
Le jeu en deux minutes
Tu diriges une équipe de 3 personnages. Un seul combat à la fois sur le
terrain, comme dans un Pokémon : tu peux changer de combattant, mais ça coûte
un tour.
Un personnage n'a pas de type. Ni élément, ni faiblesse écrite d'avance :
ce sont les cartes qu'on lui équipe qui décident de ce qu'il encaisse et de ce
qu'il fait passer. La teinte d'un sort ne sert qu'à choisir sa couleur et son
animation.
Le dé, hérité de la V1, est le cœur du système. Chaque sort a un nombre de
faces. Peu de faces = résultat fiable ; beaucoup de faces = loterie. Le jet
module les dégâts entre 55 % et 100 %… et tomber sur la face maximale
déclenche un coup critique. Le « Balayage de l'Enfer » a un dé à 66 faces :
quand il passe, il efface.
À cela s'ajoutent :
- trois oppositions défensives, toutes lisibles sur les cartes et aucune
écrite d'avance sur un personnage : l'armure retire un montant fixe à
chaque coup et lamine les sorts à coups multiples ; l'amorti plafonne ce
qu'un seul coup peut retirer et désamorce les bombes ; l'immunité annule
les statuts. Il n'y a pas de table des types dans ce jeu ;
- l'énergie : 22 points par tour, chaque sort a un coût, l'attaque de base
et la garde en régénèrent — impossible de spammer son meilleur sort ;
- les statuts : brûlure, poison, gel, étourdissement, régénération, rage,
malédiction, saignement, confusion, concentration ;
- les paliers de stats façon Pokémon (−6 à +6) ;
- un passif unique par personnage et un objet tenu ;
- une escalade à partir du round 18 : les dégâts montent, les soins
faiblissent. Aucun combat ne s'enlise.
Les gènes (IV)
Chaque personnage et chaque sort possède ses propres gènes tirés à
l'obtention, de 0 à 31 par caractéristique. Deux « Boule de Feu » ne se valent
pas. S'ajoutent les natures (+10 % sur une stat, −10 % sur une autre) et
les niveaux (1 à 50).
On peut retirer tous les gènes d'un personnage contre des crédits, ou en
perfectionner un seul contre de l'essence.
Les talents
Aux niveaux 25 et 50, chaque personnage ouvre un choix entre deux talents.
Ils dépendent du rôle — un tank arbitre entre renvoyer les dégâts et entrer
avec un bouclier, un mage entre le critique et un plancher sur son dé — et les
deux options d'un palier tirent dans des directions opposées. Vingt-quatre
talents en tout, calibrés par simulation : aucune paire ne dépasse 63 / 37.
L'essence
Un doublon dont on ne fera rien se dissout en essence. L'essence perfectionne
un gène, change un talent déjà choisi, et alimente la Forge : le sort qu'on
désigne, sans passer par le hasard. Ses gènes sortent avec un plancher de 14/31
— corrects, jamais parfaits, pour qu'un exemplaire forgé ne remplace pas un coup
de chance en booster.
Ce qu'un personnage peut apprendre
Chaque espèce a sa liste thématique de sorts, et tout sort ouvert à son
rôle s'y ajoute. La liste garde l'identité du personnage, le rôle garantit
qu'aucune carte tirée en booster ne reste inutilisable par personne.
La boucle
Combattre → gagner des crédits, des éclats et de l'XP → acheter des
personnages, des sorts et des objets à la boutique du jour ou les invoquer →
dissoudre les doublons en essence → affiner son équipe dans l'Atelier →
remonter le classement de la saison.
La défaite rapporte aussi : environ 40 % des gains. Une partie n'est jamais
perdue pour rien.
Le classement
ELO avec facteur K dégressif, huit divisions (Bois → Légende), saisons de quatre
semaines. Quand personne n'est en file après 18 secondes, tu affrontes
l'équipe réelle d'un autre joueur, pilotée par l'IA : le ladder reste
jouable même à trois joueurs connectés, et les points comptent.
Architecture
packages/
engine/ moteur de jeu en TypeScript, déterministe, sans dépendance
server/ API REST (Express) + persistance SQL
client/ interface React + Vite
legacy/ le projet Java de 2016, intact
api/ point d'entrée serverless (Vercel)
Le moteur est partagé. Le serveur l'utilise pour arbitrer les combats, le
client pour afficher les mêmes données (noms, puissances, table des éléments)
sans les dupliquer. Il est déterministe : à graine égale, un combat se rejoue à
l'identique, ce qui rend l'IA simulable et les bugs reproductibles.
Le serveur fait autorité. Le client n'envoie que des intentions
({type:'SORT', index:2}) ; toute la résolution a lieu côté serveur, qui
renvoie un flux d'événements horodatés. Le client se contente de rejouer ce
flux en animations.
Aucun WebSocket. Le jeu est au tour par tour : les combats en ligne
fonctionnent par interrogation périodique (1,6 s). C'est suffisant, et ça permet
un hébergement serverless gratuit.
Deux pilotes SQL interchangeables derrière la même interface : SQLite en
local, Postgres en déploiement. Le SQL est écrit une seule fois.
Presque aucun asset. Les bruitages sont synthétisés par la Web Audio API,
et chaque personnage possède un avatar SVG généré depuis sa fiche d'art
(couleurs, silhouette, accessoire). Les cartes peuvent afficher à la place une
illustration peinte, quand elle existe : outils/art/generer.mjs les produit
hors ligne via un endpoint compatible OpenAI, les ramène en WebP 512² — la
plus grande carte fait 268 px de large — et les recense dans un manifeste. Un
personnage sans illustration retombe sur son avatar SVG, donc le jeu reste
complet avec zéro image commitée et la direction artistique reste réversible.
La génération lit ARENE_IMAGE_URL, ARENE_IMAGE_KEY et ARENE_IMAGE_MODEL.
La production, elle, ne connaît ni clé ni latence : elle ne sert que le
résultat.
Démarrer en local
npm install
npm run build # construit le moteur, le client et le serveur
npm start # http://localhost:3000
En développement, avec rechargement à chaud :
npm run dev # client sur :5173, API sur :3000
La base SQLite est créée automatiquement dans donnees/. Crée un compte : tu
reçois 4 personnages, 16 sorts, 2 500 crédits et 60 éclats.
Autres commandes
| Commande | Effet |
|---|
npm run typecheck | vérifie les trois paquets |
npm run build:engine | reconstruit uniquement le moteur |
Variables d'environnement
| Variable | Défaut | Rôle |
|---|
PORT | 3000 | port d'écoute |
ARENE_SECRET | généré et gardé dans donnees/.secret | signature des jetons de session |
DATABASE_URL / POSTGRES_URL | — | bascule sur Postgres si défini |
ARENE_DATA_DIR | ./donnees | emplacement de la base SQLite |
ARENE_ORIGINE | * | origine autorisée (CORS) |
ARENE_DEBUT_SAISON | 5 janvier 2026 | date de référence des saisons |
Déploiement
Voir DEPLOIEMENT.md pour la mise en ligne sur Vercel
(offre gratuite) et pour l'auto-hébergement.
Licence
MIT — voir LICENSE.
