kimi-game/BENCHMARK_NOTES.md

Benchmark Notes

Choix de conception principaux

• Pas de communication en temps réel = cœur de gameplay. Le joueur ne contrôle jamais le robot directement : la seule « manette » est la liste de tâches. Toutes les mécaniques (énergie, usure, météo, terrain) servent à rendre la planification intéressante.
• Monde infini par hachage déterministe plutôt que bruit de Perlin stocké : chaque case est calculée à la volée depuis (graine, x, y), les chunks (16×16) ne servent que de cache mémoire et peuvent être purgés sans perte. Une même graine reproduit exactement le même monde, y compris après sauvegarde/chargement (seules les cases explorées sont stockées).
• Simulation à pas fixe (1/30 s) avec accumulateur, découplée du framerate ; accélération ×1/×2/×4 par multiplication du dt simulé.
• Logique / rendu séparés : seul src/ui.lua (et main.lua) touchent love.graphics. Toute la simulation est testable hors LÖVE.
• A* 4-directions avec coût d'entrée par case (plaine 1, difficile 3, rochers ∞), bâtiments bloquants intégrés à la fonction de coût, et revalidation du chemin à chaque pas (recalcul si le monde a changé).
• Échec doux : énergie à 0 → robot immobilisé jusqu'à la nuit, dépannage partiel ; jamais de game over brutal. Les journées perdues sont la vraie pression.
• Prévision météo quasi-exacte mais faillible (85 %) et déterministe : la météo réelle et l'erreur de prévision dérivent toutes deux de la graine.
• Identification couleur + forme : chaque terrain a un symbole (zigzag, triangle, losange pointé, cercle), chaque bâtiment une silhouette distincte (carré, grille solaire, pile, cercle foré, triangle relais, losange atelier, double anneau balise).

Compromis réalisés

• Pas de bibliothèque externe (contrainte) : bruit, A*, UI entièrement écrits à la main. L'UI est donc sobre et sans widgets génériques.
• Déplacement 4-directions uniquement : les diagonales compliqueraient la lisibilité des coûts de terrain et des collisions d'angle.
• La réserve de minerai par gisement est finie mais généreuse (300/60) pour ne pas imposer de méta-jeu de prospection dans un benchmark.
• Les cases explorées sont stockées comme un set de chaînes "x,y" — simple et sérialisable directement ; suffisant pour des milliers de cases.
• L'aide est un overlay texte plutôt qu'un tutoriel interactif.

Fonctionnalités terminées

• Monde procédural infini déterministe, génération à la demande, purge mémoire.
• Caméra (clavier + glisser souris), zoom centré sur le curseur, sélection de case avec panneau d'information.
• 6 types de tâches (explorer, récolter, construire, réparer, recharger) avec états (en attente / en cours / terminée / impossible / interrompue), réorganisation, suppression, estimation de durée, validation des tâches manifestement impossibles.
• 7 bâtiments fonctionnels avec règles de placement (gisement, distance entre relais, unicité), construction progressive par le robot, intégrité, messages d'erreur explicites au placement.
• Ressources (énergie, minerai, données) avec effets concrets ; réseau énergétique qui s'effondre à 0.
• Météo à 3 états + prévision faillible, impacts gameplay réels (consommation, production, vitesse, usure des bâtiments).
• Objectifs intermédiaires + objectif principal (balise) + victoire signalée + mode bac à sable après victoire.
• Sauvegarde / chargement complets (graine, jour, exploration, bâtiments, plans, ressources, robot, tâches, objectifs).
• Menu principal avec graine choisie ou aléatoire, aide en jeu (F1), notification center, pause, accélération.

Fonctionnalités partielles ou absentes

• Déplacement diagonal : absent (choix assumé).
• Marqueur visuel de gisement épuisé : absent.
• Réparation des bâtiments par l'atelier : l'atelier ne répare que le robot ; les bâtiments se réparent via une tâche dédiée du robot.
• Son : aucun (aucun asset autorisé ; aucun son généré par code).
• Multiples sauvegardes : un seul slot.

Tests effectués

love . --tests : 49 tests, 0 échec, couvrant :

• génération déterministe (même graine / graine différente / chunks à la demande) ;
• météo reproductible et prévision majoritairement exacte ;
• A* (contournement d'obstacles, cas impossible, évitement des cases chères) ;
• règles de placement et coûts de construction ;
• production des bâtiments (solaire, tempête, extracteur, batterie) ;
• planification (ajout, suppression, réorganisation, validation, sérialisation) ;
• robot (déplacement, consommation, usure, immobilisation, sérialisation) ;
• sauvegarde aller-retour complète ;
• boucle de journée de bout en bout (construction réelle d'un panneau solaire) ;
• impact du froid sur la consommation.

Vérification manuelle : love . lance le jeu sans erreur (menu, partie, caméra, placement de plan, exécution, sauvegarde F5, rechargement au menu).

Problèmes connus

• Sous LÖVE 11.4/Linux, aucun problème bloquant observé.
• Le texte des infobulles de description longues peut dépasser légèrement la largeur du panneau sur les petites fenêtres (960 px).
• La liste des tâches est tronquée visuellement au-delà de la hauteur disponible (indicateur « … (n autres) »), sans ascenseur.

Pistes d'amélioration prioritaires

1. Ascenseur sur la liste des tâches et le panneau d'objectifs.
2. Indicateur visuel de gisement épuisé et de rendement des relais.
3. File d'attente de réparations automatiques pour l'atelier.
4. Diagonales optionnelles dans le pathfinding.
5. Génération audio procédurale (love.sound.newSoundData) pour rester sans asset externe.
6. Plusieurs slots de sauvegarde et sauvegarde automatique en fin de journée.