novafarma/docs/TUTORIAL_SYSTEM.md

📚 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:

// Automatic on first start
// Or manually:
scene.tutorialSystem.showNextStep();

Show Help:

// Press H key
// Or manually:
scene.tutorialSystem.showHelp();

Reset Tutorial:

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