Resource:IT/Map manager - Revision history

Myonlake: Redirected page to IT/Resource:Mapmanager

2023-06-11T11:40:46Z

Redirected page to IT/Resource:Mapmanager

Shadd: /* Funzioni esportate */

2008-06-13T14:12:43Z

Funzioni esportate

← Older revision		Revision as of 14:12, 13 June 2008
Line 127:		Line 127:

	==Funzioni esportate==		==Funzioni esportate==
	Queste sono le funzioni del mapmanager utilizzabili tramite la funzione ~~<syntaxhighlight lang="lua">~~call()~~</syntaxhighlight>~~:		Queste sono le funzioni del mapmanager utilizzabili tramite la funzione [[IT/call\|call()]]:
	*<syntaxhighlight lang="lua">bool changeGamemode ( resource nuovaGamemode, [ resource mappaDaCaricare ] )</syntaxhighlight>		*<syntaxhighlight lang="lua">bool changeGamemode ( resource nuovaGamemode, [ resource mappaDaCaricare ] )</syntaxhighlight>
	Cambia la gamemode in '''nuovaGamemode''', impostando opzionalmente una mappa iniziale('''mappaDaCaricare'''); di default carica con la mappa.		Cambia la gamemode in '''nuovaGamemode''', impostando opzionalmente una mappa iniziale('''mappaDaCaricare'''); di default carica con la mappa.

Shadd at 13:55, 13 June 2008

2008-06-13T13:55:53Z

← Older revision		Revision as of 13:55, 13 June 2008
Line 1:		Line 1:
			{{IT/MainP}}
	[[Category:100%]]		[[Category:100%]]
	~~{{IT/MainP}}~~
	{{IT/Risorsa}}		{{IT/Risorsa}}
	Il '''map manager''' è una risorsa inclusa nel pacchetto server di MTA:SA DM e comprende comandi, funzioni ed eventi per le gamemodes per gestire dinamicamente le loro mappe. Ad esempio, quando un server ha bisogno di caricare diverse mappe per una race mode, invece di essere messe tutte nella risorsa della gamemode, possono essere inserite in una risorsa separata ed essere successivamente richiamate con la funzione "changeGamemodeMap" quando una nuova gara inizia.		Il '''map manager''' è una risorsa inclusa nel pacchetto server di MTA:SA DM e comprende comandi, funzioni ed eventi per le gamemodes per gestire dinamicamente le loro mappe. Ad esempio, quando un server ha bisogno di caricare diverse mappe per una race mode, invece di essere messe tutte nella risorsa della gamemode, possono essere inserite in una risorsa separata ed essere successivamente richiamate con la funzione "changeGamemodeMap" quando una nuova gara inizia.

Shadd: IT/Map manager moved to Resource:IT/Map manager: Moving to resource's namespace.

2008-06-06T18:40:37Z

IT/Map manager moved to Resource:IT/Map manager: Moving to resource's namespace.

← Older revision

Revision as of 18:40, 6 June 2008

Shadd at 18:39, 6 June 2008

2008-06-06T18:39:51Z

← Older revision		Revision as of 18:39, 6 June 2008
Line 179:		Line 179:
	*<syntaxhighlight lang="lua">maxplayers [numero]</syntaxhighlight>: Il massimo numero di giocatori per iniziare la mappa.		*<syntaxhighlight lang="lua">maxplayers [numero]</syntaxhighlight>: Il massimo numero di giocatori per iniziare la mappa.

	[[en:mapmanager]]		[[en:Resource:mapmanager]]

Shadd: Aggiunta categoria 100% e link alla pagina inglese

2008-06-05T15:16:20Z

Aggiunta categoria 100% e link alla pagina inglese

← Older revision		Revision as of 15:16, 5 June 2008
Line 1:		Line 1:
			[[Category:100%]]
	{{IT/MainP}}		{{IT/MainP}}
	{{IT/Risorsa}}		{{IT/Risorsa}}
Line 177:		Line 178:
	*<syntaxhighlight lang="lua">minplayers [numero]</syntaxhighlight>: Il numero minimo di giocatori per iniziare la mappa.		*<syntaxhighlight lang="lua">minplayers [numero]</syntaxhighlight>: Il numero minimo di giocatori per iniziare la mappa.
	*<syntaxhighlight lang="lua">maxplayers [numero]</syntaxhighlight>: Il massimo numero di giocatori per iniziare la mappa.		*<syntaxhighlight lang="lua">maxplayers [numero]</syntaxhighlight>: Il massimo numero di giocatori per iniziare la mappa.

			[[en:mapmanager]]

