SLAY THE GBA

🗺️ Tome 19 — Boucle de Gameplay Roguelike, Carte & Système d'Ascension (1 à 10)

Référence de conception et d'implémentation pour le moteur slay_the_gba
Source : Règles fondamentales de Slay the Spire & Slay the Spire 2 (v0.111.0 Beta)
Composants C++ associés : include/engine/map.h, src/engine/map.cpp, include/engine/run.h, src/engine/run.cpp

1. 🔄 Vue d'Ensemble de la Boucle de Gameplay (The Roguelike Run Loop)

Dans Slay the Spire 2, chaque tentative (Run) est une ascension impitoyable à travers 3 Actes consécutifs, régie par la gestion d'un Master Deck, de Reliques, de Potions, de Points de Vie (PV) et d'Or.

flowchart TD
    Start(["Départ : Choix du Héros"]) --> Init["Deck de départ (10-12 cartes)\nRelique de départ unique\n99 Or & PV Max"]
    Init --> Neow["Étage 1 : Bénédiction de Neow / L'Ancien"]
    Neow --> MapAct1["Carte Acte 1 (15 étages bifurqués)"]

    subgraph ActLoop ["Navigation dans l'Acte"]
        MapAct1 --> Node{"Type de Salle"}
        Node -->|Combat normal| Battle["Combat de Monstre\nRécompense : Or, 1 carte / 3, Potion"]
        Node -->|Combat Élite| Elite["Combat d'Élite\nRécompense : Relique, Or++, Carte rare"]
        Node -->|Feu de Camp| Camp["Feu de Camp (Étage 14 garanti)\nRepose (+30% PV) ou Forger (+)"]
        Node -->|Coffre Trésor| Chest["Trésor (Étage 7 garanti)\nRelique gratuite + Or"]
        Node -->|Marchand| Shop["Boutique\nAchat/Retrait de cartes, reliques"]
        Node -->|Événement ?| Event["Événement Mystère\nChoix narratifs & paris risqués"]

        Battle --> NextFloor["Progression vers l'étage suivant"]
        Elite --> NextFloor
        Camp --> NextFloor
        Chest --> NextFloor
        Shop --> NextFloor
        Event --> NextFloor
        NextFloor --> BossCheck{"Étage 16 ?"}
        BossCheck -->|Non| Node
    end

    BossCheck -->|Oui| Boss["Boss de Fin d'Acte (Sommet)"]
    Boss --> BossWin{"Victoire ?"}
    BossWin -->|Défaite| GameOver(["💀 Défaite : Fin de tentative"])
    BossWin -->|Victoire| AncientTransition["Rencontre d'Ancien / Relique de Boss\nSoin d'entre-actes"]

    AncientTransition --> NextAct{"Acte Actuel"}
    NextAct -->|Fin Acte 1| MapAct2["Génération Carte Acte 2"] --> ActLoop
    NextAct -->|Fin Acte 2| MapAct3["Génération Carte Acte 3"] --> ActLoop
    NextAct -->|Fin Acte 3| Victory(["🏆 Victoire Finale de la Tour !"])
    Victory --> UnlockAscension["Déblocage du niveau d'Ascension supérieur (1 à 10)"]

2. 🏛️ Configuration Initiale par Personnage (Étage 1)

Chaque héros débute son ascension avec des statistiques et un deck asymétriques :

