Une course, c’est cinq secondes répétées des milliers de fois

Le moteur ne vient pas d’une liste de fonctionnalités mais de sept piliers, posés avant le code et vérifiés par des tests. Chacun a une conséquence technique précise, et c’est pourquoi le reste de ce billet se lit comme leur mise en œuvre.

Le moteur avance par pas de 5 secondes simulées (TICK_S). L’inertie est négligée à cette granularité : le modèle est quasi statique, et la vitesse d’un groupe se calcule à partir de la puissance de chacun, sans intégrer d’accélération.

Le moteur mécanique se contente d’appliquer des allures. Ceux qui les choisissent, l’IA et la radio, sont séparés de lui par une interface (PacingDecisions). Sans politique, tout le monde roule à une allure « tempo » par défaut, ce qui permet de tester la mécanique sans les décisions.

Deux détails comptent plus qu’il n’y paraît. D’abord, les décisions de toutes les équipes sont lues sur l’état au début du tick : personne ne réagit à ce qu’un autre vient de décider dans le même pas, donc l’ordre de traitement des équipes ne compte pas. Ensuite, l’arrivée est interpolée à l’intérieur du tick : l’instant de passage n’est pas arrondi au pas de 5 secondes, ce qui laisse un sprint se jouer sur des fractions de seconde.

Pour un coureur qui pousse une puissance donnée, la vitesse est celle où la puissance fournie égale les forces qui s’opposent : la pesanteur, le roulement et l’air.

Le moteur doit trouver v sachant P : la fonction speedForPower inverse la relation par bissection, à chaque tick et pour chaque coureur. C’est pourquoi le sinus et le cosinus de l’angle de la pente ne passent pas par la trigonométrie : pour une pente g/100, sin(atan g) = g/√(1 + g²) et cos(atan g) = 1/√(1 + g²), identiques mathématiquement et bien plus rapides.

Le revêtement entre par le coefficient de roulement : 0,004 sur l’asphalte, 0,0075 à 0,0315 sur les pavés selon les étoiles du secteur et l’attribut cobbles du coureur. En descente, la vitesse est plafonnée par la technicité de la route et l’aisance du coureur. Quant à l’abri, c’est le facteur qui fait toute la tactique du vélo : 1 seul, moins de 1 dans un groupe (section 04).

Chaque coureur porte quinze attributs entiers, de flat à composure. La conversion en paramètres physiques appartient au moteur, pas au contenu : le contenu décrit un coureur, la mécanique en tire ce qu’il peut tenir. L’attribut du terrain fixe sa puissance critique (CP) ; ses réserves se vident et se reconstituent tick après tick.

La forme du jour est discrète mais indispensable : sans elle, les résultats suivaient presque exactement la hiérarchie des attributs, et la course n’avait plus de raison d’être courue. Son écart type de 3,5 % dépasse un peu la variabilité mesurée d’un jour à l’autre : il absorbe aussi ce que le modèle ne représente pas (placement, motivation, petits ennuis).

Un peloton n’est pas une liste de coureurs, c’est un objet physique. Deux coureurs consécutifs à 20 m ou moins forment un groupe ; le peloton est le plus grand de tous. Les écarts ne sont pas posés à la main : l’écart en temps entre deux groupes est la distance qui les sépare divisée par la vitesse du groupe de derrière. Ils naissent de la physique.

L’abri multiplie la traînée : à 1 on subit tout l’air, à 0,5 on n’en subit que la moitié. Il dépend de la place dans le groupe.

Ensuite, les règles s’enchaînent. Les relayeurs désignés visent une intensité, fraction de leur CP effective, qui est une puissance moyenne sur la rotation : un groupe qui s’entend va donc plus vite qu’un coureur seul à la même intensité. Chaque membre calcule la puissance qu’il lui faut pour tenir cette vitesse avec son abri ; tant qu’elle est dans ses moyens il suit et puise dans W′ au-dessus de CP. Quand W′ est vide, il décroche, roule à sa CP et l’écart se creuse tout seul. Pour éviter les va-et-vient, un lâché ne peut plus forcer pour revenir tant que W′ n’est pas remonté à 25 %.

