0.2.0-0-pre.5-fix.1

docs/studies/013-UROBURAS_FUNCTIONAL_SPEC.md

@@ -1,5 +1,5 @@
 <!-- file: docs/studies/013-UROBURAS_FUNCTIONAL_SPEC.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Uroburas — spécification fonctionnelle initiale
 
@@ -29,14 +29,18 @@ Les cartes, assets et contenus associés peuvent être téléchargés séparéme
 
 Le client ne doit pas supposer que toutes les maps ou tous les assets existent lors de l'installation.
 
-## Serpent
+## Anatomie minimale du serpent
 
-Le serpent possède au minimum :
+Un serpent valide possède au minimum quatre unités logiques :
 
-- tête ;
-- cou / première portion après la tête ;
-- corps ;
-- queue.
+1. une tête ;
+2. un cou ;
+3. une unité de corps ;
+4. une queue.
+
+Seul le **corps** est extensible.
+
+La longueur ne peut donc jamais devenir inférieure à quatre unités. Une attaque ou un effet de rétrécissement ne peut pas supprimer la tête, le cou, l'unité minimale de corps ou la queue en dehors d'une règle de mort explicite.
 
 Les interactions peuvent produire des effets différents selon la zone touchée.
 
@@ -99,3 +103,47 @@ Le produit vise aussi :
 - maps personnalisées ;
 - skins personnalisables ;
 - publication/modération éventuelles.
+
+## Représentation graphique du serpent
+
+La représentation doit pouvoir limiter le nombre d'assets nécessaires grâce aux rotations d'image.
+
+Direction fonctionnelle envisagée :
+
+- tête, cou, segments droits et queue peuvent réutiliser leurs sprites par rotation ;
+- les virages du corps nécessitent au minimum deux variantes distinctes correspondant à une courbure vers la gauche et vers la droite relativement au mouvement ;
+- ces variantes peuvent ensuite être réutilisées par rotation ;
+- les skins doivent respecter le même contrat géométrique afin d'être interchangeables.
+
+Le détail du format de skin sera défini séparément.
+
+## Priorité de la première version Uroburas
+
+La première version réelle de Uroburas se concentre sur le **Mode 1 — Challenge**.
+
+Elle doit prioritairement permettre :
+
+- moteur de grille/tilemap toroïdale ;
+- obstacles et murs ;
+- items ;
+- vies ;
+- temps ;
+- stages ;
+- caméra sur maps plus grandes que l'écran ;
+- contrôles clavier Desktop ;
+- contrôles tactiles par boutons directionnels affichés sur Mobile/Tablet ;
+- site Web initial ;
+- authentification ;
+- rewarded ads ;
+- Hall of Fame initial ;
+- échanges client/serveur authentifiés, versionnés et validables ;
+- maps/assets téléchargeables.
+
+Les systèmes de combat avancés feu/glace/poison/téléporteurs restent décrits comme direction fonctionnelle, mais ne sont pas requis pour cette première version.
+
+L'ordre de développement fonctionnel envisagé après stabilisation du Mode 1 est :
+
+1. Mode 3 — Persistent Battle Royale ;
+2. Mode 2 — PvP Battles.
+
+Cet ordre peut être réévalué ultérieurement, mais sert de priorité actuelle.

docs/studies/014-UROBURAS_MODES_AND_SESSION_RULES.md

@@ -1,5 +1,5 @@
 <!-- file: docs/studies/014-UROBURAS_MODES_AND_SESSION_RULES.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Uroburas — modes et règles de session
 
@@ -31,6 +31,16 @@ Lorsqu'un joueur meurt :
 
 À zéro vie, une rewarded ad peut éventuellement offrir une continuation si réseau et monétisation sont disponibles.
 
+Pendant la transition entre deux stages, une rewarded ad peut aussi proposer une récompense optionnelle, par exemple doubler les points gagnés pour le stage terminé. La règle exacte et le multiplicateur restent configurables.
+
+### Contrôles
+
+Sur Desktop, le jeu peut utiliser des touches directionnelles physiques, notamment WASD et/ou les flèches selon configuration.
+
+Sur Mobile/Tablet, la première approche privilégiée est un pavé directionnel affiché à l'écran, fonctionnellement équivalent à des touches directionnelles/WASD. Le joueur appuie sur les boutons plutôt que d'utiliser principalement des swipes.
+
+Ce choix vise à conserver une logique de contrôle proche entre Desktop et Mobile/Tablet.
+
 ### Stage
 
 Une map Challenge peut :
