Manuale

In questa pagina proverò a documentare l'uso di base di X-Moto. Per informazioni sull'editor dei livelli, e in generale sulle modifiche ad X-Moto controlla il wiki. Dovresti inoltre leggere il file README che puoi trovare nella directory di installazione di X-Moto.

Installazione

Installazione su Microsoft Windows 2000/XP

Su Windows, il metodo più semplice per installare X moto è di scaricare l'ultimo installer. Una volta ottenuto l'installer, lancialo e segui le istruzioni sullo schermo, Semplicissimo!.

Alternatively you can build X-Moto from the sources. You should only do this if you intend to modify the game. If you chose to do this, download xmoto sources. The .tar.gz file contains everything needed to both build the game from source code, and play the game afterwards.

Installazione su Debian (Gnu/Linux)

X-Moto è disponibile per Debian unstable e testing, quindi se questo è il vostro OS, è davvero semplice ottenere e installare il gioco, digitate quanto segue come root:

apt-get install xmoto

Fatto :-)

Installazione su Linux (e altri UNIX) partendo dai sorgenti

Se non state usando Debian (o un'altra distribuzione con X Moto) e non potete usare nessuno dei pacchetti ufficiali, dovrete installare X Moto partendo dai sorgenti. Prima di iniziare assicuratevi di avere quanto segue gia installato:

  • L'ultima versione delle gcc e g++
  • Librerie di sviluppo e headers SDL
  • Librerie di sviluppo e headers di OpenGL
  • SDL_Mixer con gli headers
  • libjpeg con gli headers
  • libpng con gli headers
  • zlib con gli headers
  • libbzip2 con gli headers
  • liblua50 con gli headers
  • liblualib50 con gli headers
  • libode0 con gli headers
  • libcurl3 con gli headers
Una volta ottenuto tutto ciò che serve potete scaricare gli ultimi sorgenti per UNIX. La compilazione e l'installazione sono piuttosto standard; cominciate decomprimendo il tar-ball in una directory di lavoro nella quale la cartella xmoto-x.y.z sarà creata. cd.nella cartella in questione. Quindi digitate:
./configure
Se va a buon fine continuate digitando:
make
Se compila senza problemi avete 2 opzioni, potete installare il gioco globalmente sul pc, o installarlo solo per l'utente in questione.
Per installarlo globalmente, su per diventare root e poi digitate il comando:
make install
. Adesso dovrebbe essere disponibile per tutti gli utenti. In seguito per disinstallare il gioco basterà digitare il comando:
make uninstall

Nota: aggiungerò i nomi dei corrispondenti pacchetti Debian in seguito. Da notare inoltre che non sono di certo un guru di Linux, quindi probabilmente molto di quello che ho scritto è senza senso e/o incompleto - per favore correggetemi con la vostra saggezza :)

Installare su Mac OS X partendo dai sorgenti

La procedura è praticamente la stessa usata per compilare su ogni altro sistema Unix-like, ma prima bisogna fare quanto segue:

  • installa SDL usando fink o con l'installer di libsdl.org,
  • installa lua da fink : si trova nel ramo instabile, per trovarlo devi aggiungere unstable/main al rigo "Rami:" in /sw/etc/fink.conf
  • installa libode50 dai sorgenti
Inserisci i seguenti comandi:
./configure LDFLAGS="-L/sw/lib -framework OpenGL -framework Cocoa -lstdc++ -lSDLmain -lSDL -lSDL_mixer" CPPFLAGS="-I/sw/include"
make
sudo make install
Adesso puoi lanciare il gioco con il comando:
/usr/local/bin/xmoto
.

Un grazie a Gabriel Boucher per questa guida.

Giocare al gioco

strawberry
Una bella fragola

flower
Un fiorellino che segnala la fine del livello.

wrecker
Una brutta mina.

I comandi di base

Un certo numero di fragole sono di solito sparse all'interno del livello, che in genere consiste in uno percorso intricato visto da un lato - più o meno come in islands in the sky. Devi raccogliere tutte le fragole per completare il livello - quando hai raccolto anche l'ultima puoi andare a trovare la margherita che ti permetterà, toccandola, di completare il livello. Alcune varianti del gioco base si possono trovare all'interno di qualche livello.

