# SYSTEM REQUIREMENTS & PLATFORM SPECIFICATIONS
**NovaFarma - 2084 Survival Farm**

---

## 💻 **PC (Windows)**

### **Minimum Requirements:**
- **OS:** Windows 10 64-bit
- **Processor:** Intel Core i3-6100 / AMD Ryzen 3 1200
- **Memory:** 4 GB RAM
- **Graphics:** NVIDIA GeForce GTX 660 / AMD Radeon HD 7850
- **DirectX:** Version 11
- **Storage:** 2 GB available space
- **Sound Card:** DirectX compatible

### **Recommended Requirements:**
- **OS:** Windows 10/11 64-bit
- **Processor:** Intel Core i5-8400 / AMD Ryzen 5 2600
- **Memory:** 8 GB RAM
- **Graphics:** NVIDIA GeForce GTX 1060 / AMD Radeon RX 580
- **DirectX:** Version 12
- **Storage:** 2 GB available space (SSD recommended)
- **Sound Card:** DirectX compatible

---

## 🍎 **macOS (MacBook)**

### **Minimum Requirements:**
- **OS:** macOS 10.15 (Catalina) or later
- **Processor:** Intel Core i5 (2016 or newer) / Apple M1
- **Memory:** 4 GB RAM
- **Graphics:** Intel Iris Plus Graphics 640 / Radeon Pro 555
- **Storage:** 2 GB available space
- **Metal:** Metal 2 compatible GPU

### **Recommended Requirements:**
- **OS:** macOS 12 (Monterey) or later
- **Processor:** Apple M1 / M2 / M3 chip
- **Memory:** 8 GB RAM
- **Graphics:** Apple M1 integrated / Radeon Pro 5500M or better
- **Storage:** 2 GB available space (SSD)
- **Metal:** Metal 3 compatible GPU

### **MacBook Models Tested:**
- ✅ MacBook Air M1/M2 (2020-2024)
- ✅ MacBook Pro 13" M1/M2 (2020-2024)
- ✅ MacBook Pro 14"/16" M1 Pro/Max (2021-2024)
- ⚠️ Intel MacBook Pro (2016-2019) - Lower performance

---

## 🐧 **Linux**

### **Minimum Requirements:**
- **OS:** Ubuntu 20.04 LTS / Fedora 34 / Arch Linux (kernel 5.10+)
- **Processor:** Intel Core i3 / AMD Ryzen 3
- **Memory:** 4 GB RAM
- **Graphics:** OpenGL 3.3 compatible
- **Storage:** 2 GB available space

### **Recommended Requirements:**
- **OS:** Ubuntu 22.04 LTS / Fedora 38 / Pop!_OS 22.04
- **Processor:** Intel Core i5 / AMD Ryzen 5
- **Memory:** 8 GB RAM
- **Graphics:** Vulkan 1.2 compatible (NVIDIA/AMD/Intel)
- **Storage:** 2 GB available space (SSD)

### **Supported Distributions:**
- ✅ Ubuntu 20.04+ / Linux Mint 20+
- ✅ Fedora 34+
- ✅ Arch Linux / Manjaro
- ✅ Pop!_OS 20.04+
- ✅ Debian 11+
- ⚠️ Steam OS 3.0 (Steam Deck)

### **Graphics Drivers:**
- **NVIDIA:** Proprietary driver 470+ recommended
- **AMD:** Mesa 21.0+ (open-source) or AMDGPU-PRO
- **Intel:** Mesa 21.0+ (open-source)

---

## 📱 **Android (Mobile)**

### **Minimum Requirements:**
- **OS:** Android 8.0 (Oreo) or later
- **Processor:** Snapdragon 660 / MediaTek Helio G80 or equivalent
- **Memory:** 3 GB RAM
- **Graphics:** Adreno 512 / Mali-G52 or better
- **Storage:** 500 MB available space
- **Screen:** 5.5" or larger, 720p resolution

