StillHammer d1731507ff Add project structure with engines, core, client

- Add CLAUDE.md project documentation
- Update all documentation with coherence fixes
- Add engines directory structure (to be converted to submodules)
- Add core/, client/ directories for main components
- Resolved 30 coherence problems (P1-P30)
- Enhanced map system with 218 procedural elements

2025-09-19 01:40:53 +08:00

3.3 KiB

Raw Blame History

Systèmes techniques

Tile System

Superficies

Océan : 362 000 000 000 m²
Total : 510 000 000 000 m²
Terre : 148 000 000 000 m² (118.4 Go)
Urbain : 4 440 000 000 m² (3.552 Go)

Référence Minecraft

MC 256x256 = 3 540 ko

Gestion mémoire

Game Chunk max DD Absolue pire cas (256x256)

Land : 131 ko
Ressources : 393 ko
Build : 459 ko
Roof : 131 ko
Effect : 131 ko
Total : 1 245 ko

Game Chunk RAM (256x256)

Land : 131 ko
Ressources : 655 ko
Build : 720 ko
Roof : 131 ko
Effect : 131 ko
Total : 1 768 ko

Architecture Multi-Échelle des Chunks

Principe de Design

Différents types de données utilisent différentes résolutions de chunks selon leur granularité naturelle et leurs besoins de performance.

Hiérarchie des Échelles

Chunk 512x512 - Terrain de Base

Usage : Données homogènes sur grandes zones

landId : 16b - Texture de la tile (potentiel modificateur) DD/Ram
roofId : 16b - Identification toitures/couverture sol
Justification : Terrain change peu, grandes zones homogènes
Mémoire : Toujours en RAM (données de base)

Chunk 256x256 - Structures et Bâtiments

Usage : Bâtiments et constructions moyennes/grandes

buildingPtr : 32b "DD"/Ram

{
    BuildingId : 32b DD/Ram
    Collision : 4b Ram
    PV : 20b DD(24b)/Ram
}

Justification : Bâtiments ont taille intermédiaire, besoin résolution moyenne
Mémoire : Chargement à la demande

Chunk 128x128 - Effets et Détails Fins

Usage : Effets visuels, particules, détails haute fréquence

effectId : 16b
Justification : Effets nécessitent granularité fine pour précision
Mémoire : Streaming selon proximité joueur

Chunk 64x64 - Gameplay Principal

Usage : Simulation de base, FOW, navigation (documenté dans map-system.md)

Justification : Échelle optimale pour mécanique Factorio-like
Mémoire : Core gameplay, chargement prioritaire

Système Ressources (Indépendant)

ResourcePatches : Formes libres non-alignées sur chunks (78x53 exemple)

Justification : Gisements naturels ne respectent pas grilles artificielles
Documentation : Détails complets dans map-system.md
Mémoire : Chargement selon exploration et exploitation

Avantages Architecture Multi-Échelle

Performance optimisée : Chaque donnée à sa résolution naturelle
Mémoire efficace : Granularité adaptée aux besoins d'accès
Scaling intelligent : Pas de sur-échantillonnage ni sous-échantillonnage
Maintenance : Systèmes indépendants, modifications isolées

Stack technique

Langages de performance

C++ / C / ASM pour performance critique
Justification : Simulation temps réel complexe + milliers d'unités
Compromise : Complexité dev acceptable vs performance requirements

Optimisations performance

Adaptive Tick Rate

Normal : 60 TPS
Sous charge : 15 TPS
Principe : Dégradation gracieuse selon la charge

Queue Systems

Batch processing pour opérations coûteuses
Future scaling : clustering dynamique per module

3.3 KiB Raw Blame History