Multi Theft Auto: Wiki - User contributions [en]

OnResourcePreStart

2018-03-21T20:00:31Z

Rafalh: Mention that OnResourcePreStart source is root element, not resource root element...

{{Server event}}
__NOTOC__
Analogous to [[onResourceStart]], but triggered before script files are initialised.
{{Note|This event isn't triggered within the resource starting.}}

==Parameters==
<syntaxhighlight lang="lua">
resource startingResource
</syntaxhighlight>

*'''startingResource''': The resource that is starting

==Source==
The [[event system#Event source|source]] of this event is the root [[element]].

==Cancel effect==
If this event is cancelled, the resource won't begin starting.

==Example==
This code will output the name of any resource that is starting.
<syntaxhighlight lang="lua">
function displayStartingRes ( res )
outputChatBox ( "Resource " .. getResourceName(res) .. " is going to start", getRootElement(), 255, 255, 255 )
end
addEventHandler ( "onResourcePreStart", getRootElement(), displayStartingRes )
</syntaxhighlight>

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

Template:Client utility functions

2018-03-04T02:15:59Z

Rafalh: Uncomment downloadFile

* [[addDebugHook]]
* [[base64Encode]]
* [[base64Decode]]
{{Bit_functions}}
* [[createTrayNotification]]
{{New items|3.0154|1.5.4 r11306|
* [[debugSleep]]}}
* [[downloadFile]]
* [[fromJSON]]
* [[getDistanceBetweenPoints2D]]
* [[getDistanceBetweenPoints3D]]
* [[getEasingValue]]
* [[getColorFromString]]
* [[getDevelopmentMode]]
* [[getFPSLimit]]
{{New items|3.0140|1.4|
* [[getLocalization]]
}}
* [[getNetworkStats]]
* [[getNetworkUsageData]]
* [[getPerformanceStats]]
* [[getRealTime]]
* [[getTickCount]]
* [[getTimers]]
* [[getTimerDetails]]
* [[gettok]]
{{New items|3.0153|1.5.3|
*[[getUserdataType]]
|9768}}
* [[getVersion]]
{{New items|3.0141|1.4.1 r6791|
* [[hash]]}}
* [[interpolateBetween]]
* [[isTimer]]
* [[isTrayNotificationEnabled]]
* [[killTimer]]
* [[md5]]
{{New items|3.0154|1.5.4 r11277|
* [[passwordHash]]
* [[passwordVerify]]
}}
{{New items|3.0135|1.3.5 r6056|
* [[pregFind]]
* [[pregReplace]]
* [[pregMatch]]
}}
* [[removeDebugHook]]
* [[resetTimer]]
* [[setClipboard]]
* [[setDevelopmentMode]]
* [[setFPSLimit]]
* [[setTimer]]
{{New items|3.0141|1.4.1 r7653|
* [[setWindowFlashing]]
}}
* [[sha256]]
* [[split]]
* [[teaEncode]]
* [[teaDecode]]
* [[tocolor]]
* [[toJSON]]
* [[utfChar]]
* [[utfCode]]
* [[utfLen]]
* [[utfSeek]]
* [[utfSub]]
<noinclude>[[Category:Functions templates]]</noinclude>

Template:Client utility functions

2012-09-23T11:10:44Z

Rafalh: Added getPerformanceStats

* [[getDistanceBetweenPoints2D]]
* [[getDistanceBetweenPoints3D]]
* [[getEasingValue]]
* [[interpolateBetween]]
* [[getColorFromString]]
* [[getRealTime]]
* [[getTickCount]]
* [[getTimerDetails]]
* [[getNetworkStats]]
* [[getPerformanceStats]]
* [[setClipboard]]
* [[getTimers]]
* [[gettok]]
* [[killTimer]]
* [[resetTimer]]
* [[setTimer]]
* [[split]]
* [[getVersion]]
* [[isTimer]]
* [[md5]]
* [[tocolor]]

* [[utfChar]]
* [[utfCode]]
* [[utfLen]]
* [[utfSeek]]
* [[utfSub]]
{{New items|3.0120|1.2|
* [[toJSON]]
* [[fromJSON]]
* [[setDevelopmentMode]]
* [[getDevelopmentMode]]
}}
{{New items|3.0151|1.4|
* [[downloadFile]]
}}
<noinclude>[[Category:Functions templates]]</noinclude>

GetPerformanceStats

2012-09-23T11:09:10Z

Rafalh: Created page with "__NOTOC__ {{Server client function}} This function returns performance information. ==Syntax== <syntaxhighlight lang="lua"> table columns, table rows = getPerformanceStats(string category, strin..."

__NOTOC__
{{Server client function}}
This function returns performance information.

==Syntax==
<syntaxhighlight lang="lua">
table columns, table rows = getPerformanceStats(string category, string options = "", string filter = "")
</syntaxhighlight>

===Required Arguments===
*'''category:''' Performance statistics category. If empty string is given, list of all categories is returned.

===Optional Arguments===
*'''options:''' Category specific ',' separated options. All categories supports 'h' option for help.
*'''filer:''' Case-sensitive filter used to select returned rows. Only 'name' column is filtered.

===Returns===
Returns two tables. First contains column names. The second contains result rows. Each row is table of cells.

==Example==
<syntaxhighlight lang="lua">
local columns, rows = getPerformanceStats("")
outputChatBox(table.concat(columns, " "))
outputChatBox("----------------")
for i, row in ipairs(rows) do
outputChatBox(table.concat(row, " "))
end
</syntaxhighlight>

==See Also==
{{Client_utility_functions}}

RU/Meta.xml

2012-09-19T20:06:27Z

Rafalh:

Файл ''meta.xml'' представляет MTA набор метаданных, таких как название ресурса, включенные в него скрипты и какие файлы предварительно кэшировать для отправки клиенту, это лишь часть. В нем также объявляются "элементы" для дальнейшей работы с ними. Он написан в XML, который базируется на HTML, и является родителем XHTML.

=Тэги=
XML - текстовый формат данных, широко используемый для представления данных. MTA использует базирующийся на XML язык для описания метаданных ресурсов с использованием тегов ниже:

*'''<info />''' Информация об этом ресурсе, возможные для включения параметры (любые произвольные параметры могут быть использованы и прочитаны с помощью [[getResourceInfo]]):
** '''author:''' Автор данного ресурса
** '''version:''' Версия ресурса
** '''name:''' Название ресурса
** '''description:''' Краткое описание ресурса
** '''type:''' Тип ресурса, может быть "gamemode" (игровой режим, мод), "script" (сценарий, скрипт), "map" (карта) или "misc" (разное).
*'''<script />''' Исходный код ресурса, возможные параметры:
** '''src:''' Название файла с исходным кодом (скрипта)
** '''type:''' Тип исходного кода: "client" или "server"

*'''<map />''' Карта для мода, возможные параметры:
**'''src:''' название .map-файла (может быть в т.ч. и путь, напр. "maps/filename.map")
**'''dimension:''' Измерение, в котором карта будет загружена (опционально)
*'''<file />''' Клинтский файл. В основном, это картинки, .txd, .col, .dff или .xml файлы. Они будут скачаны клиентами при старте ресурса (или при заходе)
**'''src:''' название клиентского файла (может быть в т.ч. и путь, напр. "images/image.png")
**'''download:''' Должен ли файл быть послан клиенту автоматичсеки или нет (опционально). По умолчанию "true", использование "no" или "false" будет значить, что файл не будет послан при старте ресурса, но сможет быть задействован позже через [[downloadFile]] (с версии 1.4)
*'''<include />''' Включение других ресурсов, которые будет использовать данный ресурс
**'''resource:''' Название ресурса, который вы хотите чтоб стартовал с данным ресурсом
**'''minversion:''' Минимальная версия, которая должна быть у '''ресурса''' (опционально)
**'''maxversion:''' Максимальная версия, которая должна быть у '''ресурса''' (опционально)
*'''<config />''' Конфигурационный файл (.xml), к которому будет иметь доступ ресурс, допустимые параметры:
**'''src:''' Название конфигурационного файла
**'''type:''' Тип конфигурационного файла: "client" или "server"
*'''<export />''' Это экспортирует функции из данного ресурса, чтобы другие ресурсы могли ими пользоваться через [[call]]
**'''function:''' Название функции
**'''type''' Является ли экспортированная функция серверной или клиентской (допустимые значения: "server" и "client")
**'''http:''' Может ли функция быть вызвана через HTTP (true/false)
*'''<html />'''
**'''src:''' Название HTTP-файла (может быть и путем)
**'''default:''' Является ли html-файл тем, который будет показан по умолчанию при заходе в /имяРесурса/ на сервере. Только один html может быть по умолчанию, все остальные игнорируются. (true/false)
**'''raw:''' Html-файл не анализируется LUA-интерпретатором и рассматривается как двоичные данные. Обязательно должно использоваться для двоичных файлов (в основном картинок) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Большинство модов использует [[settings system]], чтобы позволить администраторам серверов настраивать его по их желанию. Например, вы можете установить время раунда, а затем воспользоваться [[get]] и [[set]] для получения или изменения значений соответственно.
*'''<min_mta_version />''' Минимальная требуемая версия для правильной работы данного ресурса. При авторинге ресурсов, обычно минимальная версия должна быть установлена на в данный момент зарелиженную версию MTA:SA (на данный момент это "{{Current Version|full}}").
**'''client:''' Минимальная версия клиента
**'''server:''' Минимальная версия сервера
*'''<aclrequest />''' Лист [[Access_Control_List|ACL]]-прав, которые понадобятся ресурсу.
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Контролирует, пересылаются ли [[Element_data|данные элементов]] карты, такие как "PosX" и "DoubleSided" клиенту. Эти данные зачастую не требуются большинству модов или ресурсов. (Но следует отметить значимое исключения - map editor). При установке параметра в meta.xml мода, настройка применится ко всем картам, загруженным данным ресурсом.
**'''false:''' Отключить пересылку данных элементов карты. Это может значительно уменьшить время закачки карты.
**'''true:''' Включить пересылку данных элементов карты (по умолчанию).
}}

== Пример ==
Вот и пример meta-файла, использующего некоторые из упомянутых тегов:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}
[[Category:Scripting Concepts]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]

PL/meta.xml

2012-09-19T20:06:06Z

Rafalh:

The ''meta.xml'' file presents MTA with a set of metadata, such as the resource's name, the scripts to include, and which files to precache for sending to clients among other things. It is also the scope of "elements". It is written in XML, which is based on HTML and is the parent of XHTML.

=Tagi=
XML jest tekstowym formatem danych, który jest stosowany do prezentacji danych. MTA wykorzystuje opartą na XML język do opisu metadanych dla zasobów przy użyciu tagów poniżej:

*'''<info />'''
** '''author:''' Autor tego zasobu.
** '''version:''' Wersja tego zasobu.
** '''name:''' Nazwa tego zasobu.
** '''description:''' Krótki opis tego zasobu.
** '''type:''' Typ tego zasobu, które mogą być w postaci "gamemode", "script", "map" i "misc".
*'''<script />''' Kod źródłowy dla tego zasobu, możliwe parametry:
** '''src:''' Nazwa pliku z kodem źródłowym
** '''type:''' Rodzaj kodu źródłowego: "client" lub "server"

*'''<map />''' Mapa do gamemode, możliwe parametry:
**'''src:''' nazwa pliku .map ( może być ścieżka np."mapy/nazwapliku.map" )
**'''dimension:''' Wymiar w którym mapa zostanie załadowana
*'''<file />''' Zdjęcia i pliki w rozmiaże .txd, .dll, .col lub .jpg.
**'''src:''' Po stronie clienta nazwa pliku ( może być też ścieżka np."zdjęcia/nazwa.jpg" )
*'''<include />''' Obejmują środki, które będą używać ten zasób
**'''resource:''' Nazwa zasobu, który chcesz uruchomić z tego zasobu
**'''minversion:''' Minimalna wersja
**'''maxversion:''' Maxsymalna wersja
*'''<config />''' Config to poprostu XML, możliwe parametry:
**'''src:''' Nazwa pliku z pliku konfiguracyjnego
**'''type:''' Typ pliku konfiguracyjnym: "client" lub "server"
*'''<export />''' Te funkcje eksportowane z tego zasobu, do innych zasobów może korzystać z nich [CALL []]
**'''function:''' Nazwa funkcji
**'''type''' Czy funkcja jest eksportowana po stronie servera lub po stronie clienta (ważne są następujące wartości: "server" i "client")
**'''http:''' Czy funkcja jest wywoływana za pośrednictwem protokołu HTTP (true / false)
*'''<html />'''
**'''src:''' Nazwa pliku HTTP (może być ścieżka)
**'''default:''' Plik html jest jeden, który jest domyślnie wyświetlane podczas wizyty/resource Name/on the server. Tylko jeden html może być domyślne, reszta jest ignorowana. (true / false)
**'''raw:''' Html nie jest przetwarzany przez interpreter LUA i jest traktowany jako dane binarne. Muszą być stosowane dla plików binarnych (zdjęcia głównie) (true / false)
*'''<settings> <setting name="" value=""/> </settings>:''' Większość gamemodes używać [[System Settings]], aby pozwolić administratorom serwerów skonfigurować go tak, jak im się podoba. Na przykład można ustawić okrągły czas, a następnie użyć [[dostać]] i [[zbiór]], aby uzyskać wartość lub ją zmienić, odpowiednio.
*'''<min_mta_version />''' Minimalne wymagania wersji dla tego zasobu do poprawnego działania. Kiedy zasoby autorskie, minimalna wersja powinna zwykle być ustawiony na bieżącej wydanej wersji MTA: SA (który w tej chwili jest "{{Current Version | pełny}}").
**'''client:''' Minimalna wersja clienta
**'''server:''' Minimalna wersja servera
*'''<aclrequest />''' Lista [[Access_Control_List | ACL]] prawa ten zasób będzie potrzebne.

== Przykład ==
Oto przykład pliku meta przy niektórych znaczników wymienionych:
{{#tag:code |
<meta>
<info name="race" author"SEBO" type="gamemode" version"1.0.0" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}
[[Category:Scripting Concepts]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[ru:Meta.xml]]

IT/Meta.xml

2012-09-19T20:05:49Z

Rafalh:

{{IT/MainP}}
[[Category:100%]]
[[Category:IT/Concetti di scripting]]
[[Category:IT/Guide e tutorial]]
Il file '''meta.xml''' è uno dei file più importanti che tutte le risorse/gamemode/mappe possono caricare. I nomi dei file che i tuoi script ([[IT/Risorsa|risorse]]) andranno scritti nel file ''meta.xml''.
Ad esempio se vuoi mostrare una immagine sullo schermo del client, il client ha prima bisogno di scaricare l'immagine. Per dire al server che vuoi usare un'immagine nello script dovrai inserire il nome del file immagine nel meta.xml.<br />
Se vuoi impostare delle opzioni nello script come variabili dovrai usare il tag <syntaxhighlight lang="lua"><settings></syntaxhighlight>.

'''Nota:''' Puoi trovare un semplice generatore di meta.xml creato da ''50p'' [http://forum.mtasa.com/viewtopic.php?f=91&t=22247 qui].

== Possibili tag ==
I tag nell'XML sono molto simili a quelli dell'HTML. Il file ''meta.xml'' ha diverse coppie di file che possono essere o meno obbligatori. Alcuni tag hanno degli attributi.

*'''<info />''' Informazioni sulla risorsa attuale, tra i parametri troviamo (è possibile anche creare dei parametri personalizzati, leggibili tramite [[IT/getResourceInfo|getResourceInfo]]):
** '''author:''' L'autore della risorsa.
** '''version:''' La versione attuale della risorsa.
** '''name:''' Il nome della risorsa.
** '''description:''' Una breve descrizione della risorsa.
** '''type:''' Il tipo di risorsa, che può essere "gamemode", "script" o "map".
*'''<script />''' Il codice sorgente della risorsa, tra i cui parametri abbiamo:
** '''src:''' Il nome del file del sorgente.
** '''type:''' Il tipo di sorgente: "client" o "server".
*'''<map />''' Le mappe della gamemode, tra i cui parametri troviamo:
**'''src:''' Il nome o il percorso del file .map (es: "mappe/nomefile.map")
*'''<file />''' I file client-side. In genere si tratta di file texture (.txd), [[IT/Elemento/Collision shape|collision shapes]] (.col), immagini o modelli 3D (.dff). Questi file verranno scaricati automaticamente dal client.
**'''src:''' Nome o il percorso del file client-side (es: "immagini/immagine.png")
*'''<include />''' Risorse da includere in quella attuale.
**'''resource:''' Nome della risorsa da avviare insieme a quella attuale.
*'''<config />''' Un file di configurazione (.xml) a cui la risorsa può accedere, tra i parametri troviamo:
**'''src:''' Nome del file di configurazione.
**'''type:''' Tipo del file di configurazione: "client" o "server".
*'''<export />''' Le funzioni che la risorsa esporterà, cosicché le altre risorse possano chiamarle con [[IT/call|call]].
**'''function:''' Il nome della funzione.
**'''http:''' Se la funzione può essere chiamata via HTTP (true/false).
*'''<html />'''
**'''src:''' Il nome del file HTML (può anche essere un percorso).
**'''default:''' Se il file HTML viene mostrato di default quando si va in remoto su <syntaxhighlight lang="lua">/resourceName/</syntaxhighlight>. Un solo file HTML può essere default, gli altri vengono ignorati (true/false).
**'''raw:''' Se il file HTML non deve essere processato dall'interprete LUA, e viene trattato come dati binari. Deve essere usato per file binari (in genere immagini) (true/false).
*'''<settings> </settings>'''

== Esempio ==
Questo è un esempio di file XML che utilizza alcuni dei tag sopra descritti:
<syntaxhighlight lang="xml"><meta>
<info author="Pinco" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta></syntaxhighlight>

[[cs:Meta.xml]]
[[de:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

ES/Sobre el archivo "meta.xml"

2012-09-19T20:04:57Z

Rafalh:

El archivo ''meta.xml'' presenta un conjunto de datos, como el nombre del resource, los scripts para incluir en el resource, qué archivos enviar a los clientes, entre otras cosas. Es también el ámbito de aplicación de los ''elementos''. Está escrito en XML, que se basa en HTML y es el pariente de XHTML.

==Tags==
XML es un formato de datos de texto que es ampliamente utilizado para la representación de datos. MTA utiliza un lenguaje basado en XML para describir los datos de los recursos mediante el uso de las etiquetas a continuación:

*'''<info />''' Información sobre este ''resource'', los posibles parámetros (que se pueden utilizar y leer con [[getResourceInfo]]) son:
** '''author:''' El autor del'' resource''.
** '''version:''' La versión del ''resource''.
** '''name:''' El nombre del ''resource''.
** '''description:''' La descripción sobre el ''resource''.
** '''type:''' El tipo de ''resource'' (puede ser "gamemode", "script", "map" o "misc").
*'''<script />''' Script. Para para el resource, los atributos pueden ser:
** '''src:''' El nombre del archivo del script.
** '''type:''' El tipo de script: "client" (cliente) o "server" (servidor).
*'''<map />''' El mapa para gamemode, los posibles parámetros son:
**'''src:''' Nombre del archivo '''.map''' (la ruta puede ser, por ejemplo, "mapas/mi-mapa-freeroam.map").
**'''dimension:''' Dimensión en la que el mapa será cargado (opcional).
*'''<file />''' Un archivo de cliente. Generalmente se usan imágenes, archivos '''.txd''', '''.col''', '''.dff''' o archivos '''.xml'''. Estos se cargan por el cliente cuando el archivo está iniciado.
**'''src:''' Nombre del archivo client-side (La ruta puede ser, por ejemplo, "imagenes/imagen.png")
*'''<include />''' Para incluir ''resources'' extras, que se carguen con el '''resource''' que modificas.
**'''resource:''' El nombre del ''resource''.
**'''minversion:''' Versión mínima que el ''resource'' debe tener (opcional).
**'''maxversion:''' Versión máxima que el ''resource'' debe tener (opcional).
*'''<config />''' Configuración del archivo '''.xml''' con el que se puede acceder a los parámetros del resource:
**'''src:''' La ruta del archivo de configuración.
**'''type:''' El tipo de archivo de configuración. Puede ser "client" o "server".
*'''<export />''' Las funciones de esta exportacion para el resource, para otros recursos se pueden utilizar con [[call]]
**'''function:''' El nombre de la función.
**'''type''' El lado de la exportación (cliente o servidor). Los valores válidos son "server" y "client".
**'''http:''' Si la función se usa a través de HTTP. Se puede usar "true" o "false".
*'''<html />'''
**'''src:''' La ruta del archivo.
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.
*'''<min_mta_version />''' Minimum version requirements for this resource to run correctly. When authoring resources, the minimum version should usually be set to the current released version of MTA:SA (which at the moment is "{{Current Version|full}}").
**'''client:''' The minimum client version
**'''server:''' The minimum server version

== Ejemplo ==
Heres an example of a meta file using some of the tags mentioned:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta>
|lang="xml"}}

==Traductores==

*Benxamix2/The Kid
*pekio123

[[Category:Scripting Concepts]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[en:Meta.xml]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

DE/Meta.xml

2012-09-19T20:04:06Z

Rafalh:

Die ''meta.xml'' gibt MTA Informationen über die Resource. Beispiele dafür sind Ressourcenname, eingebundene Scripts und Dateien wie Grafiken und ähnliches. Benutzt wird hier die Auszeichnungssprache [http://de.wikipedia.org/wiki/XML XML].

== Tags ==
Folgende XML-Tags können verwenden werden:
*'''<info />''' Information über die Ressource (können via [[getResourceInfo]] eingelesen werden):
**'''author:''' Der Autor der Ressource
**'''version:''' Version der Ressource
**'''name:''' Name der Ressource
**'''description:''' Kurze Beschreibung der Ressource
**'''type:''' Typ der Ressource. Möglichkeiten sind: "gamemode", "script", "map" oder "misc"
*'''<script />''' Skriptdateien für diese Ressource, mögliche Attribute sind:
**'''src:''' Pfad zum Skript
**'''type:''' Typ: "client" oder "server"
*'''<map />''' Map für den Gamemode. Möglich ist:
**'''src:''' Pfad zur .map Datei
**'''dimension:''' Dimension, in der die Map erstellt wird
*'''<file />''' Datei: Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betritt.
**'''src:''' Pfad zur Datei
**'''download:''' wird in Version 1.4 eingeführt und gibt an, ob eine Datei beim Ressourcenstart heruntergeladen werden soll
*'''<include />''' Ressource einbringen, welche diese Ressource benutzen wird
**'''minversion:''' Minimale Version
**'''maxversion:''' Maximale Version
*'''<config />''' Konfigurationsdatei (.xml), möglich sind:
**'''src:''' Dateiname der Konfigurationsdatei
**'''type:''' Typ der Konfigurationsdatei: "client" oder "server"
*'''<export />''' Export von Funktionen dieser Ressource. Andere Resourcen können dadurch Zugriff erlangen.
**'''function:''' Funktionsname
**'''http:''' Kann die Ressource via HTTP geöffnet werden? (true/false)
*'''<html />'''
**'''src:''' Dateiname für die HTML Datei (kann ein Pfad sein)
**'''default:''' Standard HTMl-Datei, welche durch den Besuch von /resourceName/ geöffnet wird. Nur eine Datei kann als ''default'' markiert werden (true/false)
**'''raw:''' Gibt an, ob eine Datei nicht vom Lua-Interpreter analysiert und als binäre Datei verwendet werden soll. Dieses Attribut wird vor allem für Bilder benutzt (true/false)
*'''<settings>''' <setting name="" value=""/> </settings>: Viele Spielmodi benutzen diese Option, um Einstellungen, die leicht geändert werden können, festzulegen
*'''<min_mta_version />''' Minimale MTA Version
**'''client:''' Minimale Client Version
**'''server:''' Minimale Server Version
*'''<aclrequest />''' Eine Liste mit [[Access_Control_List|ACL]] Rechten, die die Ressource braucht
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Sollen [[Element_data|Element Datas]] wie "PosX" und "DoubleSided" mit dem Client synchronisiert werden? Diese Einstellung ist für die meisten Ressourcen nicht von Bedeutung. (Eine erwähnenswerte Ressource ist der Map Editor). Diese Einstellung bezieht sich auf alle Maps der Ressource.
**'''false:''' Deaktiviert die Übertragung der Element Datas. Dies kann die Downloadzeit erheblich verkürzen.
**'''true:''' Aktiviert die Übertragung der Element Datas (Standard)
}}

== Beispiel ==
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />
<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}

[[Category:DE/Skripting Konzepte]]

[[cs:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

CS/Meta.xml

2012-09-19T20:03:20Z

Rafalh:

Soubor ''meta.xml'' prezentuje MTA sbirkou ''metadat'', jako je nazev ''resource'', scripty ktere ma obsahovat, a jake soubory maji byt nacteny pro poslani clientum. Je to take rozsah "elementu". Je psana v XML, ktera je zalozena na HTML a je pribuzny XHTML.

=Tagy=
XML je textovy format dat format ktery je bezne pouzivan pro prezentovani dat. MTA pouziva na XML zalozeny jazyk pro popsani metadat pro resource uzitim tagu nize:

*'''<info />''' Informace o tomto resource, mozne parametry jsou (jakekoliv parametry muzou byt pouzity a vypsany pomoci [[getResourceInfo]][[Image:usen.gif|Pouze v Angličtině]]):
** '''author:''' Autor tohoto reource
** '''version:''' Verze resource
** '''name:''' Nazev resource
** '''description:''' Strucny popis resource
** '''type:''' Typ resource, ten muze byt "gamemode", "script", "map" nebo "misc".
*'''<script />''' Zdrojove kody pro resource, mozne parametry jsou:
** '''src:''' Nazev souboru skriptu
** '''type:''' Typ kodu: "client" nebo "server"
*'''<map />''' Mapa pro herni mod, mozne parametry jsou:
**'''src:''' .map soubor (muze byt take cesta napr. "mapy/nazev.map")
**'''dimension:''' Dimenze ve ktere bude mapa nactena (volitelne)
*'''<file />''' client-side soubor. Obecne jsou to obrazky, .txd, .col, .dff nebo .xml files. Tyto soubory budou stazeny klienty kdyz bude resource zapnut (nebo pri pripojeni)
**'''src:''' nazev client-side souboru (muze byt i cesta napr. "images/image.png")
*'''<include />''' Obsahuje jine resource ktere tento resource vyuzije, mozne parametry:
**'''resource:''' Nazev resource ktery chcete spustit spolecne s timto
**'''minversion:''' Minimalni verze '''resource''' (volitelne)
**'''maxversion:''' Maximalni verze '''resource''' (volitelne)
*'''<config />''' Konfiguracni soubor (.xml) ktery muze resource vyuzit, mozne parametry jsou:
**'''src:''' Nazev konfiguracniho souboru
**'''type:''' Typ souboru: "client" nebo "server"
*'''<export />''' Toto exportuje funkce z tohoto reosurce, takze ostatni resource je muzou vyuzit pomoci [[call]][[Image:usen.gif|Pouze v Angličtině]]
**'''function:''' Nzev funkce
**'''type''' Jaky je typ exportovane funkce server-side nebo client-side (spravne hodnoty: "server" a "client")
**'''http:''' Muze byt funkce vyvolana pomoci HTTP (true/false)
*'''<html />'''
**'''src:''' Nazev HTTP souboru (muze byt cesta)
**'''default:''' HTML soubor ktery je zobrazen defaultne pri navsteve /nazevResource/ na serveru. Pouze jeden HTML soubor muze byt vychozi, ostatni jsou ignorovany. (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Vetsina gamemodu pouziva [[settings system]][[Image:usen.gif|Pouze v Angličtině]] Aby ho administratori serveru mohli nastavit jak chteji. Muzete pouzit funkce [[get]][[Image:usen.gif|Pouze v Angličtině]] a [[set]][[Image:usen.gif|Pouze v Angličtině]] pro zjisteni hodnoty nebo pro jeji zmenu.
*'''<min_mta_version />''' Minimalni verze MTA ktera je potreba pro spravne fungovani resource. Kdyz vydavate resource, mela by byt tato hodnota nastavena na aktualni posledni vydanou verzi MTA (ktera nyni je "{{Current Version|full}}").
**'''client:''' Minimalni verze clienta
**'''server:''' Maximalni verze clienta

== Priklad ==
Zde je priklad mety vyuzivajici tagy zminene vyse:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta>
|lang="xml"}}
''Omlouvam se za preklad bez diakritiky.''
[[Category:Cesky]]
[[de:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

Meta.xml

2012-09-19T20:02:36Z

Rafalh:

The ''meta.xml'' file presents MTA with a set of metadata, such as the resource's name, the scripts to include, and which files to precache for sending to clients among other things. It is also the scope of "elements". It is written in XML, which is based on HTML and is the parent of XHTML.

=Tags=
XML is a textual data format which is widely used for the representation of data. MTA uses an XML-based language to describe the metadata for resources by using the tags below:

*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
** '''author:''' The author of this resource
** '''version:''' The version of this resource
** '''name:''' The name of this resource
** '''description:''' A brief description of this resource
** '''type:''' The type of this resource, that can be "gamemode", "script", "map" or "misc".
*'''<script />''' Source code for this resource, possible parameters are:
** '''src:''' The file name of the source code
** '''type:''' The type of source code: "client" or "server"

*'''<map />''' The map for a gamemode, possible parameters are:
**'''src:''' .map file name (can be path too eg. "maps/filename.map")
**'''dimension:''' Dimension in which the map will be loaded (optional)
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)
**'''src:''' client-side file name (can be path too eg. "images/image.png")
**'''download:''' Whether or not to be sent to the client automatically (optional). Default is "true" using "no" or "false" will mean they are not sent on resource start but could later be used by [[downloadFile]] (from version 1.4)
*'''<include />''' Include resources that this resource will use
**'''resource:''' Resource name that you want to start with this resource
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:
**'''src:''' The file name of the config file
**'''type:''' The type of the config file: "client" or "server"
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]
**'''function:''' The function name
**'''type''' Whether function is exported server-side or client-side (valid values are: "server" and "client")
**'''http:''' Can the function be called via HTTP (true/false)
*'''<html />'''
**'''src:''' The filename for the HTTP file (can be a path)
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.
*'''<min_mta_version />''' Minimum version requirements for this resource to run correctly. When authoring resources, the minimum version should usually be set to the current released version of MTA:SA (which at the moment is "{{Current Version|full}}"). See example for example.
**'''client:''' The minimum client version
**'''server:''' The minimum server version
*'''<aclrequest />''' A list of [[Access_Control_List|ACL]] rights this resource will need.
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Controls whether map [[Element_data|element data]] such as "PosX" and "DoubleSided" are transferred to the client. This data is usually not required by most gamemodes or resources. (One notable exception is the editor). When set in a gamemode meta.xml, the setting will apply to all maps loaded by that resource.
**'''false:''' Disable transfer of map element data. This can reduce map download times considerably.
**'''true:''' Enable transfer of map element data (default).
}}

== Example ==
Heres an example of a meta file using some of the tags mentioned:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}
[[Category:Scripting Concepts]]
[[cs:Meta.xml]]
[[de:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

Meta.xml

2012-09-19T20:00:33Z

Rafalh: Add Italian

The ''meta.xml'' file presents MTA with a set of metadata, such as the resource's name, the scripts to include, and which files to precache for sending to clients among other things. It is also the scope of "elements". It is written in XML, which is based on HTML and is the parent of XHTML.

=Tags=
XML is a textual data format which is widely used for the representation of data. MTA uses an XML-based language to describe the metadata for resources by using the tags below:

*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
** '''author:''' The author of this resource
** '''version:''' The version of this resource
** '''name:''' The name of this resource
** '''description:''' A brief description of this resource
** '''type:''' The type of this resource, that can be "gamemode", "script", "map" or "misc".
*'''<script />''' Source code for this resource, possible parameters are:
** '''src:''' The file name of the source code
** '''type:''' The type of source code: "client" or "server"

*'''<map />''' The map for a gamemode, possible parameters are:
**'''src:''' .map file name (can be path too eg. "maps/filename.map")
**'''dimension:''' Dimension in which the map will be loaded (optional)
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)
**'''src:''' client-side file name (can be path too eg. "images/image.png")
**'''download:''' Whether or not to be sent to the client automatically (optional). Default is "true" using "no" or "false" will mean they are not sent on resource start but could later be used by [[downloadFile]] (from version 1.4)
*'''<include />''' Include resources that this resource will use
**'''resource:''' Resource name that you want to start with this resource
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:
**'''src:''' The file name of the config file
**'''type:''' The type of the config file: "client" or "server"
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]
**'''function:''' The function name
**'''type''' Whether function is exported server-side or client-side (valid values are: "server" and "client")
**'''http:''' Can the function be called via HTTP (true/false)
*'''<html />'''
**'''src:''' The filename for the HTTP file (can be a path)
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.
*'''<min_mta_version />''' Minimum version requirements for this resource to run correctly. When authoring resources, the minimum version should usually be set to the current released version of MTA:SA (which at the moment is "{{Current Version|full}}"). See example for example.
**'''client:''' The minimum client version
**'''server:''' The minimum server version
*'''<aclrequest />''' A list of [[Access_Control_List|ACL]] rights this resource will need.
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Controls whether map [[Element_data|element data]] such as "PosX" and "DoubleSided" are transferred to the client. This data is usually not required by most gamemodes or resources. (One notable exception is the editor). When set in a gamemode meta.xml, the setting will apply to all maps loaded by that resource.
**'''false:''' Disable transfer of map element data. This can reduce map download times considerably.
**'''true:''' Enable transfer of map element data (default).
}}