### **Recommended Requirements:**
- **OS:** Android 11 or later
- **Processor:** Snapdragon 778G / MediaTek Dimensity 1100 or better
- **Memory:** 6 GB RAM
- **Graphics:** Adreno 642L / Mali-G77 or better
- **Storage:** 1 GB available space
- **Screen:** 6.0" or larger, 1080p resolution

### **Tested Devices:**
- ✅ Samsung Galaxy S10+ or newer
- ✅ Google Pixel 4 or newer
- ✅ OnePlus 7T or newer
- ✅ Xiaomi Mi 10 or newer
- ⚠️ Budget devices (under $200) - Reduced graphics quality

---

## 📱 **iOS (iPhone/iPad)**

### **Minimum Requirements:**
- **OS:** iOS 13.0 or later
- **Device:** iPhone 8 / iPad (6th gen) or newer
- **Processor:** Apple A11 Bionic or newer
- **Memory:** 2 GB RAM
- **Graphics:** Apple GPU (3-core)
- **Storage:** 500 MB available space
- **Screen:** 4.7" or larger, Retina display

### **Recommended Requirements:**
- **OS:** iOS 16.0 or later
- **Device:** iPhone 12 / iPad Air (4th gen) or newer
- **Processor:** Apple A14 Bionic or newer
- **Memory:** 4 GB RAM
- **Graphics:** Apple GPU (4-core or better)
- **Storage:** 1 GB available space
- **Screen:** 5.4" or larger, Super Retina XDR

### **Tested Devices:**
- ✅ iPhone 12 or newer (optimal performance)
- ✅ iPhone SE (3rd gen) - Good performance
- ✅ iPad Air (4th gen) or newer
- ✅ iPad Pro (2018 or newer) - Best performance
- ⚠️ iPhone 8/X - Playable (30 FPS, reduced settings)

### **App Store Features:**
- ✅ Game Center integration
- ✅ Cloud Save sync (iCloud)
- ✅ Controller support (PS5, Xbox, MFi)
- ✅ Achievements
- ⚠️ Requires Apple Developer Program ($99/year)

### **Performance Expectations:**
- iPhone 12+: 60 FPS @ 1080p (High settings)
- iPhone SE: 30-45 FPS @ 720p (Medium settings)
- iPad Pro: 90-120 FPS @ 1440p (Ultra settings)
- Battery: 4-6 hours continuous gameplay

---

## 🎮 **Handheld Gaming Devices**

### **Steam Deck**

#### **Performance Modes:**
- **30 FPS Mode:** Native resolution, High settings, 3-4 hour battery
- **60 FPS Mode:** 800p, Medium settings, 2-3 hour battery
- **Battery Saver:** 40 FPS, Low settings, 5-6 hour battery

#### **Specifications:**
- **CPU:** AMD Zen 2 (4-core, 8-thread, 2.4-3.5 GHz)
- **GPU:** AMD RDNA 2 (8 CUs, 1.0-1.6 GHz)
- **RAM:** 16 GB LPDDR5
- **Display:** 7" 1280x800 LCD, 60Hz
- **Storage:** 64GB eMMC / 256GB NVMe SSD / 512GB NVMe SSD
- **Expected Performance:** 
  - 1080p docked: 60 FPS (High settings)
  - 800p handheld: 60 FPS (Medium settings)
  - Battery life: 3-5 hours (depending on settings)

#### **Steam Deck Optimizations:**
- ✅ Quick Resume support
- ✅ FSR (FidelityFX Super Resolution) upscaling
- ✅ Cloud Save sync
- ✅ Custom controller layouts
- ✅ Per-game performance profiles

---

### **ROG Ally (ASUS)**