Shadd: Completata la traduzione

2008-06-05T15:12:45Z

Completata la traduzione

Show changes

Shadd: /* A more advanced tutorial */

2008-06-05T12:31:04Z

A more advanced tutorial

← Older revision		Revision as of 12:31, 5 June 2008
Line 56:		Line 56:
	<syntaxhighlight lang="lua">gamemode myserver mymap</syntaxhighlight>		<syntaxhighlight lang="lua">gamemode myserver mymap</syntaxhighlight>

	==~~A more advanced~~ tutorial==		==Un tutorial più avanzato==
	In ~~this~~ tutorial, ~~instead of starting the map while starting the~~ server ~~with the command above~~, ~~we'll start the map resource with a few lines of~~ script. ~~This is useful when you have multiple maps and would like to let the~~ server ~~start them automatically~~.		In questo tutorial, invece di avviare la mappa con il comando sopra descritto quando avviamo il server, avvieremo la risorsa con qualche linea di script. Questo può tornare utile se hai molte mappe e vuoi che il server le avvii automaticamente.

	~~First of all we need to add a new event~~ handler ~~for~~ [[onResourceStart]] ~~event~~, ~~which is fired when the main script is started manually with the ''~~gamemode~~'' command~~. ~~Then in the function binded to the event~~, we'~~ll load the map resource and start the map~~:		Prima di tutto dobbiamo creare un handler per l'evento [[IT/onResourceStart\|onResourceStart]], che si attiva quando la risorsa principale viene avviata con il comando <syntaxhighlight lang="lua">gamemode</syntaxhighlight>. Poi, con la funzione assegnata all'evento, carichiamo la risorsa mappa e inizializziamo la mappa:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function Initialize(startedResource)		function Initialize(startedResource)
	mapRes = getResourceFromName("mymap")		mapRes = getResourceFromName("mymap") --Otteniamo l'handle della risorsa "mymap"
	manager = getResourceFromName("mapmanager")		manager = getResourceFromName("mapmanager") --E quello di "mapmanager"
	startResource(mapRes)		startResource(mapRes) --Inizializziamo la risorsa "mymap"

	call(manager, "changeGamemodeMap", mapRes, getThisResource())		call(manager, "changeGamemodeMap", mapRes, getThisResource()) --E chiamiamo la funzione "changeGamemodeMap" dentro mapmanager
	end		end

	addEventHandler("onResourceStart", getResourceRootElement(getThisResource()), Initialize)		addEventHandler("onResourceStart", getResourceRootElement(getThisResource()), Initialize) --Impostiamo Inizialize() come handler per onResourceStart
	</syntaxhighlight>		</syntaxhighlight>
	~~The~~ [[call]] ~~function lets you use a function defined~~ in ~~another resource~~, ~~which is the~~ "changeGamemodeMap~~" function in the "~~mapmanager~~" resource in our case~~.		La funzione [[IT/call\|call]] permette, come visto, di chiamare una funzione presente in un'altra risorsa, in questo caso la funzione <syntaxhighlight lang="lua">changeGamemodeMap</syntaxhighlight> dentro la riosrsa '''mapmanager'''.

	~~If you try to run the~~ server ~~now~~, ~~it will give you several~~ "access denied" ~~errors~~. ~~That~~'~~s because the main resource, "~~myserver", ~~doesn't yet have access to the function~~ [[startResource]] ~~by default~~. ~~We must add the resource in the~~ Access Control List ~~with appropriate rights~~.		Se provassi ad avviare il server adesso, riceveresti molti errori "access denied" (accesso negato). QUesto perché la risorsa principale, '''myserver''', non ha ancora accesso di default alla funzione [[IT/startResource\|startResource]]. Dobbiamo aggiungere la funzione nell'Access Control List con i diritti necessari.

	~~Go to /Your MTA Server~~/mods/deathmatch/ ~~directory~~. ~~You will see a~~ file ~~named~~ acl.xml~~. Open it with Notepad~~, ~~and insert the following codes~~:		Vai nella cartella <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/</syntaxhighlight>. Vedrai un file chiamato '''acl.xml''', aprilo con un qualsiasi editor di testo ed inserisci il seguente codice:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<group name="myserver">		<group name="myserver">
Line 87:		Line 87:
	</acl>		</acl>
	</syntaxhighlight>		</syntaxhighlight>
	~~Make sure the~~ acl.xml ~~file is closed~~, ~~then restart the~~ server ~~process. It will reload the~~ ACL ~~settings and give your resource access to the function~~. ~~Now you can start the gamemode with~~:		Assicurati che '''acl.xml''' sia chiuso, quindi riavvia il server; esso ricaricherà il file ACL, dando i diritti di accesso della risorsa alla funzione. Ora puoi avviare la funzione con:
			<syntaxhighlight lang="lua">gamemode myserver</syntaxhighlight>
	~~'''~~gamemode myserver~~'''~~		E lo script avvierà la mappa per voi.

	~~And the~~ script ~~will automatically load the map for you~~.

	==Usage==		==Usage==

Shadd: /* A simple tutorial */ Tradotta la sezione

2008-06-05T12:07:16Z

A simple tutorial: Tradotta la sezione

← Older revision		Revision as of 12:07, 5 June 2008
Line 5:		Line 5:
	Più specificamente, il map manager memorizza la lista di tutte le gamemodes/mappe e ne gestisce il caricamento; applica alcune impostazioni della mappa che hanno effetto sul mondo del gioco e setta le regole della mappa e il tipo di gioco su ASE. Comprende inoltre una funzione che visualizza ed aggiorna automaticamente nel browser la mode/mappa.		Più specificamente, il map manager memorizza la lista di tutte le gamemodes/mappe e ne gestisce il caricamento; applica alcune impostazioni della mappa che hanno effetto sul mondo del gioco e setta le regole della mappa e il tipo di gioco su ASE. Comprende inoltre una funzione che visualizza ed aggiorna automaticamente nel browser la mode/mappa.

	==~~A simple~~ tutorial==		==Un semplice tutorial==
	In ~~this section we are going to continue the basic~~ gamemode ~~we created in the~~ [[~~Scripting Introduction~~\|~~Introduction to~~ Scripting]]. ~~We will add a simple map resource that only contains the spawnpoint data for the players, and load the data in the main~~ script ~~when the player needs to spawn~~.		In questa sezione continueremo a lavorare sulla gamemode che abbiamo creato nella pagina [[IT/Introduzione_allo_scripting\|introduzione allo Scripting]]. Aggiungeremo una semplice risorsa mappa che conterrà gli spawn dei giocatori e caricherà i dati nello script principale quando un giocatore dovrà spawnare.

	~~First of all, we make a folder under /Your MTA Server~~/mods/deathmatch/resources/, ~~and name it~~ "~~mymap~~"~~. Then under~~ /mymap/ ~~directory, create a text~~ file ~~and name it "~~meta.xml", ~~which is required for every resource~~.		Innanzitutto crea una cartella sotto <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/resources/</syntaxhighlight>, che chiamerai '''mymap'''. Dentro <syntaxhighlight lang="lua">/mymap/</syntaxhighlight> crea un file di testo chiamato '''meta.xml''', che è necessario a tutte le risorse.

	~~Enter the following codes in the~~ ''meta.xml'' ~~file~~:		Inserisci questo codice all'interno di ''meta.xml'':
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<meta>		<meta>
Line 17:		Line 17:
	</meta>		</meta>
	</syntaxhighlight>		</syntaxhighlight>
	~~Note that this resource is~~ "~~linked~~" ~~to the main resource with the ''~~gamemodes=""~~'' tag~~, ~~which contains the name of the main resource~~. ~~In the ''map''~~ tag~~, it indicates the name of the .~~map file ~~which contains the actual~~ map ~~data~~.		Notare che questa risorsa è collegata allo script principale tramite l'attributo <syntaxhighlight lang="lua">gamemodes=""</syntaxhighlight>, che contiene il nome della risorsa principale. Nel tag <syntaxhighlight lang="lua">map</syntaxhighlight> è indicato il nome del file .map che contiene le informazioni sulla mappa.

	~~Now let's create another text~~ file ~~under~~ /mymap/ ~~and name it "~~mymap.map", ~~and enter the following codes~~:		Ora crea un altro file di testo sotto <syntaxhighlight lang="lua">/mymap/</syntaxhighlight> e chiamalo '''mymap.map''', inserendovi questo codice:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<map>		<map>
Line 25:		Line 25:
	</map>		</map>
	</syntaxhighlight>		</syntaxhighlight>
	~~Note that~~ "spawnpoint~~" is the type of the element, used in~~ [[getElementsByType]] ~~function~~; ~~likewise,~~ "id~~" is used in~~ [[getElementByID]] ~~function~~.		Notare che <syntaxhighlight lang="lua">spawnpoint</syntaxhighlight> è il tipo di elemento usato nella funzione [[IT/getElementsByType\|getElementsByType]]; così come <syntaxhighlight lang="lua">id</syntaxhighlight> è usato nella funzione [[IT/getElementByID\|getElementByID]].

	~~To load the map data, the main~~ script ~~needs access to the map resource itself~~. ~~Now let~~'~~s edit the~~ script.lua ~~file in~~ "myserver~~" resource~~. ~~Enter the following code~~:		Per caricare i dati della mappa lo script principale ha bisogno di un collegamento con la risorsa della mappa. Modifichiamo il file '''script.lua''' nella risorsa <syntaxhighlight lang="lua">myserver</syntaxhighlight>. Inserisci il seguente codice:

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 36:		Line 36:
	addEventHandler("onGamemodeMapStart", g_root, loadMap)		addEventHandler("onGamemodeMapStart", g_root, loadMap)
	</syntaxhighlight>		</syntaxhighlight>
	~~Basically~~, ~~the~~ "onGamemodeMapStart~~" event gives us the~~ handle ~~of the map~~ ("startedMap"), ~~which we used to extract the~~ handle ~~of the resource containing the map~~ ("mapRoot").		In pratica, l'evento <syntaxhighlight lang="lua">onGamemodeMapStart</syntaxhighlight> ci da l'handle della mappa ("startedMap"), che abbiamo usato per estrarre l'handle della risorsa contenente la mappa ("mapRoot").

	~~With the resource~~ handle~~, we can extract the~~ spawnpoint ~~information from it~~. ~~Look at the~~ joinHandler() ~~function in~~ script.lua, ~~instead of specifying~~ x, y ~~and~~ z, ~~we can use the map data as the following~~:		Con l'handle della risorsa possiamo estrarne le informazioni sugli spawnpoint. Creando la funzione <syntaxhighlight lang="lua">joinHandler()</syntaxhighlight> dentro '''script.lua''', invece di specificare le coordinate '''x''', '''y''' e '''z''', possiamo usare i dati della mappa come segue:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function joinHandler()		function joinHandler()
	local spawn = getElementsByType("spawnpoint", mapRoot)		local spawn = getElementsByType("spawnpoint", mapRoot) --Creiamo un array locale contenente gli elementi <spawnpoint>
	local x,y,z,r		local x,y,z,r --Creaiamo delle variabili locali per tutte le coordinate
	for key, value in pairs(spawn) do		for key, value in pairs(spawn) do --Inseriamo nelle variabili delle coordinate le coordinate prese dall'elemento <spawnpoint>
	x = getElementData(value, "posX")		x = getElementData(value, "posX")
	y = getElementData(value, "posY")		y = getElementData(value, "posY")
Line 49:		Line 49:
	r = getElementData(value, "rot")		r = getElementData(value, "rot")
	end		end
	spawnPlayer(source, x, y, z)		spawnPlayer(source, x, y, z) --Spawniamo il giocatore alle coordinate appena prese
	fadeCamera(source, true)		fadeCamera(source, true) --E impostiamo la sua telecamera su di lui
	end		end
	</syntaxhighlight>		</syntaxhighlight>
	~~Now you may start the~~ gamemode in ~~the server~~ console ~~with the following command~~:		Ora puoi far partire la gamemode sul tuo server avviando in console il seguente comando:
			<syntaxhighlight lang="lua">gamemode myserver mymap</syntaxhighlight>
	~~'''~~gamemode myserver mymap~~'''~~

	==A more advanced tutorial==		==A more advanced tutorial==

Shadd: Creata la pagina e tradotta la sezione 0

2008-06-04T14:44:57Z

Creata la pagina e tradotta la sezione 0

Show changes