novafarma/docs/SOUND_TESTING_GUIDE.md

🎵 SOUND EFFECTS - TESTING GUIDE

Phase 23 Implementation - 12.12.2025

---

🚀 KAKO ZAGNATI IGRO:

Način 1: Web Server (Priporočeno)

node server.js

Nato odpri: http://localhost:3000

Način 2: Electron

npm start

Način 3: Direktno (index.html)

Odpri index.html v brskalniku (Chrome/Firefox)

---

🔊 TESTIRANJE ZVOČNIH EFEKTOV:

1. FARMING SOUNDS 🌾

DIG Sound (Till Soil)

1. Hodi po zeleni travi
2. Pritisni SPACE tipko
3. Zvok: Low thud (80Hz → 10Hz, 150ms)
4. Vizualno: Zemlja postane obdelana (tilled soil)

PLANT Sound (Plant Seeds)

1. Stopi na obdelano zemljo (tilled soil)
2. Pritisni SPACE tipko
3. Zvok: Soft triangle wave (300Hz, 120ms)
4. Vizualno: Seme se posadi (crop stage 0)

HARVEST Sound (Harvest Crops)

1. Počakaj, da rastlina zraste (ali uporabi time speed 5x)
2. Stopi na zrelo rastlino
3. Pritisni SPACE tipko
4. Zvok: Dual-tone melody (523Hz + 659Hz, 160ms)
5. Vizualno: Rastlina izgine, dobiš gold

---

2. BUILD SOUNDS 🏗️

UI CLICK Sound (Building Selection)

1. Pritisni B za build mode
2. Pritisni 1, 2, 3, 4, ali 5
3. Zvok: Pleasant click (800Hz sine, 50ms)
4. Vizualno: Izbrana stavba se spremeni

BUILD Sound (Place Building)

1. V build mode-u premakni miško
2. Klikni na zeleno območje (valid placement)
3. Zvok: Deep square wave (80Hz, 200ms)
4. Vizualno: Stavba se postavi

Hotkeys:

• 1 - Fence Post
• 2 - Fence Horizontal
• 3 - Fence Vertical
• 4 - Fence Corner
• 5 - Barn

---

3. AMBIENT MUSIC 🎶

Avtomatsko predvajanje:

• Glasba se začne ob zagonu igre
• Stil: C Minor Pentatonic (proceduralno)
• Frekvence: 130.81Hz, 155.56Hz, 174.61Hz, 196.00Hz, 233.08Hz, 261.63Hz
• Interval: Vsake 2 sekundi (40% chance za noto)
• Trajanje note: 2 sekunde (long decay)

Kontrole:

• M - Mute/Unmute (če je implementirano)

---

🎮 VSI ZVOČNI EFEKTI:

#	Akcija	Tipka	Zvok	Frekvenca	Trajanje
1	Till Soil	SPACE	Dig	80Hz → 10Hz	150ms
2	Plant Seed	SPACE	Plant	300Hz	120ms
3	Harvest Crop	SPACE	Harvest	523Hz + 659Hz	160ms
4	Select Building	1-5	UI Click	800Hz	50ms
5	Place Building	Click	Build	80Hz	200ms
6	Background	Auto	Music	C Minor	Continuous

---

🐛 TROUBLESHOOTING:

Ni zvoka?

1. Preveri volume: Zvok računalnika ni na mute
2. Preveri brskalnik: Chrome/Firefox podpirata Web Audio API
3. Preveri konzolo: Odpri Developer Tools (F12) → Console
4. Preveri SoundManager: V konzoli vpiši gameScene.soundManager.isMuted

Zvok je pretiho?

V konzoli vpiši:

gameScene.soundManager.sfxVolume = 1.0; // Povečaj na 100%

Zvok je preglasn?

V konzoli vpiši:

gameScene.soundManager.sfxVolume = 0.3; // Zmanjšaj na 30%

Izklopi glasbo:

V konzoli vpiši:

gameScene.soundManager.stopMusic();

Vklopi glasbo:

V konzoli vpiši:

gameScene.soundManager.startMusic();

---

📊 TEHNIČNE PODROBNOSTI:

Web Audio API:

• Vsi zvoki so proceduralno generirani
• Ni potrebe po zunanjih .mp3/.wav datotekah
• Deluje v vseh modernih brskalnikih

Oscillator Types:

• Sine: Mehak, čist zvok (UI click, harvest, music)
• Triangle: Mehak, topel zvok (dig, plant)
• Square: Oster, retro zvok (build)
• Sawtooth: Hrapav, agresiven zvok (attack)

Volume Control:

• musicVolume: 0.3 (30%)
• sfxVolume: 0.5 (50%)
• isMuted: false

---

✅ CHECKLIST ZA TESTIRANJE:

• Dig sound deluje (till soil)
• Plant sound deluje (plant seeds)
• Harvest sound deluje (harvest crops)
• UI click sound deluje (building selection)
• Build sound deluje (place building)
• Background music se predvaja
• Volume je primeren
• Ni napak v konzoli

---

🎯 NASLEDNJI KORAKI:

Po uspešnem testiranju:

1. Phase 24: Inventory Hotbar (Q/E tool swap)
2. Phase 25: Stamina System
3. Phase 26: Advanced Build Mode (rotate, confirm, cancel)

---

Datum: 12.12.2025
Verzija: Phase 23 Complete
Status: ✅ Ready for testing!