Files

David Kotnik 23bf7ac119 🔊💎 COMPLETE AUDIO AUDIT + AudioManager System

✅ AUDIO AUDIT (AUDIO_AUDIT_COMPLETE.md):
- 410+ files mapped to scenes
- 10 music tracks (Kevin MacLeod)
- 45 voiceover files (EN + SL)
- 355 SFX files (estimated)

📊 SCENE MAPPING:
- SplashScene: Logo only
- IntroScene: All voices + ambient
- StoryScene: Main theme
- GameScene: All music/SFX

🎵 MUSIC TRACKS:
- farm_ambient → Grassland biome
- forest_ambient → Forest biome
- night_theme → Night time (8pm-6am)
- town_theme → Town areas
- combat_theme → Enemy detected
- ana_theme → Memory scenes
- raid_warning → Zombie raid
- victory_theme → Quest complete

🎤 VOICEOVER:
- Kai: 12 EN + 12 SL (Christopher Neural)
- Ana: 8 EN + 8 SL (Aria Neural)
- Gronk: 1 EN + 1 SL (Ryan Neural UK)

✅ AUDIO MANAGER (AudioManager.js):
- Singleton pattern
- Debug logging mode
- Console output format:
  🎵 [MUSIC] Playing: farm_ambient.mp3
     Scene: GameScene
     Volume: 0.7
     Loop: true

FEATURES:
- playMusic(key, options)
- playVoice(key, subtitle)
- playSFX(key, options)
- crossfadeMusic(newKey, duration)
- Volume controls (music/voice/sfx)
- Mute/unmute all
- Kevin MacLeod attribution tracking
- Priority system
- Helper methods:
  - playUI(action)
  - playFarming(action)
  - playAnimal(type)
  - playSpecial(event)

🐛 DEBUG MODE:
- Set debugMode = true/false
- Logs every playback to console
- Shows: file, scene, volume, duration, trigger
- Easy debugging of audio issues

📝 ATTRIBUTION:
- Kevin MacLeod (CC BY 3.0)
- Microsoft Azure Edge TTS voices
- Auto-tracked in AudioManager

🎯 USAGE:
import audioManager from './systems/AudioManager.js';
audioManager.init(this);
audioManager.playMusic('farm');
audioManager.playSFX('harvest', { trigger: 'wheat' });

TOTAL: 410+ files organized & ready!

2026-01-10 22:19:21 +01:00