training-academy/README.md

13 KiB

🎮 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

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