- README.md (nouveau) : demarrage rapide - build Windows et Linux, donnees, lancement et options, tests, arborescence. - MEMORY.md : index des notes jusqu'a la Phase 30, bloc "Etat verifie" a jour (builds, tests, ressources journalisees, formats GPU, options, validation de synchronisation, mesure sans GPU), prochaines etapes 0bis et 4 mises a jour. - NOTES-AUDIT-GLOBAL.md : suite donnee par la Phase 30. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01MG5dK27RsN97DDm7CQRhx2
4.0 KiB
Vercora
Jeu d'exploration de montagne solo (marche, abattage et taillage, velo, parapente, escalade, faune, meteo, artisanat) sur une zone LiDAR reelle de 25 km2 du Vercors. Moteur maison C++20 / Vulkan, GLFW, CMake ; Windows et Linux.
Ce fichier est le demarrage rapide. L'etat du projet est dans MEMORY.md, le
detail de chaque phase dans NOTES-PHASE*.md (la derniere : NOTES-PHASE30.md,
optimisation des ressources).
Construire
Prerequis communs : CMake >= 3.20, Ninja, un compilateur C++20, le SDK Vulkan
(en-tetes, chargeur, glslc, couches de validation). GLFW, GLM et
tinyobjloader sont telecharges par CMake dans external/.
Windows (machine de developpement) :
tools\build.bat :: Debug, couches de validation actives
tools\build.bat Release
Linux (Ubuntu 24.04) :
sudo apt-get install libvulkan-dev glslc vulkan-validationlayers ninja-build \
libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libxkbcommon-dev
cmake -S . -B build-rel -G Ninja -DCMAKE_BUILD_TYPE=Release -DGLFW_BUILD_WAYLAND=OFF
ninja -C build-rel
La configuration Debug definit VERCORA_DEBUG, seule a activer les couches de
validation Vulkan.
Donnees
Les dalles LiDAR et les grilles .vchm ne sont pas versionnees ; seule
l'orthophoto assets/terrain/vercora_zone_ortho.vcto l'est. Les produire :
tools/fetch_dalles.py, tools/lidar_to_heightmap.py,
tools/assemble_terrain.py, tools/lidar_to_canopy.py (voir leurs en-tetes).
Sans elles, le jeu retombe sur un terrain synthetique.
Pour MESURER sans les vraies donnees (session cloud, nouveau poste),
python3 tools/make_bench_zone.py ecrit une zone proxy a la vraie echelle
(relief synthetique, couvert tire de l'orthophoto). Il refuse d'ecraser des
fichiers existants sans --force.
Lancer
vercora assets/terrain/vercora_zone_1m.vchm # zone 25 km2, jeu complet
vercora --demo # demo : marche et vol libre
vercora terrain # terrain synthetique
Options utiles (liste complete en tete de src/main.cpp) :
| option | effet |
|---|---|
--vsync |
presentation calee sur l'ecran : le reglage pour JOUER (consommation) |
--start=E,N --look=yaw,pitch --lock-input |
vue reproductible (Lambert 93) |
--hour=H --day=D --time-scale=0 |
heure et meteo figees |
--freeze-anim |
animation des shaders figee (captures comparables au pixel) |
--quit-after=S |
fermeture propre apres S s, bilans de fin ecrits |
--flythrough=V[,H] |
survol scripte (stress du streaming) |
--no-lod, --no-vegetation, --no-wildlife, ... |
temoins de mesure |
--force-staging |
televersement par staging meme en memoire unifiee |
Chaque partie journalise ses couts (Cout par image, Cadence de boucle,
Construction de tuiles) et ses ressources (Ressources (PHASE 30) : RAM,
memoire GPU exacte, allocations Vulkan, pool de geometrie).
Tester
- Logique, sans GPU :
tools\run_logic_tests.bat(Windows). Sous Linux, compilertests/logic_tests.cppavec la liste de sources de ce script. - Vulkan reel :
tools\run_vulkan_check.ps1(scenarios A a J,-Onlypour un sous-ensemble). Contrat du projet : zero message[Validation]. - Synchronisation : Debug avec
VK_LAYER_ENABLES=VK_VALIDATION_FEATURE_ENABLE_SYNCHRONIZATION_VALIDATION_EXT. - Sans GPU (Linux) : lavapipe (
mesa-vulkan-drivers) sous Xvfb ; le rendu y est deterministe. Recette :NOTES-PHASE30.md, section 9.
Arborescence
src/core fenetre, camera, collisions, chemins, memoire du processus
src/assets heightmap, formats .vchm / .vcto, chargeur .obj
src/renderer Vulkan : contexte, pool de geometrie, streaming du terrain, rendu
src/world terrain, vegetation, faune, meteo, activites, artisanat
src/editor editeur de niveau (F2)
shaders/ GLSL compiles en SPIR-V par CMake
tools/ build, tests, harnais Vulkan, preparation des donnees
tests/ tests headless de la logique de jeu