# 🎵 SOUND EFFECTS - TESTING GUIDE

**Phase 23 Implementation** - 12.12.2025

---

## 🚀 **KAKO ZAGNATI IGRO:**

### **Način 1: Web Server (Priporočeno)**
```bash
node server.js
```
Nato odpri: `http://localhost:3000`

### **Način 2: Electron**
```bash
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:
```javascript
gameScene.soundManager.sfxVolume = 1.0; // Povečaj na 100%
```

### **Zvok je preglasn?**
V konzoli vpiši:
```javascript
gameScene.soundManager.sfxVolume = 0.3; // Zmanjšaj na 30%
```

### **Izklopi glasbo:**
V konzoli vpiši:
```javascript
gameScene.soundManager.stopMusic();
```

### **Vklopi glasbo:**
V konzoli vpiši:
```javascript
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!