training-academy/README.md

326 lines
13 KiB
Markdown

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