Un groupe où personne ne veut rouler ne profite pas d’une rotation que personne n’a décidée : sa vitesse est la moyenne de celles que chaque membre tiendrait seul en tête à 60 % de sa CP effective, ce qui donne un peloton à 36 ou 38 km/h sur le plat. Une attaque est un coup planifié à part du reste du groupe : les attaquants visent leur intensité, bornée par la puissance dont ils disposent sur le tick, et le reste du groupe est recalculé sans eux. Un sprint, enfin, est un effort à puissance maximale qui s’éteint quand W′ est vide.

Cette règle est la raison pour laquelle la montée ne se règle pas comme le plat : à partir de 2 % de pente, l’allure d’un groupe glisse de la moyenne de ses relayeurs vers la plus haute de leurs vitesses, qu’elle atteint à 5 %. Là, l’abri ne vaut presque plus rien et c’est le plus fort qui impose son rythme.

Il n’y a pas une intelligence pour les adversaires et une autre pour vous. Il y a decideTeam : une fonction qui reçoit la vue de l’équipe, les connaissances publiques, son plan et sa mémoire, et rend les décisions de chaque coureur. L’équipe du joueur passe par elle, avec le plan que le joueur a écrit. Les équipes adverses aussi, avec le plan que leur staff a dérivé de la réputation publique des coureurs.

Cette symétrie est testée. Des effectifs identiques sous des identifiants d’équipe différents reçoivent les mêmes rôles, et les décisions d’une équipe ne changent pas quand on modifie les réserves d’un adversaire.

Le plan par défaut du staff est celui de chaque équipe adverse et le brouillon proposé au joueur. Il ne lit que la réputation publique et la lecture du parcours : doctrine offensive pour une équipe qui ne prétend pas à la victoire, sinon sprint sur une course plate et finale ailleurs ; zones d’attaque posées sur les montées de la finale, et sur les secteurs pavés les plus durs d’une classique.

Cette lecture du parcours est elle aussi du code. Le moteur classe une course en flat, hilly, mountain, cobbles ou gravel ; il repère les montées, leurs difficultés et, depuis peu, les murs (200 m à 6 % ou plus) ; et il détermine la finale, qui démarre 30 km avant l’arrivée (plus tôt sur les classiques pavées et le gravier), avancée au pied de la montée ou du secteur qu’elle chevauche.

Chaque tick, l’IA évalue pour chaque équipe et chaque groupe qui doit rouler et à quelle intensité. Cinq règles se partagent la tâche : l’échappée et les groupes de tête, la poursuite contrôlée, la défense en finale, le tempo en côte et le train du sprint. La plus parlante est la poursuite, où l’équipe d’un leader piégé derrière vise un écart cible qui rétrécit à mesure que l’arrivée approche : G*(D) = min(240 s, max(0, (D − Dcatch) · 4 s/km)). Les 4 secondes par kilomètre sont ce qu’une poursuite organisée peut réellement reprendre avec les abris de la section 04. L’écart réel à cette cible choisit alors le niveau d’effort :

Au-dessus de ces règles collectives, chaque coureur a sa propre liste de priorités, évaluée dans cet ordre :

Une attaque n’est jamais déclenchée par un script : c’est un taux par minute converti en probabilité par tick, p = 1 − e^(−λ·Δt/60), tiré dans le flux aléatoire propre au coureur, et seulement quand ses conditions sont remplies. Un coureur d’agressivité 0,8, leader dans une zone d’attaque de son plan avec assez de W′ et un timing de 1, a un taux de 0,5 · (0,5 + 0,8) = 0,65 par minute, soit environ 5 % de chances par tick de lancer l’attaque. Elle démarrera à 130 % de sa puissance critique, bornée par ce qu’il peut produire.

Le moteur sait tout. Les équipes, non. Entre l’état exact et la politique qui décide, il y a une couche de perception, identique pour tous. Chaque équipe connaît la course par deux sources.

