Przegląd Systemów Gry

Wprowadzenie

Lumos Islands składa się z wielu wzajemnie powiązanych systemów, które razem tworzą kompletne doświadczenie edukacyjno-rozrywkowe.

Mapa Systemów

┌─────────────────────────────────────────────────────────┐
│                    LUMOS ISLANDS                         │
└─────────────────────────────────────────────────────────┘
                          │
        ┌─────────────────┼─────────────────┐
        │                 │                 │
    ┌───▼────┐      ┌────▼────┐      ┌────▼────┐
    │ MIASTO │      │ OTWARTA │      │ DZIAŁKI │
    │        │      │  STREFA │      │         │
    └───┬────┘      └────┬────┘      └────┬────┘
        │                │                 │
        │                │                 │
┌───────▼────────┐  ┌───▼────┐    ┌──────▼───────┐
│   LOKACJE      │  │SUROWCE │    │   BUDOWANIE  │
│ • Kino         │  │• Drewno│    │ • Crafting   │
│ • Radio        │  │• Kamień│    │ • Stawianie  │
│ • Teatr        │  │• Rudy  │    │ • Dekoracje  │
│ • Lab          │  └────────┘    └──────────────┘
│ • ...          │
└────┬───────────┘
     │
┌────▼─────────┐       ┌──────────────┐
│ AKTYWNOŚCI   │       │   EKONOMIA   │
│ • Quizy      │◄──────┤ • LumoCoins  │
│ • Minigry    │       │ • Nagrody    │
│ • Wideo/Audio│       │ • Sklepy     │
│ • Zadania    │       │ • Handel     │
└──────────────┘       └──────────────┘
                              │
                    ┌─────────▼─────────┐
                    │  GRUPY & SOCIAL   │
                    │ • Klasy           │
                    │ • Grupy językowe  │
                    │ • Zadania grupowe │
                    │ • Chat            │
                    └───────────────────┘

Core Systems

1. System Walutowy (Currency System)

LumoCoins - uniwersalna waluta w grze

• Zdobywanie: za zadania edukacyjne, quizy, achievements
• Wydawanie: działki, dodatki do awatara, specjalne itemy
• Nie dotyczy: handel między graczami (tylko barter)

📄 Szczegóły: System Walutowy

---

2. System Lokacji (Location System)

Miasto składa się z predefiniowanych lokacji (POI - Points of Interest)

Każda lokacja zawiera:

• Unikalny typ aktywności (kino = wideo, radio = audio)
• Zestaw zadań/quizów
• NPC (opcjonalnie)
• Graficzne assety

📄 Szczegóły: Miasto i Lokacje

---

3. System Aktywności (Activity System)

Activity = jednostka treści edukacyjnych

Typy aktywności:

• Quiz - pytania wielokrotnego wyboru
• Minigra - interaktywna gra edukacyjna
• Wideo/Audio - materiały multimedialne
• Zadanie kreatywne - rysowanie, pisanie, budowanie

📄 Szczegóły: Zadania i Aktywności

---

4. System Surowców (Resource System)

Surowce zbierane w Otwartej Strefie

Kategorie:

• Podstawowe (drewno, kamień)
• Zaawansowane (rudy, kryształy)
• Specjalne (gemstones, komponenty)

Wykorzystanie:

• Crafting
• Budowanie
• Handel (barter)
• Sprzedaż do NPC

📄 Szczegóły: System Surowców

---

5. System Działek (Plot System)

Prywatne przestrzenie budowlane gracza

Charakterystyka:

• Kupowane za LumoCoins w mieście
• Różne rozmiary (small, medium, large)
• Progresywny cennik (każda następna droższa)
• Współdzielone lub prywatne

📄 Szczegóły: Działki

---

6. System Budowania (Building System)

Minecraft-like mechanika

Elementy:

• Bloki różnych typów
• Crafting (receptury)
• Narzędzia
• Dekoracje

📄 Szczegóły: Strefa Budowlana

---

7. System Grup (Group System)

Społeczne aspekty gry

Typy grup:

• Klasy szkolne
• Grupy językowe
• Grupy zainteresowań
• Prywatne (np. rodzeństwo)

