shrani

2025-12-12 13:48:49 +01:00
parent 6c583a6576
commit 8b005065fe
305 changed files with 294 additions and 0 deletions
--- a/docs/guides/SYSTEM_REQUIREMENTS.md
+++ b/docs/guides/SYSTEM_REQUIREMENTS.md
@@ -0,0 +1,480 @@
+# 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)