diff --git a/Gooner-Training-Academy-v0.5-Beta.zip b/Gooner-Training-Academy-v0.5-Beta.zip
new file mode 100644
index 0000000..c5e9ea8
Binary files /dev/null and b/Gooner-Training-Academy-v0.5-Beta.zip differ
diff --git a/Gooner-Training-Academy-v4.1-Beta.zip b/Gooner-Training-Academy-v4.1-Beta.zip
index eca3617..24dbeb1 100644
Binary files a/Gooner-Training-Academy-v4.1-Beta.zip and b/Gooner-Training-Academy-v4.1-Beta.zip differ
diff --git a/README.md b/README.md
index 34ab328..f37f984 100644
--- a/README.md
+++ b/README.md
@@ -1,438 +1,325 @@
# ๐ฎ Gooner Training Academy
-
-
*Master Your Dedication Through Advanced Training Systems*
+A comprehensive adult edging training application featuring **Campaign Mode** (30-level story progression), **Training Modules** (8 focused sessions), **Quick Play** (customizable sessions), and **Porn Cinema** (professional video player), with an advanced XP progression system and professional media library management.
+---
-A comprehensive adult edging training application featuring three specialized game modes, an advanced XP progression system, and professional media library management.
+## ๐ Quick Start
+### Desktop Application (Recommended)
+```bash
+npm install
+npm start
+```
+
+### Web Browser
+1. Open `index.html` in a modern browser
+2. Choose your game mode and begin
+3. Upload custom content via Library Management
+4. Configure settings in Options menu
+
+---
+
+## ๐ฎ Game Modes
+
+### ๐ Campaign Mode (30 Levels)
+**Structured story-driven progression across 6 narrative arcs**
+
+Experience a complete training journey from beginner to master through 30 carefully designed levels. Each arc tells a story while progressively introducing new skills and challenges.
+
+**Six Story Arcs:**
+- ๐ **Foundation (Levels 1-5)**: Edge training, rhythm, visual immersion, multi-tasking
+- ๐ **Immersion (Levels 6-10)**: Extended sessions, webcam activation, library building
+- ๐ฏ **Advanced Training (Levels 11-15)**: Hypno spirals, TTS commands, sensory overload
+- ๐ฅ **Intensity (Levels 16-20)**: Multi-screen porn, chaos mode, extreme endurance
+- ๐ง **Mind Control (Levels 21-25)**: Deep conditioning, advanced hypnosis, total immersion
+- ๐ **Mastery (Levels 26-30)**: Ultimate challenges, final tests, graduation
+
+**Features:**
+- Progressive difficulty with skill building
+- Story-driven instructor dialogue
+- Library integration (add directories, tag files)
+- Rhythm training with custom tempo sequences
+- Webcam positioning and photo sessions
+- Hypnotic visual effects and TTS narration
+- Multi-video chaos modes
+- Level-specific achievements and progression tracking
+
+**XP Rewards:**
+- โฑ๏ธ Time Training: **1 XP per 2 minutes**
+- ๐น Webcam Activity: **1 XP per minute**
+- ๐ธ Photo Session: **2 XP per photo**
+- ๐ฏ Level Completion Bonuses
+
+---
+
+### ๐๏ธ Training Modules (8 Focused Sessions)
+**Specialized 20-30 minute training experiences with rank-based unlocks**
+
+Each training module offers a focused, repeatable session designed to develop specific skills. Unlock new modules by increasing your rank through XP progression.
+
+**Available Modules:**
+- ๐ธ **Photo Session** (Tier 1 - Rank 1): Webcam-based photography with posing instructions
+- ๐ **Humiliation** (Tier 4 - Rank 10): Intense punishment and humiliation challenges
+
+**Coming Soon Modules:**
+- ๐ **Goon Loop** (Tier 1 - Rank 1): Endless edging cycles
+- ๐ต **Rhythm Training** (Tier 2 - Rank 3): Advanced rhythm patterns
+- ๐ **Worship Session** (Tier 2 - Rank 5): Dedicated worship training
+- ๐ฏ **JOI Session** (Tier 3 - Rank 7): Guided instruction sessions
+- ๐ฅ๏ธ **Multi-Screen** (Tier 3 - Rank 8): Multiple video streams
+- ๐ญ **Tease & Denial** (Tier 4 - Rank 12): Advanced edging challenges
+
+**Features:**
+- Rank-based progression system
+- Repeatable focused experiences
+- Specialized training for specific skills
+- Quick 20-30 minute sessions
+- Individual module statistics tracking
---
-
-
-## ๐ Quick Start
-
-
-
-### Desktop Application (Recommended)
-
-```bash
-
-npm install
-
-npm start
-
-```
-
-
-
-## ๐ Three Core Game Modes
-
-## ๐ฎ Game Modes
-
-### ๐ฌ Training Academy
-
-**Immersive scenario-based training with progressive storylines**
-
-
-
-The Training Academy offers structured training programs through branching narrative scenarios. Experience guided sessions with multiple specialized training modes:
-
-
-
-- **Photography Studio**: Webcam-based photography sessions with posing instructions
-
-- **Training Academy**: Core scenario-driven training with adaptive content### Web Browser
-
-- **Punishment Gauntlet**: Intense punishment and humiliation challenges
-
-- **Endurance Trials**: Progressive endurance training from beginner to expert levels
-
-
-
-**XP Rewards:**
-
-- ๐ธ Photo Session Completion: **2 XP per photo**
-
-- โฑ๏ธ Time-Based Training: **1 XP per 2 minutes**
-
-- ๐ฏ Scenario Completion Bonuses
-
-- ๐น Webcam Activities: **1 XP per minute**
-
-
-
### โก Quick Play
-
**Fast-start training with customizable sessions**
+Jump straight into action with fully customizable training sessions. Perfect for when you want immediate engagement without story progression.
**Session Setup:**
-
- โฐ Flexible Duration: 15 minutes to Endless hours
-
- ๐ฌ Background Video Integration: 40+ videos available
-
- ๐๏ธ Individual Task Controls: Enable/disable specific tasks
-
- ๐ฏ Custom Task Creation: Add personalized challenges
-
**XP Rewards:**
-
- โ Task Completion: **1-3 XP** (based on task duration)
-
- ๐ฏ Session Bonuses: **2 XP every 15 minutes**
-
- ๐น Recording Bonus: **+1 XP** when webcam recording enabled
-
-
**Features:**
-
- Real-time task filtering with persistent settings
-
- Background video with floating opacity controls
-
- Session cleanup and statistics tracking
-
- Webcam integration for photo capture
-
- Punishment system with consequence images
+---
### ๐ญ Porn Cinema
-
**Professional video viewing experience**
-
Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.
+**Features:**
- ๐ฌ Professional Video Interface: Full-screen theater mode
-
- ๐ Playlist Management: Organize viewing sessions
-
-
-
- ๐ Progress Tracking: Resume exactly where you left off
-
-
- ๐๏ธ Advanced Controls: Speed, volume, seeking, and more
-
-**XP Rewards:**
-
-- โฑ๏ธ Viewing Time: **1 XP per 5 minutes** of active viewing
-
-- โ Video Completion: **Bonus XP** for 90%+ completion
-
-- ๐ Binge Sessions: **Additional rewards** for extended viewing- Multiple training modes with unique content-
-
- Seamless integration with linked video directories
-
-- Watch time and completion analytics- Progressive difficulty scaling
-
+- Watch time and completion analytics
- Favorite video tracking
-
- Theater mode for distraction-free viewing
-
- Multi-format video support
-- Real-time XP tracking with status display
+**XP Rewards:**
+- โฑ๏ธ Viewing Time: **1 XP per 5 minutes** of active viewing
+- โ Video Completion: **Bonus XP** for 90%+ completion
+- ๐ Binge Sessions: **Additional rewards** for extended viewing
+
+---
### ๐ Experience Points (XP) Overview
-The XP system tracks your dedication and progress across all training modes, providing a unified progression metric.
-
+The XP system tracks your dedication and progress across all training modes, providing a unified progression metric that unlocks new Training Modules and tracks your overall dedication level.
### ๐ฏ XP Sources by Mode
| Mode | Activity | XP Reward | Notes |
|------|----------|-----------|-------|
-| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |
+| **Campaign Mode** | Time Training | 1 XP / 2 minutes | Passive time-based reward |
| | Webcam Activity | 1 XP / minute | Active engagement bonus |
| | Photo Session | 2 XP / photo | Achievement-based reward |
-| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |
+| | Level Completion | Bonus XP | Story progression rewards |
+| **Training Modules** | Module Completion | Variable | Based on module difficulty |
+| | Time Investment | 1 XP / 2 minutes | Consistent dedication |
+| | Special Tasks | Bonus XP | Module-specific achievements |
+| **Quick Play** | Task Completion | 1-3 XP | Duration-based scaling |
| | Session Bonus | 2 XP / 15 min | Consistency reward |
| | Recording Bonus | +1 XP | Additional engagement |
| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |
| | Video Completion | Bonus XP | 90%+ completion required |
-### ๐ Progression Levels
+### ๐ Progression & Ranks
-- **๐ฑ Beginner (0-100 XP)**: Learning the basics
-
-- **๐ Intermediate (100-500 XP)**: Building consistency
-
-- **๐ฏ Advanced (500-1500 XP)**: Mastering techniques
-
-- **๐ Expert (1500+ XP)**: Peak dedication
+**XP Levels:**
+- ๐ฑ **Beginner (0-100 XP)**: Learning the basics
+- ๐ **Intermediate (100-500 XP)**: Building consistency
+- ๐ฏ **Advanced (500-1500 XP)**: Mastering techniques
+- ๐ **Expert (1500+ XP)**: Peak dedication
+**Rank System** (Training Modules):
+- Higher XP unlocks higher-tier Training Modules
+- Ranks 1-3: Tier 1 modules (beginner)
+- Ranks 3-5: Tier 2 modules (intermediate)
+- Ranks 7-8: Tier 3 modules (advanced)
+- Ranks 10-12: Tier 4 modules (expert)
### ๐ XP Tracking
-
-- **Real-time Display**: Live XP counter in all game modes- Real-time XP tracking with status display
-
+- **Real-time Display**: Live XP counter in all game modes
- **Session Summaries**: XP earned per session with breakdowns
-
- **Statistics Dashboard**: Comprehensive XP analytics
-
- **Progress Visualization**: Charts and progression metrics
-
-## ๐ Library System Explained
+---
+## ๐ Library System
### ๐ฌ Video Library Management
-
The Library system provides centralized management for all your media content across game modes.
-
-
-### ๐ Library Organization
-
-- **Video Directories**- Real-time task filtering with persistent settings
-
+**Video Directories:**
- **Automatic Discovery**: Scans linked directories for video files
-
- **Format Support**: MP4, WebM, MOV, AVI, and more
-
- **Smart Indexing**: Automatic categorization and metadata
+- **Cross-Mode Access**: Available in all game modes
-- **Cross-Mode Access**: Available in all game modes- Session cleanup and statistics tracking
-
-- **Photo Collections**: Webcam integration for photo capture Content Management
-
+**Photo Collections:**
- **Upload System**: High-quality image upload (1600x1200 resolution)
-
- **Gallery Management**: Pinterest-style layout with aspect ratio optimization
-
-
-
-
-#### **Advanced Management**
-
-- **Bulk Operations**: Select, enable/disable, delete multiple files
-
-- **Dynamic Themes**: Library theme adapts to your uploaded content
-
- **Smart Compression**: Optimized storage without quality loss
-- **Video Integration**: Link external video directories for seamless playback
-
+**Advanced Management:**
+- **Bulk Operations**: Select, enable/disable, delete multiple files
+- **Dynamic Themes**: Library theme adapts to your uploaded content
+- **Tagging System**: Organize content with custom tags
- **Usage Analytics**: Track which content is most accessed
-
-#### **Integration Across Modes**
-
-- **Quick Play**:
- - Background video selection and task images
- - ๐ Playlist Management: Organize viewing sessions
- - ๐ฌ Background Video Integration: 40+ videos available
- - **High-Quality Processing**: 1600x1200 resolution with smart compression
-
-- **Training Academy**: Scenario content and photo sessions
-
-- **Porn Cinema**: Full video library access with playlists- ๐ Progress Tracking: Resume exactly where you left off
-
+**Integration Across Modes:**
+- **Campaign Mode**: Scenario content, video playback, photo sessions
+- **Training Modules**: Module-specific media selection
+- **Quick Play**: Background video selection and task images
+- **Porn Cinema**: Full video library access with playlists
- **Punishment System**: Consequence image selection
-- ๐ Multi-Screen Mode: 4-video grid for intensive sessions- ๐๏ธ Individual Task Controls: Enable/disable specific tasks
-
-
### ๐ Library Analytics
+- ๐ **Content Usage**: Most viewed/used media tracking
+- ๐พ **Storage Monitoring**: Space usage and optimization suggestions
+- ๐ **Sync Status**: Real-time directory scanning results
+- ๐ **Content Health**: Missing files and broken links detection
-- **๐ Content Usage**: Most viewed/used media tracking- ๐๏ธ Advanced Controls: Speed, volume, seeking, and more
-
-- **๐พ Storage Monitoring**: Space usage and optimization suggestions
-
-- **๐ Sync Status**: Real-time directory scanning results
-
-- **๐ Content Health**: Missing files and broken links detection
-
-
+---
### ๐ Data Protection
-
- **Automatic Backups**: Every 30 minutes during active sessions
-
- **Manual Backup/Restore**: Full control over your data
-
- **Export/Import**: Portable data management
-
- **Emergency Backups**: Before any reset operations
-**Features:**- โ Task Completion: **1-3 XP** (based on completion speed)
-
### ๐จ Customization
-
-- **6 Visual Themes**: Including dynamic Library theme- Seamless integration with linked video directories
-
+- **6 Visual Themes**: Including dynamic Library theme
- **Task Disable Toggles**: Individual control in Quick Play
-
-- **Adaptive Difficulty**: Progressive timer scaling- Watch time and completion analytics- ๐ฏ Session Bonuses: **2 XP every 15 minutes**### Desktop App (Recommended)
-
+- **Adaptive Difficulty**: Progressive timer scaling
- **Personal Content**: Upload and organize your media
-- Favorite video tracking
-
-### ๐ฅ๏ธ Technical Excellence
-
-- **Cross-Platform**: Windows, Mac, Linux support- Theater mode for distraction-free viewing- ๐น Recording Bonus: **+1 XP** when webcam recording enabled```bash
-
-- **Electron Desktop App**: Native OS integration
-
-- **Web Browser Compatible**: No installation required- Multi-format video support
-
-- **Professional UI**: Responsive, modern design
-
+---
## ๐ฏ Controls & Navigation
-
| Control | Action | Mode Availability |
-
|---------|--------|-------------------|
-
| **Enter** | Complete current task | All modes |
-
-| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |
-
+| **Ctrl** | Skip task (triggers punishment) | Campaign, Quick Play |
| **Space/P** | Pause/Resume session | All modes |
-
| **M** | Toggle background music | All modes |
-
| **H** | Show help menu | All modes |
-
| **Escape** | Close dialogs/return to menu | All modes |
-
---
-
-
## ๐ ๏ธ Technical Architecture
-
-
### ๐ Core Structure
-
```
-
-webGame/| Mode | Activity | XP Reward | Notes |- Webcam integration for photo capture1. Open `index.html` in a modern browser
-
+webGame/
โโโ index.html # Main hub and library management
-
-โโโ quick-play.html # Quick Play game mode|------|----------|-----------|-------|
-
-โโโ training-academy.html # Training Academy mode
-
-โโโ porn-cinema.html # Video player system| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |- Punishment system with consequence images2. Choose your game mode and begin
-
+โโโ campaign.html # Campaign Mode (30 levels)
+โโโ training-academy.html # Training Modules (8 sessions)
+โโโ quick-play.html # Quick Play game mode
+โโโ porn-cinema.html # Video player system
+โโโ library.html # Media library management
โโโ player-stats.html # Statistics dashboard
-
-โโโ user-profile.html # Profile and achievements| | Webcam Activity | 1 XP / minute | Active engagement bonus |
-
+โโโ user-profile.html # Profile and achievements
โโโ src/
-
-โ โโโ core/ # Game engine and state management| | Photo Session | 2 XP / photo | Achievement-based reward |3. Upload custom content via Image Management
-
+โ โโโ core/ # Game engine and state management
โ โโโ data/modes/ # Game mode configurations
-
-โ โโโ features/ # Modular feature systems| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |
-
+โ โโโ features/ # Modular feature systems
โ โ โโโ media/ # Video players and media management
-
-โ โ โโโ stats/ # XP and statistics tracking| | Session Bonus | 2 XP / 15 min | Consistency reward |---4. Configure settings in Options menu
-
+โ โ โโโ stats/ # XP and statistics tracking
โ โ โโโ tasks/ # Interactive task system
-
-โ โ โโโ ui/ # User interface components| | Recording Bonus | +1 XP | Additional engagement |
-
+โ โ โโโ ui/ # User interface components
โ โโโ styles/ # CSS themes and styling
-
-โ โโโ utils/ # Utility functions and helpers| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |
-
+โ โโโ utils/ # Utility functions and helpers
โโโ images/ # User-uploaded image library
-
-โโโ audio/ # Background music collection| | Video Completion | Bonus XP | 90%+ completion required |
-
-โโโ videos/ # Linked video directories
-
+โโโ audio/ # Background music collection
+โโโ videos/ # Linked video directories
+โโโ docs/ # Documentation
+ โโโ ACADEMY_PHASE1_COMPLETE.md
+ โโโ TRAINING_MODULES.md
+ โโโ MODULE_RANK_SYSTEM.md
+ โโโ LEVEL_STRUCTURE_TEMPLATE.md
+ โโโ GAME_STATS_PANEL_FIX.md
+ โโโ training-game-redesign/
```
-
-### ๐ Progression Levels
-
+### ๐ง System Requirements
- **Node.js 16+**: For Electron desktop application
-
- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+
-
- **Desktop Features**: File system access for media linking
-
- **Storage**: Minimum 100MB for application and user content
-
-
-
-
-
-## ๐ Recent Major Updates
-
-
-
-### v4.0 - Comprehensive Backup System (November 12, 2025)
-
-- โ **Automatic Data Protection**: 30-minute backup intervals
-
-- โ **Manual Backup Controls**: User-initiated backup/restore
-
-- โ **Export/Import System**: Portable data management
-
-- โ **Emergency Backup Hooks**: Before reset operations
-
-- โ **Data Loss Recovery**: Complete incident prevention system
-
-- **Session Summaries**: XP earned per session with breakdowns
-
-### v3.3 - Media Library Consolidation (November 11, 2025)
-
-- โ **Unified Gallery System**: Single media management interface- **Statistics Dashboard**: Comprehensive XP analytics**Player Features:**- **M** - Toggle music
-
-- โ **Dynamic Library Theme**: User content-based theming
-
-- โ **Pinterest Layout**: Aspect ratio-optimized image display- **Progress Visualization**: Charts and progression metrics
-
-- โ **Advanced Organization**: Smart categorization and bulk operations
-
-- ๐ฌ Professional Video Interface: Full-screen theater mode- **H** - Help menu
-
-### v3.2 - Quick Play Enhancement (November 6, 2025)
-
-- โ **Task Disable Toggles**: Individual task control system---
-
-- โ **Persistent Settings**: Configuration memory across sessions
-
-- โ **Real-time Filtering**: Dynamic task exclusion- ๐ Playlist Management: Organize viewing sessions- **Escape** - Close dialogs
-
-- โ **Enhanced Debugging**: Comprehensive logging system
-
-## ๐ Library System Explained
-
-### v3.1 - Background Video Integration (November 3, 2025)
-
-- โ **Seamless Video Playback**: Background videos during gameplay- ๐ Progress Tracking: Resume exactly where you left off
-
-- โ **Opacity Controls**: Floating video control system
-
-- โ **40+ Video Integration**: Comprehensive video library access### ๐ฌ Video Library Management
-
-- โ **Multi-Mode Support**: Video features across all game modes
-
-The Library system provides centralized management for all your media content across game modes.- ๐ Multi-Screen Mode: 4-video grid for intensive sessions## ๐ ๏ธ Technical
+### ๐ฅ๏ธ Technical Excellence
+- **Cross-Platform**: Windows, Mac, Linux support
+- **Electron Desktop App**: Native OS integration
+- **Web Browser Compatible**: No installation required
+- **Professional UI**: Responsive, modern design
+- **Modular Architecture**: Easy to extend and customize
---
+## ๐ Recent Major Updates
+### v4.1 - Campaign Mode & Training Modules (December 2025)
+- โ **Campaign Mode**: 30-level story progression across 6 arcs
+- โ **Training Modules**: 8 specialized focused training sessions
+- โ **Rank System**: XP-based module unlocking
+- โ **Level Structure Template**: Standardized level creation guide
+- โ **Advanced Rhythm Training**: Custom tempo sequences with beat timeline
+- โ **Game Stats Panel Fix**: Preserved UI consistency across all tasks
+- โ **Documentation**: Comprehensive guides for campaign and modules
+### v4.0 - Comprehensive Backup System (November 2025)
+- โ **Automatic Data Protection**: 30-minute backup intervals
+- โ **Manual Backup Controls**: User-initiated backup/restore
+- โ **Export/Import System**: Portable data management
+- โ **Emergency Backup Hooks**: Before reset operations
+- โ **Data Loss Recovery**: Complete incident prevention system
+
+### v3.3 - Media Library Consolidation (November 2025)
+- โ **Unified Gallery System**: Single media management interface
+- โ **Dynamic Library Theme**: User content-based theming
+- โ **Pinterest Layout**: Aspect ratio-optimized image display
+- โ **Advanced Organization**: Smart categorization and bulk operations
+
+### v3.2 - Quick Play Enhancement (November 2025)
+- โ **Task Disable Toggles**: Individual task control system
+- โ **Persistent Settings**: Configuration memory across sessions
+- โ **Real-time Filtering**: Dynamic task exclusion
+- โ **Enhanced Debugging**: Comprehensive logging system
+
+### v3.1 - Background Video Integration (November 2025)
+- โ **Seamless Video Playback**: Background videos during gameplay
+- โ **Opacity Controls**: Floating video control system
+- โ **40+ Video Integration**: Comprehensive video library access
+- โ **Multi-Mode Support**: Video features across all game modes
+
+---
diff --git a/docs/LEVEL_STRUCTURE_TEMPLATE.md b/docs/LEVEL_STRUCTURE_TEMPLATE.md
new file mode 100644
index 0000000..1017a57
--- /dev/null
+++ b/docs/LEVEL_STRUCTURE_TEMPLATE.md
@@ -0,0 +1,616 @@
+# Level Structure Template
+
+## Overview
+This document defines the standard structure and components for creating Training Academy campaign levels. Follow this template to ensure consistency across all levels.
+
+---
+
+## Level Data Structure
+
+### Basic Level Properties
+```javascript
+{
+ id: 'academy-level-X', // Unique identifier (academy-level-1, academy-level-2, etc.)
+ name: 'Level Title', // Display name (e.g., "Edge Training 101")
+ arc: 'Arc Name', // Story arc (Foundation, Immersion, Advanced Training, etc.)
+ level: X, // Level number (1, 2, 3, etc.)
+ duration: 300, // Estimated duration in seconds
+ interactiveType: 'scenario-adventure', // Always use this for campaign levels
+ interactiveData: {
+ // Scenario data here...
+ }
+}
+```
+
+---
+
+## Scenario Structure
+
+### Interactive Data Template
+```javascript
+interactiveData: {
+ title: 'Level X: Level Title', // Match the level name
+ steps: {
+ // Steps defined here...
+ }
+}
+```
+
+---
+
+## Step Types
+
+### 1. Story Step (Narrative/Dialogue)
+**Purpose**: Display story text without user interaction beyond continuing
+
+```javascript
+start: {
+ type: 'story',
+ mood: 'welcoming', // Options: welcoming, instructional, praising, anticipatory, intense, etc.
+ story: 'Your story text here. This displays to the player.',
+ nextStep: 'next_step_id'
+}
+```
+
+**Common Moods**:
+- `welcoming` - Friendly introduction
+- `instructional` - Teaching/guidance
+- `praising` - Positive reinforcement
+- `anticipatory` - Building excitement
+- `intense` - High energy/challenge
+- `satisfied` - Completion/success
+
+---
+
+### 2. Action Step (Interactive Task)
+**Purpose**: Execute an interactive task (edge, rhythm, library management, etc.)
+
+```javascript
+step_id: {
+ type: 'action',
+ mood: 'instructional',
+ story: 'Explanation of what the player will do.',
+ interactiveType: 'edge', // Type of interactive task
+ params: {
+ // Task-specific parameters
+ count: 5,
+ instruction: 'Edge 5 times - slowly and deliberately',
+ showTimer: true, // ALWAYS include for countdown timer display
+ preserveContent: false // Set to true if you want to append to existing content
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+---
+
+### 3. Completion Step
+**Purpose**: Mark level as complete and show completion message
+
+```javascript
+completion: {
+ type: 'completion',
+ mood: 'satisfied',
+ story: 'โ Level X Complete - Summary of achievements.',
+ outcome: 'levelX_complete'
+}
+```
+
+---
+
+## Standard Interactive Task Types
+
+### Edge Task
+**Purpose**: Edge training - stroke to the brink without release
+
+```javascript
+{
+ type: 'action',
+ mood: 'instructional',
+ story: 'Edge training instructions.',
+ interactiveType: 'edge',
+ params: {
+ count: 5, // Number of edges (optional)
+ duration: 300, // Duration in seconds (optional)
+ instruction: 'Edge 5 times - slowly and deliberately',
+ showTimer: true, // Show countdown timer in sidebar
+ preserveContent: false, // Whether to preserve existing content
+ keepVideoPlaying: false // Keep video player active
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Components Created**:
+- Edge instruction display
+- Start button
+- Dev skip button (auto-shown in dev mode)
+- Session duration display
+- Sidebar countdown timer (if showTimer: true)
+- Status messages
+
+---
+
+### Rhythm Task
+**Purpose**: Follow specific stroking rhythm patterns
+
+```javascript
+{
+ type: 'action',
+ mood: 'focused',
+ story: 'Follow the rhythm pattern.',
+ interactiveType: 'rhythm',
+ params: {
+ pattern: 'slow-fast-slow', // Pattern name (see patterns below)
+ duration: 180, // Duration in seconds
+ enableVideo: true, // Enable video playback
+ enableMetronomeSound: true, // Play metronome tick sounds
+ showTimer: true, // Show countdown timer in sidebar
+ multiPattern: [ // Optional: Multiple patterns in sequence
+ { pattern: 'fast-slow-fast', duration: 300 },
+ { pattern: 'varied-medium', duration: 360 }
+ ]
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Available Patterns**:
+- `slow-fast-slow` - [60, 80, 100, 120, 140, 120, 100, 80, 60] BPM
+- `fast-slow-fast` - [140, 120, 100, 80, 60, 80, 100, 120, 140] BPM
+- `steady` - [90, 90, 90, 90, 90, 90] BPM
+- `escalating` - [60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180] BPM
+- `varied-slow` - [70, 80, 90, 100, 0, 80, 90, 110, 100, 0, 70, 85, 95, 80, 100] BPM
+- `varied-medium` - [100, 120, 140, 160, 150, 0, 130, 150, 170, 140, 180, 0, 120, 160, 140, 180, 200] BPM
+- `varied-intense` - [140, 160, 180, 200, 0, 160, 180, 200, 220, 0, 180, 200, 220, 240, 0, 200, 220, 180, 240] BPM
+
+**Components Created**:
+- Pattern title display
+- BPM display
+- Phase indicator
+- Metronome visual (pulsing indicator)
+- Video player (if enableVideo: true)
+- Video controls (skip, volume)
+- Metronome volume control
+- Dev skip button
+- Sidebar countdown timer
+
+---
+
+### Rhythm Training Task (Advanced)
+**Purpose**: Advanced rhythm training with custom tempo sequences
+
+```javascript
+{
+ type: 'action',
+ mood: 'intense',
+ story: 'Advanced rhythm training with varying tempo.',
+ interactiveType: 'rhythm-training',
+ params: {
+ duration: 180,
+ enableVideo: false,
+ showTimer: true,
+ tempoSequence: [
+ { tempo: 60, duration: 25.71 }, // Slow warmup
+ { tempo: 120, duration: 25.71 }, // Medium
+ { tempo: 150, duration: 25.71 }, // Fast
+ { tempo: 60, duration: 25.71 }, // Back to slow
+ { tempo: 150, duration: 25.71 }, // Fast again
+ { tempo: 200, duration: 25.71 }, // Intense
+ { tempo: 240, duration: 25.71 } // Extreme finish
+ ]
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Components Created**:
+- Beat timeline visualization (scrolling beats)
+- Current BPM display
+- Tempo label
+- Video player (optional)
+- Volume controls
+- Dev skip button
+- Sidebar countdown timer
+
+---
+
+### Add Library Directory Task
+**Purpose**: Add media directory to library
+
+```javascript
+{
+ type: 'action',
+ mood: 'practical',
+ story: 'Add content to your library.',
+ interactiveType: 'add-library-directory',
+ params: {
+ suggestedTags: ['amateur', 'solo'],
+ showTimer: true
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Components Created**:
+- Select directory button
+- Suggested tags display
+- Result status area
+- Automatic completion on success
+
+---
+
+### Tag Files Task
+**Purpose**: Tag files in the library
+
+```javascript
+{
+ type: 'action',
+ mood: 'practical',
+ story: 'Tag files in your library.',
+ interactiveType: 'tag-files',
+ params: {
+ minFiles: 10,
+ suggestedTags: ['pov', 'blowjob', 'riding', 'amateur'],
+ showTimer: true,
+ preserveContent: true // Keep existing content visible
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Components Created**:
+- Open library button
+- Tag progress tracker
+- Suggested tags display
+- Auto-completion when target reached
+
+---
+
+### Video Start Task
+**Purpose**: Start video playback
+
+```javascript
+{
+ type: 'action',
+ mood: 'intense',
+ story: 'Watch the video.',
+ interactiveType: 'video-start',
+ params: {
+ player: 'focus', // Video player mode
+ tags: ['amateur'], // Filter tags
+ duration: 120, // Duration in seconds
+ showTimer: true // Show countdown timer in sidebar
+ },
+ nextStep: 'next_step_id'
+}
+```
+
+**Components Created**:
+- Video player container
+- Start video button
+- Dev skip button
+- Sidebar countdown timer
+- Auto-completion when duration complete
+
+---
+
+## Standard UI Components
+
+### 1. Sidebar Countdown Timer
+**Always Preserve Game Stats Panel**
+
+```javascript
+// โ CORRECT - Use specific timer elements
+const countdownEl = document.getElementById('sidebar-countdown-display');
+const countdownWrapper = document.getElementById('sidebar-countdown-timer');
+
+// Show timer
+if (countdownWrapper) {
+ countdownWrapper.style.display = 'block';
+}
+
+// Update timer
+if (countdownEl) {
+ const minutes = Math.floor(timeRemaining / 60);
+ const seconds = timeRemaining % 60;
+ countdownEl.textContent = `${minutes}:${seconds.toString().padStart(2, '0')}`;
+}
+
+// Hide timer
+if (countdownWrapper) {
+ countdownWrapper.style.display = 'none';
+}
+
+// โ WRONG - Never use sidebar.innerHTML
+// This destroys the game stats panel!
+sidebar.innerHTML = '
Timer
'; // DON'T DO THIS
+```
+
+**Required Elements**:
+- `#sidebar-countdown-timer` - Wrapper element (show/hide)
+- `#sidebar-countdown-display` - Text element (update time)
+- `#game-stats-panel` - Stats panel (NEVER destroy this)
+
+**See**: `docs/GAME_STATS_PANEL_FIX.md` for complete guide
+
+---
+
+### 2. Dev Skip Button
+**Standard Implementation**
+
+```javascript
+// HTML
+
+
+// JavaScript
+const skipBtn = container.querySelector('#skip-[task]-btn');
+
+// Show if dev mode
+if (window.isDevMode && window.isDevMode()) {
+ skipBtn.style.display = 'inline-block';
+}
+
+// Handler
+skipBtn.addEventListener('click', () => {
+ console.log('โฉ Dev skip - completing task');
+
+ // Clean up intervals/timers
+ if (timerInterval) clearInterval(timerInterval);
+ if (beatTimer) clearInterval(beatTimer);
+
+ // Stop audio
+ if (audioContext) audioContext.close();
+ if (ambientAudio) ambientAudio.pause();
+
+ // Hide countdown timer
+ if (countdownWrapper) {
+ countdownWrapper.style.display = 'none';
+ }
+
+ // Mark complete
+ task.completed = true;
+
+ // Enable continue button
+ const completeBtn = document.getElementById('interactive-complete-btn');
+ if (completeBtn) {
+ completeBtn.disabled = false;
+ completeBtn.textContent = 'Continue to Next Step โ';
+ }
+});
+```
+
+**Required Cleanup**:
+- Clear all intervals and timers
+- Stop all audio (metronome, ambient, video)
+- Hide countdown timer
+- Mark task as completed
+- Enable continue button
+
+---
+
+### 3. Task Completion Pattern
+**Standard Completion Flow**
+
+```javascript
+// When task naturally completes
+task.completed = true;
+
+// Update UI
+statusArea.innerHTML = '
โ Task complete!
';
+
+// Hide countdown timer
+if (showTimer && countdownWrapper) {
+ countdownWrapper.style.display = 'none';
+}
+
+// Enable continue button
+const completeBtn = document.getElementById('interactive-complete-btn');
+if (completeBtn) {
+ completeBtn.disabled = false;
+ completeBtn.textContent = 'Continue to Next Step โ';
+ completeBtn.style.background = 'linear-gradient(135deg, var(--color-success), var(--color-primary))';
+}
+```
+
+---
+
+### 4. Cleanup Function
+**Every Task Must Have Cleanup**
+
+```javascript
+// Store cleanup function on task
+task.cleanup = () => {
+ console.log('๐งน Task cleanup called');
+
+ // Clear intervals
+ if (timerInterval) clearInterval(timerInterval);
+ if (beatTimer) clearInterval(beatTimer);
+
+ // Stop audio
+ if (audioContext) {
+ audioContext.close().catch(err => console.warn('โ ๏ธ Error closing audio:', err));
+ }
+ if (ambientAudio) {
+ ambientAudio.pause();
+ ambientAudio = null;
+ }
+
+ // Stop video
+ if (videoElement) {
+ videoElement.pause();
+ videoElement = null;
+ }
+
+ // Hide countdown timer
+ const countdownTimer = document.getElementById('sidebar-countdown-timer');
+ if (countdownTimer) {
+ countdownTimer.style.display = 'none';
+ }
+
+ console.log('โ Cleanup complete');
+};
+```
+
+---
+
+## Complete Level Example
+
+### Level 1: Edge Training 101
+
+```javascript
+level1: {
+ id: 'academy-level-1',
+ name: 'Edge Training 101',
+ arc: 'Foundation',
+ level: 1,
+ duration: 300,
+ interactiveType: 'scenario-adventure',
+ interactiveData: {
+ title: 'Level 1: Edge Training 101',
+ steps: {
+ start: {
+ type: 'story',
+ mood: 'welcoming',
+ story: 'Welcome to The Academy, aspiring gooner. I am your instructor, and I will guide your transformation. Today, we begin with the foundation of all gooning: the edge. You will learn to ride the wave of pleasure without release. Are you ready to begin your journey?',
+ nextStep: 'intro_complete'
+ },
+ intro_complete: {
+ type: 'action',
+ mood: 'instructional',
+ story: 'Your first lesson is simple: edge 5 times. Stroke yourself to the very brink, feel that rush of pleasure, then stop. Hold yourself there. Feel it pulsing, demanding release. But you will not give in. This is control. This is the beginning.',
+ interactiveType: 'edge',
+ params: {
+ count: 5,
+ instruction: 'Edge 5 times - slowly and deliberately',
+ showTimer: true
+ },
+ nextStep: 'first_edges_done'
+ },
+ first_edges_done: {
+ type: 'story',
+ mood: 'praising',
+ story: 'Good. Very good. You felt it, didn\'t you? That moment where your body screamed for release, but your mind held firm. That is power. That is what we are building here. You have completed your first training session. Level 2 awaits when you\'re ready.',
+ nextStep: 'completion'
+ },
+ completion: {
+ type: 'completion',
+ mood: 'satisfied',
+ story: 'โ Level 1 Complete - You have taken your first steps into The Academy.',
+ outcome: 'level1_complete'
+ }
+ }
+ }
+}
+```
+
+---
+
+## Step Flow Diagram
+
+```
+[start] (story)
+ โ
+[intro_complete] (action - edge task)
+ โ
+[first_edges_done] (story)
+ โ
+[completion] (completion)
+```
+
+---
+
+## Critical Rules
+
+### โ DO:
+- Always include `showTimer: true` in task params
+- Use specific timer elements (`#sidebar-countdown-display`, `#sidebar-countdown-timer`)
+- Add dev skip buttons to all timed tasks
+- Include cleanup functions for all interactive tasks
+- Clear all intervals/timers in cleanup and skip handlers
+- Hide countdown timer when task completes
+- Enable continue button when task completes
+- Use consistent step naming (start, completion)
+- Include mood indicators for atmosphere
+- Provide clear instructions in story text
+
+### โ DON'T:
+- Use `sidebar.innerHTML` (destroys game stats panel)
+- Forget to clear intervals in cleanup
+- Forget to hide countdown timer when complete
+- Create tasks without cleanup functions
+- Use generic button IDs that might conflict
+- Forget to check for element existence before using
+- Hardcode values that should be parameters
+- Skip the dev skip button implementation
+- Forget to stop audio in cleanup
+
+---
+
+## Testing Checklist
+
+When creating a new level, verify:
+
+- [ ] Game stats panel stays visible throughout all tasks
+- [ ] Countdown timer appears when tasks start
+- [ ] Countdown timer updates every second
+- [ ] Countdown timer hides when task completes
+- [ ] Dev skip button appears in dev mode (`localStorage.setItem('devMode', 'true')`)
+- [ ] Dev skip button completes task immediately
+- [ ] All intervals/timers are cleared on completion
+- [ ] All intervals/timers are cleared on skip
+- [ ] All audio stops on completion
+- [ ] All audio stops on skip
+- [ ] Continue button enables when task completes
+- [ ] Level transitions smoothly to next step
+- [ ] Story text displays correctly
+- [ ] Moods are appropriate for each step
+- [ ] Task parameters work as expected
+- [ ] No console errors during execution
+- [ ] Cleanup function executes without errors
+
+---
+
+## Quick Reference
+
+### Common Parameters
+```javascript
+params: {
+ showTimer: true, // Show countdown timer
+ preserveContent: false, // Preserve existing content
+ duration: 180, // Duration in seconds
+ enableVideo: true, // Enable video player
+ suggestedTags: [], // Suggested tags array
+ instruction: '', // Custom instruction text
+}
+```
+
+### Common Element IDs
+- `#sidebar-countdown-timer` - Timer wrapper (show/hide)
+- `#sidebar-countdown-display` - Timer text (update)
+- `#game-stats-panel` - Stats panel (preserve)
+- `#interactive-complete-btn` - Continue button (enable)
+- `.skip-task-btn` - Dev skip button class
+
+### Common Event Handlers
+- Start button click โ Begin task
+- Skip button click โ Complete immediately
+- Timer interval โ Update countdown
+- Completion โ Clean up and enable continue
+
+---
+
+## Resources
+
+- **Game Stats Panel Fix**: `docs/GAME_STATS_PANEL_FIX.md`
+- **Rhythm Timeline System**: `docs/rhythm-timeline/README.md`
+- **Training Modules**: `docs/TRAINING_MODULES.md`
+- **Level Breakdowns**: `docs/LEVELS_1-15_BREAKDOWN.md`, `docs/LEVELS_16-20_BREAKDOWN.md`
+
+---
+
+## Version History
+
+- **v1.0** (2025-12-06) - Initial template based on Levels 1-3 structure
diff --git a/index.html b/index.html
index efd386c..b9c205d 100644
--- a/index.html
+++ b/index.html
@@ -221,7 +221,7 @@
Master Your Dedication
- โ Advanced Training System โ v0.41
+ โ Advanced Training System โ v0.5