FR/Meta.xml: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "Le ficher ''meta.xml'' 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 th...")
 
No edit summary
Line 3: Line 3:
Note: Vous pouvez essayer le generateur de Meta.xml crée par 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247
Note: Vous pouvez essayer le generateur de Meta.xml crée par 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247


=Tags=
=Balises=
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:
XML est un format de donnée textuel (par balisage) qui est largement utilisé pour la représentation de donnée. MTA utilise un langage basé sur XML pour décrire les métadonnées des ressources en utilisant les balises suivantes:


*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
*'''<info />''' Informations sur la ressource. Quelques paramètres possibles (tous paramètres arbitraire peut être utilsé/lu avec[[getResourceInfo]]):
** '''author:''' L'auteur de la ressource
** '''author:''' L'auteur de la ressource
** '''version:''' La version de la ressource
** '''version:''' La version de la ressource
Line 17: Line 17:
*'''<map />''' La map pour le gamemode, les paramètres possibles sont:
*'''<map />''' La map pour le gamemode, les paramètres possibles sont:
**'''src:''' Nom du fichier .map (Peut être distant. "maps/filename.map")
**'''src:''' Nom du fichier .map (Peut être distant. "maps/filename.map")
*'''<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)
*'''<file />''' Fichier côté client. Principalement des images, .txd, .col, .dff or .xml files. Ces fichiers seront téléchargés par le client lorsque la ressource sera chargée/lancée (ou lors de la connexion)
**'''src:''' client-side file name (can be path too eg. "images/image.png")
**'''src:''' le nom du fichier (peut être un chemin, ex: "images/image.png")
*'''<include />''' Include resources that this resource will use
*'''<include />''' Ressource(s) utilisée(s) par votre ressource
**'''resource:''' Resource name that you want to start with this resource
**'''resource:''' Nom d'une ressource qui sera chargée
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)
**'''minversion:''' Version minimum de cette '''resource''' (optionnel)
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)
**'''maxversion:''' Version maximum de cette '''resource''' (optionnel)
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:
*'''<config />''' Fichier de configuration (.xml) auquel la ressource peut accéder, les paramètres possibles sont:
**'''src:''' The file name of the config file
**'''src:''' Nom du fichier de configuration
**'''type:''' The type of the config file: "client" or "server"
**'''type:''' Type de fichier: "client" ou "server"
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]
*'''<export />''' Utilisé ceci pour exporter des fonctions, de votre ressource, qui pourront être utilisées par d'autres ressources [[call]]
**'''function:''' The function name
**'''function:''' Nom de la fonction
**'''type''' Whether function is exported server-side or client-side (valid values are: "server" and "client")
**'''type''' Si la fonction est côté client ou serveur (valeurs valides: "server" et "client")
**'''http:''' Can the function be called via HTTP (true/false)
**'''http:''' Permettre d'appeler la fonction via HTTP (true/false)
*'''<html />'''
*'''<html />'''
**'''src:''' The filename for the HTTP file (can be a path)
**'''src:''' Le nom du fichier HTTP (peut être un chemin)
**'''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)
**'''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)
**'''raw:''' Le fichier html n'est pas analyser par l'intrepreteur LUA et est traité comme une donnée binaire. Doit être utiliser pour les données binaires (images principalement) (truel/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.
*'''<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.


== Example ==
== Example ==
Heres an example of a meta file using some of the tags mentioned:
Un exemple de fichier ''meta'' utilisant quelques unes de ces balises :
<syntaxhighlight lang="lua" lang="xml"><meta>
<syntaxhighlight lang="lua" lang="xml"><meta>
     <info author="Slothman" type="gamemode" name="Stealth" />
     <info author="Slothman" type="gamemode" name="Stealth" />

Revision as of 09:52, 10 July 2014

Le ficher meta.xml 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.

Note: Vous pouvez essayer le generateur de Meta.xml crée par 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247

Balises

XML est un format de donnée textuel (par balisage) qui est largement utilisé pour la représentation de donnée. MTA utilise un langage basé sur XML pour décrire les métadonnées des ressources en utilisant les balises suivantes:

  • <info /> Informations sur la ressource. Quelques paramètres possibles (tous paramètres arbitraire peut être utilsé/lu avecgetResourceInfo):
    • author: L'auteur de la ressource
    • version: La version de la ressource
    • name: Le nom de la ressource
    • description: Une petite description de la ressource
    • type: Le type de ressource, ça peut être "gamemode", "script", "map" ou "misc".
  • <script /> Le code source de la ressource, les paramètres possibles sont:
    • src: Le nom du fichier
    • type: Le type du code source: "client" ou "server"
  • <map /> La map pour le gamemode, les paramètres possibles sont:
    • src: Nom du fichier .map (Peut être distant. "maps/filename.map")
  • <file /> Fichier côté client. Principalement des images, .txd, .col, .dff or .xml files. Ces fichiers seront téléchargés par le client lorsque la ressource sera chargée/lancée (ou lors de la connexion)
    • src: le nom du fichier (peut être un chemin, ex: "images/image.png")
  • <include /> Ressource(s) utilisée(s) par votre ressource
    • resource: Nom d'une ressource qui sera chargée
    • minversion: Version minimum de cette resource (optionnel)
    • maxversion: Version maximum de cette resource (optionnel)
  • <config /> Fichier de configuration (.xml) auquel la ressource peut accéder, les paramètres possibles sont:
    • src: Nom du fichier de configuration
    • type: Type de fichier: "client" ou "server"
  • <export /> Utilisé ceci pour exporter des fonctions, de votre ressource, qui pourront être utilisées par d'autres ressources call
    • function: Nom de la fonction
    • type Si la fonction est côté client ou serveur (valeurs valides: "server" et "client")
    • http: Permettre d'appeler la fonction via HTTP (true/false)
  • <html />
    • src: Le nom du fichier HTTP (peut être un chemin)
    • 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: Le fichier html n'est pas analyser par l'intrepreteur LUA et est traité comme une donnée binaire. Doit être utiliser pour les données binaires (images principalement) (truel/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.

Example

Un exemple de fichier meta utilisant quelques unes de ces balises :

<meta>
    <info author="Slothman" 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]" /> <!-- round length in minutes -->
	 <setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on -->
	 <setting name="teambalance" value="[1]" /> <!--  difference limit of amount of players between teams -->
	 <setting name="spazammo" value="[25]" /> <!-- ammo amounts -->
	 <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>