training-academy/audio/README.md

4.4 KiB

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!