== Example ==
Heres an example of a meta file using some of the tags mentioned:
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />

<sync_map_element_data>false</sync_map_element_data>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}
[[Category:Scripting Concepts]]
[[cs:Meta.xml]]
[[ru:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[pl:Meta.xml]]
[[de:Meta.xml]]
[[it:Meta.xml]]

OnClientGUITabSwitched

2012-04-14T20:18:59Z

Rafalh: Maybe its a bug in MTA?

{{Client event}}
__NOTOC__
This event is triggered each time the user switch from GUI tab.

==Parameters==
<syntaxhighlight lang="lua">
element theElement
</syntaxhighlight>
* '''theElement''': The tab which was selected.

==Source==
The [[event system#Event source|source]] of this event is the tab.

==Example==
This example creates a window with a tabpanel with two tabs. Every time a user changes tabpage a notification will be shown.

First we'll create the window. Then add a tabpanel and couple tabs with some labels in them. Qoute: [[GuiCreateWindow#Example]]
<syntaxhighlight lang="lua">
local myWindow = guiCreateWindow ( 0, 0, 0.5, 0.4, "Information", true ) -- create a window which has "Information" in the title bar.
local tabPanel = guiCreateTabPanel ( 0, 0.1, 1, 1, true, myWindow ) -- create a tab panel which fills the whole window
local tabMap = guiCreateTab( "Map Information", tabPanel ) -- create a tab named "Map Information" on 'tabPanel'
local tabHelp = guiCreateTab( "Help", tabPanel ) -- create another tab named "Help" on 'tabPanel'

-- adds a label (text) to each tab
guiCreateLabel( 0.02, 0.04, 0.94, 0.2, "This is information about the current map", true, tabMap )
guiCreateLabel( 0.02, 0.04, 0.94, 0.92, "This is help text.", true, tabHelp )
</syntaxhighlight>

Now let's add the event handler.
<syntaxhighlight lang="lua">

function OnChange( selectedTab )

-- If there is a selected tab.
if selectedTab ~= nil then

outputChatBox( "You've changed your active tab." )

end

end

addEventHandler("onClientGUITabSwitched", getRootElement( ), OnChange)
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

Template:Client utility functions

2012-04-10T14:41:50Z

Rafalh: Added missing getColorFromString

* [[getDistanceBetweenPoints2D]]
* [[getDistanceBetweenPoints3D]]
* [[getEasingValue]]
* [[interpolateBetween]]
* [[getColorFromString]]
* [[getRealTime]]
* [[getTickCount]]
* [[getTimerDetails]]
* [[getNetworkStats]]
* [[setClipboard]]
* [[getTimers]]
* [[gettok]]
* [[killTimer]]
* [[resetTimer]]
* [[setTimer]]
* [[split]]
* [[getVersion]]
* [[isTimer]]
* [[md5]]
* [[tocolor]]

* [[utfChar]]
* [[utfCode]]
* [[utfLen]]
* [[utfSeek]]
* [[utfSub]]
{{New items|3.0120|1.2|
* [[toJSON]]
* [[fromJSON]]
* [[setDevelopmentMode]]
* [[getDevelopmentMode]]
}}
{{New items|3.0151|1.3.1|
* [[downloadFile]]
}}
<noinclude>[[Category:Functions templates]]</noinclude>

OnClientResourceStop

2010-12-18T23:35:28Z

Rafalh: Source element of onClientResourceStop is root element of the resource

{{Client event}}
__NOTOC__
This event is triggered when a [[resource]] is stopped.

==Parameters==
<syntaxhighlight lang="lua">
resource stoppedResource
</syntaxhighlight>

*'''stoppedResource''': the [[resource]] that was stopped.

==Source==
The [[event system#Event source|source]] of this event is the stoped resource's [[root element]].

==Example==
This example outputs name of resource that was started.
<syntaxhighlight lang="lua">
addEventHandler( "onClientResourceStop", getRootElement( ),
function ( stoppedRes )
outputChatBox( "Resource stopped: " .. getResourceName( stoppedRes ) );
end
);
</syntaxhighlight>

==See Also==
===Client resource events===
{{Client_resource_events}}
===Client event functions===
{{Client_event_functions}}