training-academy/docs/INSTALLATION_GUIDE.md

🎮 Gooner Training Academy - Distribution Setup

📦 Installation Methods

Method 1: Automated Setup (Recommended)

Windows Users:

1. Double-click scripts/setup.bat
2. Follow the prompts
3. Launch with scripts/Start-webgame.bat

Mac/Linux Users:

1. Open terminal in this folder
2. Run: chmod +x scripts/setup.sh && ./scripts/setup.sh
3. Launch with: npm start

Method 2: Manual Setup

Prerequisites:

• Node.js 16+ - Download from https://nodejs.org/
• Modern Browser - Chrome 90+, Firefox 88+, Safari 14+
• 50MB+ Free Space - For application and user content

Installation Steps:

# 1. Install dependencies
npm install

# 2. Launch application
npm start

# Alternative: Web browser mode
# Open index.html in your browser

---

🎯 Quick Start Guide

First Time Setup:

1. Launch Application - Use setup scripts or npm start
2. Grant Permissions - Allow camera access when prompted
3. Explore Interface - Navigate through the main hub
4. Test Features - Try each game mode briefly
5. Upload Content - Add custom images via Library Management

Recommended Testing Order:

1. Quick Play (15 min) - Test core functionality
2. Library Management - Upload 3-5 test images
3. Training Academy - Test webcam verification
4. Porn Cinema - Test video playback
5. Statistics - Review progress tracking

---

🛠️ Technical Configuration

System Requirements:

• OS: Windows 10+, macOS 10.14+, Ubuntu 18.04+
• RAM: 4GB minimum, 8GB recommended
• Storage: 100MB application + user content
• Webcam: Any USB or built-in camera
• Network: None required (fully offline)

Browser Requirements:

• Chrome: 90+ (Recommended)
• Firefox: 88+
• Safari: 14+
• Edge: 90+

Optional Enhancements:

• External Video Directory - Link existing video collections
• High-Quality Images - 1600x1200 resolution support
• Multiple Audio Tracks - Background music variety

---

🔧 Configuration Options

Application Settings:

{
  "autoBackup": true,
  "backupInterval": 30,
  "maxImageStorage": 50,
  "defaultTheme": "library",
  "enableTTS": true,
  "videoQuality": "high"
}

Performance Tuning:

• Low-End Systems: Reduce video quality, disable auto-backup
• High-End Systems: Enable all features, extended sessions
• Storage Constrained: Regular library cleanup, external video linking

---

📁 File Structure Overview

Gooner-Training-Academy/
├── 📄 TESTER_GUIDE.md         # Testing instructions
├── 📄 INSTALLATION_GUIDE.md   # This file
├── 📄 README.md               # Full documentation
├── 📁 scripts/               # Installation and launch scripts
│   ├── setup.bat             # Windows installer
│   ├── setup.sh              # Mac/Linux installer
│   └── Start-webgame.bat     # Windows launcher
├── 📄 package.json            # Dependencies
├── 🌐 index.html              # Main application
├── 📁 src/                    # Application code
│   ├── core/                  # Game engine
│   ├── features/              # Feature modules
│   └── data/                  # Game configurations
├── 📁 images/                 # User image library
├── 📁 audio/                  # Background music
├── 📁 assets/                 # Application assets
└── 📁 docs/                   # Additional documentation

---

🎮 Game Mode Overview

🎬 Training Academy

• Purpose: Structured scenario-based training
• Features: Webcam verification, progressive scenarios
• Duration: 15-60 minutes per session
• XP Rewards: 1 XP per 2 minutes + bonuses

⚡ Quick Play

• Purpose: Fast-start customizable sessions
• Features: Task filtering, background videos
• Duration: 15 minutes to unlimited
• XP Rewards: 1-3 XP per task + time bonuses

🎭 Porn Cinema

• Purpose: Professional video viewing experience
• Features: Playlists, progress tracking, theater mode
• Duration: Based on video content
• XP Rewards: 1 XP per 5 minutes viewing

---

📊 Data & Privacy

Data Storage:

• Local Only: All data stays on your device
• No Network: No data sent to external servers
• Backup System: Automatic local backups every 30 minutes
• Export/Import: Portable data management

Privacy Features:

• Offline Operation: No internet connection required
• Encrypted Storage: Local data protection
• No Telemetry: No usage data collection
• User Control: Full data management control

---

⚠️ Important Notes for Testers

Development Build:

• This is a beta version with ongoing development
• Some features may have rough edges
• Performance optimizations still in progress
• Report any crashes or significant issues

Content Guidelines:

• This is adult content for 18+ users only
• Use appropriate content for testing
• Respect local laws and regulations
• Test responsibly in private environments

Testing Focus Areas:

1. Stability - Look for crashes and error states
2. Performance - Note slowdowns or memory issues
3. Features - Test all advertised functionality
4. Usability - Evaluate interface and user experience

---

🆘 Emergency Procedures

Data Recovery:

# Restore from automatic backup
npm run restore-backup

# Manual backup location
./backups/[timestamp]/

Reset Application:

# Clear all user data (WARNING: Permanent)
npm run reset-all

# Reset settings only
npm run reset-settings

Performance Reset:

# Clear cache and temporary files
npm run cleanup

# Full application restart
npm run restart

---

📞 Support Resources

Documentation:

• README.md - Complete feature documentation
• TESTER_GUIDE.md - Testing-specific instructions
• docs/ - Additional technical documentation

Troubleshooting:

1. Check console logs (F12 in browser)
2. Review error messages in terminal
3. Verify system requirements
4. Try browser refresh or application restart

Community:

• GitHub Issues - Technical problems and bugs
• Feedback Email - General suggestions and improvements
• Discord - Real-time testing discussion

---

Ready to begin testing? Launch the application and start with the TESTER_GUIDE.md! 🚀