#### **Performance Modes:**
- **Turbo Mode (30W TDP):** 1080p, Ultra settings, 60+ FPS, 1.5-2 hour battery
- **Performance Mode (25W TDP):** 1080p, High settings, 60 FPS, 2-2.5 hour battery
- **Silent Mode (15W TDP):** 720p, Medium settings, 45-60 FPS, 3-4 hour battery

#### **Specifications:**
- **CPU:** AMD Ryzen Z1 Extreme (8-core, 16-thread, up to 5.1 GHz)
- **GPU:** AMD RDNA 3 (12 CUs, up to 2.7 GHz)
- **RAM:** 16 GB LPDDR5-6400
- **Display:** 7" 1920x1080 IPS, 120Hz, FreeSync Premium
- **Storage:** 512GB PCIe 4.0 NVMe SSD
- **Expected Performance:**
  - 1080p: 60-90 FPS (High settings)
  - 720p: 120 FPS (Medium settings)
  - Battery life: 2-4 hours (depending on TDP)

#### **ROG Ally Optimizations:**
- ✅ 120Hz display support
- ✅ Armoury Crate SE integration
- ✅ Game Genie overlay support
- ✅ Windows 11 optimized
- ✅ External GPU (via USB4/Thunderbolt) support

---

### **Other Handhelds:**

#### **Lenovo Legion Go**
- **CPU:** AMD Ryzen Z1 Extreme
- **GPU:** AMD RDNA 3 (12 CUs)
- **RAM:** 16 GB LPDDR5X
- **Display:** 8.8" 2560x1600 IPS, 144Hz
- **Expected Performance:** Similar to ROG Ally (higher res = slightly lower FPS)

#### **GPD Win 4**
- **CPU:** AMD Ryzen 7 6800U
- **GPU:** AMD RDNA 2 (12 CUs)
- **RAM:** 16/32 GB LPDDR5
- **Display:** 6" 1080p touchscreen
- **Expected Performance:** Between Steam Deck and ROG Ally

#### **AYA Neo 2**
- **CPU:** AMD Ryzen 7 6800U
- **GPU:** AMD RDNA 2 (12 CUs)
- **RAM:** 16/32 GB LPDDR5
- **Display:** 7" 1920x1200 IPS
- **Expected Performance:** Similar to GPD Win 4

---

## 🎮 **Gaming Consoles (Future Support)**

### **Nintendo Switch** (Planned)
- **Target:** Nintendo Switch (original & OLED)
- **Performance:** 720p handheld / 1080p docked, 30 FPS
- **Optimizations:** Reduced particles, simplified shaders, lower draw distance
- **Status:** ⏳ Under consideration (requires Unity/Unreal port)

### **Xbox Series S/X** (Planned)
- **Series S:** 1080p, 60 FPS (Medium-High settings)
- **Series X:** 4K, 60 FPS (Ultra settings) or 1080p 120 FPS
- **Status:** ⏳ Planned for Year 2

### **PlayStation 5** (Planned)
- **Performance Mode:** 1080p, 120 FPS
- **Quality Mode:** 4K, 60 FPS (Ultra settings)
- **DualSense Features:** Haptic feedback, adaptive triggers
- **Status:** ⏳ Planned for Year 2

---

## 📊 **Performance Benchmarks**

### **Desktop PC (RTX 3060):**
- 1080p Ultra: 144+ FPS
- 1440p High: 100+ FPS
- 4K Medium: 60 FPS

### **Steam Deck:**
- 800p Medium: 60 FPS stable
- Battery: 3-4 hours

### **ROG Ally:**
- 1080p High: 75-90 FPS
- Battery: 2-3 hours (Performance mode)

### **MacBook Air M2:**
- 1080p Medium: 60 FPS
- Battery: 5-6 hours

### **Android (Flagship):**
- 720p Low-Medium: 60 FPS
- Battery: 4-5 hours

---

## 🌐 **Network Requirements**

### **Single Player:**
- ❌ No internet required
- ✅ Offline mode fully supported

