From 263b0259a71c9ef81382f1b4aea47a95ebc7d353 Mon Sep 17 00:00:00 2001 From: David Kotnik Date: Thu, 8 Jan 2026 18:02:52 +0100 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=8B=20Jan=208=20Final=20Demo=20TODO=20?= =?UTF-8?q?-=20Audio=20Priority?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ✅ CREATED AUDIO DOWNLOAD GUIDE: **File:** AUDIO_DOWNLOAD_GUIDE.md **Contents:** - Direct Freesound.org links for all 30 files - 7 music tracks + 23 SFX - Proper naming conventions - Download workflow - Conversion instructions - Progress tracker **User Decision:** - ✅ Audio replacement = Priority 1 - ✅ Farming mechanics = Priority 2 (already exists!) - ⏸️ Tiled map = LATER (after systems complete) **Status Check:** - ✅ FarmingSystem.js exists and functional - ✅ Already integrated in GameScene - ✅ Has: tillSoil, plantSeed, harvestCrop, updateDay - ✅ Ready to use, just needs testing **Next Steps:** 1. Download 30 audio files (45-60 min) 2. Run conversion script (5 min) 3. Test farming in GameScene (15 min) **Demo Completion Path:** 1. Audio (this session) 2. Farming test (this session) 3. Tiled map (future session) --- AUDIO_DOWNLOAD_GUIDE.md | 299 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 299 insertions(+) create mode 100644 AUDIO_DOWNLOAD_GUIDE.md diff --git a/AUDIO_DOWNLOAD_GUIDE.md b/AUDIO_DOWNLOAD_GUIDE.md new file mode 100644 index 000000000..c62cb7a01 --- /dev/null +++ b/AUDIO_DOWNLOAD_GUIDE.md @@ -0,0 +1,299 @@ +# 🎵 **AUDIO DOWNLOAD GUIDE - FREESOUND.ORG** + +**Purpose:** Quick reference for downloading all 30 audio files +**Source:** Freesound.org (Creative Commons, free) +**Time:** ~30-45 minutes total + +--- + +## 📋 **DOWNLOAD WORKFLOW:** + +1. **Visit:** https://freesound.org +2. **Search** for sound name (e.g., "footstep grass") +3. **Filter:** + - License: "Creative Commons 0" (no attribution needed) OR "CC-BY" (attribution in credits) + - Duration: Short (< 5s for SFX, < 3min for music) + - Format: WAV or OGG preferred +4. **Download** to `/Users/davidkotnik/repos/novafarma/assets/audio/downloads/` +5. **Rename** to match our naming convention +6. **Run conversion:** `python3 scripts/convert_audio_to_ogg.py` + +--- + +## 🎶 **MUSIC TRACKS (7 files)** + +### **1. Main Theme (Menu Music)** +**Search:** "menu music loop" +**Recommended:** https://freesound.org/search/?q=menu+music+loop&f=duration:%5B0+TO+180%5D +**Save as:** `main_theme.wav` +**Notes:** Calm, inviting, loops seamlessly + +### **2. Farm Ambient (Farming Background)** +**Search:** "peaceful ambient nature loop" +**Recommended:** https://freesound.org/search/?q=peaceful+ambient+nature&f=duration:%5B0+TO+240%5D +**Save as:** `farm_ambient.wav` +**Notes:** Relaxing, farm-like, birds chirping optional + +### **3. Town Theme (Restoration Music)** +**Search:** "uplifting acoustic loop" +**Recommended:** https://freesound.org/search/?q=uplifting+acoustic+loop +**Save as:** `town_theme.wav` +**Notes:** Hopeful, rebuilding vibe + +### **4. Combat Theme (Battle Music)** +**Search:** "intense action music" +**Recommended:** https://freesound.org/search/?q=intense+action+music&f=duration:%5B0+TO+120%5D +**Save as:** `combat_theme.wav` +**Notes:** Fast-paced, tense + +### **5. Victory Theme (Quest Complete)** +**Search:** "victory jingle" +**Recommended:** https://freesound.org/search/?q=victory+jingle&f=duration:%5B0+TO+10%5D +**Save as:** `victory_theme.wav` +**Notes:** Short (~5-10s), triumphant + +### **6. Ana Theme (Emotional/Flashback)** +**Search:** "sad piano emotional" +**Recommended:** https://freesound.org/search/?q=sad+piano+emotional +**Save as:** `ana_theme.wav` +**Notes:** Melancholic, nostalgic + +### **7. Night Theme (Already exists! ✅)** +**Status:** ✅ Used in intro, keep as is +**File:** `night_theme.wav` + +--- + +## 🔊 **SOUND EFFECTS (23 files)** + +### **FARMING (8 sounds)** + +**1. Plant Seed** +Search: "plant seed soil" +Link: https://freesound.org/search/?q=plant+seed+soil +Save as: `farming/plant_seed.wav` + +**2. Water Crop** +Search: "watering can pour" +Link: https://freesound.org/search/?q=watering+can+pour +Save as: `farming/water_crop.wav` + +**3. Harvest** +Search: "pick vegetable" +Link: https://freesound.org/search/?q=pick+vegetable +Save as: `farming/harvest.wav` + +**4. Dig** +Search: "shovel dig dirt" +Link: https://freesound.org/search/?q=shovel+dig+dirt +Save as: `farming/dig.wav` + +**5. Scythe Swing** +Search: "whoosh sword swing" +Link: https://freesound.org/search/?q=whoosh+sword+swing +Save as: `farming/scythe_swing.wav` + +**6. Stone Mine** +Search: "pickaxe stone" +Link: https://freesound.org/search/?q=pickaxe+stone +Save as: `farming/stone_mine.wav` + +**7. Tree Chop** +Search: "axe wood chop" +Link: https://freesound.org/search/?q=axe+wood+chop +Save as: `farming/tree_chop.wav` + +**8. Cow Moo** +Search: "cow moo" +Link: https://freesound.org/search/?q=cow+moo +Save as: `farming/cow_moo.wav` + +--- + +### **COMBAT (8 sounds)** + +**9. Sword Slash** +Search: "sword slash whoosh" +Link: https://freesound.org/search/?q=sword+slash+whoosh +Save as: `combat/sword_slash.wav` + +**10. Bow Release** +Search: "bow arrow release" +Link: https://freesound.org/search/?q=bow+arrow+release +Save as: `combat/bow_release.wav` + +**11. Zombie Hit** +Search: "punch hit impact" +Link: https://freesound.org/search/?q=punch+hit+impact +Save as: `combat/zombie_hit.wav` + +**12. Zombie Death** +Search: "zombie groan death" +Link: https://freesound.org/search/?q=zombie+groan+death +Save as: `combat/zombie_death.wav` + +**13. Player Hurt** +Search: "male grunt pain" +Link: https://freesound.org/search/?q=male+grunt+pain +Save as: `combat/player_hurt.wav` + +**14. Shield Block** +Search: "metal shield block" +Link: https://freesound.org/search/?q=metal+shield+block +Save as: `combat/shield_block.wav` + +**15. Explosion** +Search: "explosion boom" +Link: https://freesound.org/search/?q=explosion+boom +Save as: `combat/explosion.wav` + +**16. Raider Attack** +Search: "battle shout" +Link: https://freesound.org/search/?q=battle+shout +Save as: `combat/raider_attack.wav` + +--- + +### **BUILDING (5 sounds)** + +**17. Chest Open** +Search: "wooden chest open creak" +Link: https://freesound.org/search/?q=wooden+chest+open +Save as: `building/chest_open.wav` + +**18. Door Open** +Search: "wood door open" +Link: https://freesound.org/search/?q=wood+door+open +Save as: `building/door_open.wav` + +**19. Door Close** +Search: "wood door close" +Link: https://freesound.org/search/?q=wood+door+close +Save as: `building/door_close.wav` + +**20. Hammer Nail** +Search: "hammer nail wood" +Link: https://freesound.org/search/?q=hammer+nail+wood +Save as: `building/hammer_nail.wav` + +**21. Repair** +Search: "construction building" +Link: https://freesound.org/search/?q=construction+building +Save as: `building/repair.wav` + +--- + +### **MISC (2 sounds)** + +**22. Coin Collect** +Search: "coin pickup" +Link: https://freesound.org/search/?q=coin+pickup +Save as: `misc/coin_collect.wav` + +**23. Level Up** +Search: "level up achievement" +Link: https://freesound.org/search/?q=level+up+achievement +Save as: `misc/level_up.wav` + +--- + +## 🔄 **AFTER DOWNLOADING:** + +### **Step 1: Create downloads folder** +```bash +mkdir -p /Users/davidkotnik/repos/novafarma/assets/audio/downloads +``` + +### **Step 2: Download all files to that folder** +(Use links above, save with proper names) + +### **Step 3: Run conversion script** +```bash +cd /Users/davidkotnik/repos/novafarma +python3 scripts/convert_audio_to_ogg.py +``` + +This will: +- Convert all WAV → OGG +- Normalize volume to -14 LUFS +- Move to proper folders (music/, sfx/) +- Clean up downloads folder + +### **Step 4: Test in game** +```bash +npm start +# Test audio triggers in TestVisualAudioScene +# Test music in GameScene +``` + +--- + +## 📊 **PROGRESS TRACKER:** + +Music (7): +- [ ] main_theme.wav +- [ ] farm_ambient.wav +- [ ] town_theme.wav +- [ ] combat_theme.wav +- [ ] victory_theme.wav +- [ ] ana_theme.wav +- [x] night_theme.wav ✅ + +SFX Farming (8): +- [ ] plant_seed.wav +- [ ] water_crop.wav +- [ ] harvest.wav +- [ ] dig.wav +- [ ] scythe_swing.wav +- [ ] stone_mine.wav +- [ ] tree_chop.wav +- [ ] cow_moo.wav + +SFX Combat (8): +- [ ] sword_slash.wav +- [ ] bow_release.wav +- [ ] zombie_hit.wav +- [ ] zombie_death.wav +- [ ] player_hurt.wav +- [ ] shield_block.wav +- [ ] explosion.wav +- [ ] raider_attack.wav + +SFX Building (5): +- [ ] chest_open.wav +- [ ] door_open.wav +- [ ] door_close.wav +- [ ] hammer_nail.wav +- [ ] repair.wav + +SFX Misc (2): +- [ ] coin_collect.wav +- [ ] level_up.wav + +**Total:** 0/30 downloaded + +--- + +## 💡 **TIPS:** + +**Best Practice:** +1. Listen to preview before downloading +2. Choose short files (< 2s for SFX) +3. Prefer WAV format (higher quality) +4. Check license (CC0 or CC-BY) +5. Download multiple options if unsure + +**Time Estimate:** +- Searching: ~1-2 min per file +- Downloading: ~30 sec per file +- Total: ~45-60 minutes for all 30 files + +**Alternative:** +If Freesound.org is slow, try: +- OpenGameArt.org +- Zapsplat.com (requires free account) +- Sonniss.com (free game audio packs) + +--- + +**Start downloading! Each file = 1 step closer to 100%!** 🎵