La tua moto è, ovviamente, vista di lato, puoi controllare l'accellerazione, la frenata e facilmente cambiare la sua posizione spostando il baricentro avanti e indietro. Inoltre puoi cambiare direzione di marcia.

Controlli

La moto si controlla usando la tastiera:

Freccia in suAccellera
Freccia in giùFrena
Freccia sinistraRuota la moto in senso antiorario
Freccia destraRuota la moto in senso orario
SpazioCambia la direzione di marcia

Da notare che i tasti qui riportati possono essere configurati per venire incontro alle vostre esigenze

Inoltre alcuni altri tasti possono essere premuti mentre si gioca:

EscMette in pausa il gioco e visualizza il menù di gioco
F12Preleva uno screenshot dal gioco e lo salva nella cartella del gioco

permette ad X-Moto di connettersi ad internet

Dalla versione Alpha 0.1.14, X-Moto ha una nuova funzione che permette di collegarsi in rete per scaricare i punteggi alti (record del mondo) e i livelli extra.

La prima volta che avviate X-Moto vi sarà chiesto se volete permettere al gioco di usare la connessione internet, se non ne avete una cliccate su "No". Altrimenti vi sarà chiesto di specificare il settaggio dei proxy. X-Moto supporta proxy HTTP, SOCKS4 e SOCKS5. Se vi trovare dietro un firewall, molto probabilmente dovrete specificare un proxy; chiedete al vostro amministratore di sistema se non siete sicuri.

Replays

Dalla versione 0.1.8, X-Moto supporta la registrazione e il playback dei replay. Questi sono depositati nella cartella Replays, che su Windows si trova nella directory di installazione mentre sui sistemi Unix-like si trova in ~/.xmoto. Bisogna stare attenti in quanto i replay possono occupare molto spazio su disco, in media potete aspettarvi che un minuto di replay occupi circa 50 KB. Se si vuole disabilitare la registrazione dei replay si può settare la variabile 'StoreReplays' su 'false' nel file config.dat, su Windows questo file si trova nella cartella di installazione del programma, mentre sui sistemi Unix-like si trova in ~/.xmoto.

Altre cose da sapere riguardo ai replay di X-Moto:

  • A causa del metodo con cui vengono salvati, i replay possono risultare meno fluidi del gioco stesso.
  • Se si vogliono scambiare files di replay con altre persone bisogna tenere a mente che questi files sono gia compressi, per cui comprimerli ancora potrebbe compromettere il file.

Configurazione

Le opzioni principali di configurazione del gioco possono essere modificate da dentro al gioco cliccando sul bottone Option nel menù principale. La maggior parte di queste opzioni si spiega da sola, quindi non vi farò perdere tempo spiegandole.

Opzioni avanzate

Le opzioni sono salvate nel file config.dat. Su Windows questo file si trova nella cartella del gioco, su Linux invece si trova in ~/.xmoto. Si tratta di un file di testo in formato XML, quindi dovrebbe essere abbastanza semplice da modificare con un editor di testo. Oltre alle opzioni accessibili dal gioco qui sono presenti alcune altre non così interessanti da dover essere incluse nei menù:

WebHighscoresURLL'indirizzo da cui scaricare i punteggi alti. Potete consultare il sito per informazioni su come fare per creare la vostra lista "privata" di punteggi alti.
WebLevelsURLIndirizzo sul web in cui cercare i livelli extra.
DefaultProfileIndica quale profilo di gioco deve essere attivato all'avvio del gioco.
ScreenshotFormatFormato in cui salvare gli screenshot del gioco. Si può scegliere tra jpg e png.
NotifyAtInitSe a quest'opzione si passa il valore true sarà mostrato un messaggio all'avvio che indicherà la versione attuale del gioco. E' settata su false di default
StoreReplaysPassando true a quest'opzione i replay saranno registrati durante il gioco. Quando il giocatore muore o finisce il livello gli sarà chiesto di salvare il replay. Se impostata su false non sarà possibile registrare i replay. La registrazione dei replay ha un impatto teorico sullo scorrimento della grafica del gioco, ma in pratica non dovreste essere in grado di notare nulla.
ReplayFrameRateQuest'opzione specifica il framerate con cui sarà registrato il replay. Maggiore sarà il valore, maggiore sarà la fluidità del replay, ma allo stesso tempo aumenteranno le dimensioni del file. Evitate di impostare quest'opzione ad un valore maggiore di 50, in quanto potrebbero verificarsi conseguenze inaspettate. 25, il valore di default sembra essere un buon compromesso tra fluidità e dimensioni del file.
CompressReplaysSe quest'opzione avrà valore true i replay saranno compressi con zlib. Questo è il comportamento di default. Settate false solo se notate che il tempo di salvataggio dei replay è molto lungo.

