Resource:IT/Map manager

From Multi Theft Auto: Wiki

(Redirected from IT/Map manager)
Jump to: navigation, search
« Torna alla Pagina principale italiana .

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.

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.

Contents

Un semplice tutorial

In questa sezione continueremo a lavorare sulla gamemode che abbiamo creato nella pagina 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.

Innanzitutto crea una cartella sotto
<SERVER>/mods/deathmatch/resources/
, che chiamerai mymap. Dentro
/mymap/
crea un file di testo chiamato meta.xml, che è necessario a tutte le risorse.

Inserisci questo codice all'interno di meta.xml:

<meta>
   <info type="map" gamemodes="myserver"/>
   <map src="mymap.map"/>
</meta>
Notare che questa risorsa è collegata allo script principale tramite l'attributo
gamemodes=""
, che contiene il nome della risorsa principale. Nel tag
map
è indicato il nome del file .map che contiene le informazioni sulla mappa. Ora crea un altro file di testo sotto
/mymap/
e chiamalo mymap.map, inserendovi questo codice:

<map>
   <spawnpoint id="spawnpoint1" posX="1959.5487060547" posY="-1714.4613037109" posZ="18" rot="63.350006103516" model="0"/>
</map>
Notare che
spawnpoint
è il tipo di elemento usato nella funzione getElementsByType; così come
id
è usato nella funzione getElementByID. 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
myserver
. Inserisci il seguente codice:

function loadMap(startedMap)
	mapRoot = getResourceRootElement(startedMap)
end
 
addEventHandler("onGamemodeMapStart", g_root, loadMap)
In pratica, l'evento
onGamemodeMapStart
ci da l'handle della mappa ("startedMap"), che abbiamo usato per estrarre l'handle della risorsa contenente la mappa ("mapRoot"). Con l'handle della risorsa possiamo estrarne le informazioni sugli spawnpoint. Creando la funzione
joinHandler()
dentro script.lua, invece di specificare le coordinate x, y e z, possiamo usare i dati della mappa come segue:

function joinHandler()
	local spawn = getElementsByType("spawnpoint", mapRoot) --Creiamo una table (array) locale contenente gli elementi <spawnpoint>
	local x,y,z,r --Creaiamo delle variabili locali per tutte le coordinate
	for key, value in pairs(spawn) do --Inseriamo nelle variabili delle coordinate le coordinate prese dall'elemento <spawnpoint>
		x = getElementData(value, "posX")
		y = getElementData(value, "posY")
		z = getElementData(value, "posZ")
		r = getElementData(value, "rot")
	end
	spawnPlayer(source, x, y, z) --Spawniamo il giocatore alle coordinate appena prese
	fadeCamera(source, true) --E impostiamo la sua telecamera su di lui
end

Ora puoi far partire la gamemode sul tuo server avviando in console il seguente comando:

gamemode myserver mymap

Un tutorial più avanzato

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.

Prima di tutto dobbiamo creare un handler per l'evento onResourceStart, che si attiva quando la risorsa principale viene avviata con il comando
gamemode
. Poi, con la funzione assegnata all'evento, carichiamo la risorsa mappa e inizializziamo la mappa:

function Initialize(startedResource)
	mapRes = getResourceFromName("mymap") --Otteniamo l'handle della risorsa "mymap"
	manager = getResourceFromName("mapmanager") --E quello di "mapmanager"
	startResource(mapRes) --Inizializziamo la risorsa "mymap"
 
	call(manager, "changeGamemodeMap", mapRes, getThisResource()) --E chiamiamo la funzione "changeGamemodeMap" dentro mapmanager
end
 
addEventHandler("onResourceStart", getResourceRootElement(getThisResource()), Initialize) --Impostiamo Inizialize() come handler per onResourceStart
La funzione call permette, come visto, di chiamare una funzione presente in un'altra risorsa, in questo caso la funzione
changeGamemodeMap
dentro la riosrsa mapmanager.

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 startResource. Dobbiamo aggiungere la funzione nell'Access Control List con i diritti necessari.

Vai nella cartella
<SERVER>/mods/deathmatch/
. Vedrai un file chiamato acl.xml, aprilo con un qualsiasi editor di testo ed inserisci il seguente codice:

<group name="myserver">
   <acl name="acl_myserver"/>
   <object name="resource.myserver"/>
</group>
<acl name="acl_myserver">
   <right name="function.startResource" access="true"/>
   <right name="function.stopResource" access="true"/>
   <right name="function.restartResource" access="true"/>
</acl>

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:

gamemode myserver

E lo script avvierà la mappa per voi.

Utilizzo

