Multi Theft Auto: Wiki - User contributions [en]

IT/Scrivere una gamemode

2008-06-11T09:38:43Z

Atti: /* What else should you do */

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Eventi|onGamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===Come usare il map manager===
Per usare questa feature, la tua gamemode deve essere ''taggata'' di conseguenza. In maniera più specifica, dovremo impostare, nel meta.xml, l'attributo "type" della ''tag'' <info> a "gamemode". Inoltre, possiamo impostare per l'attributo "name" un nome più 'familiare' (come "Capture the flag") che verrà mostrato nel server browser al posto del nome della ''resource''.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

Se la tua gamemode dovrà caricare mappe personalizzate, dovranno essere presenti gli ''event handlers'' per
* onGamemodeMapStart
* onGamemodeMapStop (se necessario)
Questi eventi vengono chiamati quando una mappa per la tua gamemode viene avviata o chiusa, e passano la ''reource'' della mappa come paramentro.
All'interno della funzione legata a questi eventi potrai ottenere tutte le informazioni che ti servono dai file della mappa.

====Esempio====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap è la mappa appena avviata
local mapRoot = getResourceRootElement( startedMap ) -- ottiene il nodo di root della mappa avviata
local flagElements = getElementsByType ( "flag" , mapRoot ) -- ottiene tutte le bandiere della mappa e le salva in una tabella
-- continua a caricare informazioni come sopra

-- spawna i players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Rendere le mappe compatibili===
Le mappe sono ''resource'' separate. Questo è stato fatto perché creare una nuova mappa non implichi nessuna modifica nella gamemode, e viceversa.

Per rendere una mappa compatibile con la tua gamemode, apri il suo file meta.xml e modificalo così: l'attributo "type" dev'essere settato a "map", e l'attributo"gamemodes" dev'essere una lista senza spazi, in cui gli elementi sono i nomi delle gamemode con cui la mappa funziona, separati da virgole.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Quando tutto è pronto, gli admin potranno usare questi due comandi per avviare/fermare le gamemode:
*/gamemode nomeGamemode [nomeMappa] (nomeMappa è opzionale: puoi selezionare una mappa con cui iniziare la gamemode, di default questo parametro è vuoto)
*/changemap nomeMappa [nomeGamemode] (nomeGamemode è opzionale: seleziona la gamemode da avviare con la mappa, di default è quella corrente)

Il [[IT/Map manager|Map manager]] esporta qualche altra funzione che in questo esempio non serve, ma che potrebbe essere utile.

==Cos'altro dovresti fare==
Ci sono alcune altre ''resource'' che dovresti usare nel creare la tua mode, o almeno conoscere.

===Helpmanager===
L'[[Resource:IT/Help manager|Help manager]] dovrebbe essere l'interfaccia standard per i giocatori che hanno bisogno di aiuto. Se usi l'[[Resource:IT/Help manager|Help manager]] per mostrare il testo d'aiuto della tua mode, tutti i giocatori che lo hanno già usato in altre gamemodes sapranno immediatamente come usufruirne. Esso mostra anche un aiuto per le diverse ''resource'' attive divise per schede in una sola finestra, se necessario.

Ci sono due modi per usare l'[[Resource:IT/Help manager|Help manager]], in breve:
* Mostrare un semplice testo che spieghi come usare la gamemode
* Mostrare informazioni più complesse sotto forma di GUI.

