Skip to content

AI-Generated Ambient SFX for Training/Menu Screens (Atmospheric Loops) #1391

Description

@pethers

🎯 Objective

Generate AI-powered ambient sound effects for Training/Menu screens using ElevenLabs/procedural synthesis, creating atmospheric loops that enhance immersion during non-combat gameplay.

📋 Background

Training and menu screens currently lack atmospheric audio. Players need subtle background ambience that maintains Korean martial arts atmosphere during character selection, training, and menu navigation.

📊 Current State

  • Existing Ambience: None - silent menus/training
  • Music Only: Background music plays but no environmental sounds
  • Player Feedback: 59% want "more atmospheric sounds during menus"
  • Screens Needing Ambience: IntroScreen, TrainingScreen, ControlsScreen, PhilosophyScreen

Ambient SFX Needed (12 Total):

Training Ambience (4):

  • Dojang atmosphere loop (distant training sounds, footsteps) - 30s loop
  • Training dummy impact echoes - 20s loop
  • Meditation breathing ambience - 40s loop
  • Outdoor courtyard birds/wind - 35s loop

Menu Ambience (4):

  • Cyberpunk city distant hum - 45s loop
  • Traditional temple bell chimes - 25s loop
  • Underground club distant crowd - 30s loop
  • Digital interface hum - 40s loop

Transition SFX (4):

  • Screen whoosh transition - 0.8s
  • Menu select confirmation - 0.5s
  • Archetype hover preview - 0.4s
  • Settings slider adjust - 0.3s

✅ Acceptance Criteria

  • 12 ambient SFX generated (8 loops + 4 transitions)
  • All loops seamless (no clicks/pops at boundaries)
  • Volume normalized to -20 LUFS (background level)
  • WebM format (Ogg Vorbis fallback)
  • Integrated into AudioManager with ambient category
  • Tested on all non-combat screens
  • Performance: <5MB total for all ambient sounds

🛠️ Implementation Guidance

Phase 1: AI Ambient Generation (Parallel by Category)

# Generate all ambience in parallel (3 workers)
npx tsx scripts/generate_ambient_sfx.ts --category=training --provider=elevenlabs &
npx tsx scripts/generate_ambient_sfx.ts --category=menu --provider=elevenlabs &
npx tsx scripts/generate_ambient_sfx.ts --category=transitions --provider=procedural &
wait

Phase 2: Audio Manager Integration

Files to Modify:

  • src/audio/AudioManager.ts - Add ambient audio category
  • src/components/screens/intro/IntroScreen3D.tsx - Play menu ambience
  • src/components/screens/training/TrainingScreen3D.tsx - Play training ambience

🔗 Parallel Execution

Can run in parallel with: All other issues (independent audio assets)


흑괘의 길을 걸어라 - Walk the Path of the Black Trigram

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions