IT/Introduzione alle Risorse - Revision history

Cristiano Cardoso: Added PT-BR page

2014-07-02T13:41:58Z

Added PT-BR page

← Older revision		Revision as of 13:41, 2 July 2014
Line 77:		Line 77:
	{{Resource_events}}		{{Resource_events}}
	[[en:Resources]]		[[en:Resources]]
			[[pt-br:Recursos]]
	[[ru:Resources]]		[[ru:Resources]]

Divine at 11:12, 24 August 2009

2009-08-24T11:12:18Z

← Older revision		Revision as of 11:12, 24 August 2009
Line 76:		Line 76:
	Anche i seguenti eventi sono disponibili:		Anche i seguenti eventi sono disponibili:
	{{Resource_events}}		{{Resource_events}}
			[[en:Resources]]
			[[ru:Resources]]

ALexMiller at 22:54, 21 June 2009

2009-06-21T22:54:52Z

← Older revision		Revision as of 22:54, 21 June 2009
Line 1:		Line 1:
	{{IT/MainP}}		{{IT/MainP}}
	[[Category:25%]]		[[Category:100%]]
	[[Category:IT/Concetti di scripting]]		[[Category:IT/Concetti di scripting]]
	Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente dei file - tra cui gli script essenziali ed un file ''meta'' che descrive al [[IT/Server\|server]] come la risorsa dev'essere caricata. Una risorsa può essere vista come un programma in un sistema operativo - può essere avviata e fermata, e più risorse possono essere avviate in contemporanea.		Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente dei file - tra cui gli script essenziali ed un file ''meta'' che descrive al [[IT/Server\|server]] come la risorsa dev'essere caricata. Una risorsa può essere vista come un programma in un sistema operativo - può essere avviata e fermata, e più risorse possono essere avviate in contemporanea.

ALexMiller: /* Script functions */

2009-06-21T22:54:12Z

Script functions

← Older revision		Revision as of 22:54, 21 June 2009
Line 70:		Line 70:
	Ogni risorsa può avere un file zip, una cartella o entrambi. Nel caso che esistino entrambi, la cartella ha precedenza sul file zip, in quanto tale i file possono essere messi nella cartella per "annullare" i file nell'archivio zip. Questo permette alle cartelle di essere usato per testare e sviluppare mappe/script mentre i file zip quando sono pronti per essere usati.		Ogni risorsa può avere un file zip, una cartella o entrambi. Nel caso che esistino entrambi, la cartella ha precedenza sul file zip, in quanto tale i file possono essere messi nella cartella per "annullare" i file nell'archivio zip. Questo permette alle cartelle di essere usato per testare e sviluppare mappe/script mentre i file zip quando sono pronti per essere usati.

	==Script ~~functions~~==		==Funzioni Script==
	~~The resource system can be manipulated by~~ script. ~~As such~~, ~~the following~~ Serverside ~~scripting functions are provided~~:		Il sistema delle risorce può essre amministrato da script. In quanto tale, sono disponibili le seguenti funzioni Serverside:
	{{Resource functions}}		{{Resource functions}}

	~~The following events are also provided~~:		Anche i seguenti eventi sono disponibili:
	{{Resource_events}}		{{Resource_events}}

ALexMiller: /* File storage */

2009-06-21T22:51:14Z

File storage

← Older revision		Revision as of 22:51, 21 June 2009
Line 63:		Line 63:
	Ogni risorsa può essere solo caricata una volta, il server se ne accerterà. Se una risorsa è inclusa più di una volta, la stessa istanza sarà usata da ogni risorsa che la include.		Ogni risorsa può essere solo caricata una volta, il server se ne accerterà. Se una risorsa è inclusa più di una volta, la stessa istanza sarà usata da ogni risorsa che la include.

	==File ~~storage~~==		==Memorizzazione dei File==
	Le risorse possono sia essere memorizzati in un archivio zip sia in una cartella. Queste si trovano qui:		Le risorse possono sia essere memorizzati in un archivio zip sia in una cartella. Queste si trovano qui:

ALexMiller: /* The Meta File */

2009-06-21T22:50:34Z

The Meta File

