60 lines
3.9 KiB
Markdown
60 lines
3.9 KiB
Markdown
# 🌍 Save the Island - Progetto per la Giornata della Terra
|
|
|
|
**Save the Island** è un videogioco web in 3D nato per sensibilizzare gli utenti sulla gestione dei rifiuti e l'importanza del riciclo. Il progetto adotta un'architettura Fullstack basata su **XAMPP** per la gestione di una classifica globale e il salvataggio dei record.
|
|
|
|
---
|
|
|
|
## 🛠️ Architettura Tecnica
|
|
* **Entrypoint:** `index.php` (Pagina di atterraggio con trailer e controlli).
|
|
* **Backend:** PHP + MySQL (XAMPP) per la gestione del database e dei punteggi.
|
|
* **Frontend:** **Three.js** (motore 3D), JavaScript (ES6+), CSS3.
|
|
* **Trasferimento Dati:** Utilizzo di Cookie temporanei o `localStorage` per mantenere i dati tra le diverse fasi di gioco.
|
|
|
|
---
|
|
|
|
## 🗺️ Roadmap di Sviluppo
|
|
|
|
### 🚩 Milestone Generali (Nucleo del Progetto)
|
|
- [⚠️] **Design UI & Mockup:** Finalizzazione degli asset grafici (basati sullo schema Draw.io).
|
|
- [❌] **Configurazione Database:** Creazione delle tabelle `classifica` e `records` su MySQL.
|
|
- [⚠️] **Logica Entrypoint:** Sviluppo di `index.php` con video di sfondo e overlay dei comandi.
|
|
- [⚠️] **Sistema di Trasferimento:** Implementazione logica per il passaggio dei dati dalla Fase 1 alla Fase 2.
|
|
- [❌] **Gestione Impostazioni:** Pannello per regolare il volume e inserire il nome della squadra (servira' nella classifica).
|
|
- [⚠️] **Pagina Dinamica:** Creazione della classifica in PHP con recupero dati in tempo reale.
|
|
|
|
### 🏝️ Fase 1: La Raccolta (Timer: 1m)
|
|
- [✅] **Ambiente di gioco:** Modellazione dell'isola 3D con Three.js e gestione dei confini della mappa.
|
|
- [✅] **Sistema di Spawn:** Posizionamento casuale dei rifiuti su 20 coordinate casuali.
|
|
- [✅] **Sistema Ostacoli:** Inserimento di modelli 3D di alberi e oggetti ambientali decorativi.
|
|
- [✅] **Meccaniche di Raccolta:** Gestione delle collisioni e incremento del punteggio ecologico.
|
|
- [✅] **Interfaccia (HUD):** Overlay con Timer (60s), contatore rifiuti e disattivazione della pausa.
|
|
- [⚠️] **Schermata di caricamento:** Schermata di caricamento iniziale
|
|
- [⚠️] **Schermata iniziale:** Schermata iniziale
|
|
- [❌] **Rifinitura (Polish):** Animazioni di raccolta e ottimizzazione delle mesh 3D.
|
|
- [✅] **Timer:** Meccanica del timer per il tempo di raccolta dei rifiuti
|
|
- [❌] **Personaggio:** Cilindro che rappresenta il personaggio (fatto per collisioni piu' precise)
|
|
|
|
### ♻️ Fase 2: Lo Smistamento (Timer: 5s * Punteggio)
|
|
- [⚠️] **Timer Dinamico:** Calcolo del tempo a disposizione basato sul successo della Fase 1.
|
|
- [✅] **Motore di Smistamento:** Logica di convalida (Rifiuto ↔️ Bidone corretto).
|
|
- [✅] **Interfaccia Utente:** Layout con i 6 bidoni (Plastica, Umido, Indifferenziata, Vetro, Carta, Alluminio).
|
|
- [✅] **Gestione Input:** Meccanica di interazione tramite Drag & Drop o selezione rapida.
|
|
- [✅] **Feedback Visivo:** Effetti sonori e visivi per risposte corrette o errate.
|
|
- [❌] **Rifinitura (Polish):** Abbellimento grafico.
|
|
|
|
### 🏆 Fase Finale: Classifica & Record
|
|
- [❌] **Calcolo Punteggio:** Elaborazione dei risultati finali e calcolo dei bonus velocità.
|
|
- [❌] **Verifica Record:** Confronto del punteggio con il record personale salvato.
|
|
- [❌] **Classifica Globale:** Script PHP per l'invio e la visualizzazione della Top 10 dal database.
|
|
- [⚠️] **Classifica completa:** Pagina PHP per visualizzare la classifica di tutte le partite dal database.
|
|
- [⚠️] **Schermata Game Over:** Riepilogo statistiche e opzione per riavviare la partita.
|
|
|
|
---
|
|
|
|
## 📂 Struttura delle Cartelle
|
|
* `/assets` - Modelli 3D, video loop, texture dei rifiuti e icone dei bidoni.
|
|
* `/css` - Fogli di stile per i menu e l'interfaccia di gioco (HUD).
|
|
* `/js` - Logica delle due fasi del gioco (fase1.js, fase2.js).
|
|
* `/php` - Script per il backend (`db_connect.php`, `save_score.php`).
|
|
* `/pages` - Pagine HTML dedicate alle varie pagine del gioco (`fase1.html`, `fase2.html`).
|
|
* `index.php` - Homepage e controller principale del progetto. |