Difference between revisions of "RU/Meta.xml"

From Multi Theft Auto: Wiki
Jump to: navigation, search
(Переведено Gallardo)
Line 1: Line 1:
 
{{translate}}
 
{{translate}}
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.
+
Этот файл является одним из самых важных в МТА - в нём содержатся инструкции для интерпретатора какие файлы использовать. Так же, можно выводить чтение из скрипта в meta.xml, что позволяет задавать переменные в параметре '''<settings>''' и изменять их по ходу через админ-панель
  
Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247
+
Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: [http://forum.mtasa.com/viewtopic.php?f=91&t=22247 Ссылка]
  
== Возможные тэги ==
+
==Используемые теги==
 
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты.
 
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты.
 
Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть '''вы можете определять новые тэги в XML'''. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:
 
Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть '''вы можете определять новые тэги в XML'''. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:
  
*'''<info />''' Информация о данном ресурсе, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):
+
*'''<info />''' Информация о ресурсе (карта это, или скрипт, кто автор, какое описание)[[getResourceInfo]]):
 
** '''author:''' Автор
 
** '''author:''' Автор
 
** '''version:''' Версия
 
** '''version:''' Версия
Line 14: Line 14:
 
** '''description:''' Описание
 
** '''description:''' Описание
 
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
 
** '''type:''' Тип ресурса, может быть "gamemode", "script", "map" or "misc".
*'''<script />''' Исходный код для этого ресурса, возможные параметры:
+
*'''<script />''' Скрипт ресурса
** '''src:''' Имя файла исходного кода
+
** '''src:''' Имя файла скрипта (с расширением)
** '''type:''' Тип исходного кода: "Client" или "Server"
+
** '''type:''' Тип скрипта: "Client" или "Server"
*'''<map />''' Карта для режима игры, возможность параметрами являются:
+
*'''<map />''' Карта для режима игры
**'''src:''' .map имя файла (Может лежать в других папках. Например: "maps/filename.map")
+
**'''src:''' .map имя файла (Может лежать в других папках. Например: "maps/filename.map") (писать с расширением)
 
**'''dimension:''' Объём, в котором карта будет загружена (по желанию)
 
**'''dimension:''' Объём, в котором карта будет загружена (по желанию)
*'''<file />''' Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с клиента, когда ресурс запустится (Или при присоединении)
+
*'''<file />''' Файл на стороне клиента. Как правило, эти образы. txd, .col, .dff или .xml файлы. Они будут скачаны с сервера на клиент
 
**'''src:''' Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
 
**'''src:''' Файл на стороне клиента (Может лежать в других папках. Например: "image/image.png")
*'''<include />''' Включать ресурс, когда он ресурс будет использоваться
+
*'''<include />''' Включать ресурс, когда он ресурс будет использоваться (Учтите, что при включении несуществующего ресурса скрипт не запустится)
 
**'''resource:''' Имя ресурса, которое вы хотите использовать для этого ресурса
 
**'''resource:''' Имя ресурса, которое вы хотите использовать для этого ресурса
 
**'''minversion:''' Минимальная версия ресурса (не обязательно)
 
**'''minversion:''' Минимальная версия ресурса (не обязательно)
Line 28: Line 28:
 
*'''<config />''' Файл конфигураций (.XML) возможные параметры:
 
*'''<config />''' Файл конфигураций (.XML) возможные параметры:
 
**'''src:''' Имя конфигурационного файла
 
**'''src:''' Имя конфигурационного файла
**'''type:''' Тип файла конфигурации: "Clien" или "Server"
+
**'''type:''' Тип файла конфигурации: "Client" или "Server"
*'''<export />''' Это функция экспорта из этого ресурса, так что другие ресурсы могут использовать их - [[call]]
+
*'''<export />''' Тег экспорта функций, для последующего вызова этой функции. Подробнее о вызове: [[call]]
 
**'''function:''' Имя функции
 
