Files
novafarma/optimizations.md
2025-12-07 14:28:39 +01:00

75 lines
4.3 KiB
Markdown

# 🛠️ Plan Optimizacij in Čiščenja - NovaFarma
Datoteka namenjena tehničnim izboljšavam kode, refaktoringu in performančnim popravkom.
## 🟢 1. Opravljene Optimizacije (Completed)
Stvari, ki so bile uspešno implementirane in izboljšale delovanje.
- [x] **Distance Culling (Teren & Dekoracije)**
- Sistem skriva ploščice (tiles) in drevesa, ki so daleč od igralca, da varčuje s CPU/GPU.
- [x] **Pooling Sistem**
- `TerrainSystem` uporablja bazen spritov (`decPool`, `tilePool`) za ponovno uporabo objektov namesto nenehnega uničevanja in ustvarjanja.
- [x] **NPC Logic Throttling & Culling**
- NPC-ji daleč od igralca se ne posodabljajo in so skriti.
- AI se ne izvaja vsak frame (uporaba timerjev za premik).
- [x] **Code Refactoring & Bug Fixes**
- [x] `InteractionSystem.js`: Centralizirana logika za klike in tipkovnico (E tipka). Odstranjeni odvečni listenerji.
- [x] `Player.js`: Urejena logika gibanja in napada (Spacebar).
- [x] `NPC.js`: Dodan Health Bar, Taming logika in Loot Drop.
- [x] `TextureGenerator`: Urejen draw items (Bone, Axe, Pickaxe).
## 🟡 2. Odprte Tehnične Naloge (To-Do)
Stvari, ki bi jih bilo dobro urediti za boljšo stabilnost.
- [x] **Global Error Handling**
- Dodan `ErrorHandler.js` (Red Screen of Death). Ujame napake, ki se zgodijo med igranjem, in prikaže uporabniku prijazen crash screen z možnostjo reload-a.
- [x] **Centraliziran Loot Manager**
- Implementiran `LootSystem.js`. Skrbi za `spawnLoot`, animacijo dropov, pobiranje (razdalja do igralca) in čiščenje InteractionSystem-a.
- [x] **Z-Sorting (Depth) Optimizacija**
- Implementiran "dirty check" v `Player.js` in `NPC.js`. Depth se posodobi samo, če se Y koordinata spremeni za več kot 0.1px, namesto vsak frame.
## 🔴 3. Performančne Nadgradnje (High-End)
Če bo igra postala počasna pri velikem svetu (256x256).
# 🛠️ Plan Optimizacij in Čiščenja - NovaFarma
Datoteka namenjena tehničnim izboljšavam kode, refaktoringu in performančnim popravkom.
## 🟢 1. Opravljene Optimizacije (Completed)
Stvari, ki so bile uspešno implementirane in izboljšale delovanje.
- [x] **Distance Culling (Teren & Dekoracije)**
- Sistem skriva ploščice (tiles) in drevesa, ki so daleč od igralca, da varčuje s CPU/GPU.
- [x] **Pooling Sistem**
- `TerrainSystem` uporablja bazen spritov (`decPool`, `tilePool`) za ponovno uporabo objektov namesto nenehnega uničevanja in ustvarjanja.
- [x] **NPC Logic Throttling & Culling**
- NPC-ji daleč od igralca se ne posodabljajo in so skriti.
- AI se ne izvaja vsak frame (uporaba timerjev za premik).
- [x] **Code Refactoring & Bug Fixes**
- [x] `InteractionSystem.js`: Centralizirana logika za klike in tipkovnico (E tipka). Odstranjeni odvečni listenerji.
- [x] `Player.js`: Urejena logika gibanja in napada (Spacebar).
- [x] `NPC.js`: Dodan Health Bar, Taming logika in Loot Drop.
- [x] `TextureGenerator`: Urejen draw items (Bone, Axe, Pickaxe).
## 🟡 2. Odprte Tehnične Naloge (To-Do)
Stvari, ki bi jih bilo dobro urediti za boljšo stabilnost.
- [x] **Global Error Handling**
- Dodan `ErrorHandler.js` (Red Screen of Death). Ujame napake, ki se zgodijo med igranjem, in prikaže uporabniku prijazen crash screen z možnostjo reload-a.
- [x] **Centraliziran Loot Manager**
- Implementiran `LootSystem.js`. Skrbi za `spawnLoot`, animacijo dropov, pobiranje (razdalja do igralca) in čiščenje InteractionSystem-a.
- [x] **Z-Sorting (Depth) Optimizacija**
- Implementiran "dirty check" v `Player.js` in `NPC.js`. Depth se posodobi samo, če se Y koordinata spremeni za več kot 0.1px, namesto vsak frame.
## 🔴 3. Performančne Nadgradnje (High-End)
Če bo igra postala počasna pri velikem svetu (256x256).
- [x] Phaser Blitter / Tilemap (Zamenjava 1000 spritov za teren z enim objektom)
- [x] **Spatial Hashing za Kolizijo**
- Implementiran `SpatialGrid.js`. Igralna scena zdaj uporablja mrežo za hitro iskanje NPC-jev v bližini (`InteractionSystem`, `NPC AI`), namesto da bi iterirala čez celo tabelo.
- [x] Phaser Blitter / Tilemap (Zamenjava 1000 spritov za teren z enim objektom)
- [ ] Web Workers za AI (Težje, ker JS nima shared memory, samo message passing)ding (iskanje poti) na ločen thread (Worker), da ne blokira glavne igre.
---
*Status: Koda je trenutno stabilna in očiščena (7.12.2025).*