Leggi la [[Resource:IT/Help manager|pagina dell'Help manager]] per dettagli su come farlo.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T09:29:16Z

Atti: /* Rendere le mappe compatibili */

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Eventi|onGamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===Come usare il map manager===
Per usare questa feature, la tua gamemode deve essere ''taggata'' di conseguenza. In maniera più specifica, dovremo impostare, nel meta.xml, l'attributo "type" della ''tag'' <info> a "gamemode". Inoltre, possiamo impostare per l'attributo "name" un nome più 'familiare' (come "Capture the flag") che verrà mostrato nel server browser al posto del nome della ''resource''.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

Se la tua gamemode dovrà caricare mappe personalizzate, dovranno essere presenti gli ''event handlers'' per
* onGamemodeMapStart
* onGamemodeMapStop (se necessario)
Questi eventi vengono chiamati quando una mappa per la tua gamemode viene avviata o chiusa, e passano la ''reource'' della mappa come paramentro.
All'interno della funzione legata a questi eventi potrai ottenere tutte le informazioni che ti servono dai file della mappa.

====Esempio====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap è la mappa appena avviata
local mapRoot = getResourceRootElement( startedMap ) -- ottiene il nodo di root della mappa avviata
local flagElements = getElementsByType ( "flag" , mapRoot ) -- ottiene tutte le bandiere della mappa e le salva in una tabella
-- continua a caricare informazioni come sopra

-- spawna i players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Rendere le mappe compatibili===
Le mappe sono ''resource'' separate. Questo è stato fatto perché creare una nuova mappa non implichi nessuna modifica nella gamemode, e viceversa.

Per rendere una mappa compatibile con la tua gamemode, apri il suo file meta.xml e modificalo così: l'attributo "type" dev'essere settato a "map", e l'attributo"gamemodes" dev'essere una lista senza spazi, in cui gli elementi sono i nomi delle gamemode con cui la mappa funziona, separati da virgole.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Quando tutto è pronto, gli admin potranno usare questi due comandi per avviare/fermare le gamemode:
*/gamemode nomeGamemode [nomeMappa] (nomeMappa è opzionale: puoi selezionare una mappa con cui iniziare la gamemode, di default questo parametro è vuoto)
*/changemap nomeMappa [nomeGamemode] (nomeGamemode è opzionale: seleziona la gamemode da avviare con la mappa, di default è quella corrente)

Il [[IT/Map manager|Map manager]] esporta qualche altra funzione che in questo esempio non serve, ma che potrebbe essere utile.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T09:28:39Z

Atti: /* Making maps compatible */

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Eventi|onGamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===Come usare il map manager===
Per usare questa feature, la tua gamemode deve essere ''taggata'' di conseguenza. In maniera più specifica, dovremo impostare, nel meta.xml, l'attributo "type" della ''tag'' <info> a "gamemode". Inoltre, possiamo impostare per l'attributo "name" un nome più 'familiare' (come "Capture the flag") che verrà mostrato nel server browser al posto del nome della ''resource''.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

Se la tua gamemode dovrà caricare mappe personalizzate, dovranno essere presenti gli ''event handlers'' per
* onGamemodeMapStart
* onGamemodeMapStop (se necessario)
Questi eventi vengono chiamati quando una mappa per la tua gamemode viene avviata o chiusa, e passano la ''reource'' della mappa come paramentro.
All'interno della funzione legata a questi eventi potrai ottenere tutte le informazioni che ti servono dai file della mappa.

====Esempio====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap è la mappa appena avviata
local mapRoot = getResourceRootElement( startedMap ) -- ottiene il nodo di root della mappa avviata
local flagElements = getElementsByType ( "flag" , mapRoot ) -- ottiene tutte le bandiere della mappa e le salva in una tabella
-- continua a caricare informazioni come sopra

-- spawna i players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Rendere le mappe compatibili===
Le mappe sono ''resource'' separate. Questo è stato fatto perché creare una nuova mappa non implichi nessuna modifica nella gamemode, e viceversa.

Per rendere una mappa compatibile con la tua gamemode, apri il suo file meta.xml e modificalo così: l'attributo "type" dev'essere settato a "map", e l'attributo"gamemodes" dev'essere una lista senza spazi, in cui gli elementi sono i nomi delle gamemode con cui la mappa funziona, separati da virgole.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Quando tutto è pronto, gli admin potranno usare questi due comandi per avviare/fermare le gamemode:
/gamemode nomeGamemode [nomeMappa] (nomeMappa è opzionale: puoi selezionare una mappa con cui iniziare la gamemode, di default questo parametro è vuoto)
/changemap nomeMappa [nomeGamemode] (nomeGamemode è opzionale: seleziona la gamemode da avviare con la mappa, di default è quella corrente)

[[IT/Map manager|Map manager]] esporta qualche altra funzione che in questo esempio non serve, ma che potrebbe essere utile.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T08:58:05Z

Atti: /* How to use the mapmanager */

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Eventi|onGamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===Come usare il map manager===
Per usare questa feature, la tua gamemode deve essere ''taggata'' di conseguenza. In maniera più specifica, dovremo impostare, nel meta.xml, l'attributo "type" della ''tag'' <info> a "gamemode". Inoltre, possiamo impostare per l'attributo "name" un nome più 'familiare' (come "Capture the flag") che verrà mostrato nel server browser al posto del nome della ''resource''.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

Se la tua gamemode dovrà caricare mappe personalizzate, dovranno essere presenti gli ''event handlers'' per
* onGamemodeMapStart
* onGamemodeMapStop (se necessario)
Questi eventi vengono chiamati quando una mappa per la tua gamemode viene avviata o chiusa, e passano la ''reource'' della mappa come paramentro.
All'interno della funzione legata a questi eventi potrai ottenere tutte le informazioni che ti servono dai file della mappa.

====Esempio====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap è la mappa appena avviata
local mapRoot = getResourceRootElement( startedMap ) -- ottiene il nodo di root della mappa avviata
local flagElements = getElementsByType ( "flag" , mapRoot ) -- ottiene tutte le bandiere della mappa e le salva in una tabella
-- continua a caricare informazioni come sopra

-- spawna i players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Making maps compatible===
Maps are separate resources. This is done so no editing of the gamemode resource is ever necessary in order to create a custom map, and also allows you to pack map-specific scripts/config files with them.

To make a map compatible with your gamemode, open its resource's meta.xml and tag it as well: the "type" attribute must be set to "map", and the "gamemodes" attribute must be a comma-separated list (no spaces) of gamemode resource names that the map works with.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Once you have everything set up, admins will use these two commands to start/stop gamemodes:
/gamemode gamemodeName [mapName] (optional parameter allows picking an initial map, defaults to none)
/changemap mapName [gamemodeName] (optional parameter specifies the gamemode to start the map with, defaults to the current one)

[[Map manager]] exports a few more access functions which you don't have to use, but may be useful.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T08:42:42Z

Atti: /* Il map manager */

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Eventi|onGamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===How to use the mapmanager===
To use the mapmanager service, your gamemode resource has to be tagged as such first. More specifically you'll be setting the "type" attribute of its <info> tag to "gamemode" inside meta.xml. Also, you can set the "name" attribute to a friendly name (like "Capture the flag") that will be shown on ASE instead of the resource name.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

If your gamemode is going to load custom maps, you should add handlers for
* onGamemodeMapStart
* onGamemodeMapStop (if any unloading is necessary)
These are fired when a map for your gamemode is started or stopped, and pass the map resource as a parameter.
Within the handler function for these events you can extract all info you need from the resource's map files and configuration files.

====Example====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap contains a reference to the resource of the map
local mapRoot = getResourceRootElement( startedMap ) -- get the root node of the started map
local flagElements = getElementsByType ( "flag" , mapRoot ) -- get all flags in the map and store them in a table
-- go on loading information like in the example above

-- spawn players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Making maps compatible===
Maps are separate resources. This is done so no editing of the gamemode resource is ever necessary in order to create a custom map, and also allows you to pack map-specific scripts/config files with them.

To make a map compatible with your gamemode, open its resource's meta.xml and tag it as well: the "type" attribute must be set to "map", and the "gamemodes" attribute must be a comma-separated list (no spaces) of gamemode resource names that the map works with.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Once you have everything set up, admins will use these two commands to start/stop gamemodes:
/gamemode gamemodeName [mapName] (optional parameter allows picking an initial map, defaults to none)
/changemap mapName [gamemodeName] (optional parameter specifies the gamemode to start the map with, defaults to the current one)

[[Map manager]] exports a few more access functions which you don't have to use, but may be useful.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T08:42:02Z

Atti:

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Il map manager==
Dopo aver letto la sezione di sopra dovrebbe essere chiaro che una gamemode consiste di due parti:
* La ''resource'' della gamemode, che resta sempre uguale
* Molte ''resource'' delle mappe, che forniscono alla gamemode informazioni legate alla mappa

Ora, al posto di scrivere uno script che carichi la mappa per ogni gamemode, il [[IT/Map manager|Map manager]] fornisce funzioni per caricare le gamemodes e le mappe. Semplicemente, quando digiti il comando giusto (per esempio 'gamemode ctf ctf-italy') avvierà le due ''resource'' 'ctf' e 'ctf-italy', chiamando anche l'evento '[[IT/Map_manager#Evention|GamemodeMapStart]]' per avvertire la ''resource'' 'ctf' che una mappa è stata caricata. La ''resource'' 'ctf' può quindi accedere alle informazioni contenute in 'ctf-italy' e iniziare a spawnare i players, etc.

===How to use the mapmanager===
To use the mapmanager service, your gamemode resource has to be tagged as such first. More specifically you'll be setting the "type" attribute of its <info> tag to "gamemode" inside meta.xml. Also, you can set the "name" attribute to a friendly name (like "Capture the flag") that will be shown on ASE instead of the resource name.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

If your gamemode is going to load custom maps, you should add handlers for
* onGamemodeMapStart
* onGamemodeMapStop (if any unloading is necessary)
These are fired when a map for your gamemode is started or stopped, and pass the map resource as a parameter.
Within the handler function for these events you can extract all info you need from the resource's map files and configuration files.

====Example====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap contains a reference to the resource of the map
local mapRoot = getResourceRootElement( startedMap ) -- get the root node of the started map
local flagElements = getElementsByType ( "flag" , mapRoot ) -- get all flags in the map and store them in a table
-- go on loading information like in the example above

-- spawn players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Making maps compatible===
Maps are separate resources. This is done so no editing of the gamemode resource is ever necessary in order to create a custom map, and also allows you to pack map-specific scripts/config files with them.

To make a map compatible with your gamemode, open its resource's meta.xml and tag it as well: the "type" attribute must be set to "map", and the "gamemodes" attribute must be a comma-separated list (no spaces) of gamemode resource names that the map works with.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Once you have everything set up, admins will use these two commands to start/stop gamemodes:
/gamemode gamemodeName [mapName] (optional parameter allows picking an initial map, defaults to none)
/changemap mapName [gamemodeName] (optional parameter specifies the gamemode to start the map with, defaults to the current one)

[[Map manager]] exports a few more access functions which you don't have to use, but may be useful.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T08:28:51Z

Atti:

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team ".. team .."!" )
end
</syntaxhighlight>
La funzione [[IT/getElementsByType|getElementsByType]] restituisce una tabella contenente tutti gli elementi di un dato tipo (il tipo corrisponde al nome del ''nodo'' [nell'esempio "flag"] nel file .map). Questo funziona sia per i tipi personalizzati sia per quelli di default di MTA (come "vehicle" o "player").
[[IT/getElementData|getElementData]] è usato per ritrovare gli attributi impostati nell'XML.
In questi semplice esempio, un oggetto è creato nella posizione della bandiera e un messaggio viene inviato in cheatbox. In realtà, bisognerà fare ovviamente del lavoro in più durante il caricamento della mappa, come in questo caso creare delle ''forme di collisione'' per determinare quando un player cattura la bandiera.

==Map manager==
Having read the section above it should be clear that a gamemode should always consist of two parts:
* The gamemode resource that always stays the same
* Many different maps resources that give the gamemode map-specific information

Now instead of writing a map-loader for every single gamemode, the [[Map manager]] provides functions to load gamemodes and maps. Simply put, when you enter the correct command (for example 'gamemode ctf ctf-italy') it will start both resources 'ctf' and 'ctf-italy' while triggering an event ([[onGamemodeMapStart]]) to tell the 'ctf' resource that a map was loaded. The 'ctf' resource can then access the information 'ctf-italy' contains and start spawning players etc.

===How to use the mapmanager===
To use the mapmanager service, your gamemode resource has to be tagged as such first. More specifically you'll be setting the "type" attribute of its <info> tag to "gamemode" inside meta.xml. Also, you can set the "name" attribute to a friendly name (like "Capture the flag") that will be shown on ASE instead of the resource name.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

If your gamemode is going to load custom maps, you should add handlers for
* onGamemodeMapStart
* onGamemodeMapStop (if any unloading is necessary)
These are fired when a map for your gamemode is started or stopped, and pass the map resource as a parameter.
Within the handler function for these events you can extract all info you need from the resource's map files and configuration files.

====Example====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap contains a reference to the resource of the map
local mapRoot = getResourceRootElement( startedMap ) -- get the root node of the started map
local flagElements = getElementsByType ( "flag" , mapRoot ) -- get all flags in the map and store them in a table
-- go on loading information like in the example above

-- spawn players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Making maps compatible===
Maps are separate resources. This is done so no editing of the gamemode resource is ever necessary in order to create a custom map, and also allows you to pack map-specific scripts/config files with them.

To make a map compatible with your gamemode, open its resource's meta.xml and tag it as well: the "type" attribute must be set to "map", and the "gamemodes" attribute must be a comma-separated list (no spaces) of gamemode resource names that the map works with.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Once you have everything set up, admins will use these two commands to start/stop gamemodes:
/gamemode gamemodeName [mapName] (optional parameter allows picking an initial map, defaults to none)
/changemap mapName [gamemodeName] (optional parameter specifies the gamemode to start the map with, defaults to the current one)

[[Map manager]] exports a few more access functions which you don't have to use, but may be useful.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/Scrivere una gamemode

2008-06-11T08:02:16Z

Atti:

[[Category:25%]]
{{IT/MainP}}

Questa guida cerca di definire a grandi linee le regole per scrivere una gamemode ben fatta. Se hai appena iniziato a programmare per MTA, vorrai probabilmente controllare prima gli altri tutorial che troverai nella [[IT/Pagina principale|Pagina principale]].
==Introduzione==
Una ''gamemode'' è una risorsa che, una volta avviata, domina l'intero gameplay, dicendo ai giocatori cosa fare, creando oggetti, definendo come i giocatori possono vincere o accumulare punti eccetera eccetera. Alcuni esempi sono le gamemodes Race o Deathmatch.

==Cosa si intende per gamemode "ben fatta"?==
Per essere semplici, una gamemode "ben fatta" è una gamemode che utilizza appieno le potenzialità delle mappe (.map) di MTA; vale a dire che la gamemode non contiene elementi specifici delle mappe(pickups, oggetti, spawns, veicoli eccetera)''hardcodati'' al loro interno. Questi elementi vanno invece inseriti nelle mappe di MTA(.map) che verranno poi caricate dagli scripts. In questo modo possono essere caricate mappe diverse per la stessa gamemode, o è anche possibile creare delle mappe grazie al map editor di MTA.
Un ovvio esempio di una gamemode "ben fatta" è MTA:Race: permette ai giocatori di caricare mappe personalizzate(i file .map). Non c'è bisogno di modificare la gamemode stessa per cambiare gli spawnpoints, i veicoli, eccetera.

===Files mappa===
Tecnicamente, i file mappa non sono altro che documenti XML con estensione .map; definiscono le basi di gioco di una o più gamemodes, anche se non possono cambiare le "regole del gioco", essendo queste definite dalla gamemode(.lua).

Ogni elemento nel gioco corrisponde ad un ''nodo'' nel file .map. C'è una sintassi predefinita per elementi quali oggetti, veicoli eccetera; comunque, per elementi "speciali" delle tue gamemodes, dovrai creare tu una sintassi apposita.

====Esempio====
Per il nostro esempio, prendiamo in esame la gamemode ''Capture the Flag''. Una mappa per questa gamemode deve sostanzialmente definire gli spawnpoints dei giocatori e la posizione delle bandiere, ed eventualmente la presenza di altri oggetti come i veicoli o i pickups. Un file .map molto semplificato apparirebbe così:
<syntaxhighlight lang="xml">
<map>
<spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" rot="63.350006103516" model="0"/>
<pickup id="Armor 1" posX="1911.083984375" posY="-1658.8798828125" posZ="885.40216064453" type="armor" health="50" respawn="60000"/>
<flag posX="1959.5487060547" posY="-1714.4613037109" posZ="877.25219726563" team="blue" />
...
</map>
</syntaxhighlight>

Qui possiamo vedere due elementi di MTA: uno spawnpoint ed un pickup. Ancora più importante, questa mappa ha un ''nodo'' chiamato ''flag'' che definisce la posizione ed il colore della bandiera. Gli spawnpoints ed i pickups possono essere gestiti da risorse esterne, ma gli elementi personalizzati devono essere processati dalle gamemodes.

Insomma, vogliamo che i giocatori possano creare le proprie mappe senza aver bisogno dello script LUA.

====Esempio: come ottenere le informazioni dal file .map====
Come detto prima, la tua mode ha bisogno di ritrovare gli elementi personalizzati definiti in un file .map e processarli. Questo è abbastanza facile, come è dimostrato qui sotto.
<syntaxhighlight lang="lua">
-- crea una tabella con tutti gli elementi di tipo flag
local flagElements = getElementsByType ( "flag" )
-- crea un ciclo per ogni elemento che abbiamo trovato
for key, value in pairs(flagElements) do
-- ottiene le info di quell'elemento
local posX = getElementData ( value, "posX" )
local posY = getElementData ( value, "posY" )
local posZ = getElementData ( value, "posZ" )
local team = getElementData ( value, "team" )
-- crea un oggetto a seconda della posizione della bandiera (flag)
createObject ( 1337, posX, posY, posZ )
-- scrive in chat il team per cui abbiamo creato una base
outputChatBox ( "Base creata per il team " .. team .. "!" )
end
</syntaxhighlight>
The [[getElementsByType]] function retrieves a table of all the elements of a certain type (the type corresponds to the node name in the .map file). This works for both custom types and built-in MTA types (like "vehicle" or "player").
[[getElementData]] can be used to retrieve the xml attributes set in the .map file.
In this simple example, an object is created at the flag's location and a message is outputted in the chatbox. In reality, you will of course need to do more during map loading, like in this case setting up collision shapes to detect players taking the flag.

==Map manager==
Having read the section above it should be clear that a gamemode should always consist of two parts:
* The gamemode resource that always stays the same
* Many different maps resources that give the gamemode map-specific information

Now instead of writing a map-loader for every single gamemode, the [[Map manager]] provides functions to load gamemodes and maps. Simply put, when you enter the correct command (for example 'gamemode ctf ctf-italy') it will start both resources 'ctf' and 'ctf-italy' while triggering an event ([[onGamemodeMapStart]]) to tell the 'ctf' resource that a map was loaded. The 'ctf' resource can then access the information 'ctf-italy' contains and start spawning players etc.

===How to use the mapmanager===
To use the mapmanager service, your gamemode resource has to be tagged as such first. More specifically you'll be setting the "type" attribute of its <info> tag to "gamemode" inside meta.xml. Also, you can set the "name" attribute to a friendly name (like "Capture the flag") that will be shown on ASE instead of the resource name.
<syntaxhighlight lang="xml">

<meta>
<info type="gamemode" name="Cow catapulting 2.0"/>
</meta>
</syntaxhighlight>

If your gamemode is going to load custom maps, you should add handlers for
* onGamemodeMapStart
* onGamemodeMapStop (if any unloading is necessary)
These are fired when a map for your gamemode is started or stopped, and pass the map resource as a parameter.
Within the handler function for these events you can extract all info you need from the resource's map files and configuration files.

====Example====
<syntaxhighlight lang="lua">
function startCtfMap( startedMap ) -- startedMap contains a reference to the resource of the map
local mapRoot = getResourceRootElement( startedMap ) -- get the root node of the started map
local flagElements = getElementsByType ( "flag" , mapRoot ) -- get all flags in the map and store them in a table
-- go on loading information like in the example above

-- spawn players etc.

end

addEventHandler("onGamemodeMapStart", getRootElement(), startCtfMap)
</syntaxhighlight>

===Making maps compatible===
Maps are separate resources. This is done so no editing of the gamemode resource is ever necessary in order to create a custom map, and also allows you to pack map-specific scripts/config files with them.

To make a map compatible with your gamemode, open its resource's meta.xml and tag it as well: the "type" attribute must be set to "map", and the "gamemodes" attribute must be a comma-separated list (no spaces) of gamemode resource names that the map works with.
<syntaxhighlight lang="xml">

<meta>
<info type="map" gamemodes="cowcatapult,assault,tdm"/>
</meta>
</syntaxhighlight>

Once you have everything set up, admins will use these two commands to start/stop gamemodes:
/gamemode gamemodeName [mapName] (optional parameter allows picking an initial map, defaults to none)
/changemap mapName [gamemodeName] (optional parameter specifies the gamemode to start the map with, defaults to the current one)

[[Map manager]] exports a few more access functions which you don't have to use, but may be useful.

==What else should you do==
There are several other resources that gamemodes should use/be compliant with.

===Helpmanager===
The helpmanager is ought to be the standard interface for players when they need help. If you use the helpmanager to display your gamemode's help, every player that used helpmanager before (e.g. in other gamemodes) will immediately know how to get there. It also displays help for different resources running resources in one window, if necessary.

There are basicially two ways to use the helpmanager:
* Provide a simple text that explains how to use your gamemode
* Request a GUI element from the helpmanager that will be displayed in its own tab in the helpmanager window and lets you add any GUI elements to it. This is the recommended way for gamemodes that need to display more complex information that needs its own GUI.

Read the helpmanager page for details on how to do it.

===Scoreboard===
Scoreboard displays players and teams currently ingame. You add custom columns to it to provide map specific information. For example the column 'points' in the 'ctf' gamemode could represent the player's points gained through kills or captures. As usual, see the scoreboard help page for more information.

===Map cycler===
The map cycler controls what gamemodes and maps are played on a server. You can specifiy for example how many times in a row a map will be played until it switches to the next. To achieve this, you need to tell the map cycler when your gamemode finished (e.g. when a round ends).

[[en:Writing gamemodes]]

IT/fadeCamera

2008-06-11T07:20:25Z

Atti: /* Esempio */

{{IT/Funzioni server client}}
{{IT/MainP}}
__NOTOC__
Questa funzione dissolverà la telecamera di un giocatore in un colore o la riporterà alla normalità dopo un determinato periodo di tempo. Questo influenzerà anche il volume del suono del giocatore (dissolto al 50% = 50% del volume, dissolvenza totale = nessun suono).

==Sintassi==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool fadeCamera ( player thePlayer, bool fadeIn, [ float timeToFade = 1.0, int red = 0, int green = 0, int blue = 0 ] )
</syntaxhighlight>

===Argomenti Richiesti===
* '''thePlayer:''' Il [[IT/Elemento/Player|giocatore]] la cui telecamera deve dissolversi.
* '''fadeIn:''' Se la telecamera deve dissolversi in apertura (''true'') o in chiusura (''false'').

===Argomenti Opzionali===
* '''timeToFade:''' Il numero di secondi che impiegherà per dissolversi.
* '''red:''' La quantità di rosso del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
* '''green:''' La quantità di verde del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
* '''blue:''' La quantità di blu del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool fadeCamera ( bool fadeIn, [ float timeToFade = 1.0, int red = 0, int green = 0, int blue = 0 ] )
</syntaxhighlight>

===Argomenti Richiesti===
* '''thePlayer:''' Il [[IT/Elemento/Player|giocatore]] la cui telecamera deve dissolversi.
* '''fadeIn:''' Se la telecamera deve dissolversi in apertura (''true'') o in chiusura (''false'').

===Argomenti Opzionali===
* '''timeToFade:''' Il numero di secondi che impiegherà per dissolversi.
* '''red:''' La quantità di rosso del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
* '''green:''' La quantità di verde del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
* '''blue:''' La quantità di blu del colore nel quale la telecamera si dissolverà (0 - 255). Non necessario per dissolvenza in apertura.
</section>

===Valori restituiti===
Ritorna ''true'' se la telecamera è stata dissolta con successo, ''false'' se sono stati passati argomenti non validi alla funzione.

==Esempio==
<section name="Server" class="server" show="false">
Quando un giocatore subisce danni, attiva un rapido effetto di dissolvenza in rosso sul suo schermo.
<syntaxhighlight lang="lua">
function addRednessOnDamage ( )
fadeCamera ( source, false, 1.0, 255, 0, 0 ) -- dissolve la telecamera del giocatore sul rosso per un periodo di un secondo
setTimer ( fadeCamera, 500, 1, source, true, 0.5 ) -- non permette di dissolversi completamente, interrompe la dissolvenza e la riporta alla normalità
end
addEventHandler ( "onPlayerDamage", getRootElement(), addRednessOnDamage )
</syntaxhighlight>
</section>

==See Also==
{{IT/Camera functions}}

Template:IT/Cursor functions

2008-06-11T00:24:50Z

Atti: New page: <noinclude>{{IT/MainP}}</noinclude> *getCursorPosition *isCursorShowing *showCursor

<noinclude>{{IT/MainP}}</noinclude>
*[[IT/getCursorPosition|getCursorPosition]]
*[[IT/isCursorShowing|isCursorShowing]]
*[[IT/showCursor|showCursor]]

IT/showCursor

2008-06-11T00:23:10Z

Atti: /* See Also */

__NOTOC__
{{IT/Funzioni server client}}
Questa funzione è usata per mostrare o nascondere il cursore di un [[IT/Elemento/Player|giocatore]].

Nota che, indipendentemente dallo stato del cursore impostato da questa funzione, il cursore sarà sempre visibile quando la chatbox o il menu sono aperti.

==Sintassi==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( player thePlayer, bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/Elemento/Player|giocatore]] di cui vuoi mostrare o nascondere il cursore.
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

===Valori restituiti===
Restituisce ''true'' se il cursore del [[IT/Elemento/Player|giocatore]] è stato mostrato o nascosto con successo, altrimenti ''false''.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio attiva il cursore per un player di nome "Atti", quindi invia un messaggio se è stato attivato con successo.
<syntaxhighlight lang="lua">
local thePlayer = getPlayerFromNick ( "Atti" ) -- ottiene il player di nome Atti
if thePlayer then -- se lo abbiamo ottenuto
showCursor ( thePlayer, true ) -- gli mostriamo il cursore
if isCursorShowing ( thePlayer ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per Atti!" ) -- invia un messaggio nella chatbox
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio attiva il cursore per il client attivo, quindi invia un messaggio in chatbox.
<syntaxhighlight lang="lua">
showCursor ( true ) -- mostriamo il cursore
if isCursorShowing ( ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per "..getPlayerName( getLocalPlayer() ).."!" ) -- invia un messaggio nella chatbox
end
</syntaxhighlight>
</section>

==See Also==
{{IT/Cursor_functions}}

IT/showCursor

2008-06-11T00:22:47Z

Atti: /* Esempio */

IT/showCursor

2008-06-11T00:21:01Z

Atti:

__NOTOC__
{{IT/Funzioni server client}}
Questa funzione è usata per mostrare o nascondere il cursore di un [[IT/Elemento/Player|giocatore]].

Nota che, indipendentemente dallo stato del cursore impostato da questa funzione, il cursore sarà sempre visibile quando la chatbox o il menu sono aperti.

==Sintassi==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( player thePlayer, bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/Elemento/Player|giocatore]] di cui vuoi mostrare o nascondere il cursore.
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

===Valori restituiti===
Restituisce ''true'' se il cursore del [[IT/Elemento/Player|giocatore]] è stato mostrato o nascosto con successo, altrimenti ''false''.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio attiva il cursore per un player di nome "Atti", quindi invia un messaggio se è stato attivato con successo.
<syntaxhighlight lang="lua">
local thePlayer = getPlayerFromNick ( "Atti" ) -- ottiene il player di nome Dave
if thePlayer then -- se lo abbiamo ottenuto
showCursor ( thePlayer, true ) -- gli mostriamo il cursore
if isCursorShowing ( thePlayer ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per Atti!" ) -- invia un messaggio nella chatbox
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio attiva il cursore per il client attivo, quindi invia un messaggio in chatbox.
<syntaxhighlight lang="lua">
showCursor ( true ) -- mostriamo il cursore
if isCursorShowing ( ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per "..getPlayerName( getLocalPlayer() ).."!" ) -- invia un messaggio nella chatbox
end
</syntaxhighlight>
</section>

==See Also==
{{IT/Funzioni_cursore}}

IT/showCursor

2008-06-11T00:19:09Z

Atti: New page: __NOTOC__ {{Funzioni server client}} Questa funzione è usata per mostrare o nascondere il cursore di un giocatore. Nota che, indipendentemente dallo stato del curs...

__NOTOC__
{{Funzioni server client}}
Questa funzione è usata per mostrare o nascondere il cursore di un [[IT/Elemento/Player|giocatore]].

Nota che, indipendentemente dallo stato del cursore impostato da questa funzione, il cursore sarà sempre visibile quando la chatbox o il menu sono aperti.

==Sintassi==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( player thePlayer, bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/Elemento/Player|giocatore]] di cui vuoi mostrare o nascondere il cursore.
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool showCursor ( bool show )
</syntaxhighlight>

===Argomenti richiesti===
*'''show:''' Un valore booleano che determina se mostrare (''true'') o nascondere (''false'') il cursore.
</section>

===Valori restituiti===
Restituisce ''true'' se il cursore del [[IT/Elemento/Player|giocatore]] è stato mostrato o nascosto con successo, altrimenti ''false''.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio attiva il cursore per un player di nome "Atti", quindi invia un messaggio se è stato attivato con successo.
<syntaxhighlight lang="lua">
local thePlayer = getPlayerFromNick ( "Atti" ) -- ottiene il player di nome Dave
if thePlayer then -- se lo abbiamo ottenuto
showCursor ( thePlayer, true ) -- gli mostriamo il cursore
if isCursorShowing ( thePlayer ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per Atti!" ) -- invia un messaggio nella chatbox
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio attiva il cursore per il client attivo, quindi invia un messaggio in chatbox.
<syntaxhighlight lang="lua">
showCursor ( true ) -- mostriamo il cursore
if isCursorShowing ( ) then -- ha funzionato?
outputChatBox ( "Il cursore è ora attivo per "..getPlayerName( getLocalPlayer() ).."!" ) -- invia un messaggio nella chatbox
end
</syntaxhighlight>
</section>

==See Also==
{{IT/Funzioni_cursore}}

IT/Introduzione allo scripting della GUI

2008-06-11T00:04:59Z

Atti:

{{IT/MainP}}
[[Category:100%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[IT/Introduzione allo scripting|Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L'event handler deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Introduzione allo scripting della GUI

2008-06-11T00:02:40Z

Atti: /* Un tutorial per creare una finestra di login */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[IT/Introduzione allo scripting|Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L'event handler deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Introduzione allo scripting della GUI

2008-06-11T00:01:52Z

Atti: /* Un tutorial per creare una finestra di login */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[IT/introduzione allo scripting|Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L'event handler deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Pagina principale

2008-06-10T23:51:22Z

Atti: /* Per iniziare */

<div style="text-align:center;">[http://www.spreadfirefox.com/en-US/worldrecord Prenotati anche tu per l'uscita di Firefox 3!]<br />
[[Image:Firefoxrecord.png]]<br />
[http://www.getfirefox.com/ Scarica Firefox gratis!]</div>
<div style="border: 1px dotted #5555FF;padding:4px 8px 8px 8px;margin:10px;">Questa wiki è stata tradotta da(in ordine cronologico): [[User:Shadd|Shadd]], [[User:Atti|Atti]] e [[User:Talco|Talco]].<br />This wiki has been translated by(in chronological order): [[User:Shadd|Shadd]], [[User:Atti|Atti]] and [[User:Talco|Talco]].</div>
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>
Benvenuto nella wiki in italiano di Multi Theft Auto: San Andreas Deathmatch. Qui troverai abbondanti informazioni sullo sviluppo di gamemode e mappe per Multi Theft Auto.

Stiamo rilasciando le ''anteprime per lo sviluppatore'' perchè abbiamo bisogno del tuo aiuto! Ci sono molte [[IT/Come puoi aiutare|cose che puoi fare per aiutarci]] ad ottenere una release completa e raffinata di MTA:SA DM - creare una mappa, una gamemode, aiutare a documentare le funzioni, scrivere del codice di esempio, dei tutorial o semplicemente giocare a MTA e riportare nel forum i bug che trovi.

Questa release è una gran cosa per noi - rilasciamo il prodotto di due anni del nostro lavoro e non possiamo aspettare di vedere cosa ci fate. Ricorda che possono capitare degli inevitabili problemi e che comunque le cose non sono ancora del tutto complete!

Se hai qualche domanda o problema relativo allo scripting, sentiti libero di metterti in contatto con noi (in inglese) attraverso il nostro [[IT/Canale IRC|Canale IRC]].

'''Hai bisogno di possedere un account in mtabeta.com per poter modificare questa wiki.''' Per favore registrati in [http://www.mtabeta.com mtabeta.com] e poi usa gli stessi dati per fare il login qui. Se vandalizzerai questa wiki verrai bannato.

La wiki supporta '''[http://gears.google.com/ Google Gears]''', che ti permetterà di vedere questa wiki anche offline (e velocemente). Installa Google Gears e clicca il link ''Go Offline'' in fondo ad ogni pagina. Aspetta un'ora (!) che venga scaricata, quando avrà finito lo vedrai in basso ad ogni pagina, appena dopo il link ''Go Offline''. Fatto ciò, usa l'opzione ''Lavora scollegato'' del tuo browser (in genere nel menu File), o disconnettiti da internet e naviga nella wiki normalmente.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">L'ultima versione disponibile di '''Multi Theft Auto: San Andreas Deathmatch''' è la '''{{Current Version|full}}'''. Visita la [http://www.mtasa.com/dp.html pagina download] e scaricala!</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Per iniziare====

* [[IT/Manuale del Client|Manuale del Client]] {{IT/100%}}
* [[IT/Manuale del Server|Manuale del Server]] {{IT/100%}}
* [[IT/Bugs noti e FAQ|Bugs noti e FAQ]] {{IT/100%}}
* [[IT/Introduzione allo scripting|Introduzione allo Scripting]] {{IT/100%}}
* [[IT/Introduzione allo scripting della GUI|Introduzione allo scripting della GUI]] {{IT/100%}}
* [[IT/Guida al Debug|Guida al Debug]] {{IT/100%}} - Come trovare gli errori dei tuoi scripts
* [[IT/Classi di MTA|Classi di MTA]] {{IT/00%}}
** [[IT/Elementi|Elementi di MTA]] / [[IT/Albero degli elementi|Albero degli elementi]] {{IT/00%}}
* [[IT/Introduzione alle Risorse|Introduzione alle Risorse]] {{IT/00%}}
** [[IT/Accesso web alle Risorse|Accesso web alle Risorse]] {{IT/00%}}
** [[:Category:IT/Risorse|Catalogo risorse]]
** [[IT/Meta.xml|Meta.xml]] {{IT/100%}}
* [[IT/Scrivere una gamemode|Scrivere una gamemode]] {{IT/25%}}

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Database====
Questa sezione delinea tutte le possibilità che MTA o le ''resources'' danno.
* [[Resource:IT/Map manager|Map Manager]] {{IT/100%}}
* [[IT/Script client-side|Script client-side]] {{IT/100%}}
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Guide LUA====
Pagine create per aiutarti a comprendere il LUA (in inglese).
*[http://www.lua.org/pil/index.html "Programming in LUA" Manual]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Documentazione====
* [[IT/Funzioni Client-side|Funzioni Client-side]] {{IT/100%}}
* [[IT/Eventi Client-side|Eventi Client-side]] {{IT/00%}}
* [[IT/Funzioni Server-side|Funzioni Server-side]] {{IT/00%}}
* [[IT/Eventi Server-side|Eventi Server-side]] {{IT/00%}}

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Liste ID====
* [[IT/Skin Personaggi|Skin Personaggi]] {{IT/100%}} ([[IT/Tutte Le Skin|Tutte Le Skin)]] {{IT/100%}}
* [[IT/Vestiti di CJ|Vestiti di CJ]] {{IT/100%}}
* [[IT/Esplosivi|Esplosivi]] {{IT/100%}}
* [[IT/Segnalini radar|Segnalini radar]] {{IT/100%}}
* [[Template:IT/Suoni|Suoni]] {{IT/100%}}
* [[IT/ID Veicoli|Veicoli]] {{IT/100%}}
* [[IT/Colori default veicoli|Colori di default dei veicoli]] {{IT/100%}}
* [[IT/Colori veicoli|Tabella dei colori dei veicoli]] {{IT/100%}}
* [[IT/Miglioramenti Veicoli|Miglioramenti Veicoli]] {{IT/100%}}
* [[IT/Armi|Armi]] {{IT/100%}}
* [[IT/Meteo|Meteo]] {{IT/100%}}
</div>

|-
| colspan="2" |
|}

[[de:Hauptseite]]
[[en:Main Page]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

Talk:Introduction to Scripting the GUI

2008-06-10T23:50:28Z

Atti: New page: Are you sure about that "client" var? I translated it in the Italian wiki, and I think it's an error... --~~~~

Are you sure about that "client" var? I translated it in the Italian wiki, and I think it's an error...
--[[User:Atti|Atti]] 18:50, 10 June 2008 (CDT)

IT/Introduzione allo scripting della GUI

2008-06-10T23:49:05Z

Atti: /* Scriptare il pulsante */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L'event handler deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Introduzione allo scripting della GUI

2008-06-10T23:48:18Z

Atti: /* Scriptare il pulsante */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L''event handler' deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Introduzione allo scripting della GUI

2008-06-10T23:47:35Z

Atti: /* Scripting the button */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scriptare il pulsante===
Quando il giocatore clicca su qualsiasi parte della GUI, verrà chiamato l'evento "[[IT/onClientGUIClick|onClientGUIClick]]" per il componente GUI su cui hai cliccato. Quindi, se clicchi sul pulsante, puoi aggiungere un ''event handler'' legato al pulsante:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", pulsante, funzione, false)
</syntaxhighlight>
Nel nostro script, abbiamo bisogno di un ''event handler'' legato solo al pulsante. Quando viene cliccato, il client ''dirà'' al server di spawnare il player. Recuperate il codice dell'"onClientResourceStart" dalla precedente sezione, e aggiungete la linea successiva DOPO che la funzione CreaFinestraLogin() è chiamata:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientConfermaLogin, false)
</syntaxhighlight>
L'''event handler'' deve essere aggiunto qui perché dobbiamo essere certi che la variabile btnLogin contenga il pulsante che ci serve. Non puoi legare un evento a un elemento che non esiste. Ti sarai reso conto che abbiamo bisogno della funzione "clientConfermaLogin", come è scritto nella riga di sopra (ricordate che questa funzione va sempre PRIMA dell'''event handler'' a cui si riferisce).
<syntaxhighlight lang="lua">
function clientConfermaLogin(tasto)
if tasto == "left" then

triggerServerEvent("ConfermaLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
La variabile "tasto" è passata dall'''event handler'', ed è una stringa contenente il nome del tasto del mouse premuto ("left" [sinistra] o "right" [destra]). Qui tocchiamo anche un nuovo concetto, gli eventi personalizzati. Essi possono essere chiamati dallo stesso ''lato'' (da server a server, da client a client), o possono servire da mezzo di comunicazione tra i due ''lati'' (da server a client, o viceversa). Qui usiamo la funzione [[IT/triggerServerEvent|triggerServerEvent]] per chiamare un evento personalizzato gestito dal server , "ConfermaLogin".

A questo punto abbiamo tutto il codice che ci serve, lato client. Sul lato server, ricordiamo che nella mode che abbiamo spawneremo i players nel momento in cui entrano nella partita:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Tuttavia, visto che dovremo spawnare il player quando il pulsante viene premuto, basterà sostituire l'evento "onPlayerJoin" con l'evento personalizzato chiamato dallo script lato client. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (source) then
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Benvenuto nel mio server!", source)
end
end

addEvent("ConfermaLogin", true)
addEventHandler("ConfermaLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Nota che il secondo argomento della funzione [[IT/addEvent|addEvent]] (quello col valore "true") specifica se l'evento può essere chiamato dall'''altro lato'', ed evidentemente dobbiamo attivarlo, perché l'evento personalizzato in questo caso viene chiamato dal client. La variabile "source" in questo caso identifica il client che ha ''causato'' l'evento, cioé che ha fatto chiamare la funzione.

Infine, non dimentichiamo di includere il nuovo file ''gui.lua'' nel ''meta.xml'' della resource principale:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

A questo punto, abbiamo un semplice sistema di login che spawna il giocatore quando il pulsante "login" è premuto. Possiamo anche usare l'username e la password inviati dalla funzione [[IT/triggerServerEvent|triggerServerEvent]] per verificare l'identità del giocatore prima di spawnarlo.

IT/Introduzione allo scripting della GUI

2008-06-10T23:11:50Z

Atti: /* Usare la funzione che abbiamo scritto */

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l'''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-10T23:11:25Z

Atti:

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[IT/onClientResourceStart|onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()
end
)
</syntaxhighlight>
Vorremmo quindi che la finestra apparisse quando il giocatore entra nella partita, usando lo stesso evento "[[IT/onClientResourceStart|onClientResourceStart]]". Adesso l' ''event handler'' risulterà simile a questo:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreaFinestraLogin()

outputChatBox("Benvenuto nel server, per favore effettua il login.")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Abbiamo effettuato un controllo prima di chiamare la funzione [[IT/guiSetVisible|guiSetVisible]], in modo da verificare l'esistenza di wdwLogin: anche se esso non è un elemento valido, in ogni caso non otterremo un errore. La funzione [[IT/showCursor|showCursor]] ti dà controllo sul tuo mouse, e [[IT/guiSetInputEnabled|guiSetInputEnabled]] serve ad assicurarsi che mentre stai scrivendo nella GUI, lettere come "A", "S", "D", "W", "T" non muoveranno il tuo personaggio o chiuderanno la finestra GUI. Nel prossimo passo, faremo in modo che il bottone funzioni come desideriamo.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-10T23:02:48Z

Atti:

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Usare la funzione che abbiamo scritto===
La funzione CreaFinestraLogin è pronta, ma sarà inutile finchè non la chiameremo. Si raccomanda di creare tutti gli elementi GUI quando lo script lato client è caricato, nasconderli, e poi mostrarli al giocatore quando serve. Pertanto, creeremo un ''event handler'' legato all'evento "[[onClientResourceStart|IT/onClientResourceStart]]" per creare la finestra:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-10T22:58:27Z

Atti:

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Nota che ogni componente GUI che abbiamo creato è ''figlio'' della finestra, e per farlo abbiamo specificato l'elemento ''genitore'' (wdwLogin, in questo caso) quando abbiamo creato il componente:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)
</syntaxhighlight>
Questo è molto utile, perché quando in seguito dovremo controllare l'intero set di GUI, potremo riferirci direttamente all'elemento ''genitore''. Ad esempio:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --nasconde tutti gli elementi GUI creati finora, perché il giocatore li veda solo al momento opportuno.
</syntaxhighlight>

===Using the function we wrote===
The CreateLoginWindow function is done, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-10T22:54:49Z

Atti:

{{IT/MainP}}
[[Category:0%]]
Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)

X = 0.0825
Y = 0.2
Larghezza = 0.25
Altezza = 0.25
guiCreateLabel(X, Y, Larghezza, Altezza, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Larghezza, Altezza, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Larghezza = 0.5
Altezza = 0.15
edtUser = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)

Y = 0.5
edtPass = guiCreateEdit(X, Y, Larghezza, Altezza, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Larghezza = 0.25
Altezza = 0.2
btnLogin = guiCreateButton(X, Y, Larghezza, Altezza, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)
</syntaxhighlight>
This is very useful because later when you need to control the entire set of GUI, you can just refer to the parent element. For example:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The CreateLoginWindow function is done, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-06T22:33:15Z

Atti:

{{IT/MainP}}

Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
Come forse avrai notato, le coordinate che abbiamo inserito sono in percentuale, in questo caso rispetto all'intero schermo. Significa che 0 corrisponde all'estremità destra dello schermo, 1 a quella sinistra, e 0,5 la metà esatta. Questo è applicato non solo alla X e alla Y, ma anche alla larghezza e all'altezza della finestra (se "Larghezza" fosse 0.5, la finestra sarebbe larga esattamente la metà dello schermo). In seguito aggiungeremo le scritte ("username:" e "password:"), i campi di modifica e la casella di controllo. Sostituiamo la funzione con la sua versione completa:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

X = 0.0825
Y = 0.2
Width = 0.25
Height = 0.25
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)
</syntaxhighlight>
This is very useful because later when you need to control the entire set of GUI, you can just refer to the parent element. For example:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The CreateLoginWindow function is done, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

IT/Introduzione allo scripting della GUI

2008-06-06T21:11:59Z

Atti: New page: {{IT/MainP}}  Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzat...

{{IT/MainP}}

Una funzionalità molto importane di MTA è quella di poter scriptare delle GUI (Graphic User Interface - Interfaccia Grafica per l'Utente) personalizzate. La GUI consiste di finestre, pulsanti, campi di modifica, caselle di controllo... Essi possono essere mostrati mentre un player sta giocando, e possono essere usati al posto dei normali comandi per l'input/output.

[[Image:AdminGUI.png|thumb|GUI del pannello da Admin]]

==Un tutorial per creare una finestra di login==
In questo tutorial creeremo una semplice finestra di login, con due campi ed un pulsante. La finestra appare quando un giocatore entra nel server, e quando il pulsante viene premuto, il giocatore spawna. Il tutorial continuerà la ''gamemode'' che abbiamo iniziato nell'[[introduzione allo scripting|IT/Introduzione allo Scripting]]. Daremo anche un'occhiata allo scripting lato client.

===Disegnare la finestra===
Tutte le GUI devono essere scriptate lato client, dunque potrebbe essere conveniente riunirle tutte in una cartella separata. Dunque, quando hai creato una cartella a tuo piacimento, creiamo un file "gui.lua", e in questo file scriveremo una funzione che disegni la finestra:
<syntaxhighlight lang="lua">
function CreaFinestraLogin()
local X = 0.375
local Y = 0.375
local Larghezza = 0.25
local Altezza = 0.25
wdwLogin = guiCreateWindow(X, Y, Larghezza, Altezza, "Log In", true)
end
</syntaxhighlight>
You may click on the function's name to read its documentation. Note that the coordinates of the window is in ''percentage'' of the screen. It means that if the screen is labelled with 0 on the left end, and 1 on the right end, and if "X" is 0.5, it represents the middle of the screen. It applies to Y, window width, and window height as well (if "width" is 0.5, the window will be half as wide as the screen). Next we'll add the text labels (saying "username:" and "password:"), edit boxes and a button. Replace the function with its complete version:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

X = 0.0825
Y = 0.2
Width = 0.25
Height = 0.25
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)
</syntaxhighlight>
This is very useful because later when you need to control the entire set of GUI, you can just refer to the parent element. For example:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The CreateLoginWindow function is done, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

Introduction to Scripting the GUI

2008-06-06T18:45:52Z

Atti:

One important feature in MTA:DM is the ability to script customized GUI (Graphic User Interface). The GUI consists of windows, button, edit boxes, check boxes... Almost every standard form components in graphical environments. They can be displayed while the user is in game, and used for inputs and outpus in place of traditional commands.

[[Image:AdminGUI.png|thumb|Admin Console GUI]]

==A tutorial to make a login window==
In this tutorial we'll make a simple login window, with two input boxes and a button. The window appears when the player joins the game, and once the button is clicked, the player is spawned. The tutorial will continue the gamemode we made in [[Scripting Introduction|Introduction to Scripting]]. We'll also take a look at client-side scripting.

===Draw the window===
All the GUI must be made client side. It is also a good practice to keep all the client scripts in a separate folder. Browse to /Your MTA Server/mods/deathmatch/resources/myserver/ directory, and create a folder named "client". Under /client/ directory, create a text file and name it "gui.lua", and in this file we will write a funtion that draws the window:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)
end
</syntaxhighlight>
You may click on the function's name to read its documentation. Note that the coordinates of the window is in ''percentage'' of the screen. It means that if the screen is labelled with 0 on the left end, and 1 on the right end, and if "X" is 0.5, it represents the middle of the screen. It applies to Y, window width, and window height as well (if "width" is 0.5, the window will be half as wide as the screen). Next we'll add the text labels (saying "username:" and "password:"), edit boxes and a button. Replace the function with its complete version:
<syntaxhighlight lang="lua">
function CreateLoginWindow()
local X = 0.375
local Y = 0.375
local Width = 0.25
local Height = 0.25
wdwLogin = guiCreateWindow(X, Y, Width, Height, "Please Log In", true)

X = 0.0825
Y = 0.2
Width = 0.25
Height = 0.25
guiCreateLabel(X, Y, Width, Height, "Username", true, wdwLogin)
Y = 0.5
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)

X = 0.415
Y = 0.2
Width = 0.5
Height = 0.15
edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
Y = 0.5
edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
guiEditSetMaxLength(edtUser, 50)
guiEditSetMaxLength(edtPass, 50)

X = 0.415
Y = 0.7
Width = 0.25
Height = 0.2
btnLogin = guiCreateButton(X, Y, Width, Height, "Log In", true, wdwLogin)

guiSetVisible(wdwLogin, false)
end
</syntaxhighlight>
Note that every GUI component created is a child of the window, this is done by specifying the parent element (wdwLogin, in this case) when creating the component:
<syntaxhighlight lang="lua">
guiCreateLabel(X, Y, Width, Height, "Password", true, wdwLogin)
</syntaxhighlight>
This is very useful because later when you need to control the entire set of GUI, you can just refer to the parent element. For example:
<syntaxhighlight lang="lua">
guiSetVisible(wdwLogin, false) --hides all the GUI we made so we can show them to the player at the appropriate moment.
</syntaxhighlight>

===Using the function we wrote===
The CreateLoginWindow function is done, but it won't do anything until we call it. It is recommended to create all GUI when the client resource starts, hide them, and show them to player later when needed. Therefore, we'll write an event handler for "[[onClientResourceStart]]" to create the window:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()
end
)
</syntaxhighlight>
We would like to show the window when the client joins the game, using the same event "[[onClientResourceStart]]". Now the event handler looks like:
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()),
function ()
CreateLoginWindow()

outputChatBox("Welcome to My MTA DM Server, please log in. ")

if (wdwLogin ~= nil) then
guiSetVisible(wdwLogin, true)
end

showCursor(true)
guiSetInputEnabled(true)
end
)
</syntaxhighlight>
Note that we have a security check before making the window visible, so that in case the window had not been created, in which case wdwLogin is not a valid element, we don't get an error. The [[showCursor]] function gives control to your mouse, and [[guiSetInputEnabled]] makes sure when you type in the GUI, certain letters like "A", "S", "D", "W", "T" don't move your character or bring out the chatbox input. In the next step, we'll make the button work as desired.

===Scripting the button===
When the player clicks on any part of the GUI, the event "[[onClientGUIClick]]" will be triggered for the GUI component you clicked on. For instance, if you click on the button, you can add the event handler attached to the button:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", theButtonElement, theHandlerFunction, false)
</syntaxhighlight>
In our script, we only need the event handler attached to the button. When it's clicked, the client will tell the server to spawn the player. Find the event handler code for "onClientResourceStart" from the previous section, and add the following line right AFTER CreateLoginWindow() is called:
<syntaxhighlight lang="lua">
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)
</syntaxhighlight>
The event handler must be added here because it makes sure variable btnLogin contains the actual button. You cannot attach an event to an non-existant element. You should have noticed that we need the "clientSubmitLogin" function, as stated in the line above.
<syntaxhighlight lang="lua">
function clientSubmitLogin(button)
if button == "left" then

triggerServerEvent("SubmitLogin", getRootElement(), guiGetText(edtUser), guiGetText(edtPass))
guiSetInputEnabled(false)
guiSetVisible(wdwLogin, false)
showCursor(false)
end
end
</syntaxhighlight>
The variable "button" is passed by the event handler, and it's a string with the name of the button (either "left" or "right"). Here we also hit a new concept, which is custom events. Custom events can be triggered by script from the same side (server to server, or client to client), or from the other side (server to client, or vice versa). Here we use the [[triggerServerEvent]] function to trigger a custom event on the server, "SubmitLogin".

At this point we have all the code needed on the client side. On the server side, recall that we are spawning the player as soon as they join, as shown below:
<syntaxhighlight lang="lua">
function joinHandler()
local x,y,z
x = 1959.55
y = -1714.46
z = 10
spawnPlayer(source, x, y, z)
fadeCamera(source, true)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
However, since we are going to spawn the player when the button is clicked, we must replace the "onPlayerJoin" event with the custom event triggered by the client script. Replace the above code with the following:
<syntaxhighlight lang="lua">
function joinHandler(username, password)
local x,y,z
x = 1959.55
y = -1714.46
z = 10
if (client) then
spawnPlayer(client, x, y, z)
fadeCamera(client, true)
outputChatBox("Welcome to My Server", client)
end
end

addEvent("SubmitLogin", true)
addEventHandler("SubmitLogin", getRootElement(), joinHandler)
</syntaxhighlight>
Note that the second arguement of [[addEvent]] function (the one with value "true") specifies whether the event can be triggered by the other side, therefore we need to turn it on since the client is triggering it. Also note the variable "client", it's an internal variable used by MTA to identify the player who triggered the event.

Finally, do not forget to include the new gui.lua file in the meta.xml of the main resource, and label it as a client script:
<syntaxhighlight lang="xml">
<script src="client/gui.lua" type="client" />
</syntaxhighlight>

As to this point, we have a basic login window that spawns the player when the "login" button is clicked. You can also use the username and password submitted by the [[triggerServerEvent]] function to verify the player's identify before spawning him.

[[it:Introduzione_allo_scripting_della_GUI]]

IT/getPlayerPing

2008-06-06T18:21:35Z

Atti: /* Esempio */

__NOTOC__
{{Funzioni server client}}
{{IT/MainP}}
Questa funzione restituisce il ping di un [[IT/player|player]]. Il ping è il numero di millisecondi che i pacchetti di dati impiegano per essere inviati dal server al client o viceversa.

==Sintassi==
<syntaxhighlight lang="lua">int getPlayerPing ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer''': Il [[IT/player|player]] di cui vuoi determinare il ping.

===Valori restituiti===
Ritorna il ping come ''integer'', o ''false'' se il giocatore selezionato non è valido.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio verifica il ping di un giocatore che è appena entrato e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(source) -- ottiene il ping dell'elemento ''source'' (il player appena entrato)
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è alto, abbassalo se possibile.", source) -- mostra un messaggio al player
end
end
addEventHandler("onPlayerJoin", getRootElement(), controllaPing) -- aggiunge l'event handler
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio verifica il ping di un giocatore quando usa il comando ''ping'' e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(getLocalPlayer()) -- ottiene il ping del player del client attuale
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è alto, abbassalo se possibile.", getLocalPlayer()) -- mostra un messaggio al player
end
end
addCommandHandler("ping", controllaPing) -- aggiunge il comando ''ping''
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getPlayerPing

2008-06-06T18:20:49Z

Atti: New page: __NOTOC__ {{Funzioni server client}} {{IT/MainP}} Questa funzione restituisce il ping di un player. Il ping è il numero di millisecondi che i pacchetti di dati impiegano per...

__NOTOC__
{{Funzioni server client}}
{{IT/MainP}}
Questa funzione restituisce il ping di un [[IT/player|player]]. Il ping è il numero di millisecondi che i pacchetti di dati impiegano per essere inviati dal server al client o viceversa.

==Sintassi==
<syntaxhighlight lang="lua">int getPlayerPing ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer''': Il [[IT/player|player]] di cui vuoi determinare il ping.

===Valori restituiti===
Ritorna il ping come ''integer'', o ''false'' se il giocatore selezionato non è valido.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio verifica il ping di un giocatore che è appena entrato e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(source) -- ottiene il ping dell'elemento ''source'' (il player appena entrato)
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è piuttosto alto, abbassalo se possibile.", source) -- mostra un messaggio al player
end
end
addEventHandler("onPlayerJoin", getRootElement(), controllaPing) -- aggiunge l'event handler
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
Questo esempio verifica il ping di un giocatore quando usa il comando ''ping'' e lo avverte se esso supera i 100 ms.
<syntaxhighlight lang="lua">
function controllaPing()
local ping = getPlayerPing(getLocalPlayer()) -- ottiene il ping del player del client attuale
if (ping > 100) then -- se è maggiore di 100...
outputChatBox("Il tuo ping è piuttosto alto, abbassalo se possibile.") -- mostra un messaggio al player
end
end
addCommandHandler("ping", controllaPing) -- aggiunge il comando ''ping''
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/isPlayerDead

2008-06-06T18:10:36Z

Atti:

{{IT/Funzioni server client}}
{{IT/MainP}}
__NOTOC__
Questa funzione verifica se un giocatore è morto o meno.

==Sintassi==
<syntaxhighlight lang="lua">bool isPlayerDead ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/player|player]] di cui vuoi verificare la morte.

===Valori restituiti===
Restituisce ''true'' se il player è morto, altrimenti ''false''.

==Esempio==
<section name="Server" class="server" show="true">
Questo esempio permette a un giocatore di usare il comando 'sonomorto' per verificare se è morto o meno.
<syntaxhighlight lang="lua">
--Verifica se il giocatore è morto meno e mostra un messaggio nella chatbox
function verificaMorte ( thePlayer, commandName )
if ( isPlayerDead ( thePlayer ) ) then
outputChatBox ( "Sei morto, preparati a diventare uno zombie!", thePlayer )
else
outputChatBox ( "Tira pure un sospiro di sollievo, sei vivo.", thePlayer )
end
end
addCommandHandler ( "sonomorto", verificaMorte )
</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
Questo esempio permette a un giocatore di usare il comando 'sonomorto' per verificare se è morto o meno.
<syntaxhighlight lang="lua">
--Check if player is alive or dead and let them know in the chat box
function verificaMorte ( commandName )
if ( isPlayerDead ( getLocalPlayer() ) ) then
outputChatBox ( "Sei morto, preparati a diventare uno zombie!", getLocalPlayer() )
else
outputChatBox ( "Tira pure un sospiro di sollievo, sei vivo.", getLocalPlayer() )
end
end
addCommandHandler ( "sonomorto", verificaMorte )
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getPlayerName

2008-06-06T18:10:25Z

Atti: /* Esempio */

{{IT/Funzioni client}}
{{IT/MainP}}
__NOTOC__
Questa funzione restituisce una stringa contenente il nick di un giocatore.

==Sintassi==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Argomenti richiesti===
* '''thePlayer:''' Il giocatore di cui vuoi sapere il nome.

===Valori restituiti===
Restituisce una stringa contenente il nome del player selezionato, oppure ''false'' se è stato selezionato un player non valido.

==Esempio==
Questo esempio scrive in chat il nome del player del client che esegue lo script.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
--otteniamo il player ''locale''
local localPlayer = getLocalPlayer()
--otteniamo il suo nome
local nomeLocalPlayer = getPlayerName(localPlayer)
--e lo scriviamo in chat
outputChatBox(nomeLocalPlayer)
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getPlayerName

2008-06-06T18:10:02Z

Atti:

{{IT/Funzioni client}}
{{IT/MainP}}
__NOTOC__
Questa funzione restituisce una stringa contenente il nick di un giocatore.

==Sintassi==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Argomenti richiesti===
* '''thePlayer:''' Il giocatore di cui vuoi sapere il nome.

===Valori restituiti===
Restituisce una stringa contenente il nome del player selezionato, oppure ''false'' se è stato selezionato un player non valido.

==Esempio==
Questo esempio scrive in chat il nome del player del client che esegue lo script.
<section name="client" class="client" show="true">
<syntaxhighlight lang="lua">
--otteniamo il player ''locale''
local localPlayer = getLocalPlayer()
--otteniamo il suo nome
local nomeLocalPlayer = getPlayerName(localPlayer)
--e lo scriviamo in chat
outputChatBox(nomeLocalPlayer)
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getPlayerName

2008-06-06T18:09:35Z

Atti:

IT/getPlayerName

2008-06-06T18:09:21Z

Atti:

{{IT/Funzioni client}}
{{IT/MainP}}
__NOTOC__
Questa funzione restituisce una stringa contenente il nick di un giocatore.

==Sintassi==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Argomenti richiesti===
* '''thePlayer:''' Il giocatore di cui vuoi sapere il nome.

===Valori restituiti===
Restituisce una stringa contenente il nome del player selezionato, oppure ''false'' se è stato selezionato un player non valido.

==Esempio==
Questo esempio scrive in chat il nome del player del client che esegue lo script.
<section name="Client" class="Client" show="true">
<syntaxhighlight lang="lua">
--otteniamo il player ''locale''
local localPlayer = getLocalPlayer()
--otteniamo il suo nome
local nomeLocalPlayer = getPlayerName(localPlayer)
--e lo scriviamo in chat
outputChatBox(nomeLocalPlayer)
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getPlayerName

2008-06-06T18:09:00Z

Atti: New page: {{IT/Funzioni client}} {{IT/MainP}} __NOTOC__ Questa funzione restituisce una stringa contenente il nick di un giocatore. ==Sintassi== <syntaxhighlight lang="lua"> string getPlayerName ( player thePlaye...

{{IT/Funzioni client}}
{{IT/MainP}}
__NOTOC__
Questa funzione restituisce una stringa contenente il nick di un giocatore.

==Sintassi==
<syntaxhighlight lang="lua">
string getPlayerName ( player thePlayer )
</syntaxhighlight>

===Argomenti richiesti===
* '''thePlayer:''' Il giocatore di cui vuoi sapere il nome.

===Valori restituiti===
Restituisce una stringa contenente il nome del player selezionato, oppure ''false'' se è stato selezionato un player non valido.

==Esempio==
Questo esempio scrive in chat il nome del player del client che esegue lo script.
<section name="client" class="client" show="true">
<syntaxhighlight lang="lua">
--otteniamo il player ''locale''
local localPlayer = getLocalPlayer()
--otteniamo il suo nome
local nomeLocalPlayer = getPlayerName(localPlayer)
--e lo scriviamo in chat
outputChatBox(nomeLocalPlayer)
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/getLocalPlayer

2008-06-06T18:00:17Z

Atti: New page: {{IT/Funzioni client}} {{IT/MainP}} __NOTOC__ Questa funzione restituisce l'elemento 'player' del client che sta eseguendo lo script. ==Sintassi== <syntaxhighlight lang="lua"> player getLocalPlayer ( ...

{{IT/Funzioni client}}
{{IT/MainP}}
__NOTOC__
Questa funzione restituisce l'elemento 'player' del client che sta eseguendo lo script.

==Sintassi==
<syntaxhighlight lang="lua">
player getLocalPlayer ( )
</syntaxhighlight>

===Valori restituiti===
Restituisce l'elemento [[IT/player|player]] del client attuale.

==Esempio==
<section name="server" class="server" show="true">
Questo esempio scrive l'attuale posizione del giocatore nella console.
<syntaxhighlight lang="lua">
local localPlayer = getLocalPlayer ( )

function mostraPosizioneAttuale ( )
-- ottiene l'attuale posizione del giocatore
local px, py, pz = getElementPosition ( localPlayer )
-- la scrive nella console
outputConsole ( "La tua attuale posizione: " .. px .. " " .. py .. " " .. pz )
end
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

IT/isPlayerMuted

2008-06-06T17:49:28Z

Atti: /* Esempio */

__NOTOC__
{{IT/Funzioni server client}}
{{IT/MainP}}
Questa funzione verifica se un player è stato 'zittito', cioè se gli è impedito di inviare messaggi in chat.

==Sintassi==
<syntaxhighlight lang="lua">bool isPlayerMuted ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/player|player]] che vuoi controllare.

===Valori restituiti===
Restituisce ''true'' se il player è stato 'zittito', altrimenti ''false''.

==Esempio==
<syntaxhighlight lang="lua">
tizio = getPlayerFromNick ( "Tizio" )
if ( isPlayerMuted ( tizio ) then
outputChatBox ( "Tizio non può scrivere in chat." )
end</syntaxhighlight>

==Vedere anche==
{{IT/Player_functions}}

IT/isPlayerMuted

2008-06-06T17:47:17Z

Atti: New page: __NOTOC__ {{IT/Funzioni server client}} {{IT/MainP}} Questa funzione verifica se un player è stato 'zittito', cioè se gli è impedito di inviare messaggi in chat. ==Sintassi== <syntaxhighlight lang="lua">[l...

__NOTOC__
{{IT/Funzioni server client}}
{{IT/MainP}}
Questa funzione verifica se un player è stato 'zittito', cioè se gli è impedito di inviare messaggi in chat.

==Sintassi==
<syntaxhighlight lang="lua">bool isPlayerMuted ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/player|player]] che vuoi controllare.

===Valori restituiti===
Restituisce ''true'' se il player è stato 'zittito', altrimenti ''false''.

==Esempio==
<syntaxhighlight lang="lua">
tizio = getPlayerFromNick ( "Tizio" )
if ( isPlayerMuted ( someguy ) then
outputChatBox ( "Tizio non può scrivere in chat." )
end</syntaxhighlight>

==Vedere anche==
{{IT/Player_functions}}

IT/isPlayerDead

2008-06-06T17:25:57Z

Atti: New page: {{IT/Funzioni server client}} {{IT/MainP}} __NOTOC__ Questa funzione verifica se un giocatore è morto o meno. ==Sintassi== <syntaxhighlight lang="lua">bool isPlayerDead ( player thePlayer )</syntaxhighlight> ==...

{{IT/Funzioni server client}}
{{IT/MainP}}
__NOTOC__
Questa funzione verifica se un giocatore è morto o meno.

==Sintassi==
<syntaxhighlight lang="lua">bool isPlayerDead ( player thePlayer )</syntaxhighlight>

===Argomenti richiesti===
*'''thePlayer:''' Il [[IT/player|player]] di cui vuoi verificare la morte.

===Valori restituiti===
Restituisce ''true'' se il player è morto, altrimenti ''false''.

==Esempio==
<section name="server" class="server" show="true">
Questo esempio permette a un giocatore di usare il comando 'sonomorto' per verificare se è morto o meno.
<syntaxhighlight lang="lua">
--Verifica se il giocatore è morto meno e mostra un messaggio nella chatbox
function verificaMorte ( thePlayer, commandName )
if ( isPlayerDead ( thePlayer ) ) then
outputChatBox ( "Sei morto, preparati a diventare uno zombie!", thePlayer )
else
outputChatBox ( "Tira pure un sospiro di sollievo, sei vivo.", thePlayer )
end
end
addCommandHandler ( "sonomorto", verificaMorte )
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
Questo esempio permette a un giocatore di usare il comando 'sonomorto' per verificare se è morto o meno.
<syntaxhighlight lang="lua">
--Check if player is alive or dead and let them know in the chat box
function verificaMorte ( commandName )
if ( isPlayerDead ( getLocalPlayer() ) ) then
outputChatBox ( "Sei morto, preparati a diventare uno zombie!", getLocalPlayer() )
else
outputChatBox ( "Tira pure un sospiro di sollievo, sei vivo.", getLocalPlayer() )
end
end
addCommandHandler ( "sonomorto", verificaMorte )
</syntaxhighlight>
</section>

==Vedere anche==
{{IT/Player_functions}}

OnColShapeHit

2008-02-18T14:33:55Z

Atti: /* Example */

__NOTOC__
{{Server event}}
This event is triggered when the player or a vehicle hits a [[colshape]].

==Parameters==
<syntaxhighlight lang="lua">
element hitElement, bool matchingDimension
</syntaxhighlight>

*'''hitElement''': the [[element]] that entered the colshape.
*'''matchingDimension''': a boolean referring to whether the hit collision shape was in the same dimension as the element.

==Source==
The [[event system#Event source|source]] of this event is the [[colshape]] that got hit by a player or vehicle.

==Example==
This example creates a hill area for a ''King of the hill'' gamemode. When a player enters or leaves the area, it's announced in the chatbox.
<syntaxhighlight lang="lua">
-- create our hill area for our gamemode
local hillArea = createColSquare ( -2171.0678710938, 678.17950439453, 0, 15, 15 )

-- add hill_Enter as a handler for when a player enters the hill area
function hill_Enter ( thePlayer, matchingDimension )
local nameOfThePlayer = getClientName(thePlayer)
--announce to everyone that the player entered the hill
outputChatBox( nameOfThePlayer.." entered the zone!", getRootElement(),255, 255, 109 )
end
addEventHandler ( "onColShapeHit", hillArea, hill_Enter )

-- add hill_Enter as a handler for when a player leaves the hill area
function hill_Exit ( thePlayer, matchingDimension )
--check if the player is not dead
if isPlayerDead ( thePlayer ) ~= true then
--if he was alive, announce to everyone that the player has left the hill
outputChatBox ( nameOfThePlayer.." left the zone!", getRootElement(), 255, 255, 109 )
end
end
addEventHandler ( "onColShapeLeave", hillArea, hill_Exit )
</syntaxhighlight>

{{See also/Server event|Colshape events}}

IT/Manuale del Client

2008-02-10T11:49:55Z

Atti: /* Avviare il gioco via ASE (The All-Seeing Eye) */

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Avviare il gioco via ASE (The All-Seeing Eye)===

Se non sei soddisfatto della lista di server MTA:San Andreas, potresti provare '''The All-Seeing Eye''', che ti permettere di scorrere la lista di server fuori del gioco, e può applicare dei filtri particolari. Questo tutorial ti aiuterà a installare ASE e ad entrare in un server con il doppio click.
# Scarica ASE da http://videogames.yahoo.com/multiplayer , e installalo.
# '''Questo è un bug di MTA:SA up fino alla versione dp2, e probabilmente sarà risolto successivamente.''' <br /> Scarica [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] ed estrai ASELauncher.exe nella tua cartella di MTA (di default C:\Programmi\MTA San Andreas). Questo piccolo programma converte i comandi di ASE in un formato che MTA può comprendere.
# Adesso aggiungi MTA:SA alla tua lista di giochi di ASE:
#* In ASE, clicca ''Tools'' -> ''Options'', e seleziona la tabella ''Games''
#* Apri la categoria ''Not installed'' e seleziona ''Multi Theft Auto'' nella lista
#* Seleziona ''Visible in filter list'', clicca ''Browse'' e scegli '''ASELauncher.exe''' nella tua cartella MTA
#* Lascia vuoto il campo ''Player name'', e chiudi la finestra premendo ''OK''
# Un nuovo gioco '''Multi Theft Auto''' è apparso. Quando clicchi su ''Refresh'' nella barra in alto, vedrai tutti i server per tutte le versioni di MTA. Adesso aggiungiamo un filtro per mostrare solo la versione attuale, '''1.0 dp2'''
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''MTA:SA 1.0 dp2'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo la versione attuale di MTA, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Potete poi configurare tutti i filtri che volete: eccone uno, per esempio, per vedere solo i server che contengono ITA nel nome:
# Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
# Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
# Inserisci un nome per il filtro nel campo ''Name'', per esempio '''ITA'''
# Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if hostname ~!= "*ITA*" remove</tt> (potete sostituire ITA con quello che volete)
# Clicca ''OK''
# Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo i server che contengono ITA nel nome, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Nel caso in cui vogliate creare un filtro ancora più particolare, ecco un [http://www.udpsoft.com/eye/wizard.html wizard per creare un vostro filtro personalizzato]: dovete inserire le righe di codice che vi dà nella finestra in basso al posto del codice del filtro che state inserendo (quarto punto nella guida di sopra).

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Errori di download [Download error]'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Errori fatali [Fatal error]'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

IT/Manuale del Client

2008-02-10T11:49:17Z

Atti: /* Avviare il gioco via ASE (The All-Seeing Eye) */

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Avviare il gioco via ASE (The All-Seeing Eye)===

Se non sei soddisfatto della lista di server MTA:San Andreas, potresti provare '''The All-Seeing Eye''', che ti permettere di scorrere la lista di server fuori del gioco, e può applicare dei filtri particolari. Questo tutorial ti aiuterà a installare ASE e ad entrare in un server con il doppio click.
# Scarica ASE da http://videogames.yahoo.com/multiplayer , e installalo.
# '''Questo è un bug di MTA:SA up fino alla versione dp2, e probabilmente sarà risolto successivamente.''' <br /> Scarica [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] ed estrai ASELauncher.exe nella tua cartella di MTA (di default C:\Programmi\MTA San Andreas). Questo piccolo programma converte i comandi di ASE in un formato che MTA può comprendere.
# Adesso aggiungi MTA:SA alla tua lista di giochi di ASE:
#* In ASE, clicca ''Tools'' -> ''Options'', e seleziona la tabella ''Games''
#* Apri la categoria ''Not installed'' e seleziona ''Multi Theft Auto'' nella lista
#* Seleziona ''Visible in filter list'', clicca ''Browse'' e scegli '''ASELauncher.exe''' nella tua cartella MTA
#* Lascia vuoto il campo ''Player name'', e chiudi la finestra premendo ''OK''
# Un nuovo gioco '''Multi Theft Auto''' è apparso. Quando clicchi su ''Refresh'' nella barra in alto, vedrai tutti i server per tutte le versioni di MTA. Adesso aggiungiamo un filtro per mostrare solo la versione attuale, '''1.0 dp2'''
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''MTA:SA 1.0 dp2'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo la versione attuale di MTA, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Potete poi configurare tutti i filtri che volete: eccone uno, per esempio, per vedere solo i server che contengono ITA nel nome:
# Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
# Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
# Inserisci un nome per il filtro nel campo ''Name'', per esempio '''ITA'''
# Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if hostname ~!= "*ITA*" remove</tt> (potete sostituire ITA con quello che volete)
# Clicca ''OK''
# Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo i server che contengono ITA nel nome, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Nel caso in cui vogliate creare un filtro ancora più particolare, ecco un [http://www.udpsoft.com/eye/wizard.html wizard per creare un vostro filtro personalizzato]: dovete mettere le righe di codice che vi dà nella finestra in basso al posto del codice del filtro che state inserendo (quarto punto nella guida di sopra).

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Errori di download [Download error]'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Errori fatali [Fatal error]'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

IT/Manuale del Client

2008-02-10T11:48:55Z

Atti: /* Avviare il gioco via ASE (The All-Seeing Eye) */

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Avviare il gioco via ASE (The All-Seeing Eye)===

Se non sei soddisfatto della lista di server MTA:San Andreas, potresti provare '''The All-Seeing Eye''', che ti permettere di scorrere la lista di server fuori del gioco, e può applicare dei filtri particolari. Questo tutorial ti aiuterà a installare ASE e ad entrare in un server con il doppio click.
# Scarica ASE da http://videogames.yahoo.com/multiplayer , e installalo.
# '''Questo è un bug di MTA:SA up fino alla versione dp2, e probabilmente sarà risolto successivamente.''' <br /> Scarica [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] ed estrai ASELauncher.exe nella tua cartella di MTA (di default C:\Programmi\MTA San Andreas). Questo piccolo programma converte i comandi di ASE in un formato che MTA può comprendere.
# Adesso aggiungi MTA:SA alla tua lista di giochi di ASE:
#* In ASE, clicca ''Tools'' -> ''Options'', e seleziona la tabella ''Games''
#* Apri la categoria ''Not installed'' e seleziona ''Multi Theft Auto'' nella lista
#* Seleziona ''Visible in filter list'', clicca ''Browse'' e scegli '''ASELauncher.exe''' nella tua cartella MTA
#* Lascia vuoto il campo ''Player name'', e chiudi la finestra premendo ''OK''
# Un nuovo gioco '''Multi Theft Auto''' è apparso. Quando clicchi su ''Refresh'' nella barra in alto, vedrai tutti i server per tutte le versioni di MTA. Adesso aggiungiamo un filtro per mostrare solo la versione attuale, '''1.0 dp2'''
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''MTA:SA 1.0 dp2'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo la versione attuale di MTA, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Potete poi configurare tutti i filtri che volete: eccone uno, per esempio, per vedere solo i server che contengono ITA nel nome:
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''ITA'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if hostname ~!= "*ITA*" remove</tt> (potete sostituire ITA con quello che volete)
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo i server che contengono ITA nel nome, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

Nel caso in cui vogliate creare un filtro ancora più particolare, ecco un [http://www.udpsoft.com/eye/wizard.html wizard per creare un vostro filtro personalizzato]: dovete mettere le righe di codice che vi dà nella finestra in basso al posto del codice del filtro che state inserendo (quarto punto nella guida di sopra).

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Errori di download [Download error]'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Errori fatali [Fatal error]'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

IT/Manuale del Client

2008-01-30T16:32:25Z

Atti:

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Avviare il gioco via ASE (The All-Seeing Eye)===

Se non sei soddisfatto della lista di server MTA:San Andreas, potresti provare '''The All-Seeing Eye''', che ti permettere di scorrere la lista di server fuori del gioco, e può applicare dei filtri particolari. Questo tutorial ti aiuterà a installare ASE e ad entrare in un server con il doppio click.
# Scarica ASE da http://videogames.yahoo.com/multiplayer , e installalo.
# '''Questo è un bug di MTA:SA up fino alla versione dp2, e probabilmente sarà risolto successivamente.''' <br /> Scarica [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] ed estrai ASELauncher.exe nella tua cartella di MTA (di default C:\Programmi\MTA San Andreas). Questo piccolo programma converte i comandi di ASE in un formato che MTA può comprendere.
# Adesso aggiungi MTA:SA alla tua lista di giochi di ASE:
#* In ASE, clicca ''Tools'' -> ''Options'', e seleziona la tabella ''Games''
#* Apri la categoria ''Not installed'' e seleziona ''Multi Theft Auto'' nella lista
#* Seleziona ''Visible in filter list'', clicca ''Browse'' e scegli '''ASELauncher.exe''' nella tua cartella MTA
#* Lascia vuoto il campo ''Player name'', e chiudi la finestra premendo ''OK''
# Un nuovo gioco '''Multi Theft Auto''' è apparso. Quando clicchi su ''Refresh'' nella barra in alto, vedrai tutti i server per tutte le versioni di MTA. Adesso aggiungiamo un filtro per mostrare solo la versione attuale, '''1.0 dp2'''
#* Clicca col tasto destro su ''Multi Theft Auto'' e seleziona ''New...''
#* Nella barra in basso a sinistra, seleziona ''Modifier'' e sostituisci MYMOD con '''MTADP2'''
#* Inserisci un nome per il filtro nel campo ''Name'', per esempio '''MTA:SA 1.0 dp2'''
#* Inserisci il codice per il filtro seguente (con il numero della linea):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Clicca ''OK''
#* Il tuo nuovo filtro è mostrato tra i ''My filters''
# Finito! Ora attiva il tuo filtro per mostrare solo la versione attuale di MTA, seleziona il gioco ''Multi Theft Auto'', e fai doppio click su un server per giocare.

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Errori di download [Download error]'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Errori fatali [Fatal error]'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

IT/Pagina principale

2008-01-30T15:09:59Z

Atti:

<div style="border: 1px dotted #5555FF;padding:4px 8px 8px 8px;margin:10px;">Questa wiki è stata tradotta da(in ordine cronologico): [[User:Shadd|Shadd]], [[User:Atti|Atti]] e [[User:Talco|Talco]].<br />This wiki has been translated by(in chronological order): [[User:Shadd|Shadd]], [[User:Atti|Atti]] and [[User:Talco|Talco]].</div>
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Benvenuto nella wiki in italiano di Multi Theft Auto: San Andreas Deathmatch. Qui troverai abbondanti informazioni sullo sviluppo di gamemode e mappe per Multi Theft Auto.

Stiamo rilasciando le ''anteprime per lo sviluppatore'' perchè abbiamo bisogno del tuo aiuto! Ci sono molte [[IT/Come puoi aiutare|cose che puoi fare per aiutarci]] ad ottenere una release completa e raffinata di MTA:SA DM - creare una mappa, una gamemode, aiutare a documentare le funzioni, scrivere del codice di esempio, dei tutorial o semplicemente giocare a MTA e riportare nel forum i bug che trovi.

Questa release è una gran cosa per noi - rilasciamo il prodotto di due anni del nostro lavoro e non possiamo aspettare di vedere cosa ci fate. Ricorda che possono capitare degli inevitabili problemi e che comunque le cose non sono ancora del tutto complete!

Se hai qualche domanda o problema relativo allo scripting, sentiti libero di metterti in contatto con noi (in inglese) attraverso il nostro [[IRC Channel|Canale IRC]].

'''Hai bisogno di possedere un account in mtabeta.com per poter modificare questa wiki.''' Per favore registrati in [http://www.mtabeta.com mtabeta.com] e poi usa gli stessi dati per fare il login qui. Se vandalizzerai questa wiki verrai bannato.

La wiki supporta '''[http://gears.google.come/ Google Gears]''', che ti permetterà di vedere questa wiki anche offline (e velocemente). Installa Google Gears e clicca il link ''Go Offline'' in fondo ad ogni pagina. Aspetta un'ora (!) che venga scaricata, quando avrà finito lo vedrai in basso ad ogni pagina, appena dopo il link ''Go Offline''. Fatto ciò, usa l'opzione ''Lavora scollegato'' del tuo browser (in genere nel menu File), o disconnettiti da internet e naviga nella wiki normalmente.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">L'ultima versione disponibile di '''Multi Theft Auto: San Andreas Deathmatch''' è la '''{{Current Version|full}}'''. Visita la [http://www.mtasa.com/dp.html pagina download] e scaricala!</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Per iniziare====

* [[IT/Manuale del Client|Manuale del Client]] {{IT/75%}}{{IT/75%}}
* [[IT/Manuale del Server|Manuale del Server]] {{IT/50%}}
* [[IT/Bugs noti e FAQ|Bugs noti e FAQ]] {{IT/100%}}
* [[IT/Introduzione allo scripting|Introduzione allo Scripting]] {{IT/100%}}
* [[IT/Guida al Debug|Guida al Debug]] - Come trovare gli errori dei tuoi scripts {{IT/100%}}
* [[IT/Classi di MTA|Classi di MTA]] {{IT/00%}}
** [[IT/Elementi|Elementi di MTA]] / [[IT/Albero degli elementi|Albero degli elementi]] {{IT/00%}}
* [[IT/Introduzione alle Risorse|Introduzione alle Risorse]] {{IT/00%}}
** [[IT/Accesso web alle Risorse|Accesso web alle Risorse]] {{IT/00%}}
* [[IT/Scrivere una gamemode|Scrivere una gamemode]] {{IT/25%}}

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Database====
Questa sezione delinea tutte le possibilità che MTA o le ''resources'' danno.
* [[IT/Map manager|Map manager]] {{IT/00%}} - Usalo per le tue gamemodes
* [[IT/Script client-side|Script client-side]] {{IT/100%}}
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Guide LUA====
Pagine create per aiutarti a comprendere il LUA (in inglese).
*[http://www.lua.org/pil/index.html "Programming in LUA" Manual]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Documentazione====
* [[IT/Funzioni Client-side|Funzioni Client-side]] {{IT/00%}}
* [[IT/Eventi Client-side|Eventi Client-side]] {{IT/00%}}
* [[IT/Funzioni Server-side|Funzioni Server-side]] {{IT/00%}}
* [[IT/Eventi Server-side|Eventi Server-side]] {{IT/00%}}

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Liste ID====
* [[IT/Skin Personaggi|Skin Personaggi]] {{IT/100%}} ([[IT/Tutte Le Skin|Tutte Le Skin)]] {{IT/100%}}
* [[IT/Vestiti di CJ|Vestiti di CJ]] {{IT/100%}}
* [[IT/Esplosivi|Esplosivi]] {{IT/100%}}
* [[IT/Segnalini radar|Segnalini radar]] {{IT/100%}}
* [[Template:IT/Suoni|Suoni]] {{IT/100%}}
* [[IT/ID Veicoli|Veicoli]] {{IT/100%}}
* [[IT/Colori default veicoli|Colori di default dei veicoli]] {{IT/100%}}
* [[IT/Colori veicoli|Tabella dei colori dei veicoli]] {{IT/100%}}
* [[IT/Miglioramenti Veicoli|Miglioramenti Veicoli]] {{IT/100%}}
* [[IT/Armi|Armi]] {{IT/100%}}
* [[IT/Meteo|Meteo]] {{IT/100%}}
</div>

|-
| colspan="2" |
|}

[[pl:Main Page]]
[[ru:Main Page]]
[[en:Main Page]]
[[nl:Main Page]]

IT/Manuale del Client

2008-01-30T15:09:31Z

Atti: /* Codici degli errori e loro significato */

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Running the game from ASE (The All-Seeing Eye)===

If you are not satisfied with the in-game server browser of MTA:San Andreas, you might want to check out '''The All-Seeing Eye''', which allows you to browse the server list out of the game, and can apply custom filters. This tutorial will help with the setup of ASE, and show how to make join on double-click work.
# Download ASE from http://videogames.yahoo.com/multiplayer , and install.
# '''This applies to MTA:SA up to version 1.0 dp2, and will probably be fixed in a later version''' <br /> Download [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] and extract ASELauncher.exe to your MTA directory (default C:\Program Files\MTA San Andreas). This tiny program converts the ASE command-line to a format MTA can understand.
# Now add MTA:SA to your ASE games list:
#* In ASE, click ''Tools'' -> ''Options'', and select the tab ''Games''
#* Open the category ''Not installed'' and select ''Multi Theft Auto'' in the list
#* Check ''Visible in filter list'', click ''Browse'' and select '''ASELauncher.exe''' in your MTA San Andreas directory
#* Leave the field ''Player name'' empty, and close the dialog with ''OK''
# A new game '''Multi Theft Auto''' has appeared. When you click ''Refresh'' in the toolbar, you will see all servers for all versions of MTA. Now add a modifier to only show the current version, '''1.0 dp2'''
#* Right-click ''Multi Theft Auto'' and select ''New...''
#* In the lower-left, select ''Modifier'' and replace MYMOD by '''MTADP2'''
#* Enter a name for the modifier in the ''Name'' field, e.g. '''MTA:SA 1.0 dp2'''
#* Insert the following filter code (with the line number):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Click ''OK''
#* Your new modifier is shown under ''My filters''
# All done! Now activate your modifier to only show your game version, select the game ''Multi Theft Auto'', and double-click any server to play.

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Errori di download [Download error]'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Errori fatali [Fatal error]'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]

IT/Manuale del Client

2008-01-30T15:09:02Z

Atti: /* Error codes and their meanings */

{{IT/MainP}}
__TOC__

==Introduzione==
Multi Theft Auto: San Andreas è l'ultima di una lunga serie di mod multiplayer create dai fan per le versioni PC dei vari Grand Theft Auto. Trovate le versioni per GTA3 e Vice City che usano il vecchio ''core'' in [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Questa mod non è approvata da Rockstar Games o Take 2 Interactive.

Per favore, ricorda che MTA:SA Deathmatch è una beta, il che significa che può crashare o generare risultati inaspettati.

==Prima di iniziare==

Prima di installare Multi Theft Auto: San Andreas, assicurati che non ci siano mod installate in GTA: San Andreas. Queste andrebbero in conflitto con MTA. Se vorresti continuare a usare le tue mod per il ''single player'', puoi creare due installazioni reinstallando San Andreas in un'altra cartella del tuo Hard Disk.

Assicurati anche di stare usando '''Windows XP''', '''Windows 2000''', '''Windows Vista''' o '''Windows Server 2003''' e che il tuo PC riesca a far girare San Andreas in ''single player''. Ricorda che se raggiungi solo i requisiti minimi di San Andreas, potrebbero capitarti dei rallentamenti in MTA, visto che richiede una maggiore potenza di calcolo del processore.

'''Attenzione: MTA:SA funziona solo su GTA:SA versione 1.0.''' Se hai comprato il gioco recentemente, probabilmente hai una versione successiva.

Se riscontri dei problemi, dai un'occhiata a [[IT/Bugs noti e FAQ|bugs noti e FAQ]], o contattaci via IRC a irc://irc.multitheftauto.com/mta (in inglese).

===Requisiti di sistema===
I requisiti minimi di sistema di Multi Theft Auto: San Andreas sono leggermente più alti di quelli di Grand Theft Auto: San Andreas originale.
* Intel Pentium 4 o AMD Athlon XP
* 512MB DDR RAM
* Installazione pulista di Grand Theft Auto: San Andreas, versione 1.0 o 1.1 (americana o europea)
* 3.7GB di spazio libero nell'hard disk (3.6GB sono per un'installazione minima di GTA:SA)
* nVidia GeForce 4 series o ATI Radeon 8xxx series (compatibile con 64MB RAM e DirectX 9.0)
* Scheda audio compatibile con DirectX 9.0
* Tastiera e mouse
* Connessione a internet a banda larga (per un gioco online tranquillo)

Per le ''feature'' aggiuntive, una scheda video compatibile con il pixel shader 2.0 (nVidia GeForce FX series o superiore, ATI Radeon 9xxx series o superiore) è raccomandata.

Per un caricamento più rapido, è raccomandato un aumento di RAM.

==Installare il gioco==

# Se già non l'hai, registrati in http://www.mtabeta.com e scarica il client di MTA.
# Esegui l'installer. Riceverai un messaggio di introduzione, poi ti sarà presentato il Contratto di Licenza per l'Utente Finale (EULA). Dovrai acconsentire per continuare l'installazione.
# A questo punto potrai creare un account, usarne uno che hai già, o non usarne nessuno - in questo caso seleziona la seconda opzione
<br>
'''Prima opzione selezionata'''<br>
Crea un account in MTABeta.com, dopo averlo fatto inserisci i tuoi dati per il nell'installer<br>
'''Seconda opzione selezionata'''<br>
Inserisci i dati del tuo account nell'installer
<br><br>
# Ti sarà richiesto quali componenti installare.
#* '''Client''' è la mod che si interfaccia col gioco, ed è richiesta.
#* '''MTA Server''' ti permette di ''hostare'' il tuo server casalingo.
#* '''MTA Server > Editor''' è usato per creare nuove mappe, ed è una componente opzionale.

# Allora ti sarà chiesta la cartella dove è installato il gioco. Devi impostarla alla stessa cartella dove hai installato GTA. Di default è: '''C:\Programmi\Rockstar Games\GTA San Andreas\'''. Premi il bottone '''Install''' per iniziare l'installazione vera e propria.
# Quando finisce l'installazione, potrai decidere se avviare immediatamente MTA: San Andreas. Scegli l'opzione che vuoi e premi '''Finish'''.
# Potrai avviare MTA:DM da '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas''' se vuoi giocare.

==Avviare il gioco==
# Avvia Multi Theft Auto cliccando sull'icona in '''Start Menu\Tutti i programmi\MTA San Andreas\Play MTA San Andreas'''.
# GTA: San Andreas si avvierà e, quando tutto sarà caricato, vedrete il menu principale di MTA. Qui troverai svariate opazioni:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – ti permette di connetterti a un server di cui conosci già l'indirizzo IP o l'URL e la porta. È utile se sai già in quale server entrare e così non hai bisogno di cercarlo nell'intera lista di server.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – ti mostra una lista di server dove puoi giocare. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– ti permette di cambiare il tuo nickname ingame, personalizzare i controlli e modificare i settaggi video.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– ti mostra una lista di coloro che hanno contribuito a questo progetto.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– ti permette di creare le tue mappe personalizzate, complete di checkpoints, rampe, pickup e altri oggetti. Possono anche essere caricate su un server per poterci giocare con gli amici.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– ritorna al desktop di Windows.</font>

<br /><br />
|}

Il modo più facile di giocare è premere '''Browse Servers''' nel menu. Apparirà una nuova finestra:

<center>[[Image:manual_image006a.jpg]]</center> '''Immagine da aggiornare in seguito'''

Se i server non sono già apparsi, premi il tasto '''Refresh''' e MTA cercherà eventuali server, mostradoli in una lista.

* Nella tabella '''Name''', è mostrato il nome di ogni server.
* Nella tabella '''Players''', è mostrato il numero di players e la capacità massima del server, nel formato [Slot Usate] / [Slot Massime].
* Nella tabella '''Ping''' è mostrato il ping, o ''latenza'', tra il tuo PC e il server. Il ping è la misura del tempo che si impiega a mandare "pacchetti" di dati che devono essere mandati al server e ricevuti da esso, quindi un ping più alto significa che avrai più lag in quel particolar server. Generalmente, i server più vicini a dove ti trovi hanno i ping minori.
* Nella tabella '''Host''' c'è l'indirizzo IP del server. Lo puoi usare in futuro per connetterti al server usando l'opzione Quick Connect.

Ogni tabella può essere cliccata per disporre i suoi elementi in ordine ascendente o discendente.

Per le migliori performance di gioco e ping, cerca un compromesso tra numero di players e ping.
Quando scegli un server, selezionalo e premi il tasto '''Connect''' in alto a destra nella finestra. Se tutto va bene, dovresti connetterti al server e unirti al gioco automaticamente.

===Running the game from ASE (The All-Seeing Eye)===

If you are not satisfied with the in-game server browser of MTA:San Andreas, you might want to check out '''The All-Seeing Eye''', which allows you to browse the server list out of the game, and can apply custom filters. This tutorial will help with the setup of ASE, and show how to make join on double-click work.
# Download ASE from http://videogames.yahoo.com/multiplayer , and install.
# '''This applies to MTA:SA up to version 1.0 dp2, and will probably be fixed in a later version''' <br /> Download [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] and extract ASELauncher.exe to your MTA directory (default C:\Program Files\MTA San Andreas). This tiny program converts the ASE command-line to a format MTA can understand.
# Now add MTA:SA to your ASE games list:
#* In ASE, click ''Tools'' -> ''Options'', and select the tab ''Games''
#* Open the category ''Not installed'' and select ''Multi Theft Auto'' in the list
#* Check ''Visible in filter list'', click ''Browse'' and select '''ASELauncher.exe''' in your MTA San Andreas directory
#* Leave the field ''Player name'' empty, and close the dialog with ''OK''
# A new game '''Multi Theft Auto''' has appeared. When you click ''Refresh'' in the toolbar, you will see all servers for all versions of MTA. Now add a modifier to only show the current version, '''1.0 dp2'''
#* Right-click ''Multi Theft Auto'' and select ''New...''
#* In the lower-left, select ''Modifier'' and replace MYMOD by '''MTADP2'''
#* Enter a name for the modifier in the ''Name'' field, e.g. '''MTA:SA 1.0 dp2'''
#* Insert the following filter code (with the line number):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Click ''OK''
#* Your new modifier is shown under ''My filters''
# All done! Now activate your modifier to only show your game version, select the game ''Multi Theft Auto'', and double-click any server to play.

==Come giocare==

MTA:SA offre un sistema di scripting compreso che permette ai creatori di mappe di modificare molti elementi di gioco per creare le loro gamemode innovative. Il gioco incorpora più aspetti possibile del single player, ma ci sono alcune differenze.

Non ci sono pedoni o veicoli gestiti dall'IA. Le unice persone sulla mappa sono i tuoi avversari, o alleati se ci sono i team. Puoi parlare con tutti gli altri players con la chat nella parte in alto a sinistra dello schermo, che puoi attivare con '''T'''. Per chattare solo con i tuoi compagni di team, premi '''Y'''.

Il ''map editor'' di MTA permette ai creatori di mappe di aggiungere alle loro creazioni svariati oggetti del mondo di GTA, come le strade, i barili esplosivi, le rampe, gli edifici, le colline e molto altro. Non solo questo, ma gli oggetti possono essere mossi via scripting, cambiare ''model'' e scomparire. Questo offre una gran quantità di divertimento e di varianti del gioco.

Premi Tab per guardare lo scoreboard. Di default, verranno mostrati solo il nome del player e il ping, ma con gli script si possono aggiungere nuove colonne specifiche per la gamemode con cui si sta giocando. Per esempio, una mode deathmatch avrà sicuramente una colonna con il numero di kills del player, ma il creatore della mappa potrebbe decidere di aggiungere altre colonne per il numero di volte che sei morto, o da quanto tempo stai giocando, per poter valutare meglio il tuo punteggio.

==Controlli==

===Comandi di MTA===

* F8 (o ~) - Apre la Console
* F9 - Mostra una finestra di aiuto ingame
* F11 - Mostra la mappa di SA ''(per spostarla usa i comandi che seguono)''
**+/- del tastierino numerico - Zoom avanti e indietro
**4, 8, 6, 2 del tastierino numerico - Muove la mappa a destra, a sinistra, in alto o in basso
**0 del tastierino numerico - Alterna una mappa dinamica (segue il segnalino del player) con una libera (resta ferma)
* F12 - Salva uno screenshot dello schermo in '''C:\Programmi\MTA San Andreas\screenshots'''
* T - Chat
* Y - Chat del team
* TAB - Lista dei player (se la risorsa [[IT/Scoreboard|Scoreboard]] è avviata nel server corrente)

==Comandi della Console==

Digita '''~ (tilde)''' o '''F8''' per entrare nella console, quindi scrivi un comando seguito dagli argomenti necessari (se servono) e premi ''Invio''.

;'''bind defaults''' :Reimposta i comandi di default.

;'''maps''' :Mostra una lista di tutte le mappe disponibili nel server.

;'''nick [nickname]''' :Cambia il tuo nick ingame in quello che specifichi nel parametro [nickname].

;'''msg [nickname] [messaggio]''' o '''pm [nickname] [messaggio]''' :Invia un messaggio privato al player con il nick specificato nel parametro [nickname]. Solo la persona specificata potrà vedere il messaggio. Sia '''msg''' sia '''pm''' hanno la stessa funzione.

;'''quit''' o '''exit''' :Ti disconnette dal server e ritorna al desktop. Ha la stessa funzione del tasto ''Quit'' nel menu principale.

;'''ver''' :Mostra la versione corrente e il copyright del software.

;'''time''' :Mostra l'ora corrente.

;'''disconnect''' :Ti disconnette dal server e ritorna al menu principale.

;'''say [testo]''' :Ti permette di inviare il messaggio nel parametro [testo] nella chatbox, attraverso la console.

;'''ignore [nickname]''' :Questo ignorerà ogni messaggio scritto dal player con il nick specificato nel parametro [nickname]. Per smettere di ignorare un player, riscrivi '''ignore [nickname]'''.

'''Suggerimento:''' Puoi scrivere questi comandi in chatbox facendoli precedere da un ''/''.

Una lista (in inglese) dei comandi della console si può ottenere scrivendo '''help''' nella console e premendo ''Invio''. La mappa attuale può avere dei comandi propri che possono essere controllati digitando '''commands''' nella console.

==Codici degli errori e loro significato==
'''Download error'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Errori 'impossibile entrare nel veicolo''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[en:Deathmatch Client Manual]]
[[ru:Deathmatch Client Manual]]