In questa breve guida ti spiego come installare DimensioneX, il game engine gratuito per sviluppare giochi multiplayer.
Per cominciare, sappi che non ti serve installare il game engine per giocare ai giochi disponibili. Puoi giocarli subito con il browser, usando la pagina Gioca!
La installazione serve per sviluppare giochi multiplayer sul tuo computer, con la possibilità di pubblicarli online successivamente in modo da farli utilizzare ad un numero più ampio di persone.
Concetti fodamentali
DimensioneX è una applicazione server scritta con il linguaggio Java 1.8. Viene eseguita all’interno di un web server basato su Java, come lo è Tomcat. Essendo scritta in Java, teoricamente può essere eseguita su qualsiasi computer.
L’ambiente di esecuzione tipico include Java Development Kit (JDK) versione 1.8, e Tomcat 7, ma potrebbe girare anche su altre configurazioni.
Il pacchetto del game engine è disponibile in due versioni:
- Un Pacchetto ultra-semplice raccomandato soprattutto a chi inizia,che funziona solo sotto Windows.
- Un pacchetto generico (file con estensione .war) che deve essere installato (o, come si dice in gergo deployato) dentro a un server Tomcat. Questa versione va bene se non usi Windows o se hai già avuto a che fare con Tomcat.
Metodo 1: installazione del pacchetto UltraFacile
1. Vai alla pagina Download e scegli la prima versione “pacchetto UltraFacile“. Scaricherai un file piuttosto pesante (>200 MB) che si chiama dimx_complete.zip
2. Unzippa il file preservando la struttura delle cartelle, se hai fatto correttamente otterrai tre cartelle (Documents, PortableApps e xampp) e due file (autorun.inf e start.exe).
3. Sposta tutto quanto hai ottenuto nella cartella principale di una chiavetta USB o un drive esterno: in questa maniera potrai usare DimensioneX su qualsiasi computer Windows, previo inserimento della chiavetta USB.
Se preferisci, e se non hai necessità di portare in giro il tuo ambiente di sviluppo, puoi anche copiare il tutto nella cartella principale del tuo disco C:\ .
4. Per avviare l’ambiente, apri la cartella dove hai copiato tutto e trova il file eseguibile Start.exe. Fai doppio clic per eseguirlo: apparirà subito un menu chiamato PortableApps. Questo menu rimarrà accessibile nell’angolo basso-destra della tua barra delle attività, accanto alla zona delle icone di sistema.
5. Dentro al menu PortableApps, clicca XAMPP Control Panel. Si dovrebbe aprire una finestra come questa:
L’ultima voce è proprio Tomcat e ha un pulsante [Start] alla sua destra. Se non vedi questo pulsante come cliccabile, significa che hai fatto confusione e messo le cartelle in un posto sbagliato al passo #3 (devi copiare nella cartella principale/root del disco, non altrove).
6. Le checkbox di fianco alle varie voci NON vanno toccate. Clicca semplicemente [Start] a fianco della voce Tomcat.
7. Tomcat partirà e se va tutto bene lo vedrai marcato in colore verde. Al primo utilizzo è normale vedere questo avviso proveniente da Windows firewall che ti chiede se vuoi ricevere connessioni entranti verso Tomcat. Consiglio di dare il permesso in entrambe le caselle.
Il Control Panel XAMPP dovrebbe ora avere questo aspetto:
Se Tomcat non parte, puoi cliccare il pulsante [Logs] aprire i file di log più recenti per tentare di capire qual’è il problema.
8. Con il tuo browser, apri http://localhost:8080/dimx/ (copia-incolla questo indirizzo nella barra dell’URL e premi Invio)
Se hai fatto tutto correttamente, vedrai questo (clicca per zoomare):
Noterai che ci sono tre piccole finestrelle che mostrano “Server Up”. Puoi ora scegliere uno dei giochi preinstallati per provare a vedere come funzionano.
9. Dentro il menu PortableApps Menu, clicca Documents. Una volta aperta questa cartella puoi aprire il file “00 start from here.txt“. Troverai indicazioni simili a queste con, in più, altre informazioni (purtroppo sono in inglese, vedrò di integrare scrivendo qui appena possibile). Nella stessa cartella trovi la documentazione ufficiale del game engine in formato PDF.
Quando modifichi giochi di esempio o ne crei di nuovi, ti consiglio di usare il programma Notepad++ incluso nel pacchetto e nel menu PortableApps.
Metodo #2: installazione generica (deploy di file .WAR)
Questo metodo è da seguire se non usi Windows. Cercherò di schematizzare i passi da eseguire ma dovrai adattare le istruzioni al tuo caso specifico:
1. (solo se non già fatto) Installa la Java JDK (versione recommandata: 1.8 SE – ottienila dal sito JDK Oracle, richiede la registrazione ma è gratuito). Importante! NON installare versioni più nuove di Java, con versioni più nuove delle 1.8.* probabilmente qualcosa non funzionerà correttamente.
2. Installa Tomcat (raccomandato: Tomcat 7 – Per chi usa Linux ciò dovrebbe essere prossibile con il comando apt-get install tomcat7)
3. Avvia Tomcat e verifica che funzioni (typicamente si apre: http://localhost:8080/ dal browser )
4. Spegni Tomcat
5. Vai alla nostra pagina Download e scegli la seconda opzione “Archivio WAR deployabile”. Otterrai un file ZIP. Unzippalo – ci troverai dentro, appunto, il file dimx.war.
6. Sposta ora dimx.war nella cartella webapps di Tomcat (forse faticherai un pò a trovarla).
7. Avvia Tomcat e verifica che un nuova cartella chiamata “dimx” viene creata automaticamente accanto al file .war. NON cancellare il file war adesso, altrimenti anche la cartella sparirà.
8. Verifica che DimensioneX funzioni aprendo http://localhost:8080/dimx/ con il browser
9. Se funziona, puoi ora cambiare la configurazione di Tomcat configuration com preferisci (es. cambiando porta, aggiungendo SSL, ecc.). Alla fine, sarà bene disattivare il meccanismo di auto deploy in modo che a Tomcat non venga mai in mente di ricreare o cancellare la cartella dimx che conterrà i tuoi lavori. Ciò si fa agendo sul file di configurazione di Tomcat, server.xml. La riga è questa
<Host name=”localhost” appBase=”webapps”
unpackWARs=”true” autoDeploy=”true”>
e va modificata così:
<Host name=”localhost” appBase=”webapps”
unpackWARs=”true” autoDeploy=”false”>
Se DimensioneX non riesce a partire, (non vedi proprio la pagina di benvenuto con la lista dei giochi) è probabile che il file web.xml dentro dimx/WEB-INF non sia corretto per la versione di Tomcat che stai usando. Abbiamo fornito altre versioni che puoi provare nella stessa cartella, ma in caso di problemi andrebbero sempre letti i logs di Tomcat per capire che problemi ha incontrato all’avvio.
Se hai bisogno di supporto: Support section
Non ti fare spaventare dalla complessità iniziale: DimensioneX è robusto e non è poi così difficile farlo funzionare!
Se credi lascia un commento a questo post, in modo che correggiamo eventuali inesattezze.