3d-building-mechanics

Umożliwia szybkie wdrożenie mechaniki budowania w grach Three.js. Zawiera optymalizację wydajności poprzez indeksowanie przestrzenne, walidację stabilności konstrukcji (wzorem Rust czy Valheim) oraz obsługę multiplayer z predykcją klienta. Idealny do gier survival, sandbox czy konstrukcyjnych – gotowe moduły do spatial hash grid, damage propagation i delta compression.

1. Zaimportuj kluczowe moduły: SpatialHashGrid do indeksowania przestrzennego, HeuristicValidator do sprawdzania stabilności budynków oraz ClientPrediction dla multiplayer. Wszystkie znajdują się w folderze scripts/.

2. Zainicjuj spatial index, podając rozmiar komórki (np. 10 jednostek). Ta struktura pozwala na szybkie O(1) zapytania o obiekty w danym obszarze – niezbędne dla dużych światów.

3. Skonfiguruj walidator heurystyczny, wybierając tryb 'heuristic' dla szybkiego sprawdzenia stabilności bez pełnej symulacji fizyki. Alternatywnie użyj octree.js dla adaptacyjnych zapytań w skupiskach budynków.

4. Dla gier multiplayer włącz ClientPrediction, aby gracze widzieli natychmiastowe umieszczenie bloków, a serwer weryfikował poprawność. Delta compression automatycznie wysyła tylko zmienione dane.

5. Monitoruj wydajność za pomocą performance-profiler.js, szczególnie przy dużych bazach. Chunk manager obsługuje streaming świata – załaduj tylko widoczne obszary.

6. W razie potrzeby zapoznaj się z referencjami: performance-at-scale.md dla optymalizacji, structural-physics-advanced.md dla wyboru modelu fizyki, multiplayer-networking.md dla strategii synchronizacji.