Un groupe connu seulement par le pointage est donc estimé : on projette sa position avec le temps écoulé. Un coureur que le pointage plaçait dans un groupe aujourd’hui vu, qui n’y est plus et qu’on ne voit nulle part, a un groupe inconnu jusqu’au pointage suivant. Les arrivées et les abandons, eux, sont publics.

Et vous, directeur ? Vous recevez une projection encore plus pauvre : des groupes avec leur source et leur âge, et pour vos coureurs, des sensations en mots rapportées toutes les trois minutes, décalées d’un coureur à l’autre. Jamais une réserve, une puissance ou une vitesse, et un test vérifie que ces champs n’existent pas dans la projection.

Vos seules actions en course sont des consignes radio. Une consigne comprend des destinataires, une intention (aider la poursuite, se préserver, protéger le leader, attaquer dans une zone, surveiller un adversaire, changer de leader ou de doctrine, reprendre le plan) et une condition de fin (jusqu’à nouvel ordre, jusqu’à un point, jusqu’à un écart). Seules les erreurs structurelles la refusent : une tactique discutable est acceptée, puis éventuellement rapportée comme impossible.

À la réception, trois choses peuvent se passer. Si une consigne plus récente du même emplacement est déjà arrivée, celle-ci arrive trop tard et est écartée. Si c’est un sacrifice (poursuivre, protéger, se préserver) adressé à un leader, à une alternative ou à un coureur libre, le coureur peut la refuser, selon son caractère. Sinon, elle remplace la précédente sur le même emplacement seulement : surveiller un adversaire tout en se préservant reste possible, parce que ce sont deux emplacements distincts.

La probabilité de refus vaut clamp((ambition − (loyauté + esprit d’équipe)/2) / 100, 0, 0,5). Avec une personnalité moyenne (50, 50, 50), elle vaut 0. Pour un coureur d’ambition 80, de loyauté 30 et d’esprit d’équipe 40, le calcul donne (80 − 35) / 100 = 0,45. Un équipier, lui, ne refuse jamais.

Enfin, répéter un ordre ne donne aucun bonus. Un destinataire qui a déjà la même consigne en transit ou en vigueur est retiré de l’envoi ; si plus personne ne reste, la consigne est refusée comme doublon. Répéter ne relance aucun délai.

La météo du jour est une donnée de la course, pas un tirage du moteur : vent (vitesse et direction), pluie ou non, constante toute la course et publique. Le vent de face entre dans le terme aérodynamique de la section 02. Le vent de côté ne change pas la physique : il fabrique des bordures.

Quand le vent de côté dépasse 3 m/s, une bordure se forme. Sa force vaut s = clamp((vent de côté − 3) / (7 − 3), 0, 1). Dans un groupe de plus de 12 coureurs, c’est la largeur de la route : les 12 premiers gardent leur abri, les suivants roulent « dans le caniveau », presque à découvert, dépensent davantage et finissent par décrocher. Le groupe se casse. L’ordre dans la bordure revient d’abord aux relayeurs, puis au score placement + bonus d’équipe + un peu de chance. L’IA le sait : une équipe prétendante fait relayer deux coureurs à 0,9 pour glisser son leader dans la bonne bordure.

Les résultats disent quelque chose de sportif. Par temps calme, les incidents ne changent ni la vitesse ni la hiérarchie : un coureur arrêté rentre le plus souvent derrière les voitures. La pluie multiplie les chutes et fait gagner des vainqueurs surprises. Le vent de côté casse le peloton en bordures et favorise les rouleurs. Et par vent fort, les meilleurs sprinteurs arrivent à court de glycogène et perdent le sprint contre des coureurs plus frais : vingt vainqueurs sur trente hors du top 40 par vent du nord, malgré trente arrivées groupées.

À chaque tick, chaque coureur qui roule fait un tirage : il a un incident avec la probabilité 1 − exp(−λ · d), d étant la distance parcourue au tick précédent en kilomètres, et un second tirage choisit la nature. Tous ces tirages se font dans un flux aléatoire à part (engine.incidents).