**'''function:''' Имя функции
**'''type''' Экспортирует клиентские или серверные функции (Возможные значения: "Server" и "Client")
+
**'''type''' Тип Экспорта (''client'' или ''server'')
**'''http:''' Может ли быть функция вызвана через HTTP (true/false)
+
**'''http:''' Может ли функция быть вызвана через HTTP (true/false)
 
*'''<html />'''
 
*'''<html />'''
 
**'''src:''' Имя HTTP файла (Может быть путь. Например: files/file.png)
 
**'''src:''' Имя HTTP файла (Может быть путь. Например: files/file.png)
 
**'''default:''' HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (true/false)
 
**'''default:''' HTML-файл, который отображается по умолчанию при посещении /resourceName/ на сервере. Только один HTML-файл может быть по умолчанию, остальные игнорируются. (true/false)
 
**'''raw:''' HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (true/false)
 
**'''raw:''' HTML-файл не обрабатывается интерпретатором LUA, может рассматриваться как двоичные данные. Должен использоваться для двоичных файлов (В основном изображения) (true/false)
*'''<settings> <setting name="" value=""/> </settings>:''' Большинство режимах игры использовать [[settings system]] (Настройки системы), чтобы администраторы сервера могли настроить его так, как они хотят. Например, вы можете установить время, а затем использовать [[get]] (Получить) и [[set]] (Установить), чтобы получить значение или изменить его, соответственно.
+
*'''<settings> <setting name="" value=""/> </settings>:''' Большенство режимов игры используют этот Тег для задавания переменных. В будущем, эти переменные могут быть прочитаны из админ-панели и записаны прямо во время выполнения скрипта.
  
 
== Пример ==
 
== Пример ==
Вот пример мета файла Используется некоторые упомянутые теги:
+
Вот пример мета, в котором используются часть тегов
 
<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" />
Line 71: Line 71:
 
     <settings>
 
     <settings>
 
         <setting name="roundlimit" value="[6]" /> <!-- Длинна раунда в минутах -->
 
         <setting name="roundlimit" value="[6]" /> <!-- Длинна раунда в минутах -->
<setting name="teamdamage" value="[1]" /> <!-- 0 для выключения командной защиты, 1 для включения командной защиты -->
+
<setting name="teamdamage" value="[1]" /> <!-- 0 для выключения командного убивания, 1 для включения -->
 
<setting name="teambalance" value="[1]" /> <!-- Предел разницы количества игроков между командами -->
 
<setting name="teambalance" value="[1]" /> <!-- Предел разницы количества игроков между командами -->
 
<setting name="spazammo" value="[25]" /> <!-- Сумма боеприпасов -->
 
<setting name="spazammo" value="[25]" /> <!-- Сумма боеприпасов -->

Revision as of 18:56, 30 January 2012

Warning.png

This page requires local translation. If page will remain not translated in reasonable period of time it would be deleted.
Please clarify what language it should be translated to.

Этот файл является одним из самых важных в МТА - в нём содержатся инструкции для интерпретатора какие файлы использовать. Так же, можно выводить чтение из скрипта в meta.xml, что позволяет задавать переменные в параметре <settings> и изменять их по ходу через админ-панель

Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: Ссылка

Используемые теги

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

  • <info /> Информация о ресурсе (карта это, или скрипт, кто автор, какое описание)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: Тип файла конфигурации: "Client" или "Server"
  • <export /> Тег экспорта функций, для последующего вызова этой функции. Подробнее о вызове: call
    • function: Имя функции
    • type Тип Экспорта (client или server)
    • 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>: Большенство режимов игры используют этот Тег для задавания переменных. В будущем, эти переменные могут быть прочитаны из админ-панели и записаны прямо во время выполнения скрипта.

Пример

Вот пример мета, в котором используются часть тегов

<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]" /> <!-- Длинна раунда в минутах -->
	 <setting name="teamdamage" value="[1]" /> <!-- 0 для выключения командного убивания, 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>