training-academy/docs/README-ARCHIVED.md

Gooner Training Academy

How long can you last?

An adult edging challenge game with multiple specialized modes, professional media player system, and customizable punishment mechanics.

🎮 Game Modes

• Quick Play - Fast-start mode with background videos, task disable toggles, and streamlined interface
• Standard Game - Classic endless task mode with full feature set
• Timed Challenge - Race against the clock
• Score Target - Reach target points to win
• Training Academy - Gooning-focused training with progressive scenarios
• Punishment Gauntlet - Intense humiliation challenges
• Endurance Trials - Progressive endurance training (30s to 10min sessions)
• Photography Studio - Webcam photography and posing sessions

⭐ Core Features

🎬 Professional Media Player System

• Quick Play: Fast-start mode with background videos, task management with disable toggles, and session cleanup
• Porn Cinema: Full-featured video player with playlists, seeking, and theater mode
• Multi-Screen Quad Player: 4-video grid layout for intensive training sessions
• Video Library Management: Unified access to linked video directories with 40+ videos
• Background Video Integration: Seamless video playback during tasks with opacity controls
• Focus Interruptions: Video overlays during training scenarios
• Player Statistics: Watch time tracking, completion rates, and viewing analytics

🎮 Task Management System

• Task Disable Toggles: Individual task control with persistent settings in Quick Play mode
• Real-time Filtering: Disabled tasks excluded from gameplay with ID consistency
• Consequence Integration: Disabled tasks also filtered from consequence system
• Debug Logging: Comprehensive console output for troubleshooting

📊 Progressive Systems

• Experience Levels: Beginner → Intermediate → Advanced → Expert progression
• Adaptive Timers: 30 seconds to 10 minutes based on skill level
• Certification System: Graduate through progressive difficulty tiers
• Player Statistics: Comprehensive tracking across all game modes

Interactive Task System

• Mirror Tasks: Webcam-based self-humiliation challenges
• Focus Holds: Timed endurance and concentration exercises
• Scenario Adventures: Choose-your-own-adventure style content
• Photography Sessions: Webcam capture with posing instructions

Punishment System

• Popup Floods: 1-40 consequence images that can't be closed
• Smart Sizing: Auto-sized to image aspect ratios
• Configurable Timing: 3-30 second durations with random variations
• Visual Effects: Background blur, fade animations, countdown timers

Content Management

• Unified Media Libraries: Consolidated gallery systems for video, image, and audio content
• Advanced Theme System: 6 visual themes including dynamic Library theme with user images
• Smart Image Layout: Dynamic container sizing with Pinterest-style stacking
• Custom Images: Upload and categorize adult content (tasks vs consequences)
• Video Integration: Link external video directories for seamless playback
• High-Quality Processing: 1600x1200 resolution with smart compression
• Storage Management: 50 image limit with usage monitoring
• Bulk Operations: Select, enable/disable, and delete multiple images

<EFBFBD> Quick Start

Desktop App (Recommended)

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 Image Management
4. Configure settings in Options menu

🎯 Key Controls

• Enter - Complete task
• Ctrl - Skip task (triggers punishment)
• Space/P - Pause/resume
• M - Toggle music
• H - Help menu
• Escape - Close dialogs

🛠️ Technical

Requirements

• Modern web browser with webcam support
• Local storage for saves and images
• 50MB+ available storage for custom content

File Structure

webGame/
├── index.html              # Main interface
├── porn-cinema.html        # Professional video player
├── player-stats.html       # Statistics dashboard
├── user-profile.html       # User profile and achievements
├── src/
│   ├── core/              # Game engine and mode management
│   ├── data/modes/        # Game mode data files
│   ├── features/          
│   │   ├── media/         # Video players and cinema system
│   │   ├── stats/         # Player statistics tracking
│   │   ├── tasks/         # Interactive task management
│   │   └── ...            # Audio, webcam, UI features
│   └── styles/            # CSS and themes
├── images/                # Image storage
├── audio/                 # Background music
├── videos/                # Video file organization
└── package.json           # Electron app config

Features

• Cross-Platform: Windows, Mac, Linux via Electron
• Responsive Design: Works on desktop and mobile
• Local Storage: All data stays on your device
• Privacy-First: No data sent to servers

📋 Recent Updates

v3.3 - Media Library Consolidation & Theme System (November 11, 2025)

• ✅ Complete Media Library Cleanup: 3-phase consolidation removing 500+ lines of duplicate code
  • Phase 1: Unified video gallery system (lib-video-gallery)
  • Phase 2: Consolidated image management (lib-image-gallery)
  • Phase 3: Streamlined audio system (lib-audio-gallery)
• ✅ Advanced Theme System: 6 visual themes (hentai, pornstars, BBC, feet, library, none)
• ✅ Dynamic Library Theme: Pinterest-style layout using user's personal image collection
• ✅ Smart Image Layout: Dynamic container sizing based on aspect ratios with gap-free stacking
• ✅ Enhanced File Handling: Proper URI encoding for special characters in file paths

v3.2 - Task Management & Session Cleanup (November 6, 2025)

• ✅ Task Disable Toggles: Individual task control with persistent localStorage settings
• ✅ Consequence System Integration: Disabled tasks filtered from consequence selection
• ✅ ID Consistency: Fixed task ID generation to handle both numeric and generated IDs
• ✅ Session Cleanup: Comprehensive endGame cleanup stopping videos and periodic popups
• ✅ Debug System: Extensive console logging for task state tracking and troubleshooting

v3.1 - Quick Play Background Video System (November 3, 2025)

• ✅ Quick Play Mode: New fast-start game mode with streamlined interface
• ✅ Background Video Integration: Independent video system with 46+ videos detected
• ✅ Compact Video Controls: Floating controls with opacity cycling (hidden/dim/normal/bright)
• ✅ Video Visibility Toggle: Quick on/off button with eye icon for instant control
• ✅ Independent Game Logic: Isolated Quick Play mode preventing main game interference
• ✅ Real Task Integration: Full integration with 17 mainGameData tasks and 60 task images
• ✅ VideoLibrary Scanning: Custom video detection system using existing linked directories
• ✅ Enhanced Timer System: Fixed countdown functionality with proper Quick Play isolation

v3.0 - Professional Media System (October 31, 2025)

• ✅ Complete Porn Cinema: Professional video player with playlists, progress bars, and theater mode
• ✅ Multi-Screen Quad Player: 4-video grid layout for intensive training with minimize/restore functionality
• ✅ BaseVideoPlayer Architecture: Reusable video components across all game modes
• ✅ Video Library Integration: Seamless access to external video directories
• ✅ Player Statistics & Profiles: Watch time tracking, achievements, and user progression
• ✅ Focus Video Interruptions: Video overlays during training scenarios
• ✅ Enhanced Training Integration: Multi-screen mode button in interactive tasks

v2.0 - Major Content Update

• ✅ Added 7 specialized game modes with rich content
• ✅ Implemented progressive endurance training system
• ✅ Enhanced interactive task management
• ✅ Webcam integration for mirror and photography tasks
• ✅ Modular data system for better organization
• ✅ Removed deprecated scenario mode

v1.4 - Enhanced Image System

• ✅ Categorized image management (tasks vs consequences)
• ✅ High-quality compression and processing
• ✅ Storage quota management
• ✅ Bulk operations and selection

License

[Add your preferred license here]