Le moteur de base a grandi par couches, et chacune a ajouté une règle sans en casser une autre. Ce billet ne les détaille pas, mais voici ce qu’elles apportent.

Le déterminisme est le pilier qui coûte le plus cher et rapporte le plus. Sans lui, impossible de reproduire un bug, de comparer deux versions, de sauvegarder une course en cours ou de calibrer quoi que ce soit. Il repose sur quatre choses.

Cette phrase est la raison d’être du troisième point. Les laboratoires de test tournaient sous Node, l’application sous Electron, et leurs fonctions mathématiques ne rendaient pas exactement le même bit. Un écart d’un ulp sur une forme, et la course de la saison suivante changeait. Le correctif est un port de fdlibm 5.3, vérifié sur 30 millions de valeurs identiques bit à bit à la bibliothèque C d’origine, et un test qui fait tourner une même carrière sous Node et sous Electron puis compare l’empreinte de l’état complet.

Le journal protège aussi le pilier 6. Le contrôleur qui lit la course prend ses décisions d’arrêt tick par tick : découper la lecture autrement ne change ni la course, ni le fil, ni les arrêts, et un test le vérifie. La présentation ne peut donc pas modifier la simulation. En contrepartie, une sauvegarde porte la version de chaque modèle (physique, moteur, IA, perception, radio, tirage aléatoire) : si l’un d’eux a changé, elle est refusée, avec un message qui nomme le modèle et ses deux versions, plutôt que rejouée de travers.

Un moteur déterministe garantit qu’une course se rejoue, pas qu’elle ressemble à du vélo. Pour ça, il y a directeur lab : il déroule des centaines de courses sans consigne, avec les plans du staff, dans la vraie session (perception, radio, incidents, forme du jour), et mesure ce qui en sort. Il lit l’état exact du moteur : c’est un outil de diagnostic, jamais une lecture pour le joueur.

Sept cibles disent à quoi doit ressembler un peloton. Une cible n’est pas jugée sous 20 courses du terrain, chaque mesure porte son intervalle de confiance à 95 %, et un écart n’est significatif que si tout l’intervalle est hors de la cible. Le plafond de 35 % pour le vainqueur le plus fréquent était d’abord fixé à 25 % sans mesure, puis a été révisé en cours de route.

Les cibles ont dicté dix réglages du premier passage. Quatre racontent bien le travail :

Le banc tourne aussi en suite de tests : 100 graines par course, météo tirée, échec sur tout écart significatif, environ 45 secondes sur neuf fils au moment de T10. Et comme il est déterministe, ses résultats ne dépendent ni du nombre de fils ni de l’horloge : un test le vérifie.

Les nombres sportifs du moteur sont des hypothèses de calibration, pas des vérités validées, et nous préférons le dire d’emblée. Voici ce que nous savons ne pas encore bien faire.

• Le vallonné restait trop groupé à la mesure de T10. Le peloton arrivait presque entier au pied du mur final : 98 % des courses finissaient avec au moins 20 coureurs à 5 s ou moins, et les échappées n’y gagnaient presque jamais (1 %). Des tickets de calibration ont repris la question depuis, mais c’est le type de course où l’on reste vigilant.
• Le vent fort sur le plat est à surveiller. À 7 m/s ou plus (21 courses sur 200 à la mesure de T10), 43 % des vainqueurs étaient des favoris et 38 % venaient de hors du top 40 : plus de surprises que sur le reste du plat. C’est un point de calibration ouvert.
• La physique est quasi statique. L’inertie est négligée à l’échelle de 5 secondes, et la densité de l’air est constante à 1,225 kg/m³ partout, y compris en altitude. Quand l’altitude a été ajoutée (T66), la baisse de puissance critique était modélisée mais pas l’acclimatation.
• Hors carrière, la connaissance des rôles reste exacte et commune. En course libre et au banc, chaque équipe lit les mêmes aptitudes exactes ; c’est en carrière seulement que chacune lit ses coureurs dans son dossier et les autres dans la réputation publique.