### **Multiplayer (Future):**
- **Minimum:** 5 Mbps download / 1 Mbps upload
- **Recommended:** 10 Mbps download / 2 Mbps upload
- **Ping:** < 100ms for smooth co-op

### **Cloud Saves:**
- **Steam Cloud:** Automatic (requires Steam login)
- **Manual Backup:** Local save folder

---

## 🔧 **Development Notes**

### **Engine:** Phaser 3 (JavaScript/WebGL)
### **Rendering:** WebGL 2.0 / Canvas fallback
### **Audio:** Web Audio API
### **Packaging:** Electron (desktop) / Capacitor (mobile)

### **Cross-Platform Compatibility:**
- ✅ Windows: Native Electron
- ✅ macOS: Electron (Universal Binary for Intel + Apple Silicon)
- ✅ Linux: AppImage / Flatpak
- ✅ Steam Deck: Proton compatibility layer
- ✅ Android: Capacitor + Cordova
- ⚠️ iOS: Planned (requires Apple Developer license)

---

## 🚀 **Futuristic Platforms (Experimental)**
Možnosti za prihodnost - eksperimentalna podpora.

### **📺 Smart TV**

#### **Samsung Smart TV (Tizen OS)**
- **Minimum:** 2020 models or newer
- **OS:** Tizen 5.5 or later
- **Processor:** Quad-core 1.3 GHz
- **Memory:** 2.5 GB RAM
- **Graphics:** Hardware accelerated WebGL
- **Storage:** 500 MB
- **Input:** Samsung Smart Remote / Bluetooth controller
- **Expected Performance:** 1080p @ 30-60 FPS
- **Status:** ⏳ Planned (Web-based port via Tizen SDK)

#### **LG Smart TV (webOS)**
- **Minimum:** 2020 models or newer
- **OS:** webOS 5.0 or later
- **Processor:** Quad-core 1.5 GHz
- **Memory:** 3 GB RAM
- **Graphics:** WebGL 2.0 support
- **Input:** LG Magic Remote / Game controller
- **Expected Performance:** 1080p @ 30-60 FPS
- **Status:** ⏳ Planned (Web-based port)

#### **Android TV / Google TV**
- **OS:** Android TV 9.0 or later
- **Processor:** MediaTek MT5895 or equivalent
- **Memory:** 2 GB RAM
- **Graphics:** Mali-G52 or better
- **Input:** Bluetooth game controller required
- **Expected Performance:** 1080p @ 60 FPS
- **Status:** ✅ Compatible (via Android APK sideload)

---

### **❄️ Smart Refrigerator (IoT Appliances)**

#### **Samsung Family Hub**
- **Display:** 21.5" Full HD touchscreen
- **OS:** Tizen-based (2021+ models)
- **Processor:** Quad-core
- **Memory:** 1 GB RAM
- **Input:** Touchscreen only (no controller support)
- **Expected Performance:** 720p @ 30 FPS
- **Use Case:** Casual gameplay while cooking/waiting
- **Status:** 🧪 Experimental (proof of concept)

#### **LG InstaView ThinQ**
- **Display:** 23" touchscreen
- **OS:** webOS
- **Expected Performance:** Similar to Samsung Family Hub
- **Status:** 🧪 Experimental

**Note:** Smart fridge implementation is primarily a novelty feature. Not recommended for extended gameplay sessions.

---

### **🚗 Car Infotainment Systems**

#### **Tesla In-Car Gaming**
- **Models:** Model S (2021+), Model X (2021+), Model 3 (2022+)
- **Display:** 17" center touchscreen (Model S/X/Y) / 15" (Model 3)
- **Processor:** AMD Ryzen (Model S/X) / Intel Atom (Model 3)
- **Graphics:** AMD RDNA 2 (Model S/X) / Intel integrated (Model 3)
- **Memory:** 16 GB RAM
- **Input:** USB game controller (required)
- **Expected Performance:** 
  - Model S/X: 1080p @ 60 FPS (High settings)
  - Model 3/Y: 720p @ 30-45 FPS (Medium settings)