Funkcje:

• Wspólne zadania
• Wspólne działki
• Chat grupowy
• Eventy

📄 Szczegóły: Grupy i Współpraca

---

8. System Ról Użytkowników (User Roles System)

Różne role w ekosystemie

Role:

• Dziecko/Gracz - główny użytkownik
• Rodzic - kontrola rodzicielska, zadania custom
• Nauczyciel - zarządzanie klasą, tworzenie treści
• Administrator - zarządzanie światami i treściami

📄 Szczegóły: Role Użytkowników

---

Przepływ Danych (Data Flow)

1. Dziecko Wykonuje Zadanie

Dziecko wchodzi do Kina
  ↓
Wybiera film edukacyjny (Activity)
  ↓
Ogląda film
  ↓
Rozwiązuje quiz (5 pytań)
  ↓
System sprawdza odpowiedzi
  ↓
Jeśli >80% poprawnych:
  ↓
  ✅ Nagroda: 25 LumoCoins
  ✅ Progress: +10 XP w kategorii "Nauka"
  ✅ Achievement: "Kinoman" (jeśli 10 filmów obejrzanych)
  ↓
Aktualizacja bazy danych:
  - User.lumocoins += 25
  - User.completed_activities.push(activity_id)
  - User.xp.science += 10

2. Dziecko Buduje na Działce

Dziecko idzie na swoją działkę
  ↓
Wybiera blok z inventory
  ↓
Stawia blok (jeśli ma surowce)
  ↓
System odejmuje surowce z inventory
  ↓
Blok pojawia się na działce
  ↓
Zapis do bazy:
  - Plot.blocks.push({type: "wood", position: [x,y,z]})
  - User.inventory.wood -= 1

3. Nauczyciel Tworzy Zadanie

Nauczyciel loguje się do Web App
  ↓
Tworzy nowy quiz "Tabliczka mnożenia"
  ↓
Dodaje 10 pytań
  ↓
Przypisuje do swojej klasy (30 dzieci)
  ↓
Ustawia nagrodę: 50 LumoCoins
  ↓
System tworzy Activity (JSON)
  ↓
Dzieci z klasy widzą nowe zadanie w mieście (np. w Bibliotece)
  ↓
Po wykonaniu: raport dla nauczyciela

---

Kluczowe Decyzje Projektowe

1. Waluta Uniwersalna, Surowce Lokalne

• LumoCoins: uniwersalne dla wszystkich światów
• Surowce: osobne dla każdego świata (nie przenoszą się)

Dlaczego?

• LumoCoins = nagroda za edukację (powinna być uniwersalna)
• Surowce = część gameplay danego świata (lokalny balans ekonomiczny)

2. Handel Tylko Barter

• Gracze mogą wymieniać się tylko surowcami
• Nie można handlować LumoCoins między graczami

Dlaczego?

• Zapobiega scamom i wyzyskowi młodszych dzieci
• Uczy wartości barterowej
• LumoCoins są nagrodą za edukację, nie przedmiotem handlu

3. Progresywny System Działek

• Pierwsza działka: tańsza
• Każda następna: droższa

Dlaczego?

• Zachęca do planowania i zarządzania przestrzenią
• Długoterminowy goal (motywacja do zarabiania)
• Zapobiega spam-owaniu działkami

4. Małe i Częste Nagrody

• Zadania dają 5-50 LumoCoins
• Zamiast 1000 za duży projekt

Dlaczego?

• Szybka gratyfikacja dla dzieci
• Feeling of progress
• Częstsza interakcja z systemem nagród

5. Activity Assets jako JSON

• Wszystkie zadania/quizy/materiały jako pliki JSON
• Mini-aplikacje, łatwe do dodawania

Dlaczego?

• Łatwo skalowalne
• Rodzice/nauczyciele mogą tworzyć własne (w przyszłości)
• Oddzielenie danych od logiki gry
• Łatwo przetestować i zmodyfikować

---

Integracja Systemów

Przykład: Kompletny Flow Gracza

Scenariusz: 8-letnia Zuzia chce zbudować domek

1. Start: Zuzia ma 20 LumoCoins, 5 drewna, 0 działek
2. Cel: Potrzebuje działkę aby budować

