novafarma/docs/QUICK_DEMO_GUIDE.md

# 🎮 QUICK DEMO GUIDE - NEW FEATURES

**Date:** 15.12.2025  
**Systems:** Lighting, Weather, UI, Particles

---

## ✨ **HOW TO TEST ALL 4 NEW SYSTEMS:**

### 1️⃣ **💡 Dynamic Lighting & Shadows**

**Player Shadow:**
- Move your player around
- **Watch:** Shadow follows beneath player
- **Notice:** Shadow is darker during day, lighter at night

**Auto-Torch at Night:**
1. Open console (F12)
2. Type: `this.scene.scenes[1].weatherSystem.gameTime = 21`
3. Press Enter
4. **Watch:** Warm flickering glow appears around player!
5. Reset: `this.scene.scenes[1].weatherSystem.gameTime = 12`

**Manual Light Test (Console):**
```javascript
// Create campfire
this.scene.scenes[1].lightingSystem.createCampfire(500, 300);

// Create custom light
this.scene.scenes[1].lightingSystem.createLight(600, 300, 120, 0xff00ff, 0.5, true);
```

---

### 2️⃣ **🌬️ Wind-Affected Weather**

**Wind System:**
1. Press **R** key to toggle rain
2. **Watch:** Rain particles drift horizontally (not just straight down!)
3. Wait 5-10 seconds
4. **Notice:** Wind direction changes gradually
5. Rain angle shifts over time

**Check Wind Info (Console):**
```javascript
const wind = this.scene.scenes[1].weatherEnhancements.getWindInfo();
console.log(`Wind: ${wind.speedKmh} km/h from ${wind.directionName}`);
```

**Smooth Weather Transition (Console):**
```javascript
// Smooth fade from clear to rain
this.scene.scenes[1].weatherEnhancements.transitionWeather('clear', 'rain', () => {
    console.log('Weather changed smoothly!');
});
```

---

### 3️⃣ **🎨 Complete UI Animation Toolkit**

**Tooltip Test (Console):**
```javascript
const uiPolish = this.scene.scenes[1].uiPolish;

// Show tooltip
uiPolish.showTooltip(400, 300, "Hello World!\nThis is a tooltip!", {
    backgroundColor: '#FF0000',
    textColor: '#FFFFFF',
    fontSize: '18px'
});

// Hide after 3 seconds
setTimeout(() => uiPolish.hideTooltip(), 3000);
```

**Number Animation (Console):**
```javascript
const scene = this.scene.scenes[1];
const text = scene.add.text(400, 200, '0', { 
    fontSize: '48px',
    color: '#FFD700',
    fontWeight: 'bold'
});
scene.uiPolish.animateNumber(text, 0, 1000, 2000, 'Score: ');
```

**Button Effects (Console):**
```javascript
// Create test button
const scene = this.scene.scenes[1];
const btn = scene.add.rectangle(400, 300, 150, 50, 0x4444ff);
btn.setInteractive();
scene.uiPolish.addButtonHover(btn, 1.2, 200);

// Try hovering over the blue rectangle!
```

**Pulse Effect (Console):**
```javascript
const scene = this.scene.scenes[1];
scene.uiPolish.pulse(scene.player.sprite, 0.95, 1.05, 1000);
```

---

### 4️⃣ **✨ Enhanced Particle Effects**

**IN-GAME TESTS:**

**Craft Sparkles:**
1. Press **C** key (open crafting)
2. Craft any item (e.g., Wooden Fence)
3. **Watch:** Golden sparkle burst around player! ✨

**Dig Particles:**
1. Equip hoe (if available)
2. Click on grass tile
3. **Watch:** Brown soil particles spray upward! 💨

**Plant Sparkles:**
1. Plant seeds on tilled soil
2. **Watch:** Green sparkles appear! 🌱

**Harvest Burst:**
1. Wait for crop to grow (or speed up time)
2. Harvest mature crop
3. **Watch:** Colored particle burst! 🌾
   - Wheat → Golden particles
   - Carrot → Orange particles

**CONSOLE TESTS:**
```javascript
const particles = this.scene.scenes[1].particleEnhancements;

// Level up effect (spectacular!)
particles.levelUpEffect(400, 300);

// Damage impact (red burst)
particles.damageImpact(450, 300, 0xFF0000);

// Heal effect (rising green sparkles)
particles.healEffect(350, 300);

// Craft sparkles (golden)
particles.craftSparkles(400, 250);

// Harvest burst with different crops
particles.harvestBurst(500, 300, 'wheat');  // Golden
particles.harvestBurst(300, 300, 'carrot'); // Orange
```

---

## 🎯 **QUICK ALL-IN-ONE TEST:**

**Run this in console for a spectacular show:**
```javascript
const scene = this.scene.scenes[1];

// 1. Create lights
scene.lightingSystem.createCampfire(300, 250);
scene.lightingSystem.createCampfire(500, 250);

// 2. Start rain with wind
scene.weatherSystem.startRain(false);

// 3. Level up effect
scene.particleEnhancements.levelUpEffect(400, 300);

// 4. Create tooltip
setTimeout(() => {
    scene.uiPolish.showTooltip(400, 200, "✨ ALL SYSTEMS ACTIVE! ✨", {
        backgroundColor: '#4444ff',
        textColor: '#ffffff',
        fontSize: '24px'
    });
}, 2000);

console.log("🎉 All 4 systems demonstrated!");
```

---

## 🐛 **TROUBLESHOOTING:**

**If effects don't appear:**
1. Check console for errors (F12)
2. Verify systems loaded:
   ```javascript
   console.log(this.scene.scenes[1].lightingSystem ? '✅ Lighting' : '❌ Lighting');
   console.log(this.scene.scenes[1].weatherEnhancements ? '✅ Weather' : '❌ Weather');
   console.log(this.scene.scenes[1].uiPolish ? '✅ UI' : '❌ UI');
   console.log(this.scene.scenes[1].particleEnhancements ? '✅ Particles' : '❌ Particles');
   ```

---

**Enjoy your enhanced game!** 🎮✨