updejt

2025-12-13 01:29:24 +01:00
parent f6450cd3b8
commit c618f3d7fa
13 changed files with 1195 additions and 72 deletions
--- a/docs/CENTRAL_POPUP_GUIDE.md
+++ b/docs/CENTRAL_POPUP_GUIDE.md
@@ -0,0 +1,192 @@
+# 📋 CENTRAL POPUP SYSTEM - Complete Guide
+
+**Date**: December 13, 2025, 01:09
+
+---
+
+## ✅ WHAT IT DOES
+
+### **Central Popups**
+- Appears in **CENTER** of screen
+- Always **in front** of player
+- Pauses game (optional)
+- Easy to read and interact
+- Beautiful animations
+
+### **Types of Popups**
+1. **Quest** - Quest dialogs (📜)
+2. **Story** - Story moments (📖)
+3. **Info** - Information (ℹ️)
+4. **Success** - Success messages (✅)
+5. **Warning** - Warnings (⚠️)
+6. **Error** - Errors (❌)
+
+---
+
+## 🎮 HOW TO USE
+
+### **Show Quest:**
+```javascript
+scene.centralPopup.showQuest(
+    'First Harvest',
+    'Plant and harvest your first crops!',
+    ['Plant 5 seeds', 'Water them', 'Harvest when ready']
+);
+```
+
+### **Show Story:**
+```javascript
+scene.centralPopup.showStory(
+    'Welcome to NovaFarma',
+    'You arrive at an abandoned farm. Time to rebuild!',
+    'farm_image' // optional image
+);
+```
+
+### **Show Notification:**
+```javascript
+scene.centralPopup.showNotification('Quest completed!', 'success');
+scene.centralPopup.showNotification('Low health!', 'warning');
+```
+
+### **Custom Popup:**
+```javascript
+scene.centralPopup.showPopup({
+    title: 'Custom Title',
+    message: 'Your message here',
+    type: 'info',
+    icon: '🎉',
+    buttons: [
+        { text: 'Yes', callback: () => console.log('Yes!') },
+        { text: 'No', action: 'close' }
+    ],
+    autoClose: false
+});
+```
+
+---
+
+## 🎨 FEATURES
+
+### **Automatic Positioning**
+- Always centered on screen
+- Responsive to screen size
+- Scrolls with camera
+
+### **Beautiful Design**
+- Rounded corners
+- Colored borders (based on type)
+- Smooth animations
+- Dark overlay behind
+
+### **Interactive**
+- Multiple buttons
+- Hover effects
+- Click handlers
+- Auto-close option
+
+### **Game Integration**
+- Pauses game (optional)
+- Sound effects
+- Queue system (multiple popups)
+- Priority levels
+
+---
+
+## 📊 POPUP TYPES & COLORS
+
+| Type | Color | Border | Icon | Use For |
+|------|-------|--------|------|---------|
+| Quest | Brown | Gold | 📜 | Quests, missions |
+| Story | Dark Blue | Purple | 📖 | Story moments |
+| Info | Dark Gray | Gray | ℹ️ | Information |
+| Success | Dark Green | Green | ✅ | Achievements |
+| Warning | Dark Red | Red | ⚠️ | Warnings |
+| Error | Dark Red | Red | ❌ | Errors |
+
+---
+
+## 🔧 SETTINGS
+
+### **Enable/Disable:**
+```javascript
+scene.centralPopup.settings.enabled = false;  // Disable
+```
+
+### **Auto-Close:**
+```javascript
+scene.centralPopup.settings.autoClose = true;
+scene.centralPopup.settings.autoCloseDelay = 5000;  // 5 seconds
+```
+
+### **Pause Game:**
+```javascript
+scene.centralPopup.settings.pauseGameOnPopup = true;
+```
+
+### **Sound:**
+```javascript
+scene.centralPopup.settings.soundOnPopup = true;
+```
+
+---
+
+## 💡 EXAMPLES
+
+### **Quest Accept/Decline:**
+```javascript
+scene.centralPopup.showPopup({
+    title: 'New Quest Available',
+    message: 'Help the farmer harvest crops!',
+    type: 'quest',
+    icon: '📜',
+    buttons: [
+        { 
+            text: 'Accept', 
+            callback: () => {
+                // Start quest
+                scene.questSystem.startQuest('harvest_quest');
+            }
+        },
+        { text: 'Decline', action: 'close' }
+    ],
+    autoClose: false
+});
+```
+
+### **Story Cutscene:**
+```javascript
+scene.centralPopup.showStory(
+    'Day 1',
+    'The sun rises over your new farm. Time to get to work!',
+    'sunrise_image'
+);
+```
+
+### **Achievement:**
+```javascript
+scene.centralPopup.showNotification(
+    'Achievement Unlocked: First Harvest!',
+    'success'
+);
+```
+
+---
+
+## 🎉 RESULT
+
+**Perfect for:**
+- ✅ Quest dialogs
+- ✅ Story moments
+- ✅ Important notifications
+- ✅ Achievements
+- ✅ Warnings
+- ✅ Any message that needs attention!
+
+**Always visible, always centered, always beautiful!** 📋✨
+
+---
+
+**Osveži igro s F5 da vidiš!** 🔄
+
+*Created: December 13, 2025, 01:09*