Skip to content

About

Open Day ufficiale dell'Accademia di Belle Arti di Catania — gioco AAA open source in Unity 6 (URP). Generazione procedurale di NPC, IA (BT+GOAP), lezioni giocabili.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Open Day — Accademia di Belle Arti di Catania

Un'avventura 3D low-poly in stile GTA (terza persona, campus aperto) che fa vivere allo studente il suo primo giorno all'Accademia di Belle Arti di Catania: l'arrivo, la registrazione, la conoscenza degli altri studenti, la prima vera lezione giocabile, la visita del campus, i workshop, la mostra e la consegna del badge.

Da un'Idea del Mago Lorino · Sviluppo: LoremYpsum-cmd

Progetto realizzato in Unity 6 LTS con URP, architettura AAA (SOLID, Dependency Injection, Event Bus, Object Pooling, Assembly Definitions) e contenuti interamente procedurali e originali.


Indice


Visione

Il giocatore deve uscire dal gioco con la sensazione di aver realmente frequentato la sua prima giornata universitaria. Ogni materia dell'Accademia diventa un'esperienza giocabile; ogni studente incontrato è un individuo unico con volto, voce, personalità e storia generati proceduralmente e mai ripetuti.

L'edizione Unity punta a un campus 3D low-poly esplorabile in terza persona — movimento e camera in stile GTA/open-world — con hub centrale (cortile) e edifici collegati da percorsi liberi. I sistemi esistenti (NPC, missioni, lezioni, localizzazione) restano invariati; la geometria procedurale è un innesto artistico sostituibile con asset modulari.

Direzione visiva 3D

  • Stile: low-poly, colori piatti saturi, URP Lit senza texture (vedi LowPolyStyle).
  • Camera: ThirdPersonChaseCamera — orbita dietro al giocatore, zoom, collisione, spalla leggera.
  • Mondo: CampusPrototypeBuilder genera cortile, biblioteca, atelier, aula, bar, commons e NavMesh a runtime.
  • Setup rapido in Editor: menu ABACT → Setup → Create Campus Boot Scene (3D Low-Poly).

Dettagli in Documentation/3D_VISUAL_DIRECTION.md.

Caratteristiche principali

  • Campus vivo: centinaia di studenti, docenti e personale, ciascuno con identità unica.
  • IA profonda per ogni NPC: Behavior Tree reattivo + GOAP deliberativo + memoria episodica + sistema emotivo (Plutchik) + relazioni/amicizie emergenti + agenda giornaliera.
  • Generazione procedurale deterministica: dallo stesso seed nasce sempre lo stesso campus (fondamentale per save, QA e networking).
  • Lezioni giocabili reali: teoria del colore, composizione, triangolo dell'esposizione, quiz data-driven — con spiegazione, esercizi, quiz, pratica, feedback e valutazione.
  • Gameplay completo: controller terza/prima persona con cambio dinamico, interazioni contestuali, inventario, fotocamera in-game, missioni principali e secondarie, reputazione, achievement, dialoghi.
  • Accessibilità: sottotitoli, scala del font, modalità daltonismo, narratore, riduzione del movimento, rimappatura controlli.
  • Localizzazione: Italiano, Inglese, Francese, Spagnolo, Tedesco.
  • Performance: aggiornamento IA time-sliced, object pooling, spatial hash per le query di vicinato, MaterialPropertyBlock (GPU-instancing friendly).

Stack tecnico

Unity 6 LTS · URP · Addressables · Input System · Localization · Cinemachine · Shader Graph · Visual Effect Graph · Burst · Jobs · ScriptableObjects · SOLID · Dependency Injection · Assembly Definitions · Event Bus · Object Pooling.

Architettura

Il progetto è organizzato in assembly definition con dipendenze a senso unico, dal livello più basso al più alto:

ABACT.Core            (eventi, DI, pooling, RNG deterministico, state machine, game loop)
   ▲
ABACT.Data            (enum di dominio, modelli, ScriptableObject di authoring)
   ▲
ABACT.Characters      (generazione procedurale: nomi, volti, personalità, voci, biografie)
   ▲
ABACT.AI              (Behavior Tree, GOAP, memoria, emozioni, relazioni, agenda, reazioni)
   ▲
ABACT.Gameplay        (player, interazione, inventario, missioni, dialoghi, NPC, foto, save, mondo)
   ▲
ABACT.Lessons         (framework lezioni + moduli giocabili)   ABACT.UI   ABACT.Audio   ABACT.Localization
   ▲
ABACT.App             (composition root, bootstrap, state machine, sequenza Open Day)

Principi chiave:

  • Dependency Inversion: i sistemi dipendono da interfacce (IEventBus, IAIAgent, IInventory, IPopulationService, …), non da implementazioni.
  • Event Bus: produttori e consumatori sono disaccoppiati; le missioni avanzano osservando GameplayTriggerEvent generici.
  • Composition Root unica (GameBootstrap): l'unico punto che sa come è assemblato il sistema.
  • Loop centrale (GameLoop): un solo Update/FixedUpdate Unity instrada tutti i servizi ITickable.