Héros PV Max Or Relique de Départ Composition du Deck de Départ (10 à 12 cartes)
Soldat de Fer (Ironclad) 80 99 Sang ardent (Burning Blood) : Récupère 6 PV à la fin de chaque combat. 5 Frappe, 4 Défense, 1 Fracassement (Bash)
La Silencieuse (Silent) 70 99 Anneau du serpent (Ring of the Snake) : Pioche 2 cartes supplémentaires au tour 1. 5 Frappe, 5 Défense, 1 Neutralisation (Neutralize), 1 Survivant (Survivor)
Le Défectueux (Defect) 75 99 Noyau fissuré (Cracked Core) : Canalise 1 Orbe d'Éclair au début du combat. 4 Frappe, 4 Défense, 1 Éclair (Zap), 1 Double distribution (Dualcast)
Le Régent (Regent) 75 99 Droit divin (Divine Right) : Octroie 1 Énergie supplémentaire tous les 3 tours. 4 Frappe, 4 Défense, 1 Étoile filante (Falling Star), 1 Vénération (Venerate)
La Nécrolieuse (Necrobinder) 65 99 Phylactère lié (Bound Phylactery) : Conserve les cadavres pour invoquer des sbires. 4 Frappe, 4 Défense, 1 Déchaînement (Unleash), 1 Garde du corps (Bodyguard)

3. 🗺️ Structure de la Carte & Types de Salles

Chaque Acte est composé de 15 étages progressifs + 1 sommet de Boss (16 étages au total), répartis sur 3 couloirs verticaux (Lanes : Gauche, Centre, Droite) reliés par des chemins directionnels ascendants.

Typologie des Salles et Règles de Génération

Icône Type de Salle Étage Garanti / Règle d'apparition Effet & Choix disponibles
⚔️ Combat Normal (MONSTER) Étage 1 toujours combat. Fréquence ~45%. Affronte des monstres de base. Victoire = 15-30 Or, sélection de 1 carte parmi 3 (ou passer), chance de potion (40%).
😈 Combat d'Élite (ELITE) Ne peut apparaître avant l'étage 6. Fréquence ~20% au-delà. Ennemis redoutables avec patterns complexes. Victoire = Relique garantie, 35-50 Or, carte avec taux de Rares augmenté.
🔥 Feu de Camp (REST_SITE) Étage 14 garanti (avant-boss). Fréquence ~15%. Se Reposer (rend 30% des PV max) OU Forger (améliore définitivement une carte du deck en version +).
🎁 Salle au Trésor (TREASURE) Étage 7 garanti (mi-parcours). Ouvre un grand coffre contenant une Relique majeure et une bourse d'or. Aucun combat.
💰 Marchand de la Tour (SHOP) Fréquence ~10%. Pas d'étages consécutifs. Dépensez votre Or : 5 cartes en vente, 3 reliques, 3 potions, et service de retrait (Card Removal : 75 Or + 25 par retrait).
❓ Événement Mystère (EVENT) Fréquence ~20%. Rencontres scénarisées, sanctuaires anciens, jeux de hasard, offres démoniaques (sacrifier des PV ou accepter une malédiction contre des récompenses).
👑 Boss de l'Acte (BOSS) Étage 16 (Sommet). Accessible depuis les 3 couloirs. Boss titanesque de l'Acte. Victoire = transition d'Acte, sélection d'Ancien / Relique de Boss, soin d'Acte.

4. 📈 Le Système d'Ascension (Niveaux 1 à 10)

L'Ascension est le système de difficulté évolutif de Slay the Spire. Chaque victoire complète (Acte 3 battu) débloque le niveau d'Ascension suivant pour le personnage victorieux. Les modificateurs sont cumulatifs : l'Ascension 5 inclut les handicaps des Ascensions 1, 2, 3, 4 et 5 !

flowchart LR
    A0["A0 : Standard"] --> A1["A1 : Élites + fréquents"]
    A1 --> A2["A2 : Monstres +20% Dégâts"]
    A2 --> A3["A3 : Élites + Dégâts"]
    A3 --> A4["A4 : Boss + Dégâts"]
    A4 --> A5["A5 : Soin Boss 75%"]
    A5 --> A6["A6 : Départ 90% PV"]
    A6 --> A7["A7 : Monstres +15% PV"]
    A7 --> A8["A8 : Élites + PV"]
    A8 --> A9["A9 : Boss + PV"]
    A9 --> A10["A10 : Fléau permanent"]

Tableau Exhaustif des 10 Paliers d'Ascension