← Older revision		Revision as of 22:50, 21 June 2009
Line 7:		Line 7:
	* '''Resource''': Un archivio zip o una cartella contenente un file [[IT/Meta.xml\|meta.xml]] e un certo numero di altri file (''resource items''). Questa va posizionata nella cartella <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/resources</syntaxhighlight> di MTA.		* '''Resource''': Un archivio zip o una cartella contenente un file [[IT/Meta.xml\|meta.xml]] e un certo numero di altri file (''resource items''). Questa va posizionata nella cartella <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/resources</syntaxhighlight> di MTA.
	* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.		* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.
	==~~The~~ Meta ~~File~~==		==Il File Meta==
	''Guarda l'articolo principale [[Meta.xml]] per dettagli''		''Guarda l'articolo principale [[Meta.xml]] per dettagli''

ALexMiller: /* File storage */

2009-06-21T22:50:04Z

File storage

← Older revision		Revision as of 22:50, 21 June 2009
Line 64:		Line 64:

	==File storage==		==File storage==
	~~Resource files can either be stored~~ in a zip ~~or a directory~~. ~~This is located in~~:		Le risorse possono sia essere memorizzati in un archivio zip sia in una cartella. Queste si trovano qui:

	mods/deathmatch/resources/		mods/deathmatch/resources/

	~~Each resource can have a~~ zip ~~file~~, ~~a directory or both~~. ~~In the case of both existing~~, ~~the directory has precedence over the~~ zip ~~file~~, ~~as such files can be placed~~ in ~~the directory to over-ride the files in the~~ zip ~~file~~. ~~This allows directories to be used for testing and developing of maps~~/~~scripts while~~ zip ~~files used by end-users~~.		Ogni risorsa può avere un file zip, una cartella o entrambi. Nel caso che esistino entrambi, la cartella ha precedenza sul file zip, in quanto tale i file possono essere messi nella cartella per "annullare" i file nell'archivio zip. Questo permette alle cartelle di essere usato per testare e sviluppare mappe/script mentre i file zip quando sono pronti per essere usati.

	==Script functions==		==Script functions==

ALexMiller: /* The Meta File */

2009-06-21T22:43:03Z

The Meta File

← Older revision		Revision as of 22:43, 21 June 2009
Line 8:		Line 8:
	* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.		* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.
	==The Meta File==		==The Meta File==
	''~~See main article~~ [[Meta.xml]] ~~for details~~''		''Guarda l'articolo principale [[Meta.xml]] per dettagli''

	~~The~~ Meta ~~file is the core of each the resource~~. ~~It describes exactly what~~ files ~~in the resource should be used~~, ~~and how~~. ~~The following is an example that covers every option there is, your~~ meta ~~files can have as many or as few of these tags as you require~~:		Il file Meta è il nucleo di ogni risorsa. Descrive esattamente quali files verranno usati nella risorsa, e come. Il seguente è un esempio che comprende ogni opzione che il tuo meta file può contenere e che ti potrebbero servire:

	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
Line 50:		Line 50:
	</syntaxhighlight>		</syntaxhighlight>

			Gli attributi Script/type, Config/type e File/type specificato se lo script/la risorsa deve essere inviato al client o no, e il default è "server".

	~~Script/type~~, ~~Config/type and File/type attributes specify if the script/resource should be sent to clients or not~~, ~~and defaults to "server"~~.		Il tag include specifica le altre risorse che devono essere eseguite prima che questa risorsa sia avviata. In altre parole, se la tua risorsa depende da un'altra, puoi includere quest'ultima cosicchè l'altra risorse sia avviata prima.

	~~The include~~ tag ~~specifies other resources that should be started before this resoucre is started~~. ~~In other words, if your resource is dependent on another, you can include it so that the other resource is started first,~~		Ogni riosrsa ha la propria macchina virtuale [ (VM ) Virtual Machine in inglese ]. Questa contiene ogni script nella risorsa. Questo significa che le variabili non sono condivise con altre risorse. Il miglior modo per comunicare con le altre risorse è usando il tag ''export'' ed esportando una funzione. Questo abiliterà le altre risorse a far partire questa funzione usando la funzione [[call]].

			Gli script inviati ai client sono avviati non appena tutti gli script sono stati scaricati.

	~~Each resource has its own virtual machine (VM). This contains every~~ script ~~in the resource. This means that variables are not shared with other resources~~. ~~The best way to communictate with other resources is by using the~~ '~~'export'' tag and exporting a function. This will enable other resources to fire this function using the~~ [[~~call~~]] ~~scripting function~~.		Gli script possono leggere e scrivere alle prorie cartelle delle risorse con funzioni come [[xmlCreateFile]] e [[fileCreate]].
			Possono anche leggere e scrivere alle altre risorse, ma deve avere l'accesso da [[Access_Control_List[ACL]]].

			Ogni risorsa può essere solo caricata una volta, il server se ne accerterà. Se una risorsa è inclusa più di una volta, la stessa istanza sarà usata da ogni risorsa che la include.
	~~Scripts sent to clients are started as soon as all the scripts have been downloaded.~~


	Scripts are able to read and write to their own resource folder with functions such as [[xmlCreateFile]] and [[fileCreate]]. They can also read and write to other resources, but must have [[Access_Control_List\|ACL]] access.


	~~Each resource can only be loaded once~~, ~~the~~ server ~~will ensure this~~. ~~If a resource is included more than once~~, ~~the same instance will be used by each resource that includes it~~.

	==File storage==		==File storage==