Dettagli completi in Documentation/ARCHITECTURE.md e Documentation/SYSTEMS.md.

Struttura del repository

Assets/_Project/
  Scripts/
    Core/         Data/        Characters/   AI/
    Gameplay/     Lessons/     UI/           Audio/
    Localization/ App/         Editor/
  Tests/EditMode/
  Art/ Audio/ Data/ Prefabs/ Scenes/
Documentation/
Packages/ ProjectSettings/
.github/workflows/

Setup

  1. Installa Unity 6 LTS (6000.0.x) con i moduli delle piattaforme desiderate.
  2. Apri la cartella del progetto da Unity Hub. I pacchetti in Packages/manifest.json vengono risolti automaticamente.
  3. Al primo import Unity compila gli assembly (i .meta sono già nel repository).
  4. Apri Assets/_Project/Scenes/CampusBoot.unity e premi Play — il campus low-poly 3D si genera a runtime; WASD per muoversi, mouse per la camera GTA-style.

In alternativa, da Editor: ABACT → Setup → Create Campus Boot Scene (3D Low-Poly) rigenera scena, prefab NPC e config.

Come si avvia una sessione

Una sessione è descritta da un asset OpenDaySessionConfig (menu Create → ABACT → Open Day Session Config). Una scena di boot contiene un GameObject con il componente GameBootstrap, a cui si assegnano:

  • l'asset OpenDaySessionConfig (seed, conteggi popolazione, orario, corsi/oggetti/missioni);
  • il prefab NPC modulare e i punti di spawn;
  • (opzionale) l'AudioMixer.

All'avvio il bootstrap compone il container DI, genera la popolazione deterministica, popola il campus, avvia l'orologio e la missione principale. Senza prefab NPC il mondo è comunque valido (la popolazione esiste e può essere interrogata): vedi Population Preview (menu ABACT → Population Preview) per verificarla senza entrare in Play.

Sistemi di gioco

Area Implementazione
Generazione personaggi CharacterFactory, NameGenerator, AppearanceGenerator, PersonalityGenerator, VoiceGenerator, BiographyGenerator — unicità garantita su nome/volto/voce
IA NPCBrain (BT reattivo + GOAP), GoapPlanner (A*), MemorySystem, EmotionSystem, RelationshipSystem, DailySchedule, ReactionSystem, ConversationSystem
Player PlayerController (terza/prima persona, cambio dinamico), PlayerInputActions (Input System, rimappabile)
Interazione InteractionController, IInteractable, pickup/artwork/door
Progressione QuestSystem (event-driven), ReputationSystem, AchievementSystem, GameFlags
Lezioni LessonRunner, LessonFactory, moduli ColorMixingLesson, CompositionLesson, QuizLesson, PhotographyExposureLesson
Dialoghi DialogueRunner (grafi autorati) + ConversationDirector (conversazioni procedurali)
Audio AudioDirector (spatial + musica dinamica a livelli), VoiceSynthesizer (voci procedurali)
UI HudPresenter, NotificationPresenter (UI Toolkit, scalabili per accessibilità)
Salvataggio SaveSystem (JSON atomico con checksum, cross-platform)
Localizzazione LocalizationService (IT/EN/FR/ES/DE, fallback robusto)

Test

Test EditMode in Assets/_Project/Tests/EditMode (NUnit, Unity Test Framework):

  • framework core (event bus, DI, pool, RNG, state machine);
  • unicità della popolazione (nessun nome/volto/voce ripetuti su 600 NPC) e determinismo;
  • pianificatore GOAP (catene, costo minimo, irraggiungibilità);
  • emozioni, relazioni, agenda;
  • inventario, reputazione, missioni event-driven, scoring lezioni, localizzazione.

Esecuzione: Window → General → Test Runner → EditMode → Run All, oppure in CI (vedi sotto).

Download / Eseguibili

Edizione console standalone (disponibile ora, nessuna Unity richiesta)

L'edizione standalone è il modo per giocare subito, senza installare Unity né licenze: è un gioco da terminale .NET 8 che riusa la vera logica procedurale del progetto (RNG deterministico, generazione di NPC unici, lezione di teoria del colore, quest, achievement, salvataggi). Disponibile in 5 lingue — Italiano, Inglese, Francese, Spagnolo, Tedesco — con rilevamento automatico della lingua di sistema (override possibile dal menu lingua in-game).

Come scaricare e giocare:

  1. Scarica dalla Release v0.1.5 (o dalla sezione Releases) lo .zip per la tua piattaforma (vedi tabella).
  2. Estrai l'archivio in una cartella (contiene una sottocartella, es. win-x64/).
  3. Avvia OpenDayABACT (OpenDayABACT.exe su Windows) dalla cartella estratta. È un'app self-contained: non serve installare il runtime .NET.

