DE/Meta.xml: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "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. E...")
 
No edit summary
(11 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" />
 
    <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]" />
<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]]

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>