🎮 Imparare Python Programmando Giochi
Impara Python divertendoti! Un percorso completo per trasformare la teoria in pratica attraverso la creazione di videogiochi.
📚 Cosa Troverai Qui
Questo repository contiene una collezione progressiva di giochi creati con PyGame Zero, pensati per insegnare Python in modo pratico e coinvolgente. Ogni gioco introduce nuovi concetti di programmazione, dalle basi fino a tecniche più avanzate.
Perfetto per:
- 🎓 Studenti delle scuole superiori
- 👨🏫 Insegnanti che vogliono materiale didattico interattivo
- 🚀 Autodidatti che vogliono imparare Python in modo divertente
- 👨💻 Chiunque voglia capire la programmazione attraverso progetti concreti
Risorse principali: 🇮🇹 Italiano
🎯 I Giochi
📺 Presentati nei Video Tutorial
| Gioco |
Difficoltà |
Concetti Chiave |
| game01 - Colpisci l'Alieno |
⭐ Facile |
Eventi mouse, sprite, collisioni base |
| game02 - Ape Golosa |
⭐ Facile |
Movimento, raccolta oggetti, punteggio |
| game03 - Connetti i Satelliti |
⭐⭐ Medio |
Pathfinding, grafi, logica di gioco |
| game04 - Stella Rossa |
⭐⭐ Medio |
Animazioni, timing, gestione stato |
| game05 - Quiz |
⭐ Facile |
Input utente, logica condizionale, UI |
| game06 - Mongolfiera |
⭐⭐ Medio |
Fisica semplice, gravità, controlli |
| game07 - Flappy Bird |
⭐⭐⭐ Difficile |
Game loop, fisica, collision detection |
| game08 - Karate Kid |
⭐⭐ Medio |
Combo, timing preciso, feedback visivo |
| game09 - Stelle |
⭐⭐ Medio |
Generazione procedurale, pattern |
| game10 - Invasione dallo Spazio |
⭐⭐⭐ Difficile |
Nemici multipli, proiettili, game over |
🎁 Giochi Bonus (Non nei Video)
| Gioco |
Difficoltà |
Highlight |
| game02_1 - Tony alla Ricerca della Musica |
⭐⭐ Medio |
Ricerca file, debugging, percorsi |
| game04_1 - Stranger Stars |
⭐⭐⭐ Difficile |
Debug avanzato, correzione errori |
| game11 - La Battaglia Finale: Harry vs Voldemort |
⭐⭐⭐⭐ Avanzato |
🔥 CSV, Polars, DataFrames, AI base, sistema a turni |
| game12 - Space Data Commander |
⭐⭐⭐ Difficile |
🚀 Polars, dizionari, scoring, grafico a barre in-game |
| game13 - Quizzone + Dashboard |
⭐⭐⭐⭐ Avanzato |
📊 Polars, CSV, Streamlit, analisi dati multi-studente |
| game14 - MEMO |
⭐⭐ Medio |
🃏 Liste, timer, stato, gioco di memoria a coppie |
| game15 - Dobble |
⭐⭐⭐ Difficile |
🔵 Macchina a stati, timer, immagini, parsing stringhe |
💡 I giochi game11, game12 e game13 introducono concetti di Data Science con Polars: raccolta dati in-game, analisi statistica, scoring e dashboard interattive con Streamlit.
🎥 Video Tutorial (YouTube)
Un corso completo gratuito di circa 8 ore totali, suddiviso in sessioni tematiche:
| # |
Titolo |
Durata |
Link |
| 1 |
Introduzione a Python e basi della programmazione |
~2h |
▶️ Guarda |
| 2 |
Introduzione a PyGame Zero e primi giochi |
~2h |
▶️ Guarda |
| 3 |
Tris di giochi a difficoltà crescente |
~2h |
▶️ Guarda |
| 4 |
Quattro giochi avanzati |
~2h |
▶️ Guarda |
| BONUS |
Intervista a Daniel Pope (creatore di PyGame Zero) |
~30min |
▶️ Guarda |
🚀 Come Iniziare
Prerequisiti
# Python 3.8 o superiore
python --version
# Installa PyGame Zero
pip install pgzero
# Per il game11 (Battaglia Harry vs Voldemort) e game12 (Space Data Commander)
pip install polars
# Per il game13 (Quizzone + Dashboard)
pip install polars streamlit
Clona il Repository
git clone https://github.com/PythonBiellaGroup/LearningPythonWithGames.git
cd LearningPythonWithGames
Esegui un Gioco
# Metodo 1: Con Python
python game01.py
# Metodo 2: Con pgzrun (se configurato)
pgzrun game01.py
📖 Struttura del Progetto
LearningPythonWithGames/
├── game01/ - game10/ # Giochi dei video tutorial
├── game02_1/ # Tony alla ricerca della musica
├── game04_1/ # Stranger Stars (debugging)
├── game11/ # Harry vs Voldemort (CSV + Polars)
│ ├── harry_voldemort.py
│ ├── spells.csv # Database incantesimi
│ └── images/ # Sprite e sfondi
├── game12/ # Space Data Commander (Polars + esplorazione)
│ ├── space_data_commander.py
│ └── planets_data.csv # Generato durante il gioco
├── game13/ # Quizzone + Dashboard (Polars + Streamlit)
│ ├── quiz.py # Gioco quiz con salvataggio risposte
│ ├── aggregatore_csv.py # Aggrega le risposte di tutti gli studenti
│ ├── dashboard_quiz.py # Dashboard Streamlit per l'insegnante
│ └── domande.csv # Domande del quiz
├── game14/ # MEMO (gioco di memoria a coppie)
│ └── memo.py
├── game15/ # Dobble (trova il simbolo uguale)
│ ├── dobble.py
│ └── images/ # Immagini dei simboli (PNG)
├── images/ # Risorse grafiche condivise
├── sounds/ # Effetti sonori (se presenti)
└── README.md
🎓 Percorso di Apprendimento Consigliato
🟢 Livello 1: Fondamentali (Settimana 1-2)
- game01 - Colpisci l'Alieno
- game02 - Ape Golosa
- game05 - Quiz
Cosa impari: Variabili, funzioni, eventi, sprite, collisioni
🟡 Livello 2: Intermedio (Settimana 3-4)
- game03 - Connetti i Satelliti
- game04 - Stella Rossa
- game06 - Mongolfiera
- game08 - Karate Kid
Cosa impari: Liste, dizionari, animazioni, fisica base, stato del gioco
🔴 Livello 3: Avanzato (Settimana 5-6)
- game07 - Flappy Bird
- game09 - Stelle
- game10 - Invasione dallo Spazio
- game04_1 - Stranger Stars (debugging)
Cosa impari: Game loop complessi, OOP, gestione errori, ottimizzazione
🔵 Livello 4: Data & AI (Settimana 7+)
- game11 - Harry vs Voldemort
- game12 - Space Data Commander
- game13 - Quizzone + Dashboard
Cosa impari:
- 📊 Lavorare con CSV e DataFrames (Polars)
- 🤖 Creare un'AI semplice
- 🎯 Sistema a turni
- 📈 Manipolazione dati tabulari
- 🚀 Raccolta dati in-game e scoring
- 🖥️ Dashboard interattive con Streamlit
🟣 Livello 5: Giochi Classici Completi (Settimana 8+)
- game14 - MEMO
- game15 - Dobble
Cosa impari:
- 🃏 Logica di memoria e coppie
- 🔵 Macchina a stati complessa
- ⏱️ Timer e gestione del tempo di risposta
- 🖼️ Caricamento e rendering di immagini
- 📝 Parsing di dati strutturati da stringhe
🛠️ Strumenti e Tecnologie
- Python 3.8+ - Linguaggio di programmazione
- PyGame Zero - Framework per creare giochi senza complessità
- Polars (game11, game12, game13) - Libreria velocissima per DataFrames
- CSV (game11, game12, game13) - Formato per salvare dati tabulari
- Streamlit (game13) - Framework per creare dashboard web interattive
📚 Risorse Didattiche
📖 Documentazione Ufficiale
📘 Libri e Guide
🎯 Workshop e Tutorial
🌍 Altri Esempi e Progetti
Repository Ufficiali
Collezioni Community
🎮 Prova Online (Senza Installare)
Non vuoi installare Python? Prova questi ambienti online:
🔧 Librerie Utili per PyGame Zero
PyGame Zero Helper
Estensione con funzioni aggiuntive per semplificare lo sviluppo:
🤝 Come Contribuire
Hai creato un nuovo gioco? Hai migliorato uno esistente? Contribuisci!
- Fai un fork del repository
- Crea un branch:
git checkout -b feature/mio-gioco
- Aggiungi il tuo gioco con documentazione
- Commit:
git commit -m 'Add: Nuovo gioco X'
- Push:
git push origin feature/mio-gioco
- Apri una Pull Request
Idee per Contributi
- ✨ Nuovi giochi con tutorial
- 🐛 Correzione bug
- 📚 Traduzione documentazione
- 🎨 Nuovi asset grafici/sonori
- 📝 Miglioramenti al README
💬 Community e Supporto
📜 Licenza
Questo progetto è distribuito sotto licenza MIT - vedi il file LICENSE per dettagli.
🙏 Ringraziamenti
- Daniel Pope - Creatore di PyGame Zero
- Python Biella Group - Community e supporto
- Tutti i contributori - Grazie per rendere questo progetto migliore!
⭐ Ti Piace Questo Progetto?
Se trovi utile questo repository:
- ⭐ Lascia una stella su GitHub
- 🔄 Condividi con amici e studenti
- 🐛 Segnala bug o suggerisci miglioramenti
- 💻 Contribuisci con il tuo codice!
Fatto con ❤️ da Python Biella Group
"Il miglior modo per imparare è creare qualcosa di divertente!"