RU/Meta.xml: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 14: Line 14:
** '''description:''' Описание
** '''description:''' Описание
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
*'''<script />''' Source code for this resource, possible parameters are:
*'''<script />''' Исходный код для этого ресурса, возможные параметры:
** '''src:''' The file name of the source code
** '''src:''' Имя файла исходного кода
** '''type:''' The type of source code: "client" or "server"
** '''type:''' Тип исходного кода: "Client" или "Server"
*'''<map />''' The map for a gamemode, possible parameters are:
*'''<map />''' Карта для режима игры, возможность параметрами являются:
**'''src:''' .map file name (can be path too eg. "maps/filename.map")
**'''src:''' .map имя файла (Может лежать в других папках. Например: "maps/filename.map")
**'''dimension:''' Dimension in which the map will be loaded (optional)
**'''dimension:''' Объём, в котором карта будет загружена (по желанию)
*'''<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 />''' Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с клиента, когда ресурс запустится (Или при присоединении)
**'''src:''' client-side file name (can be path too eg. "images/image.png")
**'''src:''' Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
*'''<include />''' Include resources that this resource will use
*'''<include />''' Включать ресурс, когда он ресурс будет использоваться
**'''resource:''' Resource name that you want to start with this resource
**'''resource:''' Имя ресурса, которое вы хотите использовать для этого ресурса
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)
**'''minversion:''' Минимальная версия ресурса (не обязательно)
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)
**'''maxversion:''' Максимальная версия ресурса(не обязательно)
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:
*'''<config />''' Файл конфигураций (.XML) возможные параметры:
**'''src:''' The file name of the config file
**'''src:''' Имя конфигурационного файла
**'''type:''' The type of the config file: "client" or "server"
**'''type:''' Тип файла конфигурации: "Clien" или "Server"
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]
*'''<export />''' Это функция экспорта из этого ресурса, так что другие ресурсы могут использовать их - [[call]]
**'''function:''' The function name
**'''function:''' Имя функции
**'''type''' Whether function is exported server-side or client-side (valid values are: "server" and "client")
**'''type''' Экспортирует клиентские или серверные функции (Возможные значения: "Server" и "Client")
**'''http:''' Can the function be called via HTTP (true/false)
**'''http:''' Может ли быть функция вызвана через HTTP (true/false)
*'''<html />'''
*'''<html />'''
**'''src:''' The filename for the HTTP file (can be a path)
**'''src:''' Имя HTTP файла (Может быть путь. Например: files/file.png)
**'''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:''' HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (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:''' HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (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>:''' Большинство режимах игры использовать [[settings system]] (Настройки системы), чтобы администраторы сервера могли настроить его так, как они хотят. Например, вы можете установить время, а затем использовать [[get]] (Получить) и [[set]] (Установить), чтобы получить значение или изменить его, соответственно.


== Example ==
== Пример ==
Heres an example of a meta file using some of the tags mentioned:
Вот пример мета файла Используется некоторые упомянутые теги:
<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 22:32, 19 June 2010

Warning.png This page requires local translation. If page will remain not translated in reasonable period of time it would be deleted.
After translating the page completely, please remove the ‎{{translate}}‎ tag from the page.

Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле meta.xml. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.

Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247

Возможные тэги

Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты. Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть вы можете определять новые тэги в XML. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:

  • <info /> Информация о данном ресурсе, possible parameters include (any arbitrary parameters can be used and read using getResourceInfo):
    • author: Автор
    • version: Версия
    • name: Название
    • description: Описание
    • type: Тип ресурса, может быть "gamemode", "script", "map" or "misc".
  • <script /> Исходный код для этого ресурса, возможные параметры:
    • src: Имя файла исходного кода
    • type: Тип исходного кода: "Client" или "Server"
  • <map /> Карта для режима игры, возможность параметрами являются:
    • src: .map имя файла (Может лежать в других папках. Например: "maps/filename.map")
    • dimension: Объём, в котором карта будет загружена (по желанию)
  • <file /> Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с клиента, когда ресурс запустится (Или при присоединении)
    • src: Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
  • <include /> Включать ресурс, когда он ресурс будет использоваться
    • resource: Имя ресурса, которое вы хотите использовать для этого ресурса
    • minversion: Минимальная версия ресурса (не обязательно)
    • maxversion: Максимальная версия ресурса(не обязательно)
  • <config /> Файл конфигураций (.XML) возможные параметры:
    • src: Имя конфигурационного файла
    • type: Тип файла конфигурации: "Clien" или "Server"
  • <export /> Это функция экспорта из этого ресурса, так что другие ресурсы могут использовать их - call
    • function: Имя функции
    • type Экспортирует клиентские или серверные функции (Возможные значения: "Server" и "Client")
    • http: Может ли быть функция вызвана через HTTP (true/false)
  • <html />
    • src: Имя HTTP файла (Может быть путь. Например: files/file.png)
    • default: HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (true/false)
    • raw: HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (true/false)
  • <settings> <setting name="" value=""/> </settings>: Большинство режимах игры использовать settings system (Настройки системы), чтобы администраторы сервера могли настроить его так, как они хотят. Например, вы можете установить время, а затем использовать get (Получить) и set (Установить), чтобы получить значение или изменить его, соответственно.

Пример

Вот пример мета файла Используется некоторые упомянутые теги:

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