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

// 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):

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

Smooth Weather Transition (Console):

// 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):

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

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

// 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):

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:

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:

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:

   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! 🎮✨