🏘️ Le village de Maxance

🏘️ Étape 1 : un nouveau jeu, le village (la carte et la caméra) ✅ livrée · à valider

Un troisième jeu : un jeu de gestion façon The Settlers, sans combat. On fait grandir son village, on gère les ressources et les habitants, on passe d'un âge à l'autre. Première étape : la carte inventée au hasard, vue de biais, et la caméra. ▶ le village

🔷 Comment on dessine « de biais »

Dans la mémoire, la carte est une grille toute simple de 64 × 64 cases, comme une bataille navale : chaque case a une colonne et une ligne. Pour la voir de biais, on fait 2 choses : on tourne la grille d'un huitième de tour (45°), puis on l'écrase 2 fois en hauteur. Chaque carré devient un losange de 64 px de large et 32 px de haut.

Le calcul est dans village/moteur/iso.js. Pour la case (colonne, ligne) :

x à l'écran = (colonne − ligne) × 32
y à l'écran = (colonne + ligne) × 16

Avancer d'une colonne : on va vers la droite et vers le bas. Avancer d'une ligne : vers la gauche et vers le bas.

🖱️ Sur quelle case est la souris ?

C'est le même calcul, à l'envers. D'abord, on enlève la caméra et le zoom pour savoir où est la souris dans le monde (X, Y). Puis :

colonne = (X ÷ 32 + Y ÷ 16) ÷ 2
ligne   = (Y ÷ 16 − X ÷ 32) ÷ 2

On obtient des nombres à virgule, par exemple 31,11 : on garde la partie avant la virgule, 31. Appuie sur X : le calcul s'affiche en direct en haut à droite !

🎲 Une carte inventée avec une graine

Un ordinateur ne sait pas vraiment tirer au hasard : il fait un calcul qui donne des nombres qui ont l'air mélangés. On part d'un numéro, la graine. Même graine = mêmes nombres = même carte. C'est pour ça que la base de données garde un seul nombre, la graine, et pas les 4 096 cases !

Pour que la carte ressemble à un vrai paysage, on utilise un bruit : un hasard tout doux, où deux cases voisines ont presque la même valeur. Chaque case reçoit une altitude et une humidité :

• les 30 % de cases les plus basses deviennent de l'eau, puis un peu de sable ;
• les 5 % les plus hautes deviennent des montagnes, avec des filons de charbon, de fer ou d'or ;
• juste en dessous, des rochers (pour la future carrière de pierre) ;
• au milieu : forêt si c'est humide, prairie fleurie si c'est sec, sinon de l'herbe.

Ensuite, 2 rivières partent des montagnes. À chaque pas, elles vont vers la case voisine la plus basse, comme une vraie goutte d'eau qui descend la pente.

🎨 Le peintre dessine du fond vers l'avant

Le peintre (village/affichage/peintre.js) dessine d'abord tout le sol, puis les objets (arbres, montagnes, tente) du fond vers l'avant. Ce qui est peint en dernier passe par-dessus. En vue de biais, une case est « plus devant » quand colonne + ligne est plus grand. Si on peignait dans le désordre, un arbre du fond passerait devant une montagne !

🔎 Missions d'exploration

• Mets la souris sur une case et regarde « dans la grille » sous le capot. Bouge d'une case vers la droite : qu'est-ce qui change, la colonne ou la ligne ?
• Aux rayons X, trouve les 2 flèches « colonne → » et « ligne → », et la case (0, 0).
• Aux rayons X, suis une rivière en bleu clair depuis sa « source ». Où finit-elle ?
• Dézoome au maximum : combien de « cases peintes » ? Et en zoomant à fond ? Pourquoi c'est mieux de ne pas tout peindre ?
• Note la graine de ta carte, appuie sur G, puis efface la base de données et recharge : est-ce la même carte ?
• Dans village/config.js, trouve montagne: 0.95. Que se passerait-il avec 0.8 ?

❓ Quiz

🪓 Étape 2 : la première chaîne, et le jeu sur téléphone ✅ livrée · à valider

Les premiers bâtiments ! Le bûcheron coupe, la scierie transforme, le forestier replante, le carrier taille la pierre. Et le jeu se joue maintenant au doigt, sur un téléphone. ▶ le village

⛓️ Une chaîne de production

🌳 arbre ──🪓 bûcheron──► 🪵 tronc ──🪚 scierie──► 🟫🟫 2 planches ──► 🏗️ nouveaux bâtiments
🌱 forestier ──► pousse ──60 s──► 🌳 arbre (sinon, la forêt disparaît !)
🪨 rocher ──⛏️ carrier──► 🪨 pierre  (4 par rocher)

Si un maillon manque, tout s'arrête : sans bûcheron, la scierie attend des troncs. Sans forestier, le bûcheron finit par n'avoir plus rien à couper. C'est tout le jeu : trouver le maillon qui bloque.

🤖 La machine à états de l'ouvrier

Un ouvrier ne « réfléchit » pas : il suit une fiche. À chaque instant, il est dans un seul état, et une règle dit quand passer au suivant.

Aux rayons X (X), le nom de l'état est écrit au-dessus de chaque ouvrier, avec son minuteur. Dans « sous le capot », la liste des bâtiments montre l'état de chacun.

🖋️ La tache d'encre : trouver l'arbre le plus proche

Le bûcheron fait une recherche en largeur (village/moteur/chemins.js) : il regarde toutes les cases à 1 pas, puis à 2 pas, puis à 3 pas… comme une goutte d'encre qui s'étale sur du papier. Il ne traverse ni l'eau ni les montagnes. La première case qui a un arbre est forcément la plus proche ! Chaque case retient d'où l'encre est venue : en remontant, on obtient le chemin.

Il s'arrête à 6 pas (son rayon). Le journal dit combien de cases la tache a regardées. Une case visée est réservée (croix rouge aux rayons X) : deux bûcherons ne vont pas couper le même arbre.

💾 Sauvegarder une carte qui change

Avant, on gardait seulement la graine. Mais maintenant, des arbres disparaissent et des pousses apparaissent ! On garde donc la graine + la liste des changements : « case 2 281 : plus rien », « case 2 345 : une pousse »… Au rechargement, on refait la carte d'origine avec la graine, puis on rejoue les changements un par un. La base de données passe en version 2, avec une sauvegarde automatique toutes les 15 s.

📱 Un jeu pour téléphone

• Les doigts : un doigt glisse, deux doigts pincent pour zoomer. Si les doigts s'écartent 2 fois plus, on zoome 2 fois plus.
• Les boutons dans l'écran : au moins 56 points, la taille d'un doigt. L'interface retient où elle a dessiné chaque bouton (les « zones ») : un toucher sur une zone va au bouton, sinon il va à la carte.
• Points et pixels : un téléphone a 2 ou 3 vrais pixels par point. On dessine avec tous, sinon l'image est floue.
• Les stores : plus tard, on « emballera » la page dans une application (avec un outil comme Capacitor). Comme le jeu est fait de simples fichiers web, c'est possible sans tout réécrire.

🔎 Missions d'exploration

• Pose un bûcheron loin des arbres. Que dit le jeu ? Que dit le journal ?
• Construis une scierie sans bûcheron : regarde son panneau (touche-la).
• Aux rayons X, regarde la zone de travail (le carré jaune) d'un bâtiment touché. Pourquoi est-ce un carré et pas un rond ?
• Combien de cases la tache d'encre regarde-t-elle quand l'arbre est à 2 pas ? Et à 6 pas ?
• Dans « Base de données », trouve modifs : coupe un arbre et regarde une ligne apparaître.
• Dans village/config.js, trouve planchesParTronc et croissance.
• Ouvre le jeu sur un téléphone, et essaie le plein écran ⛶.

❓ Quiz

🚚 Étape 3 : les routes et les porteurs ✅ livrée · à valider

Fini, les troncs qui arrivent tout seuls dans l'entrepôt ! Maintenant, il faut des routes, et des porteurs qui marchent dessus avec les objets. Un bâtiment sans route est bloqué. ▶ le village

📋 La file d'attente : premier arrivé, premier servi

Le chef des livraisons (village/logique/porteurs.js) regarde tous les bâtiments, 4 fois par seconde. Pour chaque chose à transporter, il écrit un papier et le met au bout de la file. Un porteur libre prend toujours le papier du début de la file, comme à la boulangerie.

file d'attente :  [ apporter 🟫 à la cabane ] [ ramener 🪵 du bûcheron ] [ apporter 🪵 à la scierie ] ← les nouveaux papiers arrivent ici
                    ↑ le porteur libre prend celui-ci

Sous le capot, tu vois la file en direct : les 5 premiers papiers, et ce que fait chaque porteur. Avec 3 porteurs et beaucoup de bâtiments, la file s'allonge : il faudra peut-être plus de porteurs !

🔒 Réservé : promis, mais pas encore parti

Quand tu poses un chantier, ses planches restent dans l'entrepôt jusqu'à ce qu'un porteur les prenne. Mais elles lui sont promises : tu ne peux plus les utiliser pour autre chose.

libres = dans l'entrepôt − promis

Touche l'entrepôt : il affiche son stock ET ce qui est libre. Les boutons de construction regardent ce qui est libre.

🕸️ Le réseau : qui est relié ?

Encore une tache d'encre ! Elle part de l'entrepôt et suit toutes les routes qui se touchent. Un bâtiment est relié si une route de cette tache touche un de ses 4 côtés. Aux rayons X (X), chaque route a un point : vert si elle est reliée, rouge sinon. Le chemin de chaque porteur est en violet.

Pour tracer une route, le jeu cherche aussi le plus court chemin avec la tache d'encre, en évitant l'eau, les montagnes, les arbres, les rochers et les bâtiments.

💾 Ce qui n'est pas sauvegardé

La base de données (version 3) garde les routes, ce qui attend devant chaque bâtiment, et les matériaux arrivés sur chaque chantier. Mais pas les porteurs ni la file : au rechargement, le chef réécrit tous ses papiers. Ce qu'un porteur avait dans les bras est remis à sa place. C'est un vrai choix de développeur : on sauvegarde ce qui est important, et on recalcule le reste.

🔎 Missions d'exploration

• Pose 3 chantiers d'un coup, et regarde la file d'attente sous le capot. Qui est servi en premier ?
• Construis une route en zigzag et une route toute droite vers le même bâtiment. Laquelle prend le porteur ?
• Démolis la route juste à côté de l'entrepôt. Combien de bâtiments deviennent bloqués ?
• Une cabane de bûcheron très loin de l'entrepôt : les troncs s'empilent-ils devant la porte ? Que fait le bûcheron quand il y en a 4 ?
• Dans village/config.js, trouve porteurs : nombre et vitesse.
• Dans la base de données, trouve routes : ce sont des numéros de cases. Retrouve la colonne et la ligne d'un numéro (ligne × 64 + colonne).

❓ Quiz

🎣 Étape 4 : pêcheur, chasseur, repas et saisons ✅ livrée · à valider

Les habitants ont faim ! Un pêcheur et un chasseur rapportent la nourriture, et les saisons passent : fleurs au printemps, feuilles orange en automne, neige et lacs gelés en hiver. ▶ le village

⚖️ L'équilibre : produire plus que ce qu'on mange

Chaque habitant (les ouvriers ET les porteurs) mange 1 repas toutes les 2 minutes. Avec 9 habitants, ça fait :

9 habitants × 1 repas ÷ 2 minutes = 4,5 repas par minute

Un pêcheur rapporte environ 4 poissons par minute. Il faut donc au moins un pêcheur ET un chasseur pour tenir ! Sous le capot, la ligne « repas mangés par minute » fait le calcul pour toi. C'est la vraie règle de tous les jeux de gestion : ce qui entre doit être plus grand que ce qui sort.

🗓️ Les saisons avec le reste d'une division

Le jeu a une horloge : le nombre de secondes depuis le début de la partie. Pour savoir où on en est dans l'année, on prend le reste de la division par 600 (le « modulo », qu'on écrit %) :

horloge = 1 000 s
1 000 % 600 = 400     (1 000 = 1 × 600 + 400 : on est dans la 2e année, à la seconde 400)
400 ÷ 150 = 2,67 → saison n° 2 = 🍂 l'automne   (0 printemps, 1 été, 2 automne, 3 hiver)

Les flocons de neige utilisent le même tour de magie : quand un flocon sort en bas de l'écran, le reste de la division le fait revenir en haut.

🎨 Une palette par saison

