Jeux

Osmose, RPG tactique

Un RPG tactique au tour par tour à la manière de Dofus, écrit de zéro : client Godot 4 en C# pour Windows, macOS et Linux, règles partagées avec un serveur ASP.NET Core de comptes et de personnages, launcher en Rust.

En cours Sprint S45-S60+S64-S219 · 728 points

En bref, sans jargon pour les non-informaticiensLire le résuméRefermer

Ce que c'est: Un jeu vidéo de combat au tour par tour sur un plateau vu de biais, comme Dofus : on crée son personnage, on se promène dans une ville et on parle à ses habitants.
À quoi ça sert: Un vrai jeu à télécharger, avec son programme d'installation, des comptes de joueurs et un serveur, conçu pour grandir : monstres, paysages, puis jeu à plusieurs.
Ce que ça montre: La conduite d'un gros projet de jeu vidéo, de ses règles jusqu'à sa distribution, en C# et en Rust.

Code source

Comment les morceaux tiennent ensemble

Le launcher (Rust, Tauri) connecte le joueur, compare le jeu installé au manifeste du serveur (taille et empreinte SHA-256 de chaque fichier), ne télécharge que ce qui a changé, reprend un téléchargement coupé, vérifie chaque fichier, puis lance le jeu en lui passant le jeton.
Le jeu de bureau (Godot 4, C#) ne fait que dessiner : écran de connexion, village, combat. Tout ce qu'un clic peut faire est dans Rpg.Client, une bibliothèque sans moteur testée par xUnit, que le jeu rejoue lui-même dans la CI (auto-tests).
Rpg.Core porte les règles et les données (sorts, classes, monstres, cartes, village, dialogues) : la même bibliothèque sert au jeu, au serveur et au simulateur, si bien qu'un combat enregistré se rejoue à l'identique partout, sur les trois systèmes.
Le serveur (ASP.NET Core) gère comptes et personnages (JWT, mots de passe hachés, limite d'essais, EF Core et PostgreSQL), valide chaque demande avec les règles de Rpg.Core, et sert les fichiers du jeu au launcher.
Rpg.Sim, le simulateur en ligne de commande, fait jouer l'IA des milliers de fois : c'est lui qui a réglé l'équilibre des classes et des monstres.

Aperçu du combat

Le client de bureau, en Godot 4 et C# : un plateau en losanges vu de biais, des personnages animés (modèles 3D libres de Kenney), et les règles du sprint 45, sans une ligne de règle en plus dans le client.

Vidéo de 36 secondes, sans son, enregistrée par le jeu lui-même : un combat d'entraînement où l'IA joue aussi l'héroïne. Elle avance vers l'orque et le braconnier et les frappe au corps à corps ; les points de vie baissent au-dessus des têtes, le journal à gauche raconte chaque coup, et elle gagne de justesse au sixième tour, à 6 PV sur 60.

La fenêtre du launcher : en haut, le village de Clairval en bannière sous le nom « Osmose » et le bouton EN ; dessous, les champs « Nom de compte » et « Mot de passe », les cases « Mémoriser le nom de compte » et « Mémoriser le mot de passe », le bouton « Se connecter » et le lien « Pas encore de compte ? En créer un » ; en bas, la barre de mise à jour pleine et « Jeu mis à jour (version 1.0.10, 196,9 Mo) ». — Le launcher (Rust, Tauri) : il met le jeu à jour tout seul à l'ouverture, fichier par fichier ; « Se connecter » lance le jeu ; le nom et le mot de passe peuvent être mémorisés (le mot de passe dans le gestionnaire d'identifiants du système). Paquets Windows, macOS et Linux produits par la CI, non signés.

L'écran des personnages du jeu, sur le serveur Osméria, devant le village de Clairval assombri : trois cartes, Ondine (Sentinelle, niveau 1, cheveux roux), Élise (Mage, niveau 1, cheveux bleus, entourée de pistache : c'est elle qui est choisie) et Bastien (Garde, niveau 1, grand et costaud, peau foncée), chacun avec son portrait 3D, puis une carte « + Créer un personnage » ; dessous, les boutons « Jouer » et « Supprimer ». — Après le launcher, comme dans les jeux du genre : le choix du serveur (direct tant qu'il n'y en a qu'un, Osméria), puis les personnages en cartes (portrait, classe, niveau), jusqu'à cinq par compte. Comptes et personnages vivent sur le serveur (ASP.NET Core, PostgreSQL).

L'écran de création, devant le village assombri : à gauche, le personnage qui tourne, les boutons « Femme » (choisi) et « Homme » et les six apparences de femmes en vignettes, « Femme B » entourée ; à droite, la classe (Sentinelle, Garde choisie, Mage), sa description avec ses points et ses éléments (Terre, Feu), puis ses vingt sorts rangés par niveau de déblocage, du niveau 1 au niveau 100, les pastilles de couleur de la tenue, des cheveux et de la peau, les curseurs de taille et de carrure, le champ du nom « Aubépine » et les boutons « Créer » et « Annuler ». — Créer son personnage : classe (avec ses vingt sorts, par niveau), femme ou homme puis l'une des six apparences, couleurs de tenue, de cheveux et de peau, taille et carrure, sur les modèles libres de Kenney ; chaque pastille montre la couleur qu'elle donnera à ce modèle. Le serveur vérifie chaque valeur.

Le village de Clairval vu de biais : quatre maisons aux toits pointus, une fontaine au centre de routes pavées, des sapins, une mare, deux étals de marché. Le joueur est allé parler à Aubin, au centre, que la caméra suit : seul son nom s'affiche, les habitants plus loin (Rose près de son étal, Garance à côté de la porte est marquée d'un anneau rouge et du texte « Porte est : entraînement ») restent sans nom. En haut, un anneau vert pistache et le texte « Ouest : Bois de Clairval ». En bas, le dialogue : « Aubin », sa réplique sur les PM et les PA, et deux réponses numérotées. — La ville d'accueil : on s'y promène au clic, on parle à trois habitants (dialogues à choix, décrits en données), la porte est mène à un combat d'entraînement, la route de l'ouest au Bois de Clairval ; le serveur garde la position du personnage.