Ci sono molte opzioni "oscure" nel file config.dat ma le lascerò non documentate in quanto in futuro potrebbero essere modificabili dall'interno del gioco.

Argomenti da linea di comando

Si possono passare alcuni argomenti al gioco avviandolo da linea di comando.

-res WIDTHxHEIGHTQuest'opzione forza X-Moto ad usare una risoluzione di WIDTHxHEIGHT. Nota che questa risoluzione deve essere supportata dalla tua scheda video e dal monitor, se -res non è associata a -win, in questo caso potete specificare qualsiasi risoluzione vogliate.
Nota che quest'opzione scavalcherà le impostazioni che hai specificato nel gioco.
-bpp BITSImposta i bits per pixel del display a BITS. Quando X-Moto è avviato in una finestra quest'opzione non ha effetto. Se BITS è a 0, l'impostazione corrente è usata.
Così come -res, quest'opzione scavalcherà le impostazioni del gioco.
-fsForza il gioco ad avviarsi in modalità schermo intero senza tenere conto delle impostazioni specificate nel gioco.
-winCome -fs, ma forza la modalità finestra
-qAttiva la modalità discreta in cui non viene scritto nessun messaggio nel log o nella console. Quest'opzione scavalca l'opzione -v.
-vAttiva la modalità verbosa.
-noextsDisattiva l'uso delle estensioni OpenGL. Usate quest'opzione se notate errori grafici nel gioco. Da notare che quest'opzione abbassa un pò il framerate specialmente nei livelli di grandi dimensioni.
-level IDSalta direttamente al livello identificato da ID. I livelli interni sono identificati dal loro numero. Usa, per esempio, -level 16 per giocare al livello #16. I livelli esterni sono identificati dal loro ID.
-replay NAMEVisualizza il replay salvato. NAME è il nome del file di replay salvato nella sottocartella Replays con o senza l'estensione .rpl.
-profile NAMEGioca il gioco usando un dato profilo. E' utile se usata in combinazione con l'opzione -level.
-listlevelsVisualizza una lista di tutti i livelli disponibili ed esce. Utile se vuoi usare l'opzione -level per saltare direttamente ad un livello senza passare per i menù del gioco per vedere quali sono gli ID dei livelli.
-listreplaysCome -listlevels, ma funziona per i replay.
-timedemoDisattiva il rallentamento del framerate, il gioco userà sempre il massimo del framerate.
-fpsQuest'opzione visualizzerà il framerate attuale in alto a sinistra sullo schermo.
-uglyAttiva la modalità "ugly". Questo aumenterà significativamente il framerate del gioco, ma allo stesso tempo renderà l'aspetto grafico del gioco brutto; molte cose nel gioco saranno disegnate da linee, il pilota per esempio sembrerà una figura solida.
Quest'opzione è molto utile se il tuo sistema non ha una scheda video compatibile OpenGL (come per esempio se stai usando un portatile con la scheda video integrata).
Se hai abbastanza CPU puoi comunque lanciare X-Moto in modalità emulazione software OpenGL (MesaGL su linux, Windows' OpenGL driver, ecc).
-benchmarkUsato in combinazione con -timedemo e -replay, il gioco visualizzerà semplicemente il replay il più veloce possibile, scriverà il framerate medio nello stdout e uscirà.

Nota che questa lista non è completa, molte opzioni oscure sono state tralasciate. Questo è dovuto sopratutto al fatto che non tutte sono state completamente implementate o funzionano correttamente.