Galaga

Pubblicato: 14/03/2026 | Scritto da rsodvd79 | Visite: 0

🚀 Galaga — Clone in C# / Avalonia

Una fedele ricreazione arcade del classico Galaga (1981), realizzata con .NET 8 e Avalonia UI: sprite pixel-art disegnati interamente in codice, audio retro sintetizzato e un motore di gioco pulito basato su entità.

 ██████╗  █████╗ ██╗      █████╗  ██████╗  █████╗
██╔════╝ ██╔══██╗██║     ██╔══██╗██╔════╝ ██╔══██╗
██║  ███╗███████║██║     ███████║██║  ███╗███████║
██║   ██║██╔══██║██║     ██╔══██║██║   ██║██╔══██║
╚██████╔╝██║  ██║███████╗██║  ██║╚██████╔╝██║  ██║
 ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝

📸 Screenshot

✨ Funzionalità

🎮 Gameplay classico di Galaga — entrata in formazione, attacchi in picchiata, griglia nemica oscillante
🌟 Sfondo stellare dinamico — 90 stelle con parallasse a 3 velocità, rigenerate casualmente ad ogni partita
🖼️ Sprite pixel-art — Ape, Farfalla, Boss Galaga e navicella del giocatore, tutti disegnati con geometria Avalonia (nessun file immagine)
🎞️ Animazione nemica a 2 frame — le ali battono a ~7,5 Hz, fedele alla sensazione dell'arcade originale
💥 Effetti esplosione — particelle in espansione (bianco → giallo → arancione → rosso)
💀 Collisione nemico-giocatore — i nemici in picchiata uccidono il giocatore al contatto
🔊 Audio sintetizzato — sparo, esplosione, morte del giocatore e suoni di fine livello generati come forme d'onda PCM tramite OpenAL
📈 Difficoltà progressiva — i nemici si muovono più velocemente e la frequenza di fuoco aumenta ad ogni livello
🏆 Punteggio massimo persistente — salvato su disco (JSON in ~/.local/share/Galaga), sopravvive alla chiusura del gioco
🛡️ Invulnerabilità post-respawn — 2 secondi di lampeggio dopo la riapparizione, nessuna collisione
👾 Cattura del Boss Galaga — un boss in picchiata può catturare la tua nave; abbatterlo mentre la trasporta sblocca il dual-fighter (+1000 pt, doppio fuoco)
🖥️ Schermata iniziale animata — glow pulsante sul titolo, formazione nemica decorativa in stile attract-mode e prompt "PRESS SPACE" lampeggiante
🚀 Navicella migliorata — ali sagomate, abitacolo con highlight, bagliori motore a due toni

🕹️ Controlli

Suggerimento: Puoi avere al massimo 2 proiettili sullo schermo con la navicella singola, o 4 con il dual-fighter.

👾 Tipi di nemici e punteggi

┌──────────────────┬──────────────┬─────────────────┬─────────────┐
│ Nemico           │ Aspetto      │ In formazione   │ In picchiata│
├──────────────────┼──────────────┼─────────────────┼─────────────┤
│ Ape              │ Giallo       │ 50 pt           │ 100 pt      │
│ Farfalla         │ Ciano        │ 80 pt           │ 160 pt      │
│ Boss Galaga      │ Rosso/Arancio│ 150 pt          │ 400 pt      │
└──────────────────┴──────────────┴─────────────────┴─────────────┘

Disposizione della formazione (5 righe × 8 colonne = 40 nemici per livello):

Riga 0: ✦ ✦ ✦ [B] [B] ✦ ✦ ✦   ✦ = Farfalla,  B = Boss Galaga
Riga 1: ✦ ✦ ✦  ✦   ✦  ✦ ✦ ✦
Riga 2: ✶ ✶ ✶  ✶   ✶  ✶ ✶ ✶   ✶ = Ape
Riga 3: ✶ ✶ ✶  ✶   ✶  ✶ ✶ ✶
Riga 4: ✶ ✶ ✶  ✶   ✶  ✶ ✶ ✶

Regole di gioco

3 vite iniziali; la navicella riappare dopo 2 secondi
Il livello termina quando tutti i 40 nemici sono distrutti; quello successivo inizia dopo 2,5 s
Fino a 2 nemici in picchiata simultaneamente; i picchiatori che mancano il bersaglio curvano verso il basso ed escono dallo schermo, poi rientrano dall'alto
I nemici in picchiata che colpiscono il giocatore lo uccidono e muoiono a loro volta
Invulnerabilità post-respawn: per 2 s dopo la riapparizione la navicella lampeggia e non può essere colpita
Cattura e dual-fighter: se un Boss Galaga in picchiata ti tocca, ti cattura (perdi una vita) e trasporta la tua nave; distruggendolo mentre la trasporta liberi il dual-fighter (due navi affiancate, fuoco doppio, +1000 pt). Morire fa perdere il dual-fighter