Le peintre calcule 4 couleurs pour chaque case (une par saison), une seule fois, et les garde. En hiver, il mélange la couleur de l'herbe avec du blanc (82 % de blanc), et l'eau peu profonde devient de la glace. La mer profonde, elle, ne gèle pas !

🦌 Le gibier

Les cerfs et les lapins sont de petites machines à états : brouter (s'arrêter quelques secondes) → se promener (aller vers une case au hasard, pas trop loin) → brouter… Quand un chasseur en choisit un, il est visé et ne bouge plus. Toutes les 20 s, un petit naît à côté d'un parent, sauf en hiver.

🔎 Missions d'exploration

• Touche une cabane : regarde « prochain repas dans… » et les repas gardés dans la cabane.
• Combien de poissons rapporte ton pêcheur en une saison ? (Regarde « a rapporté » au début et à la fin.)
• Aux rayons X : les cercles autour des animaux (rouge = visé), et la faim de chaque ouvrier.
• Construis beaucoup de bâtiments sans nourriture… et regarde le journal. Qui part en premier ?
• Dans config.js, trouve dureeAnnee et intervalle. Que se passerait-il avec intervalle: 60 ?
• Sous le capot, regarde « moment dans l'année = horloge % 600 » quand la saison change.

❓ Quiz

🎯 Étape 5 : moins de faim, et de plus jolies animations ✅ livrée · à valider

Maxance a testé sur son téléphone et a tout noté : trop de faim, un pêcheur qui ne pêche pas, des rochers qui s'épuisent, des animations pas assez jolies, un menu trop chargé. Voici les réglages ! ▶ le village

⚖️ Régler l'équilibre d'un jeu

Avant, chaque habitant mangeait toutes les 2 minutes, et chaque repas demandait 2 voyages de porteur : ramener le poisson à l'entrepôt, puis l'apporter à la cabane. Les 3 porteurs étaient débordés ! Maintenant :

avant : 9 habitants × 1 repas ÷ 2 min   = 4,5 repas par minute, et 9 voyages de porteur par minute
après : 9 habitants × 1 repas ÷ 2,5 min = 3,6 repas par minute, et 0 voyage (on mange à l'entrepôt)

C'est le travail du game designer : jouer, sentir que c'est trop dur, chercher pourquoi (ici, les porteurs), puis changer quelques nombres dans config.js. Les vrais jeux passent des mois à ça !

🐢 Ralentir au lieu de bloquer

Chaque habitant a une vitesse : 1 quand il a mangé, 0,5 quand il a faim. Sa marche et son travail sont multipliés par ce nombre :

chemin parcouru = vitesse de marche × vitesse de l'habitant × temps
couper un arbre : 4 s quand on a mangé, 4 ÷ 0,5 = 8 s le ventre vide

🎲 Des prises qui valent plus ou moins

Quand le pêcheur pêche, le jeu tire au hasard quel poisson, selon l'eau. Au bord : 60 % de sardines, 40 % de truites. En eau profonde : 30 % de sardines, 40 % de truites, 30 % de thons. Le poisson attend devant la cabane avec sa valeur (un « lot » : un thon = 4 🐟), et le porteur ajoute cette valeur au stock.

✨ Une animation qui dure après l'événement

Quand l'arbre est coupé, il disparaît tout de suite de la mémoire du jeu. Mais le nouveau fichier affichage/effets.js écoute la radio : « un arbre est coupé ! ». Il garde alors un effet pendant 2,6 s pour le dessiner en train de tomber. Le monde ne sait rien de cette chute : c'est seulement pour nos yeux. Même chose pour le poisson qui saute, l'animal qui tombe et les étincelles du géologue.

La flèche du chasseur, elle, est calculée à partir de son minuteur : pendant les 3 premières secondes, il tend l'arc ; quand il reste 1 s, la flèche part ; quand il reste 0,7 s, elle touche l'animal.

🔎 Missions d'exploration

• Pose un pêcheur au bord de la mer (eau profonde) : pêche-t-il des thons ? Regarde le journal.
• Survole un cerf, puis un lapin : combien de 🍖 donne chacun ?
• Mets-toi en pause (P) pendant que le chasseur tend l'arc, puis avance image par image (N).
• Avec le géologue : combien de recherches pour trouver un gisement ? (Journal : « Rien trouvé » ou « Gisement trouvé »).
• Dans config.js, trouve prises et lentSiFaim.

❓ Quiz

⏳ Étape 6 : les âges, les chemins de terre et plus d'animaux ✅ livrée · à valider

Plus d'« âge de pierre » : ton village grandit par âges, du campement jusqu'à la ville. Les chemins de terre sont gratuits, les saisons prennent leur temps, et la forêt se remplit d'animaux. ▶ le village

⏳ Les âges : une échelle avec des barreaux

🏕️ campement ──► 🛖 hameau ──► 🏡 village ──► 🏰 bourg ──► 🏙️ ville
   (départ)       géologue       bientôt…

Chaque âge débloque des bâtiments. Pour monter d'un barreau, il faut remplir tous les objectifs. Pour le hameau : 6 bâtiments construits, 40 🟫, 20 🪨 et 30 🐟+🍖 dans l'entrepôt. Une fois par seconde, le jeu coche ce qui est fait (logique/ages.js). Quand tout est coché : nouvel âge ! Les objectifs sont rangés comme des données dans config.js (ages) : pour en changer, pas besoin de toucher au code.

🛤️ La vitesse dépend du sol

à travers champs   × 0,85
chemin de terre    × 1      (gratuit, au campement)
route en pierre    × 1,6    (plus tard)

À chaque pas, l'habitant regarde sur quelle case il marche, et multiplie sa vitesse par le nombre du sol. Dans la mémoire, une case de chemin vaut 1 et une case de route en pierre vaudra 2.

🏞️ L'habitat des animaux

Chaque espèce a son coin : le cerf et le sanglier dans la forêt, le lapin dans l'herbe, le canard au bord de l'eau (à 2 cases maximum), le bouquetin dans les rochers. Quand un animal choisit où aller, le jeu vérifie que la case est dans son habitat. Et un petit naît toujours à côté d'un parent de la même espèce.

🐟 Un poisson qui regarde où il va

Pendant le saut, le poisson suit une courbe en cloche. Pour qu'il ait l'air de nager dans l'air, on le tourne selon la pente de la courbe : vers le haut au début, vers le bas à la fin. Et s'il saute vers la gauche, on le retourne comme une crêpe, sinon il aurait le ventre en l'air !

🔎 Missions d'exploration

• Où trouves-tu des bouquetins ? Et des canards ?
• Sous le capot, regarde « L'âge du village » et ses objectifs cochés un par un.
• Mesure le temps d'un porteur sur un long chemin. Tu pourras comparer avec la route en pierre plus tard !
• Dans config.js, trouve ages, sols et especes.

❓ Quiz

🎓 Étape 7 : le hameau, l'université, les missions et les gemmes ✅ livrée · à valider

Le jeu a maintenant un grand plan sur 5 âges. Le hameau est complet : une université pour faire des recherches, une mine de charbon, des missions avec des personnages, et des gemmes 💎 à gagner. Et ta partie est mieux protégée. ▶ le village

🗺️ Le grand plan sur 5 âges

Tout ce plan est écrit comme des données dans village/config.js : ages, recherches, missions, boutique. Ajouter une recherche ou une mission, c'est ajouter une ligne : pas besoin de toucher au code du jeu !

✖️ Une recherche, c'est un multiplicateur

temps pour couper un arbre = 4 s × bonus « couper »
sans recherche :            4 s × 1   = 4 s
avec les haches affûtées :  4 s × 0,6 = 2,4 s   (40 % plus vite)

Si deux recherches touchent la même chose, on multiplie les deux bonus. Sous le capot, la ligne « bonus » montre chaque multiplicateur.

📜 Une mission, c'est une machine à états

(attente 1 min) ──► proposée ──[J'accepte]──► en cours ──[Livrer à temps]──► réussie 🎉 (récompense + 💎)
                       └──[Plus tard]            └──[temps écoulé]──► ratée (rien de grave)

💎 Des gemmes gagnées en jouant

Dans les vrais jeux de téléphone, les gemmes s'achètent souvent avec de l'argent. Ici, non : on les gagne seulement en jouant (missions, nouveaux âges). C'est un choix important. Si un jour le jeu va sur les stores, il faudra réfléchir avec Cyril à ce qui est juste pour les joueurs.

💾 Ta partie est gardée

La sauvegarde marchait déjà d'une version à l'autre : chaque nouvelle version convertit l'ancienne. Pour plus de sûreté :

• la sauvegarde est faite toutes les 15 secondes, et quand le téléphone ferme la page ;
• « Nouvelle carte » et « Effacer » demandent de toucher 2 fois (avant, un seul toucher effaçait tout !) ;
• « 📋 Copier ma partie » donne un long texte : garde-le dans une note, et « 📥 Charger une partie » le remet.

Attention : la navigation privée efface tout quand on ferme l'onglet. Et le jeu ouvert depuis l'icône de l'écran d'accueil a sa propre sauvegarde, différente de celle de Safari.

🔎 Missions d'exploration

• Sous le capot, trouve « Recherches · missions · gemmes ». Regarde un bonus changer après une recherche.
• Dans config.js, trouve missions : invente ta propre mission avec ton personnage !
• Touche le panneau du stock : quels objectifs restent pour le village 🏡 ?
• Mets 2 mines sur le même filon : il s'épuise 2 fois plus vite ?

❓ Quiz

🏡 Étape 8 : le village, le fer, les maisons et le marché ✅ livrée · à valider

L'âge du village est arrivé : une vraie chaîne du métal (mine de fer → fonderie → forge), des huttes et des maisons pour loger les habitants, un marché où les prix bougent, des statistiques, 6 recherches et 5 missions. ▶ le village

🐞 Le bug du toucher qui passait à côté

✍️ Maxance a remarqué que sur téléphone, Bois → Bûcheron ne faisait rien. La raison : l'écran se souvient des zones où sont les boutons, et quand on touche, il prend la zone dessinée en dernier (celle du dessus). Sous les cartes du tiroir, il y a une zone invisible « rien » (pour que toucher entre deux cartes ne touche pas la carte du monde)… mais elle était notée après les cartes, donc au-dessus d'elles : elle mangeait tous les touchers ! Maintenant, elle est notée avant. Comme des feuilles empilées : on voit celle du dessus.

⛓️ Une chaîne à 3 étages

🟤 mine de fer ────── fer ──────┐
⚫ mine de charbon ── charbon ──┴──► 🔥 fonderie ──  lingot ──┐
🪚 scierie ────────── 🟫 planche ───────────────────────────────┴──► ⚒️ forge ── 🔨 outil ──► missions, recherches, marché

Chaque flèche, c'est un porteur qui passe par l'entrepôt. La fonderie attend d'avoir les deux ingrédients : s'il manque le charbon, elle s'arrête, même avec plein de fer. C'est ce qu'on appelle un goulot d'étranglement : le morceau le plus lent de la chaîne décide de la vitesse de toute la chaîne (comme le goulot d'une bouteille).

📜 Un atelier suit une recette

Avant, la scierie avait son propre code. Maintenant, la scierie, la fonderie et la forge sont des ateliers : le même code les fait marcher, et chacun suit sa recette, rangée comme une donnée dans config.js :

scierie :  { entrees: { troncs: 1 },              sorties: { planches: 2 }, duree: 6 }
fonderie : { entrees: { fer: 1, charbon: 1 },     sorties: { lingots: 1 },  duree: 10 }
forge :    { entrees: { lingots: 1, planches: 1 }, sorties: { outils: 1 },   duree: 12 }

Comme une cuisine qui suit des fiches : pour un nouvel atelier (un moulin, une boulangerie…), il suffira d'écrire une nouvelle fiche !

🛏️ Compter les lits

places    = 6 (tentes du campement) + 3 × huttes + 6 × maisons
habitants = les ouvriers des bâtiments (les porteurs dorment à l'entrepôt)
un nouvel ouvrier arrive si : habitants < places  ET  il y a à manger

Les ouvriers ne partent pas si tu démolis une maison : seulement, personne de nouveau n'arrive. Ta partie d'avant a reçu des places offertes, pour que la nouvelle règle ne fasse partir personne.

⚖️ L'offre et la demande

Au marché, chaque ressource a un facteur (1 = le prix normal). Vendre fait baisser le facteur (« encore des planches ? on en a plein ! »), acheter le fait monter. Puis il revient doucement vers 1.

prix de vente d'un paquet = prix de base × 5 × facteur
vendre 5 planches :  facteur × (1 − 0,02 × 5) = facteur × 0,9   (10 % moins cher la fois suivante)
acheter coûte 1,5 fois plus cher que vendre (le marchand doit gagner sa vie)

Astuce de gestionnaire : vends un peu de tout plutôt que beaucoup d'une seule chose !

📊 Le compteur à la porte de l'entrepôt

Imagine un gardien assis à la porte de l'entrepôt avec un carnet : un trait pour chaque objet qui entre, un trait pour chaque objet qui sort. Toutes les 10 secondes, il tourne la page, et il garde les 30 dernières pages (5 minutes).

par minute = traits des pages gardées ÷ minutes que couvrent ces pages
bilan      = entrées − sorties   (vert : le stock monte · rouge : il baisse)

Comment le gardien voit-il tout passer ? Le stock est enveloppé dans un Proxy : un objet-espion qui ressemble au stock, mais qui est prévenu chaque fois qu'on écrit dedans. C'est comme une porte qui compte ceux qui la traversent.

🗺️ Le plan des âges

🔎 Missions d'exploration

• Sous le capot, trouve « 📊 Le compteur de l'entrepôt ». Quelle ressource a le bilan le plus rouge ?
• Aux rayons X, regarde la fonderie : « 1/1🟤 + 0/1⚫ → 1 ». Qu'est-ce qui manque ?
• Vends 3 paquets de pierres d'affilée. Regarde « ▼ % » au marché, puis attends 3 minutes.
• Dans config.js, trouve ateliers : invente la recette d'un moulin (blé → farine) !
• Construis 2 fonderies et une seule mine de fer. La 2e fonderie travaille-t-elle ? Pourquoi ?

❓ Quiz

✨ Étape 9 : un village plus beau, plus fin et plus vivant ✅ livrée · à valider

Zoome de près : les maisons ont maintenant des murs en vraie matière, des tuiles, des fenêtres et des cheminées qui fument. Les porteurs portent mieux (épaule, hotte, brouette, âne et charrette), le jour laisse place à la nuit, et des poules, des enfants, des oiseaux et des papillons font vivre le village. ▶ le village

🔍 Le niveau de détail

Dessiner une tuile, c'est un petit trait. Mais 30 maisons × 40 tuiles × 60 images par seconde, ça fait 72 000 traits par seconde ! Alors le jeu fait comme les vrais jeux vidéo : il regarde le zoom.

zoom ≥ 80 % : tous les détails (tuiles, planches, fenêtres, poignées, jardinières)
zoom ≥ 60 % : les figurants (poules, enfants, papillons)
plus loin    : des formes simples, on ne verrait pas les détails de toute façon

On appelle ça le niveau de détail. Sous le capot, « détails fins » dit oui ou non, et « temps pour peindre une image » montre combien de millisecondes il faut (moins de 16 ms = 60 images par seconde).

🌗 Le jour et la nuit, avec le modulo

part de la journée = (horloge % 360) ÷ 360       (de 0 à 1)
0 ──aube── 0,08 ────────── jour ────────── 0,62 ─crépuscule─ 0,72 ──── nuit ──── 0,96 ─aube─ 1

C'est le même calcul que pour les saisons, avec un nombre plus petit : une journée dure 6 minutes, une année 20 minutes. La nuit ne change rien aux règles : elle est juste pour les yeux.

🌙 Comment on fait la nuit

Deux couches, comme avec des calques :

1. on multiplie toute l'image par un bleu foncé : c'est comme poser une vitre teintée devant l'écran ;
2. puis on ajoute de la lumière là où il y en a. Chaque lumière est un halo (un rond qui s'efface sur les bords), dessiné une seule fois au début, puis recopié à chaque fenêtre, chaque lanterne, au feu de camp, aux lucioles.

Pour savoir où mettre les lumières, chaque bâtiment, en se dessinant, note « ici, une fenêtre » dans une liste. Le peintre les allume toutes à la fin.

🐔 Des figurants sans mémoire

Les poules et les enfants ne se souviennent pas de leur place : elle est calculée à partir de l'heure, avec un sinus et un cosinus (un point qui tourne en rond). Comme une ronde : si tu sais l'heure, tu sais où est chaque enfant ! Le hasard de chaque case (toujours le même) décide où il y a un papillon. Seuls les oiseaux ont une mémoire : leur place et leur vitesse.

🫏 La charrette : 3 papiers d'un coup

Avant, un porteur prenait UN papier dans la file. Avec un âne et une charrette, il regarde aussi les papiers suivants : s'ils vont au même bâtiment pour la même chose, il les prend avec lui (3 au plus). Le journal le dit : « prend 3 papiers d'un coup ».

🔎 Missions d'exploration

• Sous le capot, trouve « 🌗 Le jour et la nuit ». Combien de lumières sont allumées à minuit ?
• Zoome de près puis de loin : regarde « temps pour peindre une image » changer.
• Dans config.js, trouve jour : et si la nuit durait plus longtemps ?
• Construis 2 maisons : combien de poules ? Et combien d'enfants avec 12 habitants ?

❓ Quiz

🧑‍🌾 Étape 10 : les bonshommes ✅ livrée · à valider

La 2e partie de ton choix 1C. Zoome de près : chaque habitant a son visage, ses cheveux, l'habit et le chapeau de son métier, et de vrais gestes de travail. Même les ouvriers des ateliers sortent travailler devant leur bâtiment. ▶ le village

🪆 Une poupée qu'on habille

Tous les personnages sont dessinés par la même fonction : bonhomme. On lui donne une « fiche » : la peau, les cheveux, l'habit, le chapeau, et la pose des bras et des jambes. Pour un nouveau métier, il suffit d'écrire une nouvelle fiche dans TENUES (dans affichage/batisses.js) : comme les recettes des ateliers, c'est rangé comme des données.

📐 Un bras, c'est un angle

angle 0     : le bras pend le long du corps
angle 1,57  : le bras est tendu devant          (1,57 = π ÷ 2, un quart de tour)
angle 3,14  : le bras est levé au-dessus de la tête   (3,14 = π, un demi-tour)
main = épaule + (sinus de l'angle × 6,5 ; cosinus de l'angle × 6,5)

Un geste, c'est un angle qui change avec le temps. Le coup de hache du bûcheron dure 0,67 s, coupé en 3 morceaux :

0 % ──── lever la hache, lentement ──── 60 % ── FRAPPER, vite ── 75 % ── revenir ── 100 %
angle :  0,9  ───────────────────────►  3,0   ──────────────►  1,0   ─────────►  0,9

Lentement pour lever, vite pour frapper : c'est ce qui donne de la force au geste. Les animateurs des dessins animés font pareil !

🎲 Chacun sa tête

Chaque habitant tire au hasard sa couleur de peau, ses cheveux, sa coupe et sa barbe, avec une graine : le numéro de son bâtiment. Comme la graine de la carte, elle donne toujours le même résultat : ton bûcheron garde sa tête toute sa vie, même après avoir rechargé la partie.

🔎 Missions d'exploration

• Sous le capot, trouve « 🧑 bonshommes peints ». Combien y en a-t-il quand tu zoomes de près ? Et de loin ?
• Combien de temps le chasseur met-il pour tendre son arc ? Regarde bien la corde reculer.
• Dans affichage/batisses.js, trouve TENUES : change la couleur du bonnet du bûcheron !
• Mets le jeu en pause (P) pendant un coup de hache, puis avance pas à pas (N).

❓ Quiz

🏰 Étape 11 : le bourg, la réserve et les pubs ✅ livrée · à valider

Pour donner envie de revenir : le village travaille pendant ton absence (la réserve), des cadeaux arrivent contre une pub, et le bourg est plus difficile : il faut du pain, entretenir les bâtiments et chauffer les maisons l'hiver. ▶ le village

📦 La réserve : un calcul au retour

Quand la page est fermée, le jeu ne tourne pas du tout ! Alors, au retour, on calcule ce qui se serait passé, avec le rythme du village (mesuré par le compteur de l'entrepôt de l'étape 8) :

gain = rythme par minute × minutes d'absence
ex. : 6 🟫 par minute × 60 minutes = 360 🟫… mais la réserve n'a que 150 places !
→ on garde 150, et le jeu te dit « réserve pleine au bout de 25 minutes »

Pour mesurer un rythme juste, le compteur met maintenant une étoile ★ à côté de ce que TU fais (vendre, acheter, payer un chantier) : ça ne compte pas comme le travail du village.

Agrandir la réserve coûte de plus en plus cher : c'est une courbe exponentielle. Chaque niveau coûte 2,2 fois le précédent : 40, 88, 194, 426, 937 planches…

📺 Une pub juste, pas trop facile

cadeau = 4 minutes de production   (au moins l'équivalent de 24 🪙)
1re pub du jour : 100 % · 2e : 88 % · 3e : 77 % · … jusqu'à 35 %
et jamais plus du quart de ce qui te manque pour l'âge suivant

Comme ça, regarder des pubs aide à avancer, sans tout donner : il faut quand même bien gérer son village. C'est un rendement décroissant : chaque fois vaut un peu moins que la précédente.

Pour l'instant, la pub est fausse (5 secondes d'attente). Les vraies pubs ne marchent que dans une application sur les stores, avec un compte au nom d'un adulte.

🏰 Le bourg : 3 nouvelles choses à penser

🌾 ferme ─blé─► 🌬️ moulin ─farine─┐
🪵 troncs ────────────────────────┴─► 🍞 boulangerie ─pain─► les repas
🟡 mine d'or ─or─┐
⚫ charbon ──────┴─► 💍 orfèvre ─bijoux─► le marché (70 🪙 !)

• Le pain : au bourg, un repas sans pain rend mécontent (20 % moins vite).
• L'entretien : les bâtiments s'usent ; un 🔨 outil les répare (depuis l'étape 12, c'est le maçon-couvreur qui l'apporte). Usé, on va 2 fois moins vite.
• L'hiver : il faut brûler du bois dans chaque maison. Et la ferme ne produit rien sous la neige !

Les ralentissements se multiplient : mécontent ET froid, c'est 0,8 × 0,8 = 0,64, donc 36 % moins vite.

🔎 Missions d'exploration

• Sous le capot, trouve « 📦 La réserve · 📺 les pubs » : quel est le rythme de ton village ?
• Regarde 3 pubs dans la journée : la valeur passe de 100 % à 88 %, puis à 77 %…
• Combien de bois faut-il chaque minute en hiver avec 4 huttes et 3 maisons ?
• Dans config.js, trouve reserve : et si la réserve grandissait de × 2 à chaque niveau ?

❓ Quiz

👆 Étape 12 : poser, déplacer, de belles routes ✅ livrée · à valider

On voit enfin ce qu'on fait avant de le faire : le bâtiment transparent suit ton doigt, avec ✅ et ❌. On déplace un bâtiment en restant appuyé dessus, les routes se dessinent au doigt et ne font plus de quadrillage, et un maçon-couvreur répare le bourg. ▶ le village

👀 L'aperçu avant de valider

choisir ──► aperçu (vert ou rouge) ──[glisser / toucher]──► aperçu ailleurs
                    │                                         │
                    ├──[✅]──► le bâtiment ET sa route sont construits
                    └──[❌]──► rien ne change

C'est une règle d'or des applications : montrer avant de faire, et toujours laisser un moyen d'annuler. Avant, un toucher posait le bâtiment tout de suite : une erreur, et c'était raté !

⏱️ L'appui long

Comment le jeu sait-il que ton doigt reste appuyé ? Il note l'heure où le doigt se pose, et il regarde à chaque image : si 0,55 seconde est passée et que le doigt a bougé de moins de 14 points, c'est un appui long. S'il a bougé, c'est un glissé ; s'il s'est levé vite, c'est un toucher.

🛣️ Des routes sans quadrillage

Avant, chaque case de route se reliait à TOUT ce qui la touchait : la route d'à côté, et chaque bâtiment voisin. Résultat : des grilles autour des maisons. Maintenant :

• une route ne se relie à un bâtiment que par sa porte (la case devant son mur de gauche) ;
• la route proposée arrive justement devant la porte ;
• 4 routes en carré : on remplit le milieu, ça fait une petite place ;
• des traits arrondis d'un milieu de case à l'autre, et 2 ornières sur les chemins de terre.

Pour combler les trous quand le doigt glisse vite : le jeu avance case par case vers le doigt, d'abord dans la direction où il y a le plus de chemin à faire.

🎁 Le coup de pouce

✍️ Tu t'étais retrouvé bloqué : plus de scierie, et plus de planches pour en construire une ! Un bon jeu ne doit jamais bloquer le joueur pour toujours. Maintenant, si le village n'a aucun bûcheron (ou aucune scierie) et pas de quoi en payer un, il est offert. Les jeux appellent ça une soupape de sécurité.

🔎 Missions d'exploration

• Pose un bâtiment loin des routes : combien de cases de chemin le jeu propose-t-il ?
• Dessine une route qui passe sur l'eau : que devient l'aperçu ?
• Dans logique/placement.js, trouve LONGUEUR_ROUTE : à quoi sert-elle ?
• Au journal, trouve « Coup de pouce » et « Le maçon-couvreur a réparé ».

❓ Quiz

👥 Étape 13 : les villageois, les manutentionnaires et les améliorations ✅ livrée · à valider

On voit maintenant que tout dépend des maisons : des villageois se promènent en attendant du travail, et chaque nouvelle cabane en appelle un. L'entrepôt s'agrandit pour avoir plus de manutentionnaires, et chaque bâtiment peut être amélioré (hache aiguisée, scie à cadre, écurie…). ▶ le village

👥 D'où viennent les travailleurs ?

lits libres ET à manger ──(toutes les 20 s)──► un villageois arrive
villageois libre ──(une cabane l'appelle)──► il y va à pied ──► il devient bûcheron, pêcheur… ou porteur
habitants = ouvriers + porteurs + villageois sans travail   (jamais plus que les lits !)

C'est une chaîne de dépendances : pour produire plus, il faut des cabanes ; pour les faire marcher, il faut des villageois ; pour avoir des villageois, il faut des lits ET de la nourriture. Si un maillon manque, tout s'arrête : c'est ça, gérer un village !

🏗️ Les manutentionnaires de l'entrepôt

L'entrepôt a des places de porteur : 3 au début, +2 à chaque agrandissement (5 niveaux). Une place libre appelle un villageois, comme une cabane. Plus de porteurs, c'est moins d'attente dans la file des livraisons (sous le capot : « File d'attente »).

⬆️ Améliorer, ou faire une recherche ?

temps de travail = temps normal × recherches (TOUT le village) × améliorations (CE bâtiment)
bûcheron :         4 s         × 0,6 (Haches affûtées)        × 0,8 (Hache aiguisée)   = 1,92 s

Une recherche de l'université marche pour tous les bâtiments, mais elle est chère et lente. Une amélioration est immédiate et moins chère, mais seulement pour UN bâtiment : avec 4 bûcherons, il faut en payer 4. À toi de choisir : améliorer, ou construire une cabane de plus (qui demandera un villageois… et un lit) ?

🔎 Missions d'exploration

• Sous le capot, trouve « 👥 Les villageois » : combien se promènent, combien vont au travail ?
• Remplis tous les lits : est-ce qu'un villageois arrive encore ? Que dit le journal ?
• Améliore un bûcheron 2 fois : sous le capot, sa ligne montre « ★★ × 0,56 ». Pourquoi 0,56 ?
• Dans config.js, trouve ameliorations : invente une amélioration pour le pêcheur !

❓ Quiz

🔍 Étape 14 : des bâtiments plus gros, plus d'animations, de vraies icônes ✅ livrée · à valider

Les bâtiments sont dessinés plus gros pour qu'on les reconnaisse d'un coup d'œil, chacun a son animation devant la porte, et les stocks sont dessinés comme dans le jeu : de vraies planches, des bûches couchées, des pépites de charbon, de fer et d'or. ▶ le village

🔍 La loupe : grossir sans changer la carte

dessin normal ──► on pose une LOUPE au pied du bâtiment (× 1,35) ──► on dessine ──► on enlève la loupe
la case, elle, ne change pas : le bâtiment occupe toujours 1 case

Le peintre ne redessine pas chaque bâtiment en plus gros : il change d'échelle avant de dessiner (ctx.scale), comme si on regardait à travers une loupe. Le point fixe de la loupe est le pied du bâtiment, sinon il glisserait de sa case. Les lumières de la nuit suivent la même loupe. Le réglage est dans config.js : detail.echelleBatiments.

💎 Une pépite, c'est des facettes

Une pépite, c'est un petit polygone dont chaque face a sa couleur : la face éclairée est claire, celle à l'ombre est foncée. Avec 3 couleurs bien choisies, on reconnaît le charbon (noir brillant), le fer (gris-rouille) et l'or (jaune). Le même dessin sert sur la carte, dans la barre des stocks et dans le marché : une seule fonction (Batisses.icone), donc tout se ressemble.

🎬 Une animation qui ne coûte presque rien

Les animations ne sont pas « simulées » : elles sont calculées à partir de l'heure. La bûche de la scierie avance de (temps × vitesse) modulo longueur : quand elle arrive au bout, elle repart du début. Rien à sauvegarder, rien à mettre à jour : c'est pour ça que le jeu reste fluide (environ 3 ms par image).

🔎 Missions d'exploration

• Dans config.js, mets echelleBatiments à 1.8 : que se passe-t-il ? Remets 1.35 après !
• Zoome et dézoome : à partir de quand les animations disparaissent-elles ? (indice : zoomFin)
• Trouve dans affichage/batisses.js la fonction facettes : comment choisit-elle la couleur de chaque face ?
• Invente l'animation de la boulangerie : que pourrait-on voir devant sa porte ?

❓ Quiz

🐄 Étape 15 : l'élevage, la laiterie et le bonheur ✅ livrée · à valider

Des vaches dans leur enclos, un puits, du foin pour l'hiver, du lait, du beurre, du fromage et des yaourts. Les vaches peuvent tomber malades : le vétérinaire vient les soigner. Et une nouvelle jauge, le 😊 bonheur des habitants, qui change la vitesse de tout le village. ▶ le village

🔗 Une chaîne qui grandit à chaque âge

🛖 hameau :   💧 puits ─┐
              🌿 faneur ─┼─(foin, seulement en hiver)─► 🐄 étable ──► 🥛 lait
🏡 village :                                              🥛 ──► 🧈 laiterie ──► beurre
🏰 bourg :                                                🥛 ──► 🧀 fromagerie · 🍶 crèmerie

Le lait est un produit intermédiaire : on peut le manger tel quel, ou le transformer en beurre, fromage ou yaourt, qui valent plus cher au marché et donnent de nouveaux goûts. À toi de choisir comment partager ton lait !

😊 Le bonheur : une note en plusieurs parties

bonheur = 15 (la base)
        + 30 × la part des habitants qui ont le ventre plein
        +  8 par aliment différent mangé ces 10 dernières minutes (5 au plus)
        + 10 × la part qui dort dans une maison
        − 15 s'il fait froid · − 15 × la part sans pain (au bourg)

C'est la variété qui compte : 100 poissons ne valent pas mieux que 10. Mais du poisson, de la viande, du lait et du beurre, ça fait 4 goûts ! La jauge ne saute pas : elle avance de 0,5 point par seconde vers sa note (on dit qu'elle est lissée). Puis elle agit sur tout le village : 😢 sous 45, tout va 15 % moins vite et plus personne n'arrive ; 😊 à 70, 10 % plus vite ; 😄 à 85, 20 % plus vite.

🤒 La contagion

À partir du village, chaque étable a 3 chances sur 100 par minute de tomber malade (3 fois plus si les vaches manquent d'eau ou de foin). Une étable malade rend ses voisines (à 4 cases ou moins) malades plus facilement : 25 % par minute ! C'est pour ça qu'il vaut mieux espacer les étables… et construire un vétérinaire.

🔎 Missions d'exploration

• Sous le capot, trouve « 😊 Le bonheur · 🐄 l'élevage » : combien vaut chaque partie de la note ?
• Regarde le risque de maladie de chaque étable, puis construis-en deux collées : que se passe-t-il quand l'une tombe malade ?
• Dans le journal, cherche « 😋 … mange » : tu vois la douceur après le plat (+ 🥛 du lait) ?
• Dans config.js, trouve bonheur : que se passerait-il si parGout valait 12 ?

❓ Quiz

🐑 Étape 16 : les poules, les moutons et les cochons ✅ livrée · à valider

La suite de l'élevage : des œufs au hameau, de la laine, du tissu et des cochons au village, des vêtements et du jambon au bourg. Tous les troupeaux peuvent tomber malades, et les habitants bien habillés sont plus heureux. ▶ le village

🔗 Trois nouvelles chaînes

🛖 hameau :  💧 ──► 🐔 poulailler ──► 🥚 œufs
🏡 village : 💧 (+ 🌿 l'hiver) ──► 🐑 bergerie ──► 🧶 laine ──► 🧵 tisserand ──► tissu
             💧 (+ 🌿 l'hiver) ──► 🐖 porcherie ──► 🍖 viande
🏰 bourg :   🧵 tissu ──► ✂️ tailleur ──► 👕 vêtements
             🍖 viande + ⚫ charbon ──► 🥓 charcuterie ──► jambon

Regarde bien la viande : elle sert à manger, mais aussi à faire du jambon. Si la charcuterie prend trop de viande, les habitants risquent d'avoir faim ! C'est un arbitrage : une ressource, deux usages, et c'est toi qui choisis.

👕 Une ressource qu'on consomme de temps en temps

Au bourg, toutes les 10 minutes, chacun prend des vêtements neufs à l'entrepôt. Avec 30 habitants et 15 vêtements, la moitié est bien habillée : le bonheur gagne 10 × 0,5 = 5 points. C'est une consommation par paquets : rien pendant 10 minutes, puis beaucoup d'un coup. Il faut donc faire des réserves.

🔎 Missions d'exploration

• Sous le capot : combien de secondes avant les prochains habits neufs ?
• Construis 2 bergeries collées, puis attends une maladie : la porcherie d'à côté l'attrape-t-elle ? (indice : seulement la même sorte d'animal)
• Dans config.js, trouve troupeaux : que se passe-t-il si tu mets nombre: 4 pour les cochons ?

❓ Quiz

🛠️ Étape 17 : tes retours (routes, bâtiments, entrepôt, interface) ✅ livrée · à valider

Les recherches changent ce qu'on voit, les routes se pavent toutes seules, les bâtiments ont des formes différentes et une animation chacun, un entrepôt secondaire pour les coins éloignés, des ouvriers qui vont plus loin, une barre de stock plus discrète, et ce qu'on gagne qui s'envole jusqu'au stock. ▶ le village

🏬 Plusieurs points de départ

l'encre part de TOUS les entrepôts en même temps, sur les routes :
  🏠 entrepôt ──►──►──►  │  ◄──◄── 🏬 entrepôt 2
  chaque case de route retient l'entrepôt dont l'encre est arrivée en premier = le plus proche

C'est une recherche en largeur à plusieurs départs. Chaque bâtiment sait ainsi quel entrepôt est le plus proche par la route, et ce sont les porteurs de cet entrepôt qui le livrent. Si ses porteurs sont tous occupés depuis 15 s, ceux d'un autre entrepôt viennent aider. Le stock, lui, est partagé : c'est le même village.

🧱 Une recherche qui se voit

Quand « Routes pavées » est finie, le jeu parcourt toutes les cases de la carte et change chaque chemin de terre (1) en route pavée (2). Puis l'outil Route construit directement des routes pavées. « Outils en fer » change aussi la couleur des outils des ouvriers : de la pierre grise et brune au fer brillant.

🔎 Missions d'exploration

• Sous le capot, trouve la ligne « 🏬 … : porteurs · bâtiments servis » de chaque entrepôt.
• Construis un bûcheron entre les 2 entrepôts : lequel le livre ? (regarde son panneau, puis sous le capot)
• Dans config.js, trouve zoomAnimations et rayon : que valent-ils maintenant ?

❓ Quiz

🎩 Étape 18 : les classes d'habitants, et des bâtiments reconnaissables de loin ✅ livrée · à valider

Les huttes deviennent des maisons, les maisons des maisons bourgeoises, quand leurs habitants ont ce qu'ils veulent. Paysans, artisans et bourgeois n'ont pas les mêmes besoins, et les plus riches paient des impôts. De loin, chaque bâtiment montre son repère. ▶ le village

🪜 L'échelle des logements

🛖 hutte (3 lits)          👨‍🌾 paysans   : à manger
   │ au village, 1 minute avec : 3 goûts + 🥛 ou 🥚 · puis 6 🟫 6 🪨
   ▼
🏠 maison (6 lits)         👷 artisans  : + 1 🪙 d'impôt par minute chacun
   │ au bourg, 1 minute avec : 5 goûts + 🧀 ou 🥓 + 👕 + 😊 60 % · puis 12 🟫 16 🪨 2 🔨
   ▼
🏡 maison bourgeoise (10)  🎩 bourgeois : + 3 🪙 d'impôt par minute chacun

Un logement évolue tout seul quand les besoins de la classe suivante sont remplis pendant une minute entière. C'est comme une récompense : tu soignes tes chaînes de production, et ton village s'embellit, gagne des lits et paie plus d'impôts. Mais si une classe n'a plus ce qu'elle veut, le bonheur baisse (la nouvelle ligne « 🎩 Besoins des classes »).

📍 Un repère à taille fixe

Quand on dézoome, tout rapetisse… sauf les repères ! Leur taille est 20 ÷ zoom : à 50 % de zoom, on les dessine 2 fois plus gros, donc à l'écran ils gardent toujours la même taille. C'est ce que font les cartes routières avec leurs icônes.

🔎 Missions d'exploration

• Sous le capot, trouve « 🎩 Les classes d'habitants » : combien de paysans, d'artisans, de bourgeois ?
• Dans le journal, cherche « Impôts » : combien de pièces par minute ?
• Dans config.js, trouve classes : que se passe-t-il si delai vaut 20 ?

❓ Quiz

⚖️ Étape 19 : la nourriture rééquilibrée, et l'entrepôt 2 dès le hameau ✅ livrée · à valider

Il fallait une énorme quantité de nourriture : on a mesuré pourquoi, et corrigé la vraie cause. Et l'entrepôt secondaire se trouve maintenant dans le menu Routes, dès le hameau. ▶ le village

🔬 Mesurer avant de corriger

Avant de changer les nombres, on a fait une expérience : un village de 18 bâtiments, 10 minutes de jeu accéléré, et on compte. Résultat : 46 habitants… dont 35 sans travail ! Chaque hutte faisait venir 3 bouches de plus, qui se promenaient en mangeant. Ce n'était donc pas la production qui était trop faible : c'étaient trop de mangeurs.

avant :  46 habitants (35 sans travail) · 14 repas mangés par minute
après :  14 habitants (3 sans travail)  ·  4 repas mangés par minute · 18 rapportés par minute

Les nouvelles règles : un villageois n'arrive que s'il y a du travail pour lui (ou s'il y a moins de 2 villageois qui attendent), on mange toutes les 3 min 20 (au lieu de 2 min 30), la boulangerie fait 3 pains, et la porcherie 4 viandes.

❓ Quiz

🚚 Étape 20 : les livraisons qui ne traînent plus ✅ livrée · à valider

294 livraisons en retard, c'était trop ! Les porteurs portent plus, marchent plus vite, ne partent plus tous au chantier, et les cabanes gardent plus de choses devant leur porte. La barre du stock montre ce qui est vraiment disponible, et les messages tiennent dans leur cadre. ▶ le village

📏 Le goulot d'étranglement

Une file d'attente qui grandit, c'est un goulot d'étranglement : il arrive plus de travail que ce qu'on peut faire. Pour le faire sauter, il y a 3 façons : plus de porteurs (4 au départ, + 3 par niveau d'entrepôt), des voyages plus rapides (2,8 cases par seconde), et plus d'objets par voyage (3, ou 6 avec la charrette). L'expérience, sur un village de 26 bâtiments posés d'un coup :

avant : 8 minutes pour finir les chantiers · file de 197 → 42
après : 4 minutes pour finir les chantiers · file de 167 → 23, et les ateliers continuent pendant ce temps

🔒 Disponible = stock − promis

Quand tu poses un chantier, ses matériaux restent dans l'entrepôt jusqu'à ce qu'un porteur les emporte, mais ils sont promis. La barre du haut montre maintenant ce qui est disponible : le stock moins ce qui est promis. Les statistiques 📊 montrent toujours le vrai stock.

❓ Quiz

🐢 Étape 21 : des porteurs plus calmes, l'université en pages, des mines plus loin ✅ livrée · à valider

Les porteurs ne filent plus à toute allure, l'université cache les recherches faites et se lit page par page, et la cabane du mineur peut être à 4 cases du filon. ▶ le village

🧮 Quand les bonus se multiplient

2,8 (porteur) × 1,6 (route pavée) × 1,3 (brouettes) × 1,25 (écurie) = 7,3 cases par seconde 😵
maintenant : min(3,4 ; 2,2 × 1,6 × 1,3 × 1,25) = min(3,4 ; 5,7) = 3,4 cases par seconde 🙂

Chaque bonus seul est raisonnable, mais multipliés ensemble, ils deviennent énormes. Pour éviter ça, on met un plafond (Math.min) : la vitesse ne dépasse jamais 3,4. Pour garder des livraisons rapides, les porteurs portent toujours 3 objets par voyage.

📄 Des pages

Quand une liste est plus longue que l'écran, on la coupe en pages : on calcule combien de lignes tiennent, puis la page n montre les lignes de n × taille à (n + 1) × taille. C'est la même chose qu'un livre !

❓ Quiz

🧹 Étape 22 : moins de brouillon, des champs et des enclos ✅ livrée · à valider

La ferme a de vrais champs et les élevages de vrais enclos pleins d'animaux, sur les cases à côté. Les bâtiments sont plus gros. Plus de bulles 🍞 partout : les alertes du village sont montrées une seule fois. Le panneau d'un bâtiment est rangé en 3 parties. Les ânes et leurs charrettes restent sur la route. ▶ le village

🧩 Un bâtiment sur plusieurs cases

       [0, −1]  [1, −1]          la ferme : sa case [0, 0], plus 3 cases à côté
  [0, 0] 🏠      [1, 0] 🌾       (en décalage de colonne et de ligne)

Pour poser un grand bâtiment, le jeu vérifie que toutes ses cases sont libres. Puis il les marque toutes comme occupées : on ne peut plus construire ni faire de route dessus, et toucher le champ ouvre le panneau de la ferme. Quand on la démolit, toutes ses cases sont libérées. Une partie plus ancienne garde ses fermes : elles prennent seulement les cases libres autour d'elles.

📐 Suivre la route avec un vecteur

Avant, l'âne suivait le porteur à l'horizontale, mais les routes vont en diagonale ! Maintenant, on calcule le vecteur qui va du porteur à sa prochaine case, et on place l'âne et la charrette derrière lui, sur ce vecteur : ils restent sur la route.

❓ Quiz

🏚️➡️🏛️ Étape 23 : le niveau se voit, sans icônes ✅ livrée · à valider

Plus d'icônes sur les bâtiments : on les reconnaît à leur forme. Un bâtiment amélioré change d'aspect : socle en pierre, puis toit plus beau, murs plus hauts et girouette. Et dans ta partie, les fermes et les élevages trop serrés sont déplacés tout seuls pour avoir leurs champs et leurs enclos. ▶ le village

🏗️ Le niveau dans le dessin

niveau 1 (rien)   : le bâtiment de base
niveau 2 (★)      : + un socle en pierre, des volets, une lanterne · un peu plus grand
niveau 3 (★★)     : + des murs plus hauts, un plus beau toit (paille → bardeaux → tuiles), une girouette dorée

Le même dessin sert pour tous les bâtiments : on fabrique une copie du modèle avec quelques réglages changés (modeleNiveau). Un bâtiment sans socle, c'est un bâtiment que tu n'as pas encore amélioré !

🧹 Ranger un village

Au chargement, le jeu cherche les fermes et les élevages qui n'ont pas toutes leurs cases. Pour chacun, il cherche la place libre la plus proche, en tournant autour en carrés de plus en plus grands, puis il le déplace et lui fait une route.

❓ Quiz

🏘️ Étape 24 : des bâtiments sur 2 × 2 cases, une grande carte, des porteurs qui suivent ✅ livrée · à valider

Presque tous les bâtiments prennent maintenant 4 cases, et sont dessinés bien plus gros. Une nouvelle partie a une carte de 96 × 96 cases. Chaque entrepôt gagne des porteurs quand il a beaucoup de bâtiments à livrer, et on peut avoir 4 entrepôts secondaires. ▶ le village

🚚 Le travail fait venir des porteurs

places d'un entrepôt = ses places de base + 1 pour 4 bâtiments qu'il livre
ex. l'entrepôt principal (4 places) qui livre 18 bâtiments : 4 + 18 ÷ 4 = 4 + 4 = 8 porteurs

C'est une règle qui s'adapte : plus le village grandit, plus il y a de porteurs, sans rien faire. L'expérience, sur un village de 26 bâtiments : les porteurs passent tout seuls de 4 à 8, et la file d'attente descend à 18. (Il faut toujours des villageois et des lits pour eux !)

🧱 Un bloc de 2 × 2 cases

Un grand bâtiment prend sa case, plus 3 autres : [0, −1], [1, 0] et [1, −1]. On le dessine au milieu du bloc, une demi-case à droite de sa case. Les routes peuvent toucher n'importe laquelle de ses cases. Les champs et les enclos sont sur la colonne d'après.

❓ Quiz

🎨 Étape 25 : une silhouette par métier, et l'inventaire 🎒 ✅ livrée · à valider

Les bâtiments n'étaient que des boîtes avec un toit à deux pentes : seules les couleurs changeaient. Maintenant, chaque métier a sa forme : une tour, une colline, une tente, une grue, un dôme… Et la barre du stock est redevenue petite : tout le reste est dans l'inventaire, en pleine page. ▶ le village

👀 La silhouette : ce qu'on voit de loin

Quand on est loin, on ne voit plus les détails (les fenêtres, les outils devant la porte) : on voit seulement le contour du bâtiment, sa silhouette. Si toutes les silhouettes sont les mêmes, l'œil ne peut pas les trier. Les dessinateurs de jeux font ce test : ils remplissent chaque bâtiment en noir et regardent si on le reconnaît encore.

avant :  🏠 🏠 🏠 🏠 🏠   (la même boîte, 5 couleurs)
après :  ⛺ tipi   🗼 tour du moulin   ⛰️ colline de la mine   🏗️ grue   🕌 dôme   🏭 cheminée d'usine

Il y a maintenant 6 formes de toit : à deux pentes, en pavillon (4 pentes, sans pignon), de grange (cassé en deux), en appentis (une seule pente), en voûte (arrondi) et plat. Et de grands morceaux qui dépassent. Chaque modèle de bâtiment a un réglage toitForme ; un seul dessinateur, structure, choisit la forme.

🎒 L'inventaire : une fiche calculée

Pour chaque ressource, la fiche dit qui la fabrique et à quoi elle sert. Ces lignes ne sont pas écrites à la main : le jeu les calcule en lisant ses propres règles (les recettes des ateliers, les prix des bâtiments, le marché). Si on ajoute un atelier demain, sa fiche sera juste toute seule. Seule la phrase « ce que c'est » est écrite (le réglage info de chaque ressource dans config.js).

🔍 Missions d'exploration

• Ouvre l'inventaire et touche 🥛 le lait : combien de bâtiments s'en servent ?
• Touche une ressource avec un 🔒 : à quel âge la découvriras-tu ?
• Construis un moulin et une mine : à quelle distance de zoom les reconnais-tu encore ?

❓ Quiz

🚶 Étape 26 : les ouvriers vont plus loin ✅ livrée · à valider

Les mines voient les filons jusqu'à 12 cases, et le mineur y va à pied. Tous les autres ouvriers cherchent du travail 50 % plus loin. ▶ le village

⚖️ Plus loin, mais plus long

temps pour 1 morceau = creuser + marcher (aller et retour)
filon à 2 cases  : 8 s + 2 × 1 ÷ 1,6 ≈ 8 + 1   = 9 s
filon à 12 cases : 8 s + 2 × 11 ÷ 1,6 ≈ 8 + 14 = 22 s

C'est un compromis : aller loin permet de trouver des filons, mais un mineur près de son filon produit plus de 2 fois plus vite. Le bon joueur construit sa mine le plus près possible ! (Le mineur creuse toujours le filon le plus proche d'abord.)

Pour savoir où dessiner le mineur, le jeu n'a pas besoin de chemin : il regarde le temps passé. Pendant la première moitié de la marche, il avance vers le filon ; à la fin, il revient. C'est une interpolation : une position calculée entre deux points, selon une fraction de 0 à 1.

📏 Les nouveaux rayons (en cases)

bûcheron 12 → 18 · forestier 9 → 14 · carrière 12 → 18
pêcheur 10 → 15 · chasseur 14 → 21 · géologue 14 → 21 · mine 4 → 12

❓ Quiz

🧭 Étape 27 : la tournée du géologue, du maçon et du vétérinaire ✅ livrée · à valider

Ces trois-là ne rentrent plus chez eux après chaque travail : ils vont du suivant au suivant, partout sur la carte. ▶ le village

🔁 La machine à états change

avant :  chercher → aller → travailler → revenir → se reposer → chercher…
après :  chercher → aller → travailler → encore du travail ? ─ oui → aller → travailler → …
                                                       └─ non (ou plus d'outils) → revenir → se reposer

Une seule flèche a changé, et ça change toute la vie de ces ouvriers ! La tache d'encre (la recherche du plus proche) part maintenant de l'endroit où il est, pas de sa maison. Pour rentrer, une autre tache d'encre cherche le chemin vers sa maison.

C'est le problème du voyageur de commerce : un facteur qui doit passer chez beaucoup de gens. Aller à chaque fois au plus proche de là où on est, c'est une méthode simple (et souvent assez bonne), qu'on appelle « le plus proche voisin ».

🔍 Missions d'exploration

• Combien de travaux d'affilée ton géologue fait-il avant de rentrer ?
• Que fait le maçon quand il n'a plus d'outils dans sa cabane ?

❓ Quiz

💎 Étape 28 : plus de montagnes, des filons à découvrir, des bâtiments géants ✅ livrée · à valider

Les montagnes sont devenues un sol rocheux plat. Les filons sont cachés dessous : le géologue les découvre, et des paillettes apparaissent. La mine creuse un puits dedans. Les bâtiments ont chacun leur taille, jusqu'à 4 × 4 cases. Et chaque objet de l'inventaire a sa grande icône. ▶ le village

🙈 Une information cachée

Le jeu SAIT où sont tous les filons (la carte les invente dès le début), mais il ne les MONTRE pas : chaque case a un petit drapeau revele (0 = caché, 1 = découvert). Le peintre ne dessine les paillettes que si le drapeau vaut 1, et la mine ne peut creuser que les filons découverts. C'est comme le « brouillard de guerre » des jeux de stratégie.

Pour ta partie, on n'a rien eu à changer dans la carte gardée : elle est refaite à partir de sa graine, puis on aplanit les montagnes à la fin. Comme ça, tout le reste (arbres, rivières) est exactement au même endroit.

📐 La taille d'un bâtiment

1 × 1 : hutte, maison, puits            (dessin × 1,8)
2 × 2 : cabanes, maison bourgeoise       (× 2,3)
3 × 3 : ateliers, élevages, mines        (× 3,3)
4 × 4 : entrepôts, université, moulin, marché, fonderie, ferme (× 4,3)

❓ Quiz

🧭 Étape 29 : le conseiller et le bilan ✅ livrée · à valider

Un conseiller relit tout le village toutes les 2 secondes et te dit quoi faire, et pourquoi. L'inventaire montre ce qui monte ▲ et ce qui baisse ▼. ▶ le village

🧠 Des règles qui deviennent des conseils

SI la nourriture baisse ET il reste moins de 5 minutes      → 🔴 « construis un pêcheur »
SI un atelier attend un ingrédient ET il n'y en a plus      → 🟠 « construis celui qui le fabrique »
SI il n'y a plus de lit                                    → 🟠 « construis une hutte »
SI un objectif de l'âge n'est pas atteint                  → 🔵 « voici ce qui t'aiderait »

C'est un système expert : une liste de règles « SI … ALORS … », rangées par urgence. Le conseiller ne triche pas : il lit les mêmes chiffres que toi (le compteur de l'entrepôt, les lits, les ateliers). Il ne change rien au village, il conseille.

Le goulot d'étranglement, c'est l'endroit où la chaîne coince. Exemple : une forge sans lingots, parce que la fonderie n'a pas de fer, parce qu'aucune mine n'en creuse. Le conseiller remonte la chaîne et te montre le premier maillon cassé.

🔍 Missions d'exploration

• Laisse la nourriture baisser : quand le conseil devient-il rouge ?
• Construis une forge sans fonderie : que dit le conseiller ?

❓ Quiz

📦 Étape 30 : les commandes et les objectifs pas à pas ✅ livrée · à valider

Des clients passent des commandes claires, avec une récompense. Et chaque âge est découpé en 8 petites étapes guidées, une à la fois, avec leur raison. ▶ le village

⚖️ Une commande qui vaut toujours à peu près pareil

valeur d'une commande = 40 × (âge + 1) pièces
quantité = valeur ÷ prix au marché       (arrondi à un nombre pair)
au campement : 40 🪙 → 40 ÷ 1 = 40 troncs, ou 40 ÷ 2 = 20 planches
récompense = 1,5 × la valeur = 60 🪙

Grâce au prix du marché, une commande de bijoux (chers) demande peu de bijoux, et une commande de troncs (pas chers) en demande beaucoup : c'est équitable. Et la commande ne demande que ce que le village sait déjà fabriquer : elle est toujours possible.

Les objectifs pas à pas, c'est le même but qu'avant, mais découpé : un gros problème devient une suite de petits problèmes faciles. C'est une des idées les plus importantes en programmation !

❓ Quiz

🏛️ Étape 31 : le Grand Beffroi, le monument de la ville ✅ livrée · à valider

À la ville, un énorme chantier de 5 × 5 cases : le Grand Beffroi. Il se construit en 4 paliers, chacun avec des ressources de toutes les chaînes et une grosse récompense. Il grandit sous tes yeux. ▶ le village

🧱 Les 4 paliers

1. 🧱 Fondations sculptées : pierres, planches, outils             → +300 🪙  +3 💎  +4 😊
2. 🏛️ Grands murs : pierres, lingots, planches, charbon           → +500 🪙  +4 💎  +5 😊
3. 🕌 Tour et dôme doré : tissus, bijoux, outils, lingots          → +800 🪙  +6 💎  +6 😊
4. 🎉 Fête d'inauguration : pain, fromage, jambon, vêtements, yaourt → +1500 🪙 +10 💎 +10 😊

Chaque palier demande des choses de chaînes différentes : pour finir le monument, il faut que tout le village marche. C'est un objectif à long terme, et tu peux donner petit à petit. Le jeu se souvient de tout ce que tu as déjà donné (la sauvegarde garde les « dons »).

❓ Quiz

🌍 Étape 32 : la nouvelle base de la grande ville ✅ livrée · à valider

Le grand changement commence ! Une nouvelle partie, sur une carte immense (256 × 256 cases), un style plus réaliste pour les adultes, et des routes larges, prêtes pour les voitures de demain. ▶ le village

🎨 Moins « dessin animé »

Le style « dessin animé » vient surtout de 2 choses : des gros traits noirs autour de tout, et des couleurs très vives. On a donc affiné les traits (presque 2 fois plus fins, et gris foncé au lieu de noir) et adouci toutes les couleurs : la fonction adoucir garde 62 % de la couleur et la mélange avec du gris, comme de vrais matériaux un peu patinés.

📐 Une carte 7 fois plus grande

avant : 96 × 96  =  9 216 cases
après : 256 × 256 = 65 536 cases (7 fois plus)

Pour rester fluide, le peintre ne dessine que les cases visibles à l'écran, et la mini-carte écrit directement ses 65 536 points d'un coup (une « image de pixels »), au plus une fois par seconde.

🗺️ La suite du grand changement

• Étape 33 : 👥 les besoins des habitants et la population, façon SimCity, et l'encyclopédie « qui fait quoi ».
• Étape 34 : ⚡ l'époque industrielle et l'électricité.
• Étape 35 : 🚰 l'eau courante et les égouts.
• Étape 36 : 🚗 les routes goudronnées, les voitures et les camions.
• Étape 37 : 🚓 les services : police, pompiers, hôpital, école.
• Étape 38 : 🛍️ l'époque moderne : centres commerciaux, aéroport.

❓ Quiz

👥 Étape 33 : les besoins des habitants, la prospérité, et l'encyclopédie ✅ livrée · à valider

Comme dans SimCity : un recenseur note chaque besoin des habitants, en tire la prospérité de la ville, et plus la ville prospère, plus elle grandit vite. Et l'encyclopédie 📖 explique ce que fait chaque bâtiment et ce dont il a besoin. ▶ le village

🔁 Une boucle de croissance

besoins remplis → prospérité ↑ → plus d'habitants arrivent → plus d'ouvriers
      ↑                                                              ↓
      └──────────────── plus de production, plus de bâtiments ◄──────┘

C'est une boucle : quand tout va bien, ça va de mieux en mieux. Mais elle marche aussi dans l'autre sens : s'il manque à manger, la prospérité baisse, moins d'habitants arrivent… Ton rôle de maire : garder chaque besoin au vert.

prospérité = la moyenne des besoins (de 0 à 100 %)
arrivées   × (0,5 + prospérité)   → 50 % : × 1 ; 90 % : × 1,4

🔍 Missions d'exploration

• Quel besoin est le plus bas au début de la partie ? Pourquoi ?
• Dans l'encyclopédie, quel bâtiment a besoin d'eau à côté de lui ?

❓ Quiz

⚡ Étape 34 : l'époque industrielle et l'électricité ✅ livrée · à valider

Après la ville : 🏭 l'époque industrielle. Une centrale à charbon fait de l'électricité, qui suit les routes. Les ateliers alimentés vont plus vite, les nouvelles usines ne marchent pas sans courant, et les habitants le veulent. ▶ le village

🔌 Un réseau, une puissance limitée

1 centrale qui tourne = 40 unités
maison 1 · atelier 2 · usine 8 · entrepôt 3

le réseau sert les plus PROCHES d'abord (en cases de route) :
  maison (2 cases) ✅ · scierie (5) ✅ · aciérie (9) ✅ · … · le 41e point ❌ coupé

Pour savoir qui est le plus proche, on refait une tache d'encre, mais seulement sur les cases de route, en partant de la centrale. C'est un réseau : comme pour les porteurs, ce qui n'est pas relié par la route ne reçoit rien.

L'offre (ce que fournissent les centrales) doit être plus grande que la demande (ce que tout le monde consomme). Sinon : pénurie !

❓ Quiz

🚰 Étape 35 : l'eau courante, les égouts et les immeubles ✅ livrée · à valider

L'eau et les égouts marchent comme l'électricité : des stations, des tuyaux sous les routes, une puissance limitée. Les maisons bourgeoises qui ont les 3 réseaux deviennent des immeubles de 20 lits. ▶ le village

🧰 Un seul outil pour 3 réseaux

distribuer(réseau, sources, puissance, consommation, drapeau)

⚡ électricité : centrales  · 40 chacune · maison 1, usine 8…    → b.courant
🚰 eau         : pompages   · 40 chacune · maison 1, élevage 2…  → b.eau
🚽 égouts      : épurations · 40 chacune · maison 1, usine 2…    → b.egout

Au lieu d'écrire 3 fois le même code, on a écrit une fonction qui sait distribuer « quelque chose » le long des routes. On lui donne juste qui fournit, combien et qui consomme. C'est ce qu'on appelle réutiliser du code : si on trouve une erreur, on la corrige une seule fois pour les 3 réseaux.

Et les réseaux dépendent les uns des autres : une station sans électricité s'arrête. On calcule donc l'électricité d'abord, puis l'eau et les égouts. C'est une chaîne de dépendances, comme celle des ateliers.

🔍 Missions d'exploration

• Ouvre « sous le capot » : compare l'offre et la demande des 3 réseaux.
• Construis plein de maisons loin de la station : lesquelles n'ont pas d'eau ? Pourquoi celles-là ?
• Laisse la centrale sans charbon : regarde ce qui arrive à l'eau et aux égouts dans le journal.

❓ Quiz

🚜 Étape 36 : une route passe toujours (et les ponts) ✅ livrée · à valider

Fini les routes bloquées ! La route abat les arbres et casse les rochers qui la gênent (ce qu'ils donnent va à l'entrepôt), et elle fait des ponts sur l'eau. ▶ le village

🧭 Contourner d'abord, foncer ensuite

1er essai : la tache d'encre évite les arbres, les rochers et l'eau
   → un chemin pas trop long (au plus 2 fois le trajet tout droit) ? on le prend, c'est gratuit !
2e essai : la tache d'encre passe partout (sauf sur les bâtiments)
   → la route dégage son passage : 🪓 arbres, ⛏️ rochers, 🌉 ponts

Le jeu fait 2 essais : un « gentil » (on garde la forêt pour le bûcheron) et un « bulldozer ». C'est une idée qu'on retrouve partout en programmation : essayer la solution la moins chère, et seulement si elle échoue, la solution plus forte.

Pour que les ouvriers marchent sur les ponts, la carte connaît maintenant les routes : une case d'eau avec une route est praticable.

🔍 Missions d'exploration

• Trace une route en 2 touchers de chaque côté d'un petit bois : passe-t-elle autour ou à travers ? Et pour un très grand bois ?
• Démolis une case de pont (🧹) : combien de planches reviennent ?
• Regarde le stock de troncs avant et après une route à travers la forêt.

❓ Quiz

🧺 Étape 37 : des bâtiments qu'on reconnaît de loin (leur cour) ✅ livrée · à valider

Les bâtiments ne sont plus géants : ils reprennent une taille normale, au fond de leur place. Devant, une cour remplie des objets de leur métier, et une enseigne au-dessus de la porte. ▶ le village

🎭 Un décor de théâtre, en 3 couches

1. le sol de la cour et la clôture du fond   (le plus loin de toi)
2. le bâtiment, posé au fond de sa place
3. les objets de devant, la clôture de devant et l'enseigne   (le plus près de toi)

Ce qui est loin est peint d'abord, ce qui est près en dernier : c'est la même règle que pour toute la carte (« peindre du fond vers l'avant »). Les objets sont rangés comme des données : pour chaque bâtiment, une liste « dans quel coin, quel objet ». Ajouter un objet, c'est ajouter une ligne dans affichage/cours.js.

Et pourquoi on reconnaît mieux de loin ? Parce que l'œil repère d'abord les formes et les couleurs : un tas noir (charbon), des toiles rayées (marché), des draps colorés (tisserand), une grue (carrière)… pas la taille.

🔍 Missions d'exploration

• Dézoome au maximum : quels bâtiments reconnais-tu encore ? Lesquels se ressemblent trop ?
• Remplis l'entrepôt : les piles de sa cour grandissent avec le stock.
• Invente un objet pour un bâtiment qui n'en a pas assez à ton goût (écris-le dans « mes idées »).

❓ Quiz

🧲 Étape 38 : un village propre (ciseaux, gisements, aimant) ✅ livrée · à valider

Les bâtiments ne débordent plus sur la route ; la carte a de grands gisements visibles dès le début ; le géologue recharge les mines épuisées ; et un aimant aide à aligner les bâtiments le long des routes. ▶ le village

✂️ Les ciseaux du peintre

Pour qu'un bâtiment ne déborde jamais, le peintre pose un masque (on dit « clip » en anglais) : une forme en dehors de laquelle il ne peut plus rien peindre. Ici, c'est le losange de la place, prolongé vers le haut (un bâtiment haut a le droit de cacher ce qui est derrière lui).

🧲 L'aimant

pour chaque place à 2 cases au plus du doigt :
   une route TOUT le long de la porte ?   → 3 points
   une route tout le long d'un autre côté ? → 2 points
   moins 1 point par case d'écart avec le doigt
on garde la place qui a le plus de points

C'est une note donnée à chaque possibilité, puis on choisit la meilleure : beaucoup de jeux (et d'ordinateurs qui jouent aux échecs) font comme ça.

⛏️ Les gisements

La carte pose ses gisements avec un dé à graine : le premier de chaque minerai assez près du village, les autres loin, et jamais deux collés (22 cases au moins). Quand une mine a tout creusé, le géologue trouve une nouvelle veine dessous.

🔍 Missions d'exploration

• Regarde la mini-carte : combien de gisements de chaque couleur trouves-tu ?
• Place une scierie à 1 case d'une route, puis à 3 cases : quand l'aimant la colle-t-il ?
• Ouvre « sous le capot » : combien de grands gisements et de mines épuisées ?

❓ Quiz

🎯 Étape 39 : livraison directe, entrepôt clair, carrières sur gisement ✅ livrée · à valider

Les porteurs vont tout droit à l'atelier qui attend ce qu'ils portent ; le panneau de l'entrepôt explique ses 3 améliorations ; et la pierre se trouve dans des gisements, comme les minerais. ▶ le village

🎯 Le raccourci du porteur

AVANT : bûcheron → entrepôt → scierie   (2 voyages)
APRÈS : bûcheron → scierie → entrepôt   (la scierie est servie tout de suite)

le porteur ramasse 3 troncs ; la scierie a de la place pour 2 :
   2 troncs → scierie, et le 3e rentre avec lui à l'entrepôt

C'est une optimisation : on obtient le même résultat avec moins de travail. Le jeu calcule « qui a besoin de ce que je porte, le plus près de moi ? ». Et pour que les statistiques restent justes, il compte comme si les troncs étaient passés par l'entrepôt.

⛏️ La carrière devient une mine

Dans config.js, la carrière a rejoint la liste des mines : carriere: { filon: "pierres" }. Une seule ligne, et elle se comporte comme les mines de charbon, de fer et d'or (poser sur un gisement, creuser, être rechargée par le géologue). C'est la force des règles rangées comme des données !

🔍 Missions d'exploration

• Ouvre « sous le capot » : combien de livraisons directes depuis le début ?
• Suis un porteur qui part de chez le bûcheron : va-t-il à l'entrepôt ou à la scierie ? Pourquoi ?
• Regarde la mini-carte : trouves-tu les 10 gisements de pierre ?

❓ Quiz

🦌 Étape 40 : gibier, université unique, entrepôts 2, un seul logement ✅ livrée · à valider

Le gibier se renouvelle tout seul, l'université et le marché ne se construisent qu'une fois, chaque entrepôt secondaire s'agrandit, et on ne construit plus qu'un seul logement. ▶ le village

🍼 Une croissance qui dépend du nombre

naissances par minute = nombre d'animaux × 20 %
  100 animaux → 20 naissances par minute
   30 animaux →  6 naissances par minute
et si une espèce tombe sous 6 animaux : de nouveaux arrivent de la forêt

C'est comme une vraie population : plus il y a de parents, plus il y a de petits. Mais si les chasseurs tuent plus vite qu'il n'en naît, la population baisse… sauf que la règle des « 6 au moins » l'empêche de disparaître. Il y a aussi un plafond (280), pour que la carte ne soit pas envahie.

❓ Quiz

🧱 Étape 41 : toutes les routes pavées ✅ livrée · à valider

Après la recherche « Routes pavées », il n'y a plus jamais de chemin de terre : même la route proposée jusqu'à la porte d'un nouveau bâtiment est pavée. ▶ le village

🔎 Le bug caché

Les outils de route savaient déjà faire des routes pavées. Mais un autre bout de code, celui qui construit la route jusqu'à la porte d'un nouveau bâtiment, demandait toujours « de la terre » (sorte 1). C'est un bug : une règle écrite à un seul endroit, mais oubliée à un autre. La correction : une seule fonction, sorteDe, que TOUS les morceaux de code demandent avant de construire une route. Une règle, un seul endroit !

❓ Quiz

Étape 42 : les lingots toujours pareils ✅ livrée · à valider

Les lingots sont maintenant dessinés de la même façon partout : dans les messages, les panneaux, les bulles et le journal. ▶ le village

🔤 Les emojis, c'est du texte

Un emoji est une lettre spéciale, comme « A » : c'est l'ordinateur qui choisit son dessin, et il n'existe pas d'emoji « lingot ». Le jeu écrivait donc le boulon dans ses textes. La solution : avant d'écrire un texte, le jeu cherche ce boulon et, à sa place, il dessine le lingot avec ses propres traits (deux trapèzes gris). C'est comme un remplacement de mots, mais avec un dessin.

❓ Quiz

🏹 Étape 43 : un chasseur n'est jamais sans gibier ✅ livrée · à valider

Autour de chaque chasseur, il y a toujours au moins 6 animaux. S'il n'en trouve pas, il en arrive tout de suite. ▶ le village

🌍 Partout, ce n'est pas « près de lui »

À l'étape 40, il naissait beaucoup d'animaux, mais n'importe où sur une carte de 256 × 256 cases. Un chasseur pouvait avoir chassé tout son coin : les petits naissaient à 100 cases de là ! Ma règle était juste en total, mais fausse localement. La correction compte les animaux dans le rayon de CHAQUE chasseur.

Et une 2e sécurité : au moment exact où le chasseur cherche et ne trouve rien, du gibier arrive tout de suite. Comme ça, même entre deux vérifications, il n'attend jamais.

❓ Quiz

📦 Étape 44 : des ateliers et des porteurs plus grands ✅ livrée · à valider

Les ateliers gardent 3 fois plus d'ingrédients, 2 fois plus de produits attendent devant leur porte, et les porteurs portent de plus en plus avec les améliorations. ▶ le village

✖️ Des multiplicateurs qui s'enchaînent

4 objets
× 1,5 (brouettes)          =  6
× 2   (ânes et charrettes)  = 12
× 1,5 (écurie)              = 18

Chaque amélioration multiplie ce qu'on avait déjà : c'est pour ça que la dernière rapporte le plus (+6 objets, alors que les brouettes en donnaient +2). Et pour les ateliers, c'est une addition : + 3 de réserve à chaque ⭐, toujours pareil.

❓ Quiz

🚜 Étape 45 : construire même sur les arbres ✅ livrée · à valider

Les bâtiments, comme les routes, dégagent leur place : les arbres et les rochers disparaissent, et ce qu'ils donnent va à l'entrepôt. ▶ le village

♻️ Réutiliser ce qui existe

La route savait déjà dégager son passage (étape 36) avec une fonction, degager. Pour les bâtiments, on n'a pas réécrit la même chose : on a donné à cette fonction la liste des cases du bâtiment. Une fonction, deux usages !

❓ Quiz

⚡ Étape 46 : un jeu de nouveau fluide ✅ livrée · à valider

On a mesuré ce qui ralentissait le jeu, et on a corrigé les 5 plus gros coupables. ▶ le village

⏱️ D'abord mesurer, ensuite corriger

Un jeu doit dessiner environ 60 images par seconde : il a donc 16 millièmes de seconde par image pour TOUT faire. On a chronométré chaque morceau du jeu dans un grand village, et on a trouvé 5 coupables :

🧺 les cours : 30 à 60 formes par bâtiment, à CHAQUE image    → un « autocollant » dessiné une fois
✂️ les ciseaux : une zone de 4 000 px par bâtiment            → seulement ceux qui dépassent, sur leur hauteur
⛏️ les mines : 625 cases regardées 120 fois par seconde        → seulement quand elles commencent un travail
🔍 le géologue : toute la carte, même sans mine épuisée       → il vérifie d'abord qu'il y a du travail
🔧 sous le capot : 10 fois par seconde, même caché             → 4 fois, et rien quand il est caché

L'autocollant (on dit « sprite ») est une astuce de tous les jeux vidéo : ce qui ne bouge pas est dessiné une fois dans une image cachée, puis on recolle l'image. Recoller, c'est beaucoup plus rapide que redessiner 50 formes !

❓ Quiz

🚶 Étape 47 : plus de limite pour aller au travail ✅ livrée · à valider

Les villageois vont travailler partout sur la carte, même dans une mine très loin. Et le panneau dit pourquoi personne ne vient. ▶ le village

🐛 Un bug que seule ta partie montrait

La « tache d'encre » qui trouve le chemin d'un villageois s'arrêtait à 60 cases. Sur une petite carte, c'était assez. Mais avec la carte de 256 × 256 et les gisements d'or loin du village (étape 38), la mine était trop loin : le villageois ne trouvait aucun chemin, et ne partait jamais. Dans mes tests, je posais les mines plus près : je ne voyais pas le bug. C'est ta partie, avec un vrai village, qui l'a montré. Merci pour ta capture d'écran !

❓ Quiz

🌆 Étape 48 : l'époque moderne et les services publics ✅ livrée · à valider

La suite après l'époque industrielle : une école, un hôpital, des pompiers et la police, qui servent les maisons les plus proches par la route. ▶ le village

🔧 Sous le capot : un service, c'est comme l'eau courante

Je n'ai pas écrit de nouvel outil. L'école utilise la même fonction que l'électricité et l'eau (distribuer, dans logique/electricite.js). Elle fait une « tache d'encre » le long des routes, à partir de l'école, puis elle sert les maisons les plus proches d'abord, jusqu'à ce qu'il n'y ait plus de places.

🏫 école (60 places)
 │ route
 ├── 🏠 6 lits  ✅  (reste 54)
 ├── 🏢 20 lits ✅  (reste 34)
 ├── 🏢 20 lits ✅  (reste 14)
 └── 🏢 20 lits ❌  pas assez de places : il faut une 2e école !

Ce qui change d'un service à l'autre est rangé comme des données dans config.js (« services ») : le nombre de lits, le drapeau posé sur la maison (aEcole, aHopital…), le nom du besoin. Le nouveau fichier logique/services.js (« la mairie ») ne fait que passer ces données à la fonction.

🔎 Missions d'exploration

• Sous le capot, dans « 🌆 Les services publics » : combien de lits sont servis, et combien de logements sont « sans » ?
• Construis une école loin des maisons, puis une près : laquelle sert les maisons en premier ?
• Dans config.js, cherche services : combien de lits sert un hôpital ? Que se passerait-il avec 200 ?

❓ Quiz

📏 Étape 49 : le texte reste dans la bulle ✅ livrée · à valider

Quand tu livres une commande (ou que tu gagnes quelque chose), le titre ne dépasse plus de la bulle. ▶ le village

🔧 Sous le capot : mesurer avant de dessiner

Avant, la bulle faisait toujours 220 pixels de large, quel que soit le texte. Maintenant, le jeu demande au navigateur « combien de pixels fait ce texte ? » (measureText). La bulle prend cette largeur. Si c'est plus large que l'écran, on coupe le titre entre deux mots, et la bulle grandit vers le haut.

avant :  [ 📦 Merci de la part de la bou]langère…   ← ça dépasse
après :  [ 📦 Merci de la part de la boulangère ]
         [        du village voisin !          ]

❓ Quiz

🎲 Étape 50 : incendies, voleurs et malades ✅ livrée · à valider

Les services publics servent vraiment à quelque chose : sans eux, des incidents arrivent aux maisons. ▶ le village

🔧 Sous le capot : un dé qui dépend de ta ville

Toutes les 15 secondes, le jeu lance un dé pour chaque service (logique/incidents.js, « le dé de la ville »). La chance n'est pas fixe : elle dépend de la part de lits sans le service.

chance d'incendie = 12 % × part des lits sans pompiers

   aucun lit protégé    → 12 % × 100 % = 12 %   (un feu toutes les 2 min environ)
   la moitié protégée   → 12 % ×  50 % =  6 %
   tout protégé         → 12 % ×   0 % =  0 %   (plus jamais de feu !)

Le tirage utilise Math.random() : un nombre au hasard entre 0 et 1. S'il est plus petit que la chance, l'incident arrive. Dans « 🎲 Les incidents », sous le capot, tu vois les chances du prochain dé, et tout ce qui est arrivé depuis le début.

🔎 Missions d'exploration

• Sous le capot, note la chance d'incendie. Construis une caserne : de combien baisse-t-elle ?
• Dans config.js, cherche incidents : que se passerait-il avec taux: 1 pour le feu ?

❓ Quiz

🛣️ Étape 51 : le goudron, les camions et les voitures ✅ livrée · à valider

Une recherche goudronne toutes les routes, les porteurs deviennent des camions et des voitures font vivre la ville. ▶ le village

🔧 Sous le capot : un dessin qui suit la route

Un camion ne se dessine pas comme un bonhomme : il doit être tourné dans le sens de la route. Le jeu regarde la prochaine case du chemin (une colonne de plus, ou une ligne de plus), calcule les 4 coins du dessous du camion dans ce sens, puis peint seulement les côtés tournés vers toi, et le dessus.

Les voitures sont des figurants, comme les poules et les enfants : elles ne transportent rien et ne changent pas les règles. Chacune retient sa case et sa direction. Au bout de la case, elle choisit au hasard une route voisine, sans faire demi-tour, sauf dans une impasse.

Pour la sauvegarde, rien ne change : une route goudronnée est une route pavée (le nombre 2), qu'on dessine et qu'on parcourt autrement quand la recherche est faite. Pas de nouveau format, donc aucun risque pour ta partie.

❓ Quiz

🛍️ Étape 52 : les centres commerciaux et l'aéroport ✅ livrée · à valider

Tes produits se vendent tout seuls dans les magasins, et des touristes arrivent en avion. ▶ le village

🔧 Sous le capot : ce qui rapporte

🛍️ une vente = prix du marché × 4 objets × 1,3
   ex. 4 👕 à 26 🪙 : 26 × 4 × 1,3 = 135 🪙

✈️ les touristes = 0,8 × habitants × (0,5 + prospérité)
   ex. 200 habitants, prospérité 80 % : 0,8 × 200 × 1,3 = 208 🪙 par minute

Le centre commercial est aussi un service (comme l'école) : il sert 100 lits. Il est donc aussi un besoin dans 👥. Sous le capot, le groupe « 🛍️✈️ Les commerces et l'aéroport » montre ce qu'ils ont rapporté.

❓ Quiz

🗼 Étape 53 : la Grande Tour, et la métropole ✅ livrée · à valider

Le monument immense : 6 paliers, des milliers de ressources, une tour de verre avec une flèche dorée. Et le dernier âge : la métropole. ▶ le village

🔧 Sous le capot : réutiliser le Grand Beffroi

La Grande Tour n'a pas eu besoin d'un nouveau module : logique/monument.js (le Grand Beffroi) sait maintenant lire deux listes de paliers. Il regarde le type du bâtiment : « monument » → la liste du Beffroi, « merveille » → celle de la Tour. Tout le reste (donner, compter, récompenser, sauvegarder) est le même code.

const M = (b) => (b.type === "merveille" ? C.merveille : C.monument);
                     ↑ une seule ligne pour choisir la bonne liste

🔎 Missions d'exploration

• Additionne tout ce que demande la Tour (dans config.js, « merveille ») : combien de pierres au total ?
• Quel palier sera le plus dur pour ta ville ? Quelle chaîne de production faut-il agrandir ?

❓ Quiz

🌱 Étape 54 : le forestier replante selon les coupes ✅ livrée · à valider

Chaque arbre coupé est noté : le forestier en replante jusqu'à 5 par voyage, sans se reposer. ▶ le village

🔧 Sous le capot

Le jeu tient un compteur (monde.aReplanter) : +1 à chaque arbre abattu, −1 à chaque pousse plantée. Le forestier lit ce compteur pour savoir combien en planter. C'est comme une dette : le village « doit » des arbres à la forêt.

pousses par voyage = le plus petit entre 5 et les arbres à replanter (au moins 1)
   12 à replanter → 5, puis 5, puis 2 → 0 : il redevient normal

Ce compteur est sauvegardé : la sauvegarde passe en version 23 (une ancienne partie commence à 0).

❓ Quiz

🏙️ Étape 55 : une vraie métropole et les gratte-ciel ✅ livrée · à valider

1 000 habitants pour la métropole, et des gratte-ciel de 60 lits pour les loger. ▶ le village

🔧 Sous le capot

Le gratte-ciel est une évolution, comme la hutte qui devient une maison : config.js dit « immeuble → gratte-ciel, à l'époque moderne, avec les réseaux ET les services ». La fonction qui dit pourquoi un logement n'évolue pas a juste une règle de plus : elle vérifie les 5 drapeaux des services (aEcole, aHopital…) sur ce bâtiment.

❓ Quiz

⚓🏟️ Étape 56 : le port et le stade ✅ livrée · à valider

Des cargos viennent acheter de grosses cargaisons ; un match toutes les 3 minutes rend la ville heureuse. ▶ le village

🔧 Sous le capot

Un nouveau fichier, logique/metropole.js (« le maire de la métropole »), compte les secondes jusqu'au prochain cargo et au prochain match. Le cargo choisit ton produit le plus abondant : il trie la liste des produits du plus nombreux au moins nombreux, et prend le premier.

un cargo = prix du marché × 30 × 1,6      ex. 30 🔨 à 22 🪙 : 22 × 30 × 1,6 = 1 056 🪙

❓ Quiz

🚀 Étape 57 : la fusée ✅ livrée · à valider

Le dernier grand chantier : construire une fusée palier par palier… et la lancer dans l'espace ! ▶ le village

🔧 Sous le capot

La fusée réutilise encore logique/monument.js : c'est le 3e monument du jeu (le Beffroi, la Tour, la fusée). Quand le dernier palier est donné, le jeu note l'heure (lanceA). Le dessin calcule depuis combien de secondes elle est lancée, et la fait monter de plus en plus vite :

hauteur = (secondes depuis le décollage)² × 2,2
   1 s → 2 px · 5 s → 55 px · 10 s → 220 px · 20 s → 880 px : elle accélère !

❓ Quiz

🏆 Étape 58 : un grand chantier pour passer chaque âge ✅ livrée · à valider

Chaque âge a son bâtiment immense, de plus en plus long à construire : il faut le finir pour passer à l'âge suivant. ▶ le village

🔧 Sous le capot : la rétention

« Rétention », c'est le mot des créateurs de jeux pour dire : est-ce que le joueur revient ? Un objectif long, qu'on voit avancer petit à petit, donne envie de revenir voir où il en est. C'est pour ça que les travaux durent de plus en plus longtemps :

🛖 Grande Hutte  ▓░            2 paliers · 45 s → 75 s
🔔 Chapelle      ▓▓░           3 paliers · 1 min 30 → 2 min 30
🏯 Donjon        ▓▓░           3 paliers · 2 min 30 → 4 min
⛪ Cathédrale    ▓▓▓░          4 paliers · 4 → 7 min
🏛️ Beffroi       ▓▓▓░          4 paliers · 5 → 8 min
🚉 Grande Gare   ▓▓▓▓░         5 paliers · 6 → 10 min
🗼 Grande Tour   ▓▓▓▓▓░        6 paliers · 10 → 15 min
🚀 La fusée      ▓▓▓░          4 paliers · 10 → 20 min

Pour le dessin, une astuce : on dessine le bâtiment fini, mais avec des ciseaux qui coupent tout ce qui est au-dessus de la hauteur déjà construite (grandir, dans affichage/batisses.js). Un seul dessin par bâtiment, et il « pousse » tout seul !

Les secondes de travaux qui restent sont sauvegardées : la sauvegarde passe en version 24.

🔎 Missions d'exploration

• Additionne les travaux de la Grande Tour : combien de minutes en tout ?
• Coupe la route d'un chantier en travaux : que dit son panneau ?

❓ Quiz

🌬️ Étape 59 : plus d'entrepôts, les aciéries et le choix de l'énergie ✅ livrée · à valider

Autant d'entrepôts que tu veux, des fonderies qui deviennent des aciéries, une centrale moins gourmande, et 3 nouvelles façons de faire de l'électricité. ▶ le village

🔧 Sous le capot : des sources qui changent

                 prix                          production
⚡ charbon       200🪨 40🔩 20🔨                 40   (s'il a du charbon)
🌬️ éolienne       40🟫 20🔩 10🔨                 12 × vent    (30 % → 100 %)
☀️ solaire        40🪨 60🔩 30🔨                 30 × soleil  (0 la nuit !)
☢️ nucléaire   1 000🪨 400🔩 200🔨               300  (1 lingot par minute)

Le vent est calculé avec des sinus : il monte et descend tout seul, lentement. Le soleil suit la journée : à minuit, les panneaux ne font plus rien ! C'est le vrai casse-tête des ingénieurs : le vent et le soleil sont gratuits, mais pas toujours là. Il faut garder une source « sûre » (charbon ou nucléaire) pour la nuit. Sous le capot, la ligne « ⚡ production par sorte · 🌬️ vent · ☀️ soleil » te montre tout en direct.

🔎 Missions d'exploration

• Regarde la production de tes panneaux solaires le jour, puis la nuit.
• Combien d'éoliennes faut-il pour faire autant qu'une centrale à charbon ? Et quand il y a peu de vent ?

❓ Quiz

🗺️ La feuille de route du village

Le jeu de gestion, étape par étape. Maxance peut changer l'ordre ou ajouter des étapes.

📔 Journal de bord du village

Après chaque étape : ce qui a été fait, et ce que Maxance a appris, avec ses mots à lui.