David Kotnik
263b0259a7
✅ 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)
300 lines
7.5 KiB
Markdown
300 lines
7.5 KiB
Markdown
# 🎵 **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%!** 🎵
|