From 0f20a33b270b48c8f9117086771413ada913991e Mon Sep 17 00:00:00 2001 From: SimonezYT Date: Wed, 1 Apr 2026 11:58:43 +0200 Subject: [PATCH] Update README.md --- README.md | 111 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 58 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 1694be5..0706099 100755 --- a/README.md +++ b/README.md @@ -1,54 +1,59 @@ -# 🌍 Pulisci il Mondo - Progetto per la Giornata della Terra - -**Pulisci il Mondo** Γ¨ 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. -- [❌] **Rifinitura (Polish):** Animazioni di raccolta e ottimizzazione delle mesh 3D. - -### ♻️ 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. - -### πŸ† 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. -- [❌] **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 core e rendering (Three.js, stage1.js, stage2.js). -* `/php` - Script per il backend (`db_connect.php`, `save_score.php`). -* `/games` - Pagine HTML dedicate alle sessioni di gioco (`fase1.html`, `fase2.html`). +# 🌍 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. + +### πŸ† 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 core e rendering (Three.js, stage1.js, stage2.js). +* `/php` - Script per il backend (`db_connect.php`, `save_score.php`). +* `/games` - Pagine HTML dedicate alle sessioni di gioco (`fase1.html`, `fase2.html`). * `index.php` - Homepage e controller principale del progetto. \ No newline at end of file