tuturiol

docs/TUTORIAL_SYSTEM.md

@@ -0,0 +1,160 @@
+# 📚 TUTORIAL SYSTEM - Complete!
+
+**Date**: December 13, 2025, 01:30
+
+---
+
+## ✅ WHAT IT DOES
+
+### **Automatic Tutorial**
+- Shows on first game start
+- 6 steps covering all basics
+- Auto-advances after 5 seconds
+- Can skip anytime
+
+### **Help Anytime**
+- Press **H** for keyboard shortcuts
+- Shows all controls
+- Quick reference
+
+---
+
+## 🎮 TUTORIAL STEPS
+
+### **Step 1: Welcome**
+- Movement (W/A/S/D)
+- Attack (SPACE)
+- Interact (E)
+
+### **Step 2: Building**
+- Build mode (B)
+- Select buildings (1-5)
+- Place buildings (Click)
+
+### **Step 3: Crafting**
+- Crafting menu (C)
+- Craft tools
+- Use resources
+
+### **Step 4: Fishing**
+- Cast rod (R)
+- Catch fish (SPACE)
+- Move bobber (LEFT/RIGHT)
+
+### **Step 5: Save/Load**
+- Quick save (F5)
+- Load game (F9)
+- Auto-save
+
+### **Step 6: More Controls**
+- Stats panel (TAB)
+- Map (M)
+- Pause (ESC)
+- Help (H)
+
+---
+
+## ⌨️ KEYBOARD SHORTCUTS
+
+### **Press H anytime to see:**
+
+```
+🎮 MOVEMENT:
+W/A/S/D - Move
+SPACE - Attack
+E - Interact
+
+🏗️ BUILD & CRAFT:
+B - Build Mode
+C - Crafting Menu
+
+🎣 FISHING:
+R - Cast Rod
+SPACE - Catch Fish
+
+💾 SAVE/LOAD:
+F5 - Quick Save
+F9 - Load Game
+
+📋 OTHER:
+TAB - Stats Panel
+M - Map
+ESC - Pause
+H - Help
+```
+
+---
+
+## 🎨 DESIGN
+
+### **Popup Style:**
+- Dark green background
+- Light green border
+- Farm theme colors
+- Large, readable text
+
+### **Features:**
+- Progress indicator (Step X of 6)
+- Skip button
+- Next button
+- Auto-advance
+
+### **Animation:**
+- Fade in
+- Scale effect
+- Smooth transitions
+
+---
+
+## 💾 PROGRESS SAVING
+
+### **Remembers:**
+- Tutorial completed status
+- Current step
+- Saved in localStorage
+
+### **Reset:**
+- Clear browser data
+- Or call `tutorialSystem.reset()`
+
+---
+
+## 🔧 USAGE
+
+### **Show Tutorial:**
+```javascript
+// Automatic on first start
+// Or manually:
+scene.tutorialSystem.showNextStep();
+```
+
+### **Show Help:**
+```javascript
+// Press H key
+// Or manually:
+scene.tutorialSystem.showHelp();
+```
+
+### **Reset Tutorial:**
+```javascript
+scene.tutorialSystem.reset();
+```
+
+---
+
+## ✨ FEATURES
+
+- ✅ 6-step tutorial
+- ✅ Auto-advance
+- ✅ Skip option
+- ✅ Progress saving
+- ✅ Help popup (H key)
+- ✅ Farm theme design
+- ✅ Smooth animations
+- ✅ Keyboard shortcuts reference
+
+---
+
+**Osveži igro s F5 da vidiš tutorial!** 🔄
+
+*Created: December 13, 2025, 01:30*