Niveau Nom Officiel Description du Handicap Impact Mécanique sur GBA
Ascension 0 Mode Standard Difficulté par défaut du jeu. Multiplicateurs à 100%, 0 malédiction de départ.
Ascension 1 Élites Renforcés Les salles d'Élites apparaissent plus fréquemment sur la carte. Augmentation du ratio d'Élites sur la carte (MapGraph::generate).
Ascension 2 Monstres Meurtris Les attaques de tous les monstres normaux infligent plus de dégâts (+20%). Multiplicateur de dégâts : x1.20 (get_enemy_damage_multiplier()).
Ascension 3 Élites Féroces Les attaques des monstres Élites infligent plus de dégâts. Les patterns offensifs des Élites infligent +25% de dégâts bruts.
Ascension 4 Boss Impitoyables Les attaques des Boss d'actes infligent plus de dégâts. Les attaques signature des Boss sont augmentées de 2 à 4 points de dégâts.
Ascension 5 Soin Réduit La régénération de fin d'acte ne rend que 75% des PV manquants (au lieu de 100%). Lors du passage d'acte : hp += (max_hp - hp) * 75 / 100.
Ascension 6 Départ Éprouvé Le héros commence son ascension avec 10% de PV en moins. hp = (max_hp * 9) / 10 (ex: Ironclad débute à 72/80 PV, Necrobinder à 58/65 PV).
Ascension 7 Monstres Robustes Les monstres normaux ont plus de Points de Vie (+15%). Multiplicateur de PV ennemis : x1.15 (get_enemy_hp_multiplier()).
Ascension 8 Élites Robustes Les monstres Élites possèdent une réserve de PV accrue (+20%). Les PV max de tous les monstres Élites sont multipliés par x1.20.
Ascension 9 Boss Colossaux Les Boss d'Actes possèdent une réserve de PV accrue (+25%). Les Boss ont des seuils de PV nettement plus élevés (ex: 300+ PV).
Ascension 10 Fléau de l'Ascension Vous débutez la tentative avec la carte malédiction Fléau (Ascender's Bane) dans votre deck. La carte insupportable (Injouable, Éthérée) est insérée d'office au deck de départ.

5. 🛠️ Architecture Moteur GBA C++20 (slay_the_gba)

Pour respecter les contraintes strictes de la Game Boy Advance (32 Ko de Fast WRAM, 256 Ko de WRAM, processeur ARM7TDMI 16.78 MHz), toute la boucle est implémentée sans aucune allocation dynamique sur le tas (malloc/new).

1. Le Graphe de Carte (MapGraph)

  • Déclaré dans include/engine/map.h.
  • Stocké dans un FixedVector<MapNode, 50> (45 nœuds de couloir + 1 nœud de Boss = 46 nœuds au total).
  • Chaque nœud connaît son numéro d'étage (0 à 15), son couloir (0 à 2), son type de salle (RoomType), et jusqu'à 3 liens enfants (children).
enum class RoomType : uint8_t {
    MONSTER = 0,
    EVENT,
    SHOP,
    REST_SITE,
    TREASURE,
    ELITE,
    BOSS
};

struct MapNode {
    uint8_t floor;      // 0 à 15 (15 = Boss)
    uint8_t lane;       // 0: Gauche, 1: Centre, 2: Droite
    RoomType type;
    uint8_t children[3];
    uint8_t children_count;
};

2. Le Gestionnaire de Tentative (RunManager)

  • Déclaré dans include/engine/run.h.
  • Coordonne les transitions d'écrans via l'énumération RunPhase :
  • MAP_NAVIGATION : Sélection de la prochaine salle au D-Pad.
  • IN_COMBAT : Moteur de combat Butano 60 FPS.
  • REWARD_SCREEN : Choix d'une carte parmi 3 et collecte de l'Or.
  • CAMPFIRE : Écran de repos ou forge.
  • SHOP : Écran de transaction avec le Marchand.
  • ANCIENT_BLESSING : Écran de dialogue et de choix d'Ancien (Neow, Darv, etc.).
  • VICTORY_ACT : Écran de triomphe final et déblocage de l'Ascension.