@@ -142,3 +152,13 @@ Les bots sont exécutés côté serveur, peuvent mourir, respawn après un déla
 ### Observation
 
 Un utilisateur peut rester spectateur sans tentative active.
+
+## Priorité de développement des modes
+
+L'implémentation réelle doit d'abord stabiliser les moteurs et besoins du Mode 1.
+
+Le Mode 3 vient ensuite afin d'ajouter progressivement le temps réel persistant, les bots serveur et les règles de monde longue durée sur une base de gameplay déjà stable.
+
+Le Mode 2 vient ensuite afin de construire les parties PvP bornées, privées ou matchmaking, en réutilisant les mécanismes multijoueurs déjà éprouvés.
+
+La présence de la spec des Modes 2 et 3 dans `0.2.0` n'implique pas leur implémentation dans la première version Uroburas.

docs/studies/015-UROBURAS_MAP_ASSET_AND_UGC_SPEC.md

@@ -1,19 +1,23 @@
 <!-- file: docs/studies/015-UROBURAS_MAP_ASSET_AND_UGC_SPEC.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Uroburas — maps, assets et UGC
 
-## Téléchargement
+## Contenu embarqué et téléchargement
 
-Le client doit pouvoir télécharger :
+Le package du jeu peut embarquer les maps solo initiales et les assets nécessaires à la première expérience.
 
-- maps ;
+Le client doit néanmoins pouvoir télécharger ou mettre à jour :
+
+- maps supplémentaires ;
+- skins ;
 - textures/sprites ;
 - sons ;
 - metadata ;
 - rulesets ;
-- skins ;
-- autres ressources propres à une map.
+- autres ressources propres à une map ou à une saison/version.
+
+Le téléchargement de contenu est donc une fonction normale du produit, pas uniquement une extension UGC.
 
 ## Package de map
 

docs/studies/016-UROBURAS_COMBAT_ITEM_EFFECT_SPEC.md

@@ -1,5 +1,5 @@
 <!-- file: docs/studies/016-UROBURAS_COMBAT_ITEM_EFFECT_SPEC.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Uroburas — combat, items et effets
 
@@ -7,6 +7,8 @@
 
 Une attaque peut produire un résultat différent selon tête, cou, corps ou queue. Une attaque peut parfois devenir indirectement bénéfique en raccourcissant le serpent.
 
+Le serpent ne peut toutefois jamais être raccourci sous son anatomie minimale : tête + cou + une unité de corps + queue. Les effets qui devraient supprimer davantage de segments sont bornés à cette longueur minimale, sauf si l'impact constitue une mort explicite.
+
 ## Inventaire
 
 Un serpent peut obtenir un ou plusieurs items et décider de les utiliser ou non. Capacité, stacking, puissance, durée, cooldown et combinaison sont configurables par ruleset.
@@ -70,3 +72,11 @@ Les téléporteurs peuvent fonctionner par paire ou groupe, utiliser un identifi
 ## Paramétrage
 
 Les effets peuvent définir level, power, range, duration, spread, cooldown, zone, charges et interactions avec protections.
+
+## Portée de la première version
+
+Feu, glace, poison, téléporteurs et protections avancées restent dans la spécification afin de préserver la direction du game design.
+
+Ils ne sont pas requis pour la première version réelle, centrée sur le Mode 1 et ses moteurs fondamentaux.
+
+Leur modélisation détaillée pourra être revue avant l'implémentation des modes multijoueurs.

docs/studies/017-UROBURAS_SCORE_RESPAWN_AND_HALL_OF_FAME.md

@@ -1,5 +1,5 @@
 <!-- file: docs/studies/017-UROBURAS_SCORE_RESPAWN_AND_HALL_OF_FAME.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Uroburas — score, respawn et Hall of Fame