Le Bois de Clairval vu de biais : une route pavée blanche qui serpente entre des rangées de sapins, des rochers, une mare. Le joueur est au milieu de l'écran, sur la route, à côté d'un anneau vert pistache et du texte « Nord : Lande des Brumes » ; plus à gauche, un anneau rouge et le texte « Clairière : entraînement ». En haut à gauche, « Bois de Clairval » et l'aide « Clic : marcher · clic sur un habitant : lui parler · molette : zoom · Q et E : tourner · M : carte » ; en haut à droite, les boutons « Carte » et « EN ». — Une zone de niveau 3, deux fois plus grande que le village : la caméra suit le joueur, zoome à la molette et tourne d'un quart avec Q et E ; l'anneau vert mène à la zone suivante, et le serveur garde la zone et la case où l'on se tient.

La carte du monde, ouverte sur le Bois de Clairval : trois cases reliées par des traits, « Lande des Brumes, niveau 10 » en haut, « Bois de Clairval, niveau 3, vous êtes ici », bordée de vert pistache, en bas à gauche, et « Clairval, niveau 1 » à sa droite. — La carte du monde (touche M) : chaque zone à sa place, avec son niveau, reliée à ses voisines ; les zones et leurs liens sont décrits en données et vérifiés par les tests.

La fiche de caractéristiques, sur le village : en haut, le portrait d'Aubépine, « Niveau 10 · Garde » et les onglets « Caractéristiques » et « Sorts ». À gauche, des cases : Points de vie 122, PA 8, PM 4, Initiative 10, Points à répartir 6 / 90, et un bouton « Réinitialiser ». À droite, un tableau, chaque ligne à la couleur de son élément : Vitalité (rose) 20 investis, +5 d'équipement, 25 au total, +25 PV ; Terre (marron) 45, +20, 65, +12 dégâts Terre ; Feu (rouge) 0 ; Eau (bleu) 9, +4, 13, +2 dégâts Eau ; Air (vert) 10, +4, 14, +2 dégâts Air ; une colonne de résistance à 0 %, puis les boutons MIN, moins, plus et MAX. Dessous : « 10 points dans un élément = +2 dégâts dans cet élément, et rien d'autre ». — La fiche de caractéristiques : Vitalité, Terre, Eau, Feu, Air, chacune à sa couleur ; les points investis et ceux de l'équipement, ce que chaque total donne (10 points = +2 dégâts dans l'élément, et rien d'autre) ; une valeur à taper, MIN, MAX, et tout reprendre à tout moment.

L'onglet « Sorts » de la fiche de personnage : en haut, des filtres Tous, Neutre, Terre, Feu, Eau, Air et « Sorts : 8 point(s) de sort ». À gauche, une grille de tuiles, chacune avec son icône blanche sur la couleur de l'élément du sort : Coup de bouclier (rang 2/5, dans le deck), Lame ardente, Lame de glace, Taillade, Provocation, Rempart, Fauchage (tous dans le deck), puis des sorts grisés avec leur niveau (Fente ardente niv. 15, Ressac niv. 20…) ; dessous, « Deck 7/12 » et les sept icônes du deck. À droite, la fiche de Coup de bouclier avec son icône : rang 2/5, Terre, coût 3 PA, portée 1 à 1, 2 lancers par tour, critique 10 %, « 20 à 24 dégâts Terre » en couleur, « 22 à 26 en critique » en gras, poussée de 2, rang suivant pour 2 points de sort : 22 à 26, un bouton « Retirer du deck » et des boutons moins et plus. — Les sorts : les vingt-quatre de la classe, quatre par élément et huit neutres, chacun avec son icône sur la couleur de son élément, verrouillés jusqu'à leur niveau ; la fiche donne les dégâts normaux et critiques avec les caractéristiques et l'équipement du personnage, et ce que donne le rang suivant.