- **Restriction:** Only playable when parked
- **Status:** ⏳ Planned (requires Tesla SDK access)

#### **General Car Infotainment (Android Automotive)**
- **OS:** Android Automotive OS
- **Systems:** Polestar 2, Volvo XC40, Renault Megane E-Tech
- **Display:** 9-12" touchscreen
- **Processor:** Snapdragon 820A Automotive or better
- **Memory:** 4-8 GB RAM
- **Input:** Touchscreen / Steering wheel controls
- **Expected Performance:** 720p @ 30 FPS
- **Safety Restriction:** Only accessible when vehicle is parked
- **Status:** ⏳ Planned (via Android Automotive app)

#### **CarPlay / Android Auto**
- **Note:** Apple CarPlay and Android Auto do NOT support games
- **Alternative:** Use iPhone/Android device directly (phone screen)
- **Status:** ❌ Not supported (platform limitation)

---

### **🎮 Other Emerging Platforms**

#### **Meta Quest 3 / Apple Vision Pro (VR/AR)**
- **Type:** Mixed Reality / Virtual Reality headset
- **Potential:** Non-VR mode (flat screen in virtual space)
- **Performance:** Native resolution @ 90Hz
- **Input:** Hand tracking / Controllers
- **Status:** 🧪 Research phase (low priority)

#### **Smart Glasses (AR)**
- **Devices:** Ray-Ban Meta, Vuzix Blade
- **Type:** Augmented Reality overlay
- **Use Case:** Minimal HUD, notifications only
- **Status:** 🔬 Conceptual (not practical for full gameplay)

#### **Smart Watch (Wear OS / watchOS)**
- **Type:** Companion app only
- **Features:** Inventory notifications, quick stats, alerts
- **Gameplay:** Not suitable for full game
- **Status:** 💡 Idea phase (companion app possible)

---

## 🎯 **Platform Roadmap**

### **Current (2025):**
- ✅ Windows, macOS, Linux
- ✅ Steam Deck, ROG Ally
- ✅ Android
- ⏳ iOS (In Development)

### **Near Future (2026):**
- 🔄 Nintendo Switch
- 🔄 Xbox Series S/X
- 🔄 PlayStation 5
- 🔄 Smart TV (Samsung/LG)

### **Experimental (2027+):**
- 🧪 Tesla In-Car Gaming
- 🧪 Smart Refrigerators
- 🧪 Android Automotive
- 🔬 AR/VR Support (Vision Pro)

---

## ⚠️ **Important Notes**

### **Safety Disclaimer for Automotive:**
**WARNING:** Playing games while driving is illegal and extremely dangerous. 
- Car infotainment gameplay is ONLY enabled when vehicle is in PARK mode
- Engine must be OFF or in accessory mode
- System will auto-pause if vehicle shifts out of park
- Intended for passengers and during charging/parking breaks

### **Smart Appliance Limitations:**
- Limited input methods (touchscreen only)
- Lower performance vs dedicated gaming devices
- Not recommended for competitive or long sessions
- Primarily novelty/casual use case

### **Development Costs:**
- Each platform requires separate SDK/license
- Tesla SDK: Invite-only program
- Smart TV SDKs: Free but require device purchase for testing
- iOS: $99/year Apple Developer Program
- Console SDKs: $2,500+ per platform + devkit hardware

---

**Last Updated:** 8.12.2025  
**Version:** Alpha 0.9.0  
**Supported Platforms:** 7 (Windows, macOS, Linux, Steam Deck, ROG Ally, Android, iOS)  
**Planned Platforms:** 6 (Switch, Xbox, PlayStation, Smart TV, Tesla, Android Automotive)  
**Experimental:** 4 (Smart Fridge, AR/VR, Smart Watch)