🚀 Per iniziare

Prerequisiti

.NET 8 SDK
macOS, Linux o Windows (l'audio richiede un dispositivo compatibile OpenAL)

Compilazione ed esecuzione

# Clona il repository
git clone https://github.com/your-username/Galaga.git
cd Galaga

# Avvia il gioco
dotnet run --project Galaga/Galaga.csproj

# Esegui i test
dotnet test

# Esegui un singolo test
dotnet test --filter "FullyQualifiedName~Player_dies_when_hit_by_enemy_bullet"

# Build di rilascio
dotnet publish Galaga/Galaga.csproj -c Release -o publish/

🏗️ Architettura

Galaga/
├── Engine/
│   ├── GameEngine.cs       # Logica di gioco pura: ciclo tick, collisioni, IA, punteggio
│   ├── GameState.cs        # Tutto lo stato mutabile (fase, punteggio, vite, liste entità)
│   └── HighScoreStore.cs   # Persistenza punteggio massimo su file JSON
├── Entities/
│   ├── Entity.cs           # Base astratta: posizione, dimensione, collisione AABB
│   ├── Player.cs           # Movimento, limite proiettili, respawn, invulnerabilità, dual-fighter
│   ├── Enemy.cs            # Macchina a stati per ciascun nemico (supporta cattura navi)
│   ├── EnemyFormation.cs   # Griglia, oscillazione, ondate di entrata
│   ├── Bullet.cs           # Direzione determinata dall'enum BulletOwner
│   └── Explosion.cs        # Dati visivi della particella di esplosione
├── Views/
│   ├── GameCanvas.cs       # Controllo Avalonia: timer 60 fps, eventi tastiera, Render()
│   └── SpriteRenderer.cs   # Tutto il codice di disegno (pixel-art + geometria)
└── Audio/
    └── SoundPlayer.cs      # Sintesi OpenAL (sparo, esplosione, morte, fine livello, cattura, rescue)

Flusso dei dati

GameCanvas.OnTick(16ms)
    │
    ├─► GameCanvas.UpdateStars(dt)   ── parallasse delle stelle
    │
    ├─► GameEngine.Tick(dt)          ──► modifica GameState
    │       │                              │
    │       ├─ giocatore / formazione      ├─ lista Bullets
    │       ├─ collisioni (proiettili +    ├─ lista Explosions
    │       │  nemico-giocatore)           └─ coda PendingSounds
    │       └─ accoda SoundEffects
    │
    ├─► SoundPlayer.Play()    ◄── estrae da PendingSounds
    │
    └─► InvalidateVisual()    ──► GameCanvas.Render(DrawingContext)
                                      │
                                      ├─ SpriteRenderer.DrawEnemy(frame)
                                      ├─ SpriteRenderer.DrawPlayer()
                                      ├─ SpriteRenderer.DrawExplosion()
                                      └─ HUD / testi overlay

Macchina a stati del nemico

FormationEntry ──(raggiunge lo slot)──► InFormation
                                             │
                                  (innesco casuale picchiata)
                                             │
                                             ▼
                                          Diving ──(fuori schermo in basso)──► Returning
                                                                                    │
                                                                       (raggiunge lo slot)
                                                                                    │
                                                                                    ▼
                                                                              InFormation

Regola chiave: Nello stato InFormation, Enemy.Update() aggancia X/Y a FormationX + oscillationOffset ad ogni tick. Impostare X/Y direttamente non ha effetto duraturo se non vengono aggiornati anche FormationX/FormationY.

Collisione con il giocatore: I nemici in stato Diving che toccano il giocatore lo uccidono e muoiono a loro volta — tranne il Boss Galaga, che invece lo cattura e trasporta la nave finché non lo distruggi (liberando il dual-fighter).

🔊 Audio

I suoni vengono sintetizzati a runtime come PCM a 22050 Hz e riprodotti tramite OpenAL (Silk.NET.OpenAL). Nessun file audio incluso. Se OpenAL non è disponibile, il gioco funziona senza audio.

🧪 Test

dotnet test

20 test unitari coprono i livelli GameEngine ed Entities (nessuna dipendenza dall'interfaccia grafica):

Vite, limite proiettili e respawn del giocatore
Invulnerabilità post-respawn e mancata uccisione durante il lampeggio
Cattura del Boss Galaga e rescue del dual-fighter
Rilevamento collisioni (AABB, guardia entità morte)
Punteggio (bonus formazione vs. picchiata, +1000 rescue)
Transizioni game over e fine livello
Inizializzazione della formazione
Morte del giocatore per collisione con nemico in picchiata

🛠️ Stack tecnologico

📄 Licenza

MIT

Apri il progetto su GitHub

Per il codice sorgente e gli altri progetti visita il profilo GitHub di rsodvd79 .