# 🎮 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:**
```bash
# 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:**
```json
{
  "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:**
```bash
# Restore from automatic backup
npm run restore-backup

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

### **Reset Application:**
```bash
# Clear all user data (WARNING: Permanent)
npm run reset-all

# Reset settings only
npm run reset-settings
```

### **Performance Reset:**
```bash
# 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!** 🚀