DE/Meta.xml: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(some corrections)
Line 1: Line 1:
Die meta.xml stellt MTA mit einem Satz von Metadaten, wie z. B. der Ressource Name, den Skripten enthalten und welche Dateien precache für den Versand an Kunden unter anderem. Es ist auch der Umfang der "Elemente". Es wird in XML erstellt, was auf HTML basiert und ist die Überstufe von XHTML.
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 ==
== Tags ==
XML ist ein Datenformat, welches für die Representation von Daten benutzt wird.
Folgende XML-Tags können verwenden werden:
    <info /> Information über die Resource, :
*'''<info />''' Information über die Ressource (können via [[getResourceInfo]] eingelesen werden):
        author: Der Author der Resource
**'''author:''' Der Author der Ressource
        version: Entwicklungsversion der Resource
**'''version:''' Version der Ressource
        name: Name der Resource
**'''name:''' Name der Ressource
        description: Beschreibung der Resource
**'''description:''' Kurze Beschreibung der Ressource
        type: Typ der Resource. Verfügbar sind: "gamemode", "script", "map" oder "misc".
**'''type:''' Typ der Ressource. Möglichkeiten sind: "gamemode", "script", "map" oder "misc"
    <script /> Quellcode für diese Resource, mögliche Parameter sind:
*'''<script />''' Skriptdateien für diese Ressource, mögliche Attribute sind:
        src: Dateiname des Quellcodes
**'''src:''' Pfad zum Skript
        type: Typ des Quellcodes: "client" oder "server"  
**'''type:''' Typ: "client" oder "server"  
    <map /> Map für den Gamemode. Möglich ist:
*'''<map />''' Map für den Gamemode. Möglich ist:
        src: .map <Name>
**'''src:''' Pfad zur .map Datei
        dimension: Dimension in der die Map erstellt wird
**'''dimension:''' Dimension, in der die Map erstellt wird
    <file /> Client-Seitige Datei. Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betreten hat.
*'''<file />''' Datei: Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betritt.
        src: Client-Seitiger Dateiname
**'''src:''' Pfad zur Datei
        download: Wird in Version 1.4 eingeführt
**'''download:''' wird in Version 1.4 eingeführt und gibt an, ob eine Datei beim Ressourcenstart heruntergeladen werden soll
    <include /> Resource einbringen welche diese Resource benutzen wird
*'''<include />''' Ressource einbringen, welche diese Ressource benutzen wird
        minversion: Minimale Version
**'''minversion:''' Minimale Version
        maxversion: Maximale Version
**'''maxversion:''' Maximale Version
    <config /> Konfigurationsdatei (.xml), Möglich sind:
*'''<config />''' Konfigurationsdatei (.xml), möglich sind:
        src: Dateiname der Konfigurationsdatei
**'''src:''' Dateiname der Konfigurationsdatei
        type: Typ der Konfigurationsdatei: "client" oder "server"  
**'''type:''' Typ der Konfigurationsdatei: "client" oder "server"  
    <export /> Diese Funktion exportiert von dieser Resource, andere Resourcen können dadurch hierdrauf Zugriff erlangen.
*'''<export />''' Export von Funktionen dieser Ressource. Andere Resourcen können dadurch Zugriff erlangen.
        function: Der Funktionsname
**'''function:''' Funktionsname
        http: Kann die Resource per HTTP öffnen (true/false)
**'''http:''' Kann die Ressource via HTTP geöffnet werden? (true/false)
    <html />
*'''<html />'''
        src: Dateiname für die HTTP Datei (Kann ein Pfad sein)
**'''src:''' Dateiname für die HTML Datei (kann ein Pfad sein)
        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:''' Standard HTMl-Datei, welche durch den Besuch von /resourceName/ geöffnet wird. Nur eine Datei kann als ''default'' markiert werden (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:''' Gibt an, ob eine Datei nicht vom Lua Interpreter interpretiert werden soll. Dieses Attribut wird vor allem für Bilder benutzt (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.
*'''<settings>''' <setting name="" value=""/> </settings>: Viele Spielmodi benutzen diese Option, um Einstellungen, die leicht geändert werden können, festzulegen
    <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.3.0").
*'''<min_mta_version />''' Minimale MTA Version
        client: The minimum client version
**'''client:''' Minimale Client Version
        server: The minimum server version
**'''server:''' Minimale Server Version
    <aclrequest /> A list of ACL rights this resource will need.
*'''<aclrequest />''' Eine Liste mit ACL Rechten, die die Ressource brauch

Revision as of 18:02, 22 August 2012

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 XML.

Tags

Folgende XML-Tags können verwenden werden:

  • <info /> Information über die Ressource (können via getResourceInfo eingelesen werden):
    • author: Der Author 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 interpretiert 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 ACL Rechten, die die Ressource brauch