📚 DOCUMENTATION COMPLETE: AUDIO_ASSET_MANIFEST.md (61 files detailed) and VFX_IMPLEMENTATION_GUIDE.md (6 systems with code examples). Ready for asset production phase.

2026-01-05 19:29:14 +01:00
parent 370c527fcd
commit 1e74086fa3
10 changed files with 2168 additions and 4 deletions
--- a/docs/AUDIO_ASSET_MANIFEST.md
+++ b/docs/AUDIO_ASSET_MANIFEST.md
@@ -0,0 +1,219 @@
+# 🎵 AUDIO ASSET MANIFEST
+**Project:** Mrtva Dolina (DolinaSmrti)  
+**Last Updated:** 2026-01-05 19:27 CET  
+**Total Audio Files:** 61
+
+---
+
+## 📂 **AUDIO STRUCTURE**
+
+```
+assets/audio/
+├── music/          (8 tracks)
+├── ambience/       (12 loops)
+├── sfx/            (25 effects)
+├── voices/         (11 NPC voice packs)
+└── ui/             (5 interface sounds)
+```
+
+---
+
+## 🎼 **1. MUSIC (8 tracks)**
+
+| Track | Type | Duration | Mood | Loop | Status |
+|-------|------|----------|------|------|--------|
+| **main_theme.ogg** | Theme | 3:00 | Epic/Dark | Yes | 🔴 Needed |
+| **farm_ambient.ogg** | Background | 2:30 | Peaceful/Rustic | Yes | 🔴 Needed |
+| **combat_theme.ogg** | Action | 2:00 | Intense/Fast | Yes | 🔴 Needed |
+| **raid_warning.ogg** | Alert | 1:30 | Tense/Urgent | Yes | 🔴 Needed |
+| **town_theme.ogg** | Background | 2:45 | Hopeful/Building | Yes | 🔴 Needed |
+| **night_theme.ogg** | Background | 2:15 | Mysterious/Eerie | Yes | 🔴 Needed |
+| **victory_theme.ogg** | Reward | 0:45 | Triumphant | No | 🔴 Needed |
+| **ana_theme.ogg** | Emotional | 2:30 | Melancholic/Hope | Yes | 🔴 Needed |
+
+**Specifications:**
+- Format: OGG Vorbis (compressed)
+- Sample Rate: 44.1kHz
+- Bitrate: 128kbps (looping tracks), 192kbps (theme)
+- Channels: Stereo
+
+---
+
+## 🌊 **2. AMBIENCE (12 loops)**
+
+| Ambience | Environment | Loop | Status |
+|----------|-------------|------|--------|
+| **wind_soft.ogg** | Outdoor/Day | Yes | 🔴 Needed |
+| **wind_strong.ogg** | Outdoor/Storm | Yes | 🔴 Needed |
+| **rain_light.ogg** | Weather | Yes | 🔴 Needed |
+| **rain_heavy.ogg** | Weather | Yes | 🔴 Needed |
+| **crickets.ogg** | Night | Yes | 🔴 Needed |
+| **birds_chirping.ogg** | Day | Yes | 🔴 Needed |
+| **fire_crackling.ogg** | Indoor/Campfire | Yes | 🔴 Needed |
+| **water_stream.ogg** | River/Lake | Yes | 🔴 Needed |
+| **zombie_moans_distant.ogg** | Danger Zone | Yes | 🔴 Needed |
+| **town_bustle.ogg** | Populated Area | Yes | 🔴 Needed |
+| **workshop_ambient.ogg** | Building Interior | Yes | 🔴 Needed |
+| **forest_ambient.ogg** | Biome | Yes | 🔴 Needed |
+
+**Specifications:**
+- Format: OGG Vorbis
+- Sample Rate: 44.1kHz
+- Bitrate: 96kbps (ambient loops)
+- Seamless Loop: Required
+- Duration: 30-60 seconds per loop
+
+---
+
+## 🔊 **3. SOUND EFFECTS (25 files)**
+
+### **Farming (8 SFX)** ✅
+| SFX | Use Case | Status |
+|-----|----------|--------|
+| **dig.ogg** | Digging/Hoeing | ✅ Exists |
+| **plant_seed.ogg** | Planting | ✅ Exists |
+| **harvest.ogg** | Crop harvest | ✅ Exists |
+| **water_crop.ogg** | Watering can | 🔴 Needed |
+| **tree_chop.ogg** | Axe on tree | 🔴 Needed |
+| **stone_mine.ogg** | Pickaxe on stone | 🔴 Needed |
+| **scythe_swing.ogg** | Harvesting tool | 🔴 Needed |
+| **cow_moo.ogg** | Farm animal | 🔴 Needed |
+
+### **Combat (8 SFX)**
+| SFX | Use Case | Status |
+|-----|----------|--------|
+| **sword_slash.ogg** | Melee attack | 🔴 Needed |
+| **zombie_hit.ogg** | Enemy damage | 🔴 Needed |
+| **zombie_death.ogg** | Enemy killed | 🔴 Needed |
+| **player_hurt.ogg** | Player damage | 🔴 Needed |
+| **raider_attack.ogg** | Raider swing | 🔴 Needed |
+| **shield_block.ogg** | Blocking | 🔴 Needed |
+| **bow_release.ogg** | Ranged attack | 🔴 Needed |
+| **explosion.ogg** | Bomb/Trap | 🔴 Needed |
+
+### **Building (5 SFX)**
+| SFX | Use Case | Status |
+|-----|----------|--------|
+| **hammer_nail.ogg** | Construction | 🔴 Needed |
+| **door_open.ogg** | Building entry | 🔴 Needed |
+| **door_close.ogg** | Building exit | 🔴 Needed |
+| **chest_open.ogg** | Loot access | 🔴 Needed |
+| **repair.ogg** | Fixing structures | 🔴 Needed |
+
+### **Misc (4 SFX)**
+| SFX | Use Case | Status |
+|-----|----------|--------|
+| **footstep_grass.ogg** | Walking | 🔴 Needed |
+| **footstep_stone.ogg** | Walking | 🔴 Needed |
+| **coin_collect.ogg** | Currency pickup | 🔴 Needed |
+| **level_up.ogg** | XP milestone | 🔴 Needed |
+
+**Specifications:**
+- Format: OGG Vorbis
+- Sample Rate: 44.1kHz
+- Bitrate: 128kbps
+- Duration: 0.1-2 seconds
+- No silence padding
+
+---
+
+## 🗣️ **4. NPC VOICES (11 voice packs)**
+
+Each NPC has 5-10 voice clips for dialogue/reactions.
+
+| NPC | Voice Type | Clips | Status |
+|-----|------------|-------|--------|
+| **Kai Marković** | Young Male, Gruff | 10 | 🔴 Needed |
+| **Ana Marković** | Young Female, Soft | 10 | 🔴 Needed |
+| **Ivan Kovač** | Middle-aged Male, Tough | 8 | 🔴 Needed |
+| **Teacher** | Female, Mature | 8 | 🔴 Needed |
+| **Mayor** | Male, Authoritative | 8 | 🔴 Needed |
+| **Kustos** | Male, Scholarly | 8 | 🔴 Needed |
+| **Pek** | Male, Jolly | 6 | 🔴 Needed |
+| **Šivilja** | Female, Kind | 6 | 🔴 Needed |
+| **Tehnik** | Male, Nerdy | 6 | 🔴 Needed |
+| **Arborist** | Male, Calm | 6 | 🔴 Needed |
+| **Priest** | Male, Somber | 6 | 🔴 Needed |
+
+**Voice Clip Types:**
+- Greeting (1-2 clips)
+- Quest Start (1 clip)
+- Quest Complete (1 clip)
+- Trading (1 clip)
+- Reaction/Filler (2-4 clips)
+
+**Specifications:**
+- Format: OGG Vorbis
+- Sample Rate: 44.1kHz
+- Bitrate: 96kbps (voice)
+- Duration: 1-3 seconds per clip
+- Normalize audio levels
+
+---
+
+## 🖱️ **5. UI SOUNDS (5 files)**
+
+| UI Sound | Use Case | Status |
+|----------|----------|--------|
+| **button_click.ogg** | Menu interaction | 🔴 Needed |
+| **button_hover.ogg** | Menu hover | 🔴 Needed |
+| **notification.ogg** | Alert popup | 🔴 Needed |
+| **quest_complete.ogg** | Achievement | 🔴 Needed |
+| **error.ogg** | Invalid action | 🔴 Needed |
+
+**Specifications:**
+- Format: OGG Vorbis
+- Sample Rate: 44.1kHz
+- Bitrate: 128kbps
+- Duration: 0.1-0.5 seconds
+- Clean, no reverb
+
+---
+
+## 📋 **AUDIO PRODUCTION NOTES**
+
+### **Voice Recording:**
+- Use Edge TTS (Microsoft Azure) for NPC voices
+- Slovenian language for authentic feel
+- ADHD-friendly: Short, punchy clips (1-3s max)
+
+### **Music Generation:**
+- AI-assisted composition (Suno AI, AIVA)
+- Dark folk/post-apocalyptic style
+- Seamless loops required
+
+### **SFX Sources:**
+- Freesound.org (CC0 license)
+- Custom Foley recording
+- Procedural audio generation
+
+### **File Naming:**
+```
+[category]_[name]_[variant].ogg
+
+Examples:
+music_main_theme.ogg
+sfx_dig_01.ogg
+voice_kai_greeting_01.ogg
+ambience_rain_light_loop.ogg
+ui_button_click.ogg
+```
+
+---
+
+## ✅ **COMPLETED AUDIO (3/61)**
+
+1. ✅ dig.ogg
+2. ✅ plant_seed.ogg
+3. ✅ harvest.ogg
+
+---
+
+## 🔴 **NEEDED AUDIO (58/61)**
+
+**Priority Order:**
+1. **High:** Combat SFX (8), UI sounds (5), Main theme (1)
+2. **Medium:** Farming SFX (5), Ambience (12), Building SFX (5)
+3. **Low:** NPC voices (82 clips), Additional music (7)
+
+**Est. Production Time:** 20-30 hours for full audio implementation