Antivirus ti blocca il download? Prova la variante leggera OpenDayABACT-<piattaforma>-framework-dependent.zip (richiede .NET 8 già installato, raramente segnalata). Verifica sempre SHA256SUMS.txt.

Sistema Architettura File
Windows x64 OpenDayABACT-win-x64.zip
Windows ARM64 OpenDayABACT-win-arm64.zip
Windows x86 (32-bit) OpenDayABACT-win-x86.zip
macOS Apple Silicon (ARM64) OpenDayABACT-osx-arm64.zip
macOS Intel (x64) OpenDayABACT-osx-x64.zip
Linux x64 OpenDayABACT-linux-x64.zip
Linux ARM64 OpenDayABACT-linux-arm64.zip
Linux ARM 32-bit (Raspberry Pi, ecc.) OpenDayABACT-linux-arm.zip
Linux musl (Alpine / molti SBC) x64 OpenDayABACT-linux-musl-x64.zip
Linux musl ARM64 OpenDayABACT-linux-musl-arm64.zip

Dettagli in Standalone/README.md.

Nota su antivirus e binari non firmati

Questi sono build open source non firmate con certificato di code-signing. Alcuni antivirus o SmartScreen possono mostrare un falso positivo sugli eseguibili non firmati: è un avviso euristico, non un'infezione reale. Per ridurre il rischio i binari sono pubblicati come build self-contained multi-file non compresse (la forma che gli antivirus considerano più affidabile, rispetto ai single-file "impacchettati"). Puoi verificare l'integrità di ogni .zip con i checksum in SHA256SUMS.txt allegato alla Release:

# macOS / Linux
shasum -a 256 -c SHA256SUMS.txt
# Windows (PowerShell)
Get-FileHash OpenDayABACT-win-x64.zip -Algorithm SHA256

Se il sistema blocca l'avvio di un'app non firmata:

  • macOS: rimuovi la quarantena dopo l'estrazione con xattr -dr com.apple.quarantine /percorso/della/cartella-estratta (oppure Impostazioni di Sistema → Privacy e sicurezza → Apri comunque).
  • Windows: nella finestra SmartScreen scegli "Maggiori informazioni" → "Esegui comunque".

Non è necessario — e non consigliamo — disattivare l'antivirus.

Piattaforme mobile/console

Le build prebuilt qui sopra coprono desktop (Windows, macOS, Linux, incl. ARM e musl). I target mobile e console (Android, iOS, PlayStation/Xbox/Switch) non sono supportati da un'app console .NET: richiedono la pipeline Unity, che a sua volta necessita della licenza Unity del manutentore. Sono quindi fuori ambito per questi eseguibili precompilati (vedi l'edizione Unity più sotto).

Edizione Unity 3D (CI)

Il progetto è open source (codice sotto licenza MIT — vedi LICENSE). Gli eseguibili Unity non sono versionati nel repository: vengono compilati automaticamente dalla CI e pubblicati come GitHub Release quando configurata.

Per generare e pubblicare gli eseguibili:

  1. Aggiungi i repository secrets UNITY_LICENSE, UNITY_EMAIL, UNITY_PASSWORD (basta una licenza Unity Personal gratuita — vedi game.ci/docs/github/activation).
  2. Crea un tag di versione e fai il push:
    git tag v0.1.0 && git push origin v0.1.0
  3. Il workflow .github/workflows/release.yml compila Windows, Linux, macOS, WebGL e Android e allega gli .zip alla Release. Li trovi poi nella sezione Releases del repository.

In alternativa, build locale da Editor con la pipeline ABACT.Editor.BuildPipeline (vedi sotto).

Build multi-piattaforma

Pipeline headless in ABACT.Editor.BuildPipeline, invocabile da CI:

Unity -batchmode -quit -projectPath . -executeMethod ABACT.Editor.BuildPipeline.BuildWindows

Target: Windows, macOS, Linux, Android, iOS, WebGL (gli store PlayStation/Xbox/Switch usano gli stessi entry point una volta installati i moduli di piattaforma sull'agent). Workflow CI di esempio in .github/workflows/ci.yml.

Stato dei contenuti binari

Il codice, i dati e i generatori di contenuto a runtime sono completi e originali. Gli asset binari (mesh modulari, texture, clip audio, scene autorate, lightmap) non sono inclusi come file di testo: vengono prodotti tramite la pipeline procedurale in-engine e l'authoring in Editor. Ogni script che li consuma è progettato per degradare con grazia in loro assenza (la simulazione, l'IA e i sistemi restano pienamente funzionanti), così l'integrazione artistica è un innesto, non una riscrittura.

Licenza e marchio

Progetto autorizzato dall'Accademia di Belle Arti di Catania, con uso autorizzato del marchio ufficiale e ricostruzione degli spazi. Tutti i contenuti generati sono originali e non riproducono persone reali.

About

Open Day ufficiale dell'Accademia di Belle Arti di Catania — gioco AAA open source in Unity 6 (URP). Generazione procedurale di NPC, IA (BT+GOAP), lezioni giocabili.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages