ES/Sobre el archivo "meta.xml"

From Multi Theft Auto: Wiki
Revision as of 19:44, 17 December 2011 by The Kid (talk | contribs)
Jump to navigation Jump to search

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 "1.6.0").
    • client: The minimum client version
    • server: The minimum server version

Example

Heres an example of a meta file using some of the tags mentioned: <meta>

   <info author="Slothman" type="gamemode" name="Stealth" />
   <config src="help.xml" type="client"/>
   <min_mta_version client="1.6.0" server="1.6.0" />
   <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>