class RunManager {
public:
    CharacterId character = CharacterId::IRONCLAD;
    uint8_t ascension_level = 0; // 0 à 10
    uint8_t current_act = 1;     // 1, 2, 3
    uint8_t current_floor = 1;   // 1 à 16
    int16_t hp = 80;
    int16_t max_hp = 80;
    int16_t gold = 99;

    FixedVector<CardId, 50> master_deck;
    FixedVector<std::string_view, 25> relics;
    FixedVector<std::string_view, 3> potions;

    MapGraph map;
    int current_node_index = -1;
    RunPhase phase = RunPhase::MAP_NAVIGATION;

    CombatEngine combat;
    FixedVector<CardId, 3> current_card_rewards;
    int16_t gold_reward = 0;
    // ...
};

6. 🎮 Validation & Tests Unitaires Automatisés

L'ensemble de la boucle de jeu et les règles d'Ascension sont validés par la suite de tests unitaires C++20 (make test) :

=== Slay The GBA Engine Test ===
[PASS] Procedural Map Graph: 16 floors generated (3 start branches, 1 Boss summit)
[PASS] Run Loop: Deck, Combat, Burning Blood (+6 HP), Card Reward & Gold picked
[PASS] Campfire: Rest healed HP back to max
[PASS] Ascension 0-10: Levels, handicap HP (A6/A10), dmg mult (A2), and HP mult (A7) verified
[PASS] Act Progression: Act 3 Boss victory triggers Run Completed
=== All Engine Tests Passed Successfully! ===

Tome 19 rédigé pour le projet Slay The GBA — Version patch v0.111.0 Beta.

Tome 21 — Interface Style Pokémon, Navigation de Carte & Inspecteur de Deck

1. Vision & Architecture UI/UX

Ce tome spécifie l'expérience joueur immersive combinant deux philosophies emblématiques : 1. La navigation et progression de Slay the Spire : exploration procédurale de 16 étages, vision des embranchements futurs, gestion et consultation permanente du Deck principal via raccourci manette. 2. L'ergonomie des combats et événements inspirée des jeux Pokémon GBA (Génération 3) : disposition en diagonale de l'arène (héros vu de dos/trois-quarts en bas à gauche, monstre en haut à droite), boîtes de statut à jauges dynamiques, menu d'action 4 directions, et fenêtres de dialogue pour les événements mystères.

2. Navigation de Carte Classique (Slay the Spire)

Disposition Écran & Défilement D-Pad

Sur l'écran GBA (240x160 pixels), la carte de l'Acte est visualisée verticalement : - Défilement vertical (Haut / Bas) : Permet d'inspecter les étages 1 à 16 (sommet de la Tour avec le Boss) pour planifier son cheminement (repérer les Feux de camp, Boutiques et Élites). - Sélection des embranchements (Gauche / Droite) : Met en surbrillance l'une des voies connectées accessibles depuis la salle actuelle (MapGraph::get_next_nodes). - Confirmation (Bouton A) : Valide le déplacement et fait entrer le joueur dans la salle choisie. - Consultation rapide du Deck (Bouton SELECT) : Bascule instantanément sur l'Inspecteur de Deck.

┌────────────────────────────────────────────────────────┐
│  🗺️  CARTE DE LA TOUR — ACTE 1   PV:80/80   OR:99 💰   │
├────────────────────────────────────────────────────────┤
│  Étage 16 :               👑 [BOSS GUARDIAN]           │
│  Étage 15 :     [Feu]            [Feu]           [Feu] │
│  Étage 14 :    [Combat]        [Élite]         [Shop]  │
│  ...                                                   │
│  Étage  2 :   👉[Combat]        [Event ?]       [Shop] │
│  Étage  1 :    *[Combat]                               │
├────────────────────────────────────────────────────────┤
│  > Voie Gauche (Étage 2) : Combat de Monstre [Combat]  │
│  Haut/Bas: Défiler   G/D: Choisir Route   A: Entrer    │
│  SELECT: Registre du Deck                              │
└────────────────────────────────────────────────────────┘

