Benvenuti nella repository del progetto "Tris", una versione del gioco del tris (Tic Tac Toe) implementato in C# Console. Questa implementazione consente ai giocatori di collegarsi tramite un server websocket con database Sql Lite per sfidarsi o giocare contro un avversario automatico basato sull'algoritmo Minimax. Il codice è rilasciato sotto la licenza GNU General Public License v3.0.
I principali collaboratori per questo progetto sono: Per domande, problemi o suggerimenti, puoi contattare direttamente i principali collaboratori del progetto o aprire una issue.
- Giorgio Citterio (email: Giorgio.Citterio@issgreppi.it)
- Umberto Colombo (email: Umberto.Colombo@issgreppi.it)
- Andrea Panzeri (email: Andrea.Panzeri.2005@issgreppi.it)
- Marco Passoni (email: Marco.Passoni@issgreppi.it)
- Gabriele Viganò (email: Gabriele.Vigano@issgreppi.it)
Il progetto è stato ideato come parte integrante del percorso educativo della classe 5iB della scuola Villa Greppi di Monticello Brianza (LC). L'obiettivo principale è stato quello di applicare le conoscenze acquisite durante il corso di studi, mettendo in pratica le competenze informatiche nello sviluppo di un'applicazione funzionale e divertente.
Il progetto "Tris" è un'implementazione avanzata del classico gioco del tris (Tic Tac Toe) sviluppato in C# Console. Va oltre la semplice rappresentazione delle regole di base, offrendo un'esperienza interattiva in grado di connettere due giocatori attraverso un server web socket e con database Sql Lite. Inoltre, presenta la possibilità di sfidare un avversario virtuale, il quale sfrutta un'intelligenza artificiale basata sull'algoritmo Minimax per creare partite competitive e coinvolgenti.
Questo progetto offre un'implementazione esaustiva e efficiente delle regole classiche del tris. Attraverso la console C#, consente a due giocatori di competere sullo stesso dispositivo o attraverso una connessione di rete. La struttura modulare e flessibile del codice consente l'interazione multi-client attraverso il server web socket, garantendo un'esperienza di gioco fluida e intuitiva.
Una delle caratteristiche più rilevanti di questo progetto è la presenza di un giocatore AI basato sull'algoritmo Minimax. Questa intelligenza artificiale apprende dalle mosse precedenti e calcola le mosse ottimali, valutando le possibili strategie di gioco per massimizzare le probabilità di vittoria o minimizzare le possibilità di sconfitta. L'algoritmo Minimax, implementato con cura e precisione, analizza in profondità le possibili mosse e crea un'esperienza di gioco sfidante, adattandosi alle scelte del giocatore umano.
Oltre all'implementazione di un'IA sofisticata, il progetto mira a ottimizzare le prestazioni attraverso un design attento e una gestione efficiente delle risorse. L'architettura del codice è stata sviluppata considerando l'ottimizzazione della memoria e l'efficienza algoritmica, garantendo un'esperienza di gioco fluida e reattiva.
La struttura modulare del codice permette una facile espandibilità e personalizzazione del gioco. I programmatori possono facilmente aggiungere nuove funzionalità, ottimizzare le strategie dell'IA o modificare l'interfaccia utente per adattarla alle proprie esigenze. L'architettura flessibile consente agli sviluppatori di estendere il progetto in molteplici direzioni, incoraggiando la creatività e l'innovazione nel mondo del gioco del tris.
La sicurezza e l'affidabilità sono elementi chiave integrati nel progetto. Si pone particolare attenzione nella gestione delle connessioni e nel controllo delle operazioni di gioco, garantendo un'esperienza priva di problemi e sicura per tutti gli utenti.
Siamo aperti ai contributi dalla comunità. Se desideri contribuire a questo progetto, puoi farlo in vari modi:
- Segnalando bug o problemi tramite le issues.
- Aggiungendo nuove funzionalità o migliorando quelle esistenti con pull request.
- Migliorando la documentazione.
- Aiutando a testare il gioco e segnalando eventuali problemi.
Certamente! Ecco una versione ampliata e più accattivante:
Benvenuto alla guida per l'installazione del gioco del Tris con Intelligenza Artificiale! Segui attentamente questi passaggi per iniziare a divertirti con il gioco.
Inizia clonando il repository sul tuo computer. Assicurati di avere Git installato e digita il seguente comando nel terminale:
git clone https://github.com/Tris-tps/tris_tpsIn alternativa al passaggio della clonazione, si puó procedere anche con il download della cartella main .Zip.
Per utilizzare il Package Manager Console, segui questi passaggi:
-
Apertura del Package Manager Console: Una volta aperto il progetto in Visual Studio, vai al menu in alto e seleziona
Strumenti (Tools). -
Seleziona NuGet Package Manager: Trova l'opzione
NuGet Package Managernel menuStrumenti (Tools). Espandi questa voce e clicca suConsole del gestore pacchetti (Package Manager Console). -
Console del gestore pacchetti: Si aprirà una finestra contenente la Console del gestore pacchetti, dove inserirai comandi specifici di NuGet per gestire i pacchetti del tuo progetto.
Prima di avviare il progetto "WebSocketTrisServer", esegui la migrazione della soluzione:
-
Naviga nella directory del progetto "WebSocketTrisServer".
-
Cancella la cartella "Migrations".
-
Apri Visual Studio Community e accedi alla "Console di gestione pacchetti di Visual Studio".
-
Utilizza i seguenti comandi nella "Package Manager Console":
Add-Migration 'Init' Update-Database
Apri il progetto in Visual Studio Community. Assicurati di configurare correttamente l'avvio multiplo per una corretta esecuzione del gioco:
- Nella "Solution Explorer", fai clic con il tasto destro sulla "Solution" e seleziona "Proprietà".
- Abilita la sezione "Multiple Startup Projects".
- Seleziona le voci "WebSocketTrisServer", "Client" e "Client_2".
- Imposta "WebSocketTrisServer" come progetto principale spostandolo in cima alla lista.
Avvia il progetto utilizzando Visual Studio Community. Questo passaggio garantisce che il server e i client siano pronti per l'interazione.
Collega i client al server web socket per iniziare a giocare o sfidare l'Intelligenza Artificiale nel gioco del Tris.
Questa procedura ti guiderà attraverso l'installazione e l'avvio del progetto, consentendoti di tuffarti nel mondo del Tris con l'Intelligenza Artificiale. Buon divertimento giocando!
Desideriamo ringraziare sinceramente tutti coloro che hanno contribuito o supportato questo progetto. Il vostro contributo è prezioso per noi!
Questo progetto è rilasciato sotto la licenza GNU General Public License v3.0. Questa licenza ti dà la libertà di utilizzare, modificare e distribuire il codice sorgente in conformità con i termini specificati nella licenza.
È importante notare che, in virtù della licenza GNU GPL v3.0, qualsiasi modifica apportata a questo software e successivamente distribuita deve anch'essa essere rilasciata con la stessa licenza open source.
All'interno di questa repository, troverai una documentazione dettagliata che include diagrammi UML (Unified Modeling Language), tra cui diagrammi delle classi, diagrammi delle sequenze e diagrammi dei casi d'uso. Questa documentazione offre una visione chiara e strutturata della struttura del progetto, delle interazioni tra i componenti e delle funzionalità implementate.
Inoltre, è disponibile uno studio di fattibilità che analizza l'idoneità del progetto "Tris" e delle sue funzionalità. Questo studio fornisce una valutazione approfondita delle risorse necessarie, dei vincoli tecnici e delle potenziali sfide da affrontare durante lo sviluppo e la distribuzione del gioco.
La documentazione UML e lo studio di fattibilità sono strumenti cruciali per comprendere il progetto in modo approfondito e pianificare le fasi future del suo sviluppo.