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.
- Visione
- Direzione visiva 3D
- Caratteristiche principali
- Stack tecnico
- Architettura
- Struttura del repository
- Setup
- Come si avvia una sessione
- Sistemi di gioco
- Test
- Build multi-piattaforma
- Stato dei contenuti binari
- Licenza e marchio
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.
- Stile: low-poly, colori piatti saturi, URP Lit senza texture (vedi
LowPolyStyle). - Camera:
ThirdPersonChaseCamera— orbita dietro al giocatore, zoom, collisione, spalla leggera. - Mondo:
CampusPrototypeBuildergenera 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.
- 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).
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.
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
GameplayTriggerEventgenerici. - Composition Root unica (
GameBootstrap): l'unico punto che sa come è assemblato il sistema. - Loop centrale (
GameLoop): un soloUpdate/FixedUpdateUnity instrada tutti i serviziITickable.
Dettagli completi in Documentation/ARCHITECTURE.md e Documentation/SYSTEMS.md.
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/
- Installa Unity 6 LTS (6000.0.x) con i moduli delle piattaforme desiderate.
- Apri la cartella del progetto da Unity Hub. I pacchetti in
Packages/manifest.jsonvengono risolti automaticamente. - Al primo import Unity compila gli assembly (i
.metasono già nel repository). - Apri
Assets/_Project/Scenes/CampusBoot.unitye 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.
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.
| 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 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).
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:
- Scarica dalla Release v0.1.5
(o dalla sezione Releases) lo
.zipper la tua piattaforma (vedi tabella). - Estrai l'archivio in una cartella (contiene una sottocartella, es.
win-x64/). - Avvia
OpenDayABACT(OpenDayABACT.exesu 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 sempreSHA256SUMS.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.
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 SHA256Se 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.
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).
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:
- Aggiungi i repository secrets
UNITY_LICENSE,UNITY_EMAIL,UNITY_PASSWORD(basta una licenza Unity Personal gratuita — vedi game.ci/docs/github/activation). - Crea un tag di versione e fai il push:
git tag v0.1.0 && git push origin v0.1.0 - Il workflow
.github/workflows/release.ymlcompila Windows, Linux, macOS, WebGL e Android e allega gli.zipalla Release. Li trovi poi nella sezione Releases del repository.
In alternativa, build locale da Editor con la pipeline ABACT.Editor.BuildPipeline (vedi sotto).
Pipeline headless in ABACT.Editor.BuildPipeline, invocabile da CI:
Unity -batchmode -quit -projectPath . -executeMethod ABACT.Editor.BuildPipeline.BuildWindowsTarget: 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.
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.
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.