Typologie des Salles et Icônes GBA

Type de Salle Icône GBA Libellé Écran Comportement à l'entrée
MONSTER [Combat] Combat Standard Lance le combat contre un monstre de l'acte
ELITE [Élite] Combat d'Élite Combat difficile, récompense relique majeure
REST_SITE [Feu] Feu de Camp Choix : Se reposer (+30% PV) ou Forger (+1 carte)
SHOP [Shop] Marchand de la Tour Achats de cartes, reliques, potions et purge de carte
TREASURE [Coffre] Salle au Trésor Coffre scellé (+50 Or et 1 relique gratuite)
EVENT [Event ?] Événement Mystère Rencontre narrative avec choix style Pokémon
BOSS [BOSS] Gardien de l'Étage Combat de boss final de l'acte

3. Registre & Inspecteur de Deck (DeckViewer)

Accessible à tout moment en navigation (et via le menu en combat) par la touche SELECT ou l'option dédiée : - En-tête : Identité du Héros, Teinte/Couleur choisie (Flamme Azur, etc.), PV actuels/Max, Or possédé, Étage courant. - Barre de Reliques : Liste de toutes les reliques passives actives (Sang Ardent, Vajra, Akabeko...). - Inventaire du Deck : Défilement carte par carte avec affichage clair du statut d'amélioration (+), coût en Énergie, Type (Attaque, Compétence, Pouvoir) et description complète des effets. - Touche B ou SELECT : Retour immédiat à l'écran de navigation sans transition superflue.

4. Arène de Combat Style Pokémon (GBA Gen 3)

Disposition Spatiale (240x160)

  • Socles de combat (Piédestaux) :
  • Joueur : Positionné en bas à gauche (x = -65, y = 14).
  • Ennemi : Positionné en haut à droite (x = 65, y = -34).
  • Boîte de Statut Ennemi (Haut-Gauche) :
  • Nom du monstre et Étage.
  • Jauge de PV proportionnelle [████████░░] avec décompte numérique 34/44.
  • Bouclier d'Armure dynamique (+6B).
  • Bulle d'Intention (Attaque 11 dégâts, Buff Force +3).
  • Badges d'états et altérations ([STR+3], [VULN:1], [POISON:7]).
  • Boîte de Statut Héros (Bas-Droite / Centre-Droit) :
  • Nom du Héros et Teinte active ([Shiny]).
  • Jauge de PV proportionnelle [██████████] avec décompte 80/80.
  • Bouclier d'Armure (+5B).
  • Compteur d'Énergie [●][●][●] (3/3).
  • Jauge de ressource spécifique selon l'édition de cartouche :
    • Soldat de Fer : FORCE: +2 | MÉTALLISATION: 3
    • La Silencieuse : POISON ENNEMI: 7
    • Le Défectueux : ORBES: [⚡ Foudre] [❄️ Glace] [🌑 Dark] (3 emplacements)
    • Le Régent : ÉTOILES SOUVERAINES: ⭐⭐⭐ (3/5)
    • La Nécrolieuse : TITOS 12/12 (PV et PV Max du familier ; les Âmes sont des cartes, elles n'ont pas de jauge)
┌────────────────────────────────────────────────────────┐
│ [ENNEMI] Cultist (Étage 1)                             │
│ PV: [==========] 44/44                                 │
│ Intent: Attaque 6 dégâts                               │
│                                                        │
│                           [HÉROS] Soldat de Fer [Shiny]│
│                           PV: [==========] 80/80  [+5B]│
│                           ÉNERGIE: [●][●][●] (3/3)     │
│                           RESSOURCE: STR: +0 | METAL: 0│
├────────────────────────────────────────────────────────┤
│ Que doit faire Soldat de Fer ?                         │
│  > [1] CARTES (Attaques)         [2] SAC (Potions : 1) │
│    [3] MON DECK (Select)         [4] FIN DE TOUR       │
└────────────────────────────────────────────────────────┘

Le pavé de commande inférieur adopte la structure 2x2 des jeux Pokémon : 1. [1] CARTES : Ouvre le sous-menu des cartes en main. - Présentation façon "Capacités Pokémon" : Nom de la carte, coût en Énergie (remplaçant les PP), type et description complète de l'effet. - Touche A pour déclencher la carte. - Touche B pour annuler et revenir au menu principal. 2. [2] SAC : Affiche les potions portées à la ceinture (jusqu'à 3 fioles) pour utilisation instantanée. 3. [3] MON DECK : Ouvre l'overlay de consultation des cartes et reliques sans passer son tour. 4. [4] FIN DE TOUR : Conclut le tour du joueur, applique les statuts de fin de tour et déclenche l'animation d'offensive de l'ennemi.

Sensations & Animations de Combat

  • Respiration au repos (Idle Bobbing) : Flottement subtil de 1 pixel alterné toutes les 24 frames.
  • Fente offensive (Player Lunge) : Déplacement rapide vers l'ennemi lors du jeu d'une carte d'attaque.
  • Secousse de dégâts (Enemy Shake & Flicker) : Trépidation latérale de l'ennemi et clignotement lors de la réception d'un coup.
  • Indicateur de dégâts flottant : Affichage temporaire du montant de dégâts infligés au-dessus de la cible (-9 HP !).

5. Événements Mystères Style Pokémon

Les salles [Event ?] abandonnent les pavés textuels rigides pour adopter la scénarisation des rencontres de PNJ / Pokémon légendaires : - Cadre de Dialogue immersif : Texte narratif avec défilement fluide et typographie rétro. - Boîte de Choix interactive : 2 à 3 alternatives explicites avec indication des bénéfices et sacrifices. - Résolution avec feedback sonore et visuel : Message d'issue confirmant l'octroi d'Or, la guérison, l'amélioration d'une carte ou l'obtention d'une relique.

┌────────────────────────────────────────────────────────┐
│  ❓ MANNEQUIN D'ENTRAÎNEMENT USÉ                       │
├────────────────────────────────────────────────────────┤
│  « BZZZT ! SÉQUENCE D'ENTRAÎNEMENT INITIÉE !           │
│    Réglez vos coups ou subissez l'humiliation ! »      │
├────────────────────────────────────────────────────────┤
│  > [1] Attaque acharnée (Subissez 6 dégâts, +60 Or)    │
│    [2] Réparer les rouages (Améliorez 1 carte du deck) │
│    [3] Prendre la fuite (Continuer la route)           │
└────────────────────────────────────────────────────────┘

6. Automatisation des Builds & Nettoyage (make clean)

Afin d'éviter tout conflit de cache et d'éliminer les versions obsolètes de l'application :

Commande Makefile Action effectuée
make clean Supprime les ROMs obsolètes (ex: slay_the_gba.gba), les .elf, .map, fichiers temporaires, répertoires bin/ et build_*. Préserve les 5 ROMs officielles.
make clean-all Nettoyage complet incluant la suppression de toutes les cartouches .gba pour repartir d'un dépôt totalement vierge.
make all-roms Compile proprement et simultanément les 5 éditions de cartouches (slay_ironclad.gba, slay_silent.gba, slay_defect.gba, slay_regent.gba, slay_necrobinder.gba).
make test Exécute la suite de tests unitaires C++20 déterministes (100% PASS).
make test-e2e Exécute la simulation complète de bout en bout de la boucle de jeu (100% PASS).
make play Lance le simulateur interactif complet dans le terminal.