Krok 1: Zarobienie monet

• Idzie do Kina
• Ogląda film o dinozaurach (10 min)
• Rozwiązuje quiz (5/5 poprawnych)
• Nagroda: +25 LumoCoins ✅
• Stan: 45 LumoCoins, 5 drewna

Krok 2: Zbieranie surowców

• Wychodzi z miasta do Otwartej Strefy
• Zbiera drewno (klikając na drzewa)
• Zebrała: +15 drewna
• Stan: 45 LumoCoins, 20 drewna

Krok 3: Kupno działki

• Wraca do miasta
• Idzie do Sklepu z Działkami
• Kupuje małą działkę za 50 LC
• Problem: Ma tylko 45 LC, brakuje 5

Krok 4: Dodatkowe zadanie

• Idzie do Radio
• Słucha podcastu o przyrodzie (5 min)
• Rozwiązuje quiz (4/5 poprawnych)
• Nagroda: +20 LumoCoins ✅
• Stan: 65 LumoCoins, 20 drewna

Krok 5: Kupno działki (retry)

• Wraca do Sklepu
• Kupuje małą działkę za 50 LC ✅
• Stan: 15 LumoCoins, 20 drewna, 1 działka

Krok 6: Budowanie

• Teleportuje się na działkę
• Otwiera crafting menu
• Crafting: 4 drewna = 1 ściana
• Buduje 4 ściany (zużywa 16 drewna)
• Crafting: 2 drewna = 1 dach
• Buduje 1 dach (zużywa 2 drewna)
• Stan: 15 LumoCoins, 2 drewna, 1 domek ✅

Krok 7: Achievement

• System wykrywa: "Zbudowałaś pierwszy dom!"
• Nagroda: Badge "Architekt" + 30 LumoCoins ✅
• Stan końcowy: 45 LumoCoins, 2 drewna, 1 domek, 1 badge

---

Metryki i Analityka

Kluczowe Metryki dla Gry

1. Engagement

   • Daily Active Users (DAU)
   • Session duration
   • Retention (D1, D7, D30)

2. Educational Impact

   • Zadania ukończone (completion rate)
   • Quiz accuracy (% poprawnych odpowiedzi)
   • Time spent na aktywności edukacyjne vs budowanie

3. Economy

   • LumoCoins earned per day (średnia)
   • LumoCoins spent (gdzie wydają)
   • Balance (faucet vs sink)

4. Social

   • Grupowe zadania ukończone
   • Handel między graczami (transactions)
   • Chat activity (jeśli włączony)

5. Content

   • Najpopularniejsze aktywności
   • Najsłabiej wykonane quizy (do poprawy)
   • Custom content od nauczycieli (ile, jakość)

---

Roadmap Systemów

v1.0 (MVP)

• ✅ System walutowy (LumoCoins)
• ✅ Podstawowe lokacje (3-5 w mieście)
• ✅ Prosty crafting i budowanie
• ✅ Działki (1 rozmiar)
• ✅ Quizy podstawowe
• ✅ Single-player mode

v1.1

• ✅ Multiplayer (widzenie innych graczy)
• ✅ Chat (predefiniowane wiadomości)
• ✅ Więcej lokacji (10+)
• ✅ Różne rozmiary działek

v1.2

• ✅ Grupy i zadania grupowe
• ✅ Custom content (nauczyciele mogą dodawać)
• ✅ Achievements system
• ✅ Handel między graczami

v2.0

• ✅ Wiele światów
• ✅ Eventy sezonowe
• ✅ Zaawansowany crafting
• ✅ Private worlds dla szkół

---

Podsumowanie

Systemy Lumos Islands są zaprojektowane aby:

1. Skalować się - od prostego MVP do zaawansowanej platformy
2. Integrować - wszystkie systemy współpracują ze sobą
3. Modularność - każdy system może być rozwijany niezależnie
4. Bezpieczeństwo - kontrola rodzicielska i moderacja
5. Edukacja First - nagrody za edukację, zabawa jako motywator

Kolejne dokumenty opisują każdy system szczegółowo z przykładami implementacji.