Shadd: New page: {{IT/MainP}} Category:25% Category:IT/Concetti di scripting Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente de...

2008-06-14T00:23:22Z

New page: {{IT/MainP}} Category:25% Category:IT/Concetti di scripting Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente de...

New page

{{IT/MainP}}
[[Category:25%]]
[[Category:IT/Concetti di scripting]]
Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente dei file - tra cui gli script essenziali ed un file ''meta'' che descrive al [[IT/Server|server]] come la risorsa dev'essere caricata. Una risorsa può essere vista come un programma in un sistema operativo - può essere avviata e fermata, e più risorse possono essere avviate in contemporanea.

==Terminologia==
* '''Resource''': Un archivio zip o una cartella contenente un file [[IT/Meta.xml|meta.xml]] e un certo numero di altri file (''resource items''). Questa va posizionata nella cartella <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/resources</syntaxhighlight> di MTA.
* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.
==The Meta File==
''See main article [[Meta.xml]] for details''

The Meta file is the core of each the resource. It describes exactly what files in the resource should be used, and how. The following is an example that covers every option there is, your meta files can have as many or as few of these tags as you require:

<syntaxhighlight lang="xml">
<meta>
<info author="eAi" description="This is a basic CTF script" version="4"/>

<include resource="radarblips"/>
<include resource="markermanagement" />

<script src="ctf.lua" />
<script src="flag.lua" />
<script src="ctf_client.lua" type="client" />

<file src="model.dff" />
<file src="quitbutton.png" />
<file src="killed.png" />

<html src="test.htm" default="true"/>
<html src="logo.png" raw="true" />

<export function="multiply" http="true" />
<export function="getPlayerList" />
<export function="getElementOwner" type="client"/>

<config src="vehicle-list.xml" type="client" />
<config src="markerconfig.xml" type="server" />

<map src="somestuff.map" dimension="99" />
</meta>
</syntaxhighlight>
While a CTF map may have a meta.xml that looks like:
<syntaxhighlight lang="xml">
<meta>
<include resource="ctf" />
<map src="myuberl33tctfmap.map" />

<info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" />
</meta>
</syntaxhighlight>

Script/type, Config/type and File/type attributes specify if the script/resource should be sent to clients or not, and defaults to "server".

The include tag specifies other resources that should be started before this resoucre is started. In other words, if your resource is dependent on another, you can include it so that the other resource is started first,

Each resource has its own virtual machine (VM). This contains every script in the resource. This means that variables are not shared with other resources. The best way to communictate with other resources is by using the ''export'' tag and exporting a function. This will enable other resources to fire this function using the [[call]] scripting function.

Scripts sent to clients are started as soon as all the scripts have been downloaded.

Scripts are able to read and write to their own resource folder with functions such as [[xmlCreateFile]] and [[fileCreate]]. They can also read and write to other resources, but must have [[Access_Control_List|ACL]] access.

Each resource can only be loaded once, the server will ensure this. If a resource is included more than once, the same instance will be used by each resource that includes it.

==File storage==
Resource files can either be stored in a zip or a directory. This is located in:

mods/deathmatch/resources/

Each resource can have a zip file, a directory or both. In the case of both existing, the directory has precedence over the zip file, as such files can be placed in the directory to over-ride the files in the zip file. This allows directories to be used for testing and developing of maps/scripts while zip files used by end-users.

==Script functions==
The resource system can be manipulated by script. As such, the following Serverside scripting functions are provided:
{{Resource functions}}

The following events are also provided:
{{Resource_events}}