# Audio Library for Gooner Training Academy

This directory contains all audio files used in the game. The AudioManager will automatically discover and categorize audio files placed in the appropriate subdirectories.

## Background Music (Legacy)

The existing background music tracks are still available:
- **Colorful-Flowers(chosic.com).mp3** - Upbeat and energetic music
- **New-Beginnings-chosic.com_.mp3** - Ambient and inspiring music  
- **storm-clouds-purpple-cat(chosic.com).mp3** - Intense and dramatic music
- **Tokyo-Music-Walker-Brunch-For-Two-chosic.com_.mp3** - Calm and peaceful music

## New Audio System Structure

```
/audio/
  /tasks/               # Audio that plays during edging tasks
    /teasing/          # Light, teasing audio for building arousal
      - tease1.mp3     # Soft whispers, light moaning
      - tease2.mp3     # Gentle encouragement, sultry voices
      - whisper1.mp3   # ASMR-style teasing whispers
    
    /intense/          # More aggressive audio for advanced tasks
      - intense1.mp3   # Heavy breathing, intense moaning
      - intense2.mp3   # Urgent whispers, building intensity
      - heavy_breathing.mp3
    
    /instructions/     # Verbal JOI-style commands
      - stroke_slow.mp3  # "Stroke slowly for me..."
      - stroke_fast.mp3  # "Faster! Don't stop!"
      - stop_now.mp3     # "Stop! Hands off!"

  /punishments/         # Audio when punishment popups appear
    /denial/           # Frustration and denial audio
      - no_no_no.mp3   # "No, no, no! You don't get to cum!"
      - denied.mp3     # "Denied! Try again!"
      - bad_boy.mp3    # "Bad boy! No touching!"
    
    /mocking/          # Teasing/mocking for skippers
      - pathetic.mp3   # "How pathetic..."
      - weak.mp3       # "Too weak to continue?"
      - try_again.mp3  # "Try again, if you can handle it"

  /rewards/             # Celebration audio for task completion
    /completion/
      - good_boy.mp3   # "Good boy! Well done!"
      - well_done.mp3  # "Excellent work!"
      - reward1.mp3    # Positive reinforcement audio

  /ambient/             # Background/atmospheric audio (optional)
    /background/
      - ambient1.mp3   # Subtle background audio
      - ambient2.mp3   # Atmospheric soundscapes
```

## Supported Formats

- **MP3**: Recommended (best compatibility)
- **WAV**: High quality, larger files
- **OGG**: Good compression, modern browsers

## File Naming Conventions

- Use descriptive names (e.g., `soft_whisper.mp3`, `intense_breathing.mp3`)
- Avoid spaces (use underscores: `stroke_fast.mp3`)
- Keep names concise but clear
- Use lowercase for consistency

## Audio Guidelines

### Task Audio (`/tasks/`)
- **Duration**: 30 seconds to 3 minutes
- **Volume**: Recorded at consistent levels
- **Content**: Encouraging, teasing, instructional
- **Quality**: Clear audio, minimal background noise

### Punishment Audio (`/punishments/`)
- **Duration**: 5-30 seconds (punchy and immediate)
- **Content**: Denial, mocking, correction
- **Tone**: Dominant, disapproving, teasing

### Reward Audio (`/rewards/`)
- **Duration**: 5-15 seconds
- **Content**: Praise, encouragement, satisfaction
- **Tone**: Positive, affirming, proud

## Usage in Game

The AudioManager will:
1. **Auto-discover** all audio files in these directories
2. **Randomly select** from available files in each category
3. **Respect volume settings** and user preferences
4. **Fade in/out** for smooth transitions
5. **Allow previewing** in the settings menu

## Getting Started

1. **Add your first audio files** to `/tasks/teasing/` and `/punishments/denial/`
2. **Test in-game** - audio will be discovered automatically
3. **Adjust volumes** in the game's Options > Audio menu
4. **Add more files** as needed for variety

## Pro Tips

- **Layer experiences**: Combine teasing task audio with denial punishment audio
- **Build tension**: Use progression from teasing to intense categories
- **Create variety**: Multiple files in each category prevent repetition
- **Test volumes**: Ensure audio doesn't overpower or get lost
- **Consider timing**: Match audio duration to typical task lengths

## Technical Notes

- Audio files are loaded on-demand (not preloaded)
- Web Audio API used for precise volume control
- Cross-fade capabilities for smooth transitions
- Category-based enable/disable for user control
- Preview functionality for settings menu

Add your audio files to the appropriate directories and they'll be automatically integrated into the game experience!