GTA
/
training-academy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity
training-academy/README.md

1028 lines
39 KiB
Markdown
Raw Blame History

# 🎮 Gooner Training Academy# 🎮 Gooner Training Academy# 🎮 Gooner Training Academy# Gooner Training Academy
*Master Your Dedication Through Advanced Training Systems*
A comprehensive adult edging training application featuring three specialized game modes, an advanced XP progression system, and professional media library management.*Master Your Dedication Through Advanced Training Systems*
---
## 🚀 Quick StartA comprehensive adult edging training application featuring three specialized game modes, an advanced XP progression system, and professional media library management.*Master Your Dedication Through Advanced Training Systems**How long can you last?*
### 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**
### 🎬 Training Academy
Quick Play provides immediate access to task-based gameplay with streamlined setup and maximum customization control.
**Immersive scenario-based training with progressive storylines**
**Session Setup:**
**Fast-start training with customizable sessions**
### 🎬 Training Academy
Quick Play provides immediate access to task-based gameplay with streamlined setup and maximum customization control.
**Immersive scenario-based training with progressive storylines**
**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.
- 🎬 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
- Favorite video tracking
- Theater mode for distraction-free viewing
- Multi-format video support
- Real-time XP tracking with status display
### 📈 Experience Points (XP) Overview
The XP system tracks your dedication and progress across all training modes, providing a unified progression metric.
### 🎯 XP Sources by Mode
| Mode | Activity | XP Reward | Notes |
|------|----------|-----------|-------|
| **Training Academy** | 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 |
| | 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
- **🌱 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 Tracking
- **Real-time Display**: Live XP counter in all game modes- Real-time XP tracking with status display
- **Session Summaries**: XP earned per session with breakdowns
- **Statistics Dashboard**: Comprehensive XP analytics
- **Progress Visualization**: Charts and progression metrics
## 📚 Library System Explained
### 🎬 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
- **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- Session cleanup and statistics tracking
- **Photo Collections**: Webcam integration for photo capture Content Management
- **Upload System**: High-quality image upload (1600x1200 resolution)
- **Smart Categorization**: Tasks vs Consequences automatic sorting- Punishment system with consequence images
- **Gallery Management**: Pinterest-style layout with aspect ratio optimization
Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.**Session Setup:**- **Custom Images**: Upload and categorize adult content (tasks vs consequences)
#### **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**Player Features:**- ⏰ Flexible Duration: 15 minutes to 4+ hours- **Video Integration**: Link external video directories for seamless playback
- **Usage Analytics**: Track which content is most accessed
- 🎬 Professional Video Interface: Full-screen theater mode
#### **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
- **Punishment System**: Consequence image selection
- 🔄 Multi-Screen Mode: 4-video grid for intensive sessions- 🎛️ Individual Task Controls: Enable/disable specific tasks- **Storage Management**: 50 image limit with usage monitoring
### 📊 Library Analytics
- **📈 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- 🎯 Custom Task Creation: Add personalized challenges- **Bulk Operations**: Select, enable/disable, and delete multiple images
- **📋 Content Health**: Missing files and broken links detection
**XP Rewards:**
---
- ⏱️ Viewing Time: **1 XP per 5 minutes** of active viewing
## 🎛️ Key Features
- ✅ Video Completion: **Bonus XP** for 90%+ completion
### 🔒 Data Protection
- **Automatic Backups**: Every 30 minutes during active sessions- 📊 Binge Sessions: **Additional rewards** for extended viewing**XP Rewards:**## <20> Quick Start
- **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
- **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)
- **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
npm install
---
---
## 🎯 Controls & Navigation
**Features:**npm start
| Control | Action | Mode Availability |
|---------|--------|-------------------|## ⭐ XP System Explained
| **Enter** | Complete current task | All modes |
| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |- Real-time task filtering with persistent settings```
| **Space/P** | Pause/Resume session | All modes |
| **M** | Toggle background music | All modes |### 📈 Experience Points (XP) Overview
| **H** | Show help menu | All modes |
| **Escape** | Close dialogs/return to menu | All modes |The XP system tracks your dedication and progress across all training modes, providing a unified progression metric.- Background video with floating opacity controls
---
## 🛠️ Technical Architecture### 🎯 XP Sources by Mode- Session cleanup and statistics tracking### Web Browser
### 📂 Core Structure
```
webGame/| Mode | Activity | XP Reward | Notes |- Webcam integration for photo capture1. Open `index.html` in a modern browser
├── 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
├── player-stats.html # Statistics dashboard
├── user-profile.html # Profile and achievements| | Webcam Activity | 1 XP / minute | Active engagement bonus |
├── src/
│ ├── core/ # Game engine and state management| | Photo Session | 2 XP / photo | Achievement-based reward |3. Upload custom content via Image Management
│ ├── data/modes/ # Game mode configurations
│ ├── features/ # Modular feature systems| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |
│ │ ├── 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
│ │ ├── tasks/ # Interactive task system
│ │ └── ui/ # User interface components| | Recording Bonus | +1 XP | Additional engagement |
│ ├── styles/ # CSS themes and styling
│ └── utils/ # Utility functions and helpers| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |
├── images/ # User-uploaded image library
├── audio/ # Background music collection| | Video Completion | Bonus XP | 90%+ completion required |
└── videos/ # Linked video directories
```### 🎭 Porn Cinema## 🎯 Key Controls
### 🔧 Development Requirements### 📊 Progression Levels
- **Node.js 16+**: For Electron desktop application
- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+- **🌱 Beginner (0-100 XP)**: Learning the basics**Professional video viewing experience**
- **Desktop Features**: File system access for media linking
- **Storage**: Minimum 100MB for application and user content- **📈 Intermediate (100-500 XP)**: Building consistency
---- **🎯 Advanced (500-1500 XP)**: Mastering techniques- **Enter** - Complete task
## 📋 Recent Major Updates- **🏆 Expert (1500+ XP)**: Peak dedication
### v4.0 - Comprehensive Backup System (November 12, 2025)Dedicated video player system designed for focused media consumption with comprehensive viewing analytics.- **Ctrl** - Skip task (triggers punishment)
- ✅ **Automatic Data Protection**: 30-minute backup intervals
- ✅ **Manual Backup Controls**: User-initiated backup/restore### 🔍 XP Tracking
- ✅ **Export/Import System**: Portable data management
- ✅ **Emergency Backup Hooks**: Before reset operations- **Real-time Display**: Live XP counter in all game modes- **Space/P** - Pause/resume
- ✅ **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
---
## 🎓 Getting Started Guide
### 📁 Library Organization- 🎛️ Advanced Controls: Speed, volume, seeking, and more
### 1. **First Launch**
- Run the application via desktop app or open `index.html`
- Complete the initial setup and library configuration
- Link your video directories for enhanced experience#### **Video Directories**### Requirements
### 2. **Library Setup**- **Automatic Discovery**: Scans linked directories for video files
- Upload task and consequence images via Image Management
- Link video directories for background content- **Format Support**: MP4, WebM, MOV, AVI, and more**XP Rewards:**- Modern web browser with webcam support
- Organize content for optimal gameplay experience
- **Smart Indexing**: Automatic categorization and metadata
### 3. **Choose Your Path**
- **New to Training**: Start with **Quick Play** for immediate access- **Cross-Mode Access**: Available in all game modes- ⏱️ Viewing Time: **1 XP per 5 minutes** of active viewing- Local storage for saves and images
- **Structured Learning**: Begin with **Training Academy** scenarios
- **Media Focus**: Explore **Porn Cinema** for dedicated viewing
### 4. **Progress Tracking**#### **Photo Collections**- ✅ Video Completion: **Bonus XP** for 90%+ completion- 50MB+ available storage for custom content
- Monitor XP growth across all modes
- Check statistics dashboard for detailed analytics- **Upload System**: High-quality image upload (1600x1200 resolution)
- Use player profile to track achievements and milestones
- **Smart Categorization**: Tasks vs Consequences automatic sorting- 📊 Binge Sessions: **Additional rewards** for extended viewing
---
- **Gallery Management**: Pinterest-style layout with aspect ratio optimization
## 📄 License
- **Storage Limits**: 50 image maximum with usage monitoring### File Structure
This project is licensed under the MIT License - see the LICENSE file for details.
**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.
### 🔧 Library Features**Features:**```
#### **Media Linking**- Seamless integration with linked video directorieswebGame/
```
📁 Linked Directories:- Watch time and completion analytics├── index.html # Main interface
├── /videos/mainstream/ # General video content
├── /videos/specialized/ # Category-specific content - Favorite video tracking├── porn-cinema.html # Professional video player
├── /images/tasks/ # Task-related images
└── /images/consequences/ # Punishment images- Theater mode for distraction-free viewing├── player-stats.html # Statistics dashboard
```
- Multi-format video support├── user-profile.html # User profile and achievements
#### **Advanced Management**
- **Bulk Operations**: Select, enable/disable, delete multiple files├── src/
- **Dynamic Themes**: Library theme adapts to your uploaded content
- **Smart Compression**: Optimized storage without quality loss---│ ├── core/ # Game engine and mode management
- **Usage Analytics**: Track which content is most accessed
│ ├── data/modes/ # Game mode data files
#### **Integration Across Modes**
- **Quick Play**: Background video selection and task images## ⭐ XP System Explained│ ├── features/
- **Training Academy**: Scenario content and photo sessions
- **Porn Cinema**: Full video library access with playlists│ │ ├── media/ # Video players and cinema system
- **Punishment System**: Consequence image selection
### 📈 Experience Points (XP) Overview│ │ ├── stats/ # Player statistics tracking
### 📊 Library Analytics
- **📈 Content Usage**: Most viewed/used media trackingThe XP system tracks your dedication and progress across all training modes, providing a unified progression metric.│ │ ├── tasks/ # Interactive task management
- **💾 Storage Monitoring**: Space usage and optimization suggestions
- **🔄 Sync Status**: Real-time directory scanning results│ │ └── ... # Audio, webcam, UI features
- **📋 Content Health**: Missing files and broken links detection
### 🎯 XP Sources by Mode│ └── styles/ # CSS and themes
---
├── images/ # Image storage
## 🎛️ Key Features
| Mode | Activity | XP Reward | Notes |├── audio/ # Background music
### 🔒 Data Protection
- **Automatic Backups**: Every 30 minutes during active sessions|------|----------|-----------|-------|├── videos/ # Video file organization
- **Manual Backup/Restore**: Full control over your data
- **Export/Import**: Portable data management| **Training Academy** | Time Training | 1 XP / 2 minutes | Passive time-based reward |└── package.json # Electron app config
- **Emergency Backups**: Before any reset operations
| | Webcam Activity | 1 XP / minute | Active engagement bonus |```
### 🎨 Customization
- **6 Visual Themes**: Including dynamic Library theme| | Photo Session | 2 XP / photo | Achievement-based reward |
- **Task Disable Toggles**: Individual control in Quick Play
- **Adaptive Difficulty**: Progressive timer scaling| **Quick Play** | Task Completion | 1-3 XP | Speed-based scaling |### Features
- **Personal Content**: Upload and organize your media
| | Session Bonus | 2 XP / 15 min | Consistency reward |- **Cross-Platform**: Windows, Mac, Linux via Electron
### 🖥️ Technical Excellence
- **Cross-Platform**: Windows, Mac, Linux support| | Recording Bonus | +1 XP | Additional engagement |- **Responsive Design**: Works on desktop and mobile
- **Electron Desktop App**: Native OS integration
- **Web Browser Compatible**: No installation required| **Porn Cinema** | Video Viewing | 1 XP / 5 minutes | Engagement tracking |- **Local Storage**: All data stays on your device
- **Professional UI**: Responsive, modern design
| | Video Completion | Bonus XP | 90%+ completion required |- **Privacy-First**: No data sent to servers
---
## 🎯 Controls & Navigation
### 📊 Progression Levels## 📋 Recent Updates
| Control | Action | Mode Availability |
|---------|--------|-------------------|- **🌱 Beginner (0-100 XP)**: Learning the basics
| **Enter** | Complete current task | All modes |
| **Ctrl** | Skip task (triggers punishment) | Training, Quick Play |- **📈 Intermediate (100-500 XP)**: Building consistency ### v3.3 - Media Library Consolidation & Theme System (November 11, 2025)
| **Space/P** | Pause/Resume session | All modes |
| **M** | Toggle background music | All modes |- **🎯 Advanced (500-1500 XP)**: Mastering techniques- ✅ **Complete Media Library Cleanup**: 3-phase consolidation removing 500+ lines of duplicate code
| **H** | Show help menu | All modes |
| **Escape** | Close dialogs/return to menu | All modes |- **🏆 Expert (1500+ XP)**: Peak dedication - Phase 1: Unified video gallery system (lib-video-gallery)
--- - Phase 2: Consolidated image management (lib-image-gallery)
## 🛠️ Technical Architecture### 🔍 XP Tracking - Phase 3: Streamlined audio system (lib-audio-gallery)
### 📂 Core Structure- **Real-time Display**: Live XP counter in all game modes- ✅ **Advanced Theme System**: 6 visual themes (hentai, pornstars, BBC, feet, library, none)
```
webGame/- **Session Summaries**: XP earned per session with breakdowns- ✅ **Dynamic Library Theme**: Pinterest-style layout using user's personal image collection
├── index.html # Main hub and library management
├── quick-play.html # Quick Play game mode- **Statistics Dashboard**: Comprehensive XP analytics- ✅ **Smart Image Layout**: Dynamic container sizing based on aspect ratios with gap-free stacking
├── training-academy.html # Training Academy mode
├── porn-cinema.html # Video player system- **Progress Visualization**: Charts and progression metrics- ✅ **Enhanced File Handling**: Proper URI encoding for special characters in file paths
├── player-stats.html # Statistics dashboard
├── user-profile.html # Profile and achievements
├── src/
│ ├── core/ # Game engine and state management---### v3.2 - Task Management & Session Cleanup (November 6, 2025)
│ ├── data/modes/ # Game mode configurations
│ ├── features/ # Modular feature systems- ✅ **Task Disable Toggles**: Individual task control with persistent localStorage settings
│ │ ├── media/ # Video players and media management
│ │ ├── stats/ # XP and statistics tracking## 📚 Library System Explained- ✅ **Consequence System Integration**: Disabled tasks filtered from consequence selection
│ │ ├── tasks/ # Interactive task system
│ │ └── ui/ # User interface components- ✅ **ID Consistency**: Fixed task ID generation to handle both numeric and generated IDs
│ ├── styles/ # CSS themes and styling
│ └── utils/ # Utility functions and helpers### 🎬 Video Library Management- ✅ **Session Cleanup**: Comprehensive endGame cleanup stopping videos and periodic popups
├── images/ # User-uploaded image library
├── audio/ # Background music collectionThe Library system provides centralized management for all your media content across game modes.- ✅ **Debug System**: Extensive console logging for task state tracking and troubleshooting
└── videos/ # Linked video directories
```
### 🔧 Development Requirements### 📁 Library Organization### v3.1 - Quick Play Background Video System (November 3, 2025)
- **Node.js 16+**: For Electron desktop application
- **Modern Browser**: Chrome 90+, Firefox 88+, Safari 14+- ✅ **Quick Play Mode**: New fast-start game mode with streamlined interface
- **Desktop Features**: File system access for media linking
- **Storage**: Minimum 100MB for application and user content#### **Video Directories**- ✅ **Background Video Integration**: Independent video system with 46+ videos detected
---- **Automatic Discovery**: Scans linked directories for video files- ✅ **Compact Video Controls**: Floating controls with opacity cycling (hidden/dim/normal/bright)
## 📋 Recent Major Updates- **Format Support**: MP4, WebM, MOV, AVI, and more- ✅ **Video Visibility Toggle**: Quick on/off button with eye icon for instant control
### v4.0 - Comprehensive Backup System (November 12, 2025)- **Smart Indexing**: Automatic categorization and metadata- ✅ **Independent Game Logic**: Isolated Quick Play mode preventing main game interference
- ✅ **Automatic Data Protection**: 30-minute backup intervals
- ✅ **Manual Backup Controls**: User-initiated backup/restore- **Cross-Mode Access**: Available in all game modes- ✅ **Real Task Integration**: Full integration with 17 mainGameData tasks and 60 task images
- ✅ **Export/Import System**: Portable data management
- ✅ **Emergency Backup Hooks**: Before reset operations- ✅ **VideoLibrary Scanning**: Custom video detection system using existing linked directories
- ✅ **Data Loss Recovery**: Complete incident prevention system
#### **Photo Collections**- ✅ **Enhanced Timer System**: Fixed countdown functionality with proper Quick Play isolation
### v3.3 - Media Library Consolidation (November 11, 2025)
- ✅ **Unified Gallery System**: Single media management interface- **Upload System**: High-quality image upload (1600x1200 resolution)
- ✅ **Dynamic Library Theme**: User content-based theming
- ✅ **Pinterest Layout**: Aspect ratio-optimized image display- **Smart Categorization**: Tasks vs Consequences automatic sorting### v3.0 - Professional Media System (October 31, 2025)
- ✅ **Advanced Organization**: Smart categorization and bulk operations
- **Gallery Management**: Pinterest-style layout with aspect ratio optimization- ✅ **Complete Porn Cinema**: Professional video player with playlists, progress bars, and theater mode
### v3.2 - Quick Play Enhancement (November 6, 2025)
- ✅ **Task Disable Toggles**: Individual task control system- **Storage Limits**: 50 image maximum with usage monitoring- ✅ **Multi-Screen Quad Player**: 4-video grid layout for intensive training with minimize/restore functionality
- ✅ **Persistent Settings**: Configuration memory across sessions
- ✅ **Real-time Filtering**: Dynamic task exclusion- ✅ **BaseVideoPlayer Architecture**: Reusable video components across all game modes
- ✅ **Enhanced Debugging**: Comprehensive logging system
### 🔧 Library Features- ✅ **Video Library Integration**: Seamless access to external video directories
### v3.1 - Background Video Integration (November 3, 2025)
- ✅ **Seamless Video Playback**: Background videos during gameplay- ✅ **Player Statistics & Profiles**: Watch time tracking, achievements, and user progression
- ✅ **Opacity Controls**: Floating video control system
- ✅ **40+ Video Integration**: Comprehensive video library access#### **Media Linking**- ✅ **Focus Video Interruptions**: Video overlays during training scenarios
- ✅ **Multi-Mode Support**: Video features across all game modes
```- ✅ **Enhanced Training Integration**: Multi-screen mode button in interactive tasks
---
📁 Linked Directories:
## 🎓 Getting Started Guide
├── /videos/mainstream/ # General video content### v2.0 - Major Content Update
### 1. **First Launch**
- Run the application via desktop app or open `index.html`├── /videos/specialized/ # Category-specific content - ✅ Added 7 specialized game modes with rich content
- Complete the initial setup and library configuration
- Link your video directories for enhanced experience├── /images/tasks/ # Task-related images- ✅ Implemented progressive endurance training system
### 2. **Library Setup**└── /images/consequences/ # Punishment images- ✅ Enhanced interactive task management
- Upload task and consequence images via Image Management
- Link video directories for background content```- ✅ Webcam integration for mirror and photography tasks
- Organize content for optimal gameplay experience
- ✅ Modular data system for better organization
### 3. **Choose Your Path**
- **New to Training**: Start with **Quick Play** for immediate access#### **Advanced Management**- ✅ Removed deprecated scenario mode
- **Structured Learning**: Begin with **Training Academy** scenarios
- **Media Focus**: Explore **Porn Cinema** for dedicated viewing- **Bulk Operations**: Select, enable/disable, delete multiple files
### 4. **Progress Tracking**- **Dynamic Themes**: Library theme adapts to your uploaded content### v1.4 - Enhanced Image System
- Monitor XP growth across all modes
- Check statistics dashboard for detailed analytics- **Smart Compression**: Optimized storage without quality loss- ✅ Categorized image management (tasks vs consequences)
- Use player profile to track achievements and milestones
- **Usage Analytics**: Track which content is most accessed- ✅ High-quality compression and processing
---
- ✅ Storage quota management
## 📄 License
#### **Integration Across Modes**- ✅ Bulk operations and selection
This project is licensed under the MIT License - see the LICENSE file for details.
- **Quick Play**: Background video selection and task images
**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.
- **Training Academy**: Scenario content and photo sessions## License
- **Porn Cinema**: Full video library access with playlists
- **Punishment System**: Consequence image selection[Add your preferred license here]
### 📊 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
---
## 🎛️ Key Features
### 🔒 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
### 🖥️ 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
---
## 🎯 Controls & Navigation
| Control | Action | Mode Availability |
|---------|--------|-------------------|
| **Enter** | Complete current task | All modes |
| **Ctrl** | Skip task (triggers punishment) | Training, 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
├── quick-play.html # Quick Play game mode
├── training-academy.html # Training Academy mode
├── porn-cinema.html # Video player system
├── hypno-gallery.html # Immersive slideshow system
├── player-stats.html # Statistics dashboard
├── user-profile.html # Profile and achievements
├── scripts/ # Installation and launch scripts
│ ├── setup.bat # Windows installer
│ ├── setup.sh # Mac/Linux installer
│ ├── Start-webgame.bat # Windows launcher
│ └── create-distribution.* # Distribution builders
├── docs/ # Documentation and guides
│ ├── HYPNO-GALLERY-README.md # Hypno Gallery documentation
│ ├── INSTALLATION_GUIDE.md # Setup instructions
│ ├── TESTER_GUIDE.md # Testing instructions
│ ├── ROADMAP.md # Development roadmap
│ └── archive/ # Archived documentation
├── 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
```
### 🔧 Development 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.1 - Critical Stability & Performance Update (November 26, 2025)
- ✅ **Quick Play Session Cleanup**: Complete timer and video cleanup on end session
- Fixed timers continuing after end session (taskTimer, gameTimerInterval, xpDisplayInterval, recordingTimerInterval)
- Enhanced video stopping with comprehensive cleanup (pause, mute, reset, clear source)
- Added debug logging to track timer IDs and video element cleanup
- ✅ **Function Spam Prevention**: Added game state guards to prevent functions running after session ends
- Guards in syncTaskWithOverlay(), updateRecordingOverlay(), updateTimerDisplay()
- Checks `!isGameRunning || window.isEndingGame` before execution
- Eliminated console spam and unnecessary processing
- ✅ **Porn Cinema Memory Leak Fix**: CRITICAL fix preventing crashes from event listener accumulation
- Changed from individual button listeners to event delegation pattern
- Single parent listener handles all playlist button clicks via event bubbling
- Prevents exponential memory growth during extended sessions
- ✅ **Porn Cinema Error Handling**: User-friendly error recovery system
- Try-catch wrapper for initialization with styled error overlay
- Retry and home buttons for crash recovery
- Null checks for missing DOM elements (theater mode buttons)
- ✅ **Porn Cinema Cleanup System**: Comprehensive destroy() method for proper resource cleanup
- Removes event listeners, stops and unloads videos, clears playlist data
- Window close handlers (beforeunload, pagehide) trigger automatic cleanup
- Prevents memory leaks when closing porn cinema window
- ✅ **Enhanced Theme System**: 6 visual themes with dynamic Library theme option
- Static themes: Hentai, Pornstars, BBC, Feet
- Dynamic Library theme: Pinterest-style layout using user's personal image collection
- Theme customization via dropdown in Options menu
- None option to disable all background images
- ✅ **Desktop Photo Storage**: Webcam photos now saved to file system in desktop app
- Photos saved to `photos/captured/` directory
- Organized by session type (training-academy, dress-up, etc.)
- File-based storage instead of localStorage for better performance
- Automatic fallback to data URLs in browser mode
- Photo gallery access with download and management options
### 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
### v3.3 - Media Library Consolidation (November 11, 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 6, 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 3, 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
---
## 🎓 Getting Started Guide
### 1. **First Launch**
- Run the application via desktop app or open `index.html`
- Complete the initial setup and library configuration
- Link your video directories for enhanced experience
### 2. **Library Setup**
- Upload task and consequence images via Image Management
- Link video directories for background content
- Organize content for optimal gameplay experience
### 3. **Choose Your Path**
- **New to Training**: Start with **Quick Play** for immediate access
- **Structured Learning**: Begin with **Training Academy** scenarios
- **Media Focus**: Explore **Porn Cinema** for dedicated viewing
### 4. **Progress Tracking**
- Monitor XP growth across all modes
- Check statistics dashboard for detailed analytics
- Use player profile to track achievements and milestones
---
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
**Note**: This is adult content software intended for personal use by consenting adults. Please use responsibly and in accordance with local laws and regulations.
Reference in New Issue View Git Blame Copy Permalink