DE/Meta.xml: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
(10 intermediate revisions by 6 users not shown)
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 ==
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"
**'''cache:''' Funktioniert nur bei clientseitigen Scripts. Standardwert ist "true". Bei "false" wird die Datei nicht auf der Festplatte gespeichert
**'''validate:''' Wenn "false" wird das Script nicht auf Kompatibilität geprüft.
*'''<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 einbinden, welche diese Ressource benutzen wird
**'''resource:''' Der Name der Ressource, die inkludiert werden soll
**'''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:syntaxhighlight |
<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" />


== Tags ==
    <include resource="scoreboard" />
XML ist ein Datenformat, welches für die Representation von Daten benutzt wird.
    <include resource="killmessages" />
     <info /> Information über die Resource, :
     <include resource="maplimits" />
        author: Der Author der Resource
 
        version: Entwicklungsversion der Resource
    <settings>
        name: Name der Resource
        <setting name="roundlimit" value="[6]" /> <!-- round length in minutes -->
        description: Beschreibung der Resource
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on -->
        type: Typ der Resource. Verfügbar sind: "gamemode", "script", "map" oder "misc".
<setting name="teambalance" value="[1]" /> <!--  difference limit of amount of players between teams -->
    <script /> Quellcode für diese Resource, mögliche Parameter sind:
<setting name="spazammo" value="[25]" /> <!-- ammo amounts -->
        src: Dateiname des Quellcodes
<setting name="m4ammo" value="[100]" />
        type: Typ des Quellcodes: "client" oder "server"  
<setting name="shotgunammo" value="[25]" />
    <map /> Map für den Gamemode. Möglich ist:
<setting name="sniperammo" value="[20]" />
        src: .map <Name>  
<setting name="ak47ammo" value="[120]" />
        dimension: Dimension in der die Map erstellt wird
<setting name="rifleammo" value="[40]" />
    <file /> Client-Seitige Datei. Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betreten hat.
<setting name="deserteagleammo" value="[45]" />
        src: Client-Seitiger Dateiname
<setting name="pistolammo" value="[132]" />
        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)
<setting name="uziammo" value="[150]" />
    <include /> Include resources that this resource will use
<setting name="tec9ammo" value="[150]" />
        resource: Resource name that you want to start with this resource
<setting name="silencedammo" value="[65]" />
        minversion: Minimum version that resource needs to be (optional)
<setting name="grenadeammo" value="[4]" />
        maxversion: Maximum version that resource needs to be (optional)
<setting name="satchelammo" value="[4]" />
    <config /> Config file (.xml) can be accessed by resource, possible parameters are:
<setting name="teargasammo" value="[4]" />
        src: The file name of the config file
<setting name="molatovammo" value="[4]" />
        type: The type of the config file: "client" or "server"  
<setting name="isAllowedToShoot" value="true" />
    <export /> This exports functions from this resource, so other resources can use them with call
    </settings>
        function: The function name
 
        type Whether function is exported server-side or client-side (valid values are: "server" and "client")
    <aclrequest>
        http: Can the function be called via HTTP (true/false)
<right name="function.startResource" access="true" />
    <html />
<right name="function.stopResource" access="true" />
        src: The filename for the HTTP file (can be a path)
<right name="function.setPlayerMuted" access="true" />
        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)
    </aclrequest>
        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.
</meta>
    <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").
|lang="xml"}}
        client: The minimum client version
 
        server: The minimum server version
 
    <aclrequest /> A list of ACL rights this resource will need.
[[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]]

Revision as of 17:40, 24 September 2016

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 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"
    • cache: Funktioniert nur bei clientseitigen Scripts. Standardwert ist "true". Bei "false" wird die Datei nicht auf der Festplatte gespeichert
    • validate: Wenn "false" wird das Script nicht auf Kompatibilität geprüft.
  • <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 einbinden, welche diese Ressource benutzen wird
    • resource: Der Name der Ressource, die inkludiert werden soll
    • 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 ACL Rechten, die die Ressource braucht
  • <sync_map_element_data /> Sollen 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

<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" />
    <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>