GTA
/
training-academy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 2 Wiki Activity
training-academy/audio
History
dilgenfritz 84b17a7930 Implement simplified XP system with overall counter 
- Replace scoring system with XP-based progression
- Task-based XP: 2 XP per regular task, 5 XP per scenario step
- Overall XP counter for rankings/leveling (persistent across sessions)
- No overall XP awarded for quit/abandoned sessions (only completed sessions)
- Session XP always displayed but only added to overall on completion
- Simplified from time/activity bonuses to pure task completion rewards
- Updated UI with dual XP display: Session XP / Total XP
- Audio playlist system continues in background during gameplay
 		2025-10-30 11:41:26 -05:00
..
README.md Save current state: Fixed text readability in scenarios and interactive tasks 2025-10-29 17:04:42 -05:00
TESTING.md Implement simplified XP system with overall counter 2025-10-30 11:41:26 -05:00

README.md

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!