Per usare il map manager, le tue risorse devono essere prima marcate come gamemodes o mappe.

Devi contrassegnare le risorse gamemode con il tipo corretto nel tag
info
:
<info description="Una gamemode" type="gamemode" />
Anche le risorse mappa hanno bisogno dell'attributo
type="map"
, più un attributo
gamemodes
con una lista di gamemodes con cui sono compatibili, separate da virgole e senza spazi.
<info description="Una mappa" type="map" gamemodes="ctv,koth" />

Il server può caricare al massimo una gamemode e una mappa alla volta.

Attributi opzionali delle resources

Questi attributi vanno nel tag
info
della risorsa.
  • name
    : Il nome pubblico della risorsa, che verrà visualizzato nella lista di gamemodes e nei messaggi del server al posto del nome del file.

Comandi

Questi comandi sono eseguibili sulla risorsa map manager:

  • changemap nuovamappa [nuovagamemode]
    Cambia la mappa attuale, e opzionalmente anche la gamemode.
  • changemode nuovagamemode [nuovamappa]
    Cambia la gamemode attuale, e opzionalmente anche la mappa.
  • gamemode nuovagamemode [nuovamappa]
    Come sopra.
  • stopmode
    Stoppa la gamemode e la mappa corrente.
  • stopmap
    Stoppa la mappa corrente.
  • maps [gamemode]
    Mostra tutte le mappe del server, opzionalmente solo quelle collegate alla gamemode specificata.
  • gamemodes
    Mostra tutte le gamemodes.

Impostazioni

  • mapmanager.color [colore in codice hex]
    Cambia il colore dei messaggi di output del mapmanager con quello in codice esadecimale(#RRGGBB) (default: #E1AA5A).
  • mapmanager.messages [booleano]
    true se i cambiamenti di gamemode/mappa sono abilitati, false se no (default: true).
  • mapmanager.ASE [booleano]
    true se il mapmanager può mostrare gamemode e mappa su ASE, false se no (default: true).

Funzioni esportate

Queste sono le funzioni del mapmanager utilizzabili tramite la funzione call():

Cambia la gamemode in nuovaGamemode, impostando opzionalmente una mappa iniziale(mappaDaCaricare); di default carica con la mappa.

Cambia la mappa in nuovaMappa, impostando opzionalmente una gamemode da avviare prima di cambiare(gamemodeDaCambiare); di default carica con la gamemode corrente.

Ritorna una table con i puntatori di tutte le gamemodes.

Ritorna una table con i puntatori di tutte le gamemode compatibili con laMappa.

Ritorna una table con i puntatori di tutte le mappe.

Ritorna una table con i puntatori di tutte le mappe compatibili con laGamemode. Se il parametro non viene specificato, ritorna tutte le mappe che non sono compatibili con nessuna gamemode.

Ritorna il puntatore della gamemode attualmente in esecuzione.

Ritorna il puntatore della mappa attualmente in esecuzione.

Ritorna se laGamemode è o no una gamemode.

Ritorna se la gamemode è compatibile con la mappa o no.

Determina se laMappa è una mappa o no.

Ritorna se la mappa è compatibile con la gamemode o no.

  • bool stopGamemode ( )

Stoppa la gamemode e la mappa correnti.

  • bool stopGamemodeMap ( )

Stoppa la mappa corrente.

Eventi

Per tutti questi eventi, source è l'elemento root della risorsa.

  • onGamemodeStart ( resource gamemodeIniziata )

Si attiva prima che venga iniziata una gamemode.

  • onGamemodeStop ( resource gamemodeFermata )

Si attiva prima che venga fermata una gamemode

  • onGamemodeMapStart ( resource mappaIniziata )

Si attiva prima che venga iniziata una mappa.

  • onGamemodeMapStop ( resource mappaFermata )

Si attiva prima che venga fermata una mappa.

Impostazioni supportate dalle mappe

Le seguenti impostazioni tratte dal registro vengono applicate dal map manager quando una mappa inizia:

  • gamespeed [numero]
    : La velocità di gioco della mappa.
  • gravity [numero]
    : La gravità della mappa.
  • time [stringa tipo 'hh:mm']
    : L'ora della mappa.
  • weather [numero]
    : L'ID del meteo della mappa.
  • waveheight [numero]
    : L'altezza delle onde della mappa.
  • locked_time [booleano]
    : Se l'ora sarà bloccata o meno.
  • minplayers [numero]
    : Il numero minimo di giocatori per iniziare la mappa.
  • maxplayers [numero]
    : Il massimo numero di giocatori per iniziare la mappa.
In other languages