# 🎮 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.

---

## 🚀 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 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
- Seamless integration with linked video directories
- Watch time and completion analytics
- Favorite video tracking
- Theater mode for distraction-free viewing
- Multi-format video support

**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 that unlocks new Training Modules and tracks your overall dedication level.


### 🎯 XP Sources by Mode

| Mode | Activity | XP Reward | Notes |
|------|----------|-----------|-------|
| **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 |
| | 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 & Ranks

**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
- **Session Summaries**: XP earned per session with breakdowns
- **Statistics Dashboard**: Comprehensive XP analytics
- **Progress Visualization**: Charts and progression metrics

---
## 📚 Library System

### 🎬 Video Library Management
The Library system provides centralized management for all your media content across game modes.

**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

**Photo Collections:**
- **Upload System**: High-quality image upload (1600x1200 resolution)
- **Gallery Management**: Pinterest-style layout with aspect ratio optimization
- **Smart Compression**: Optimized storage without quality loss

**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:**
- **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

### 📊 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

---
### 🔒 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

### 🎨 Customization
- **6 Visual Themes**: Including dynamic Library theme
- **Task Disable Toggles**: Individual control in Quick Play
- **Adaptive Difficulty**: Progressive timer scaling
- **Personal Content**: Upload and organize your media

---

## 🎯 Controls & Navigation

| Control | Action | Mode Availability |
|---------|--------|-------------------|
| **Enter** | Complete current task | All modes |
| **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/
├── index.html              # Main hub and library management
├── 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
├── src/
│   ├── core/              # Game engine and state management
│   ├── data/modes/        # Game mode configurations
│   ├── features/          # Modular feature systems
│   │   ├── media/         # Video players and media management
│   │   ├── stats/         # XP and statistics tracking
│   │   ├── tasks/         # Interactive task system
│   │   └── ui/            # User interface components
│   ├── styles/            # CSS themes and styling
│   └── utils/             # Utility functions and helpers
├── images/                # User-uploaded image library
├── 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/
```

### 🔧 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

### 🖥️ 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

### v0.51 - Library & UI Polish (December 2025)
- ✅ **Multi-Directory Selection**: Add multiple directories at once to libraries
- ✅ **Tag-Based Filtering**: Filter images/videos by tags, including "Untagged" option
- ✅ **Hypno Gallery Restructure**: Separated single/grid modes with click-to-assign interface
- ✅ **User Profile System**: Popup modal with stats, achievements, and player card export
- ✅ **Tag Modal UX**: Click-away-to-close on all tag modals (removed X buttons)
- ✅ **Video Library Fixes**: Clickable thumbnails, improved directory unlinking
- ✅ **Quick Play Enhancements**: Removed category system, improved message editing
- ✅ **Portrait Video Support**: Fixed cropping issues across all modes
- ✅ **TTS Unification**: Shared TTS settings between Campaign and Training Modules

### v0.50 - 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

---