L'écran d'inventaire et d'équipement, sur le village : à gauche, le personnage en 3D entre deux colonnes de sept emplacements carrés (coiffe, amulette, cape, épaulettes, plastron, ceinture, bottes ; anneaux 1 et 2, arme à une main, arme à deux mains, bouclier, familier, monture), chacun montrant l'icône de l'objet porté ou, pâle, la forme de l'emplacement vide. À droite, un champ « Rechercher un objet », les onglets Tout, Équipement, Consommables, Ressources et Quête, et une grille d'icônes dessinées (anneau, épée, patte, cape, bottes, potions, crocs, insigne), à la couleur de leur caractéristique, avec leur nombre ; dessous, un cadre qui donne la fiche de l'objet survolé ; en bas, « Enregistrer » et « Fermer ». — S'équiper : le personnage entouré de ses quatorze emplacements, l'inventaire en onglets et en grille, une recherche ; les icônes sont dessinées par le jeu (la forme dit l'emplacement, la couleur la caractéristique). Inventaire d'exemple d'une Garde de niveau 10 ; en jeu, le serveur garde ce que chaque combat laisse.

Plateau isométrique en herbe, en damier, avec des arbres, des rochers et deux mares ; Aubépine, Sentinelle de niveau 10, en haut à gauche, un orque et un braconnier entourés de rouge à droite. Les cases qu'elle peut atteindre sont en vert clair, le chemin vers la case survolée en jaune. En haut, « Tour 1 · À vous de jouer » et, à droite, la frise des huit prochains tours en portraits ; à gauche, le journal (le braconnier et l'orque se sont déplacés). En bas, PV 111/111, PA 8, PM 4, puis le deck en deux rangées de six : sept sorts, chacun avec son icône blanche sur la couleur de son élément (marron, rouge, bleu, vert, gris), numérotés 1 à 6 puis Ctrl+1, les cinq dernières places vides ; enfin le bouton « Fin du tour ». — Se déplacer : les cases atteignables, le chemin, et le deck de douze sorts en deux rangées (touches 1 à 6 et Ctrl+1 à 6).

Le même combat : la Flèche ardente (deuxième place du deck, entourée de pistache) est choisie ; les cases à sa portée sont marquées et le braconnier, visé, est sur une case rouge ; à droite, sous la frise, le panneau de survol annonce « Braconnier : 17 à 20 dégâts, 19 à 22 en critique » au-dessus de sa fiche « Braconnier · 44/44 PV · 6 PA · 4 PM ». En bas, PV 111/111, PA 8, PM 1, et le deck de la Sentinelle avec ses icônes. — Viser : la portée du sort, la ligne de vue, la cible et les dégâts prévus, critiques compris ; en haut, la frise des prochains tours.

Captures faites par le jeu lui-même (option --screenshot), dans un écran virtuel, avec le rendu OpenGL logiciel de Mesa.

Icônes des sorts : game-icons.net, sous licence CC BY 3.0, par Lorc, Delapouite et Sbed (le fond retiré, posées sur la couleur de l'élément).

Pour le lancer chez vous (SDK .NET 10 et Godot 4.7 .NET) :

cd projects/rpg
dotnet run --project src/Rpg.Sim -- --simulate 100 --lang fr   # des combats de l'IA, dans le terminal
docker compose up --build rpg-api                                   # le serveur des comptes et des personnages, sur le port 8002
dotnet build godot/Rpg.Godot.csproj
godot --path godot -- --lang fr                                # le jeu (« Jouer hors ligne » sans serveur)

Exécutables prêts à lancer (Windows, macOS, Linux, non signés), produits par la CI, qui y joue un combat entier, gardés 14 jours : artefacts du workflow rpg

Technologies

Godot 4
C#
.NET
ASP.NET Core
EF Core
PostgreSQL
JWT
Rust
Tauri
xUnit
Docker

Qui fait quoi

Godot 4: Le client de bureau : cartes isométriques, combat, création de personnage, ville et PNJ, exporté pour Windows, Linux et macOS par la CI.
C#: Les règles du jeu (grille, points d'action et de mouvement, ligne de vue, sorts, IA) dans une bibliothèque déterministe, partagée par le client et le serveur.
.NET: La plateforme commune du client, des règles et du serveur.
ASP.NET Core: Le serveur des comptes et des personnages, qui valide chaque personnage créé.
EF Core: L'accès à la base et ses migrations.
PostgreSQL: Les comptes, les personnages et leur progression.
JWT: Les jetons de connexion, partagés par le launcher et le jeu.
Rust: Le launcher : connexion, vérification et téléchargement des seuls fichiers modifiés.
Tauri: L'interface du launcher et ses paquets pour les trois systèmes.
xUnit: Les tests des règles (chemins, ligne de vue, combats rejoués) et du serveur, sur une vraie base PostgreSQL.
Docker: Le serveur et sa base, lancés par docker compose.

Definition of Done

Code relu, diff par diff
Tests unitaires et d'intégration verts
CI verte sur Linux, Windows et macOS si compilé
README, REVIEW.md et DECISIONS.md à jour
Textes en français et en anglais
Démo déployée et testée sur mobile