Multi Theft Auto: Wiki - User contributions [en]

RU/Meta.xml

2012-01-30T18:56:28Z

Gallardo994: Переведено Gallardo

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

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

==Используемые теги==
Тэги в .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>:''' Большенство режимов игры используют этот Тег для задавания переменных. В будущем, эти переменные могут быть прочитаны из админ-панели и записаны прямо во время выполнения скрипта.

== Пример ==
Вот пример мета, в котором используются часть тегов
<syntaxhighlight lang="lua" lang="xml"><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]" /> 
<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></syntaxhighlight>
[[Category:Scripting Concepts]]
[[Category:Incomplete]]
[[en:Meta.xml]]

RU/Meta.xml

2012-01-30T18:56:16Z

Gallardo994: Переведено Gallardo

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

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

==Используемые теги==
Тэги в .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>:''' Большенство режимов игры используют этот Тег для задавания переменных. В будущем, эти переменные могут быть прочитаны из админ-панели и записаны прямо во время выполнения скрипта.

== Пример ==
Вот пример мета, в котором используются часть тегов
<syntaxhighlight lang="lua" lang="xml"><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]" /> 
<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></syntaxhighlight>
[[Category:Scripting Concepts]]
[[Category:Incomplete]]
[[en:Meta.xml]]

Введение в скриптинг

2012-01-30T18:45:57Z

Gallardo994:

Ресурсы являются ключевой частью MTA. Ресурс - это папка или zip архив, содержащий набор файлов, а также мета файл, описывающий серверу, как нужно загружать ресурс и из каких файлов он состоит. Ресурс играет практически ту же роль, что и программа в операционной системе - он может быть запущен и остановлен, а также могут быть запущены несколько ресурсов одновременно. Всё, что выполняется с помощью сценариев находится в ресурсах, что реализовано в сценариях: игровые режимы, игровые карты или что-либо ещё - все это ресурсы.

'''Вам будет проще начать писать сценарии на языке Lua, если вы будете использовать специализированный Lua-редактор такой как [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] или [http://luaedit.luaforge.net/ LuaEdit]. Для дистрибутивов GNU/Linux возможно использовать встроенный по умолчанию (в большую часть ОС) Gedit'''

==Создание простого сценария==
Для начала давайте сделаем так, чтобы по команде игрока "createvehicle" рядом с игроком создавалась машина.

===Подготовка===
Как описывалось выше, ресурс является папкой или zip архивом, поэтому для начала мы должны создать папку. Название папки является названием ресурса. Это название используется для запуска или прекращения выполнения ресурса и для обращения к ресурсу в сценариях. В нашем примере, папку необходимо назвать ''commands''.

Каждому ресурсу необходим файл ''meta.xml''. В нашем случае, мы хотим создать сценарий, который обеспечит пользователю выполнение нескольких простых команд, поэтому нам необходимо сообщить серверу о необходимости загрузки файла сценария, в нашем случае таким файлом сценария пусть будет ''script.lua''.
Содержимое файла ''meta.xml'':
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" description="A few simple commands" />
<script src="script.lua" />
</meta>
</syntaxhighlight>

Теперь нам необходимо создать файл ''script.lua'', о котором упоминалось выше, в той же самой директории, где расположен файл ''meta.xml''. В результате содержимое папки ''commands'' должно быть таким:

<syntaxhighlight lang="xml">
/commands/meta.xml
/commands/script.lua
</syntaxhighlight>

===Написание сценария===
Начнем с содержимого файла ''script.lua''. Как описывалось выше, нам необходимо обеспечить команду, которая будет создавать машину рядом с игроком. Для начала нам необходимо создать функцию, которую мы будем вызывать, и обработчик команды, который позволит игроку вводить и выполнять команду в окне консоли.

<syntaxhighlight lang="lua">
-- создание функции, вызываемой обработчиком команды, с аргументами: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- код сценария для создания машины
end

-- создание обработчика команды
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Обратите внимание: Имена функций в коде примеров являются ссылками на wiki-статьи, описывающие функции в документации.''

====О обработчиках команд====
Первым аргументом [[addCommandHandler]] название команды, введенной игроком, второй аргумент - функция, которая будет вызвана, в нашем случае это ''createVehicleForPlayer''.

Если вы уже знакомы с написанием сценариев, то вам наверняка приходилось вызывать функции следующего вида:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>

Таким способом мы вызываем функцию [[addCommandHandler]], а затем функцию ''createVehicleForPlayer''. Она, конечно же, может быть вызвана этим же способом отдельно. Но для нее мы используем обработчик команды, который вызывает ее в пожожей манере, но только внутри.

Например: Какой-нибудь игрок в процессе игры введет в окно консоли команду "createvehicle 468" для создания машины Sanchez, обработчик команды вызовет функцию createVehicleForPlayer , так же, как '''если бы''' у нас в коде сценария была строка:
<syntaxhighlight lang="lua">
createVehiceForPlayer(thePlayer,"createvehicle","468") -- thePlayer это игрок, который ввел команду
</syntaxhighlight>
Эта функция имеет несколько параметров: параметр, отвечающий за игрока, который ввел команду, параметр, имеющий в качестве значения введенную команду и параметр, содержащий текст, который следовал после команды, в нашем случае это "468" - идентификатор машины Sanchez. Первые два параметра такие же, как и у остальных обработчиков команд, о которых вы можете прочитать информацию на странице [[addEventHandler]]. Поэтому, вы всегда должны определить, по крайней мере, эти два параметра для использования чего-либо после них (например, для обработки текста, введенного после команды, как в нашем примере - идентификатора модели машины).

''Обратите внимание: Вы можете добавить обработчик команды только ПОСЛЕ того, как вы определили функцию обработчика, иначе она не будет найдена. Порядок размещения функций имеет значение.''

====Написание функции====
Для того, чтобы написать код созданной функции, нам необходимо продумать детали того, что мы хотим сделать:
* Получить позицию игроков для того, чтобы знать куда поместить новую машину (допустим, что мы хотим, чтобы она появилась справа от игрока)
* Вычислить позицию того места, куда необходимо поместить машину (это необходимо для того, чтобы она не появилась на месте игрока)
* Создать машину
* Проверить успешность создания машины или вывести сообщение

Для того, чтобы выполнить поставленные задачи, мы должны использовать несколько функций. Чтобы найти подходящую для решения задачи функцию, мы должны посмотреть страницу [[Scripting Functions|Список функций серверного приложения]]. Сначала нам необходима функция для получения позиции игроков. Так как игроки относятся к [[RU/Element|'''элементам''']] (основным классам, описывающим игровые сущности или, проще говоря, игровые объекты), то мы сначала переходим к странице [[Server_Scripting_Functions#Element_functions|'''Element functions''']], где и находим функцию [[getElementPosition]]. Щелкнув по названию функции в списке, мы получаем описание функции. Тут же мы можем посмотреть синтаксис, возвращаемое значение и даже пример ее использования. Синтаксис показывает нам, какие аргументы необходимо передать функции.

функция [[getElementPosition]], имеет следующий синтаксис:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

Три ''float'' перед названием функции - это тип возвращаемого значения. В этом случае, подобное означает, что функция возвращает три числа с плавающей точкой. В круглых скобках, вы можете увидеть аргументы, которые необходимо передать функции. В нашем случае имеется только аргумент типа ''element'', содержащий объект, чью позицию мы хотим получить (в нашем примере это игрок).

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- получить позицию и поместить ее в переменные x,y,z
-- (local обозначает локальный контекст: переменные существуют только в текущей области действия. В данном случае - в пределах текущей функции)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Далее мы хотим гарантировать то, что машина не создастся прямо на игроке, поэтому мы добавляем небольшое значение переменной ''x'', что дает на возможность создать машину правее от игрока.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- получить позицию игрока
x = x + 5 -- добавить 5 единиц к позиции по оси x
end
</syntaxhighlight>

Теперь нам необходима другая функция, а именно функция для создания машины. Мы снова начинаем ее поиск в [[Scripting Functions|списке функций серверного приложения]], в этот раз - так как речь идет о машинах - то ищем функцию в разделе [[Scripting_Functions#Vehicle_functions|'''Vehicle functions''']], в котором мы выбираем [[createVehicle]]. В синтаксисе этой функции, нам необходимо только возвращаемое значение (которое является единственным), типа ''vehicle'', относящееся к ''element''. Это возвращаемое значение указывает на машину, которая только что создана. Также, вы вероятно обратили внимание на то, что некоторые аргументы заключены в квадратные скобки [ ], которые означают, что этот аргумент функции необязателен.

Теперь у нас имеются все аргументы, необходимые для выполнения команды [[createVehicle]] внутри нашей функции: мы вычислили позицию по переменным ''x,y,z'' и знаем идентификатор модели, которую мы хотим создать с помощью команды ("createvehicle 468") и мы имеем доступ к функции через переменную ''vehicleModel''.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- получить позицию игрока
x = x + 5 -- добавить 5 единиц измерения к координате x позиции игрока
-- создать машину и сохранить возвращенный элемент vehicle в переменной ''createdVehicle''
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Конечно, этот код может быть улучшен многими способами. По крайней мере, нам необходимо добавить проверку на успешное создание машины. На странице [[createVehicle]] мы можем прочитать в разделе '''Returns''' о том, что функция возвращает ''false'' в том случае, если неполучилось создать машину. Поэтому, нам достаточно проверить значение переменной ''createVehicle''.

Теперь у нас имеется полность завершенный сценарий:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- получить позицию игрока
x = x + 5 -- добавить 5 единиц измерения к координате x позиции игрока
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- проверка на возврат значения ''false''
if (createdVehicle == false) then
-- если возвращено ''false'', то необходимо вывести сообщение пользователю в окно чата, но только тому игроку, который создавал машину.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

Как вы можете увидеть, в последнем примере кода появилась еще одна функция [[outputChatBox]]. О ней вы можете самостоятельно узнать, посмотрев соответствующую страницу с документацией по этой функции.

==Что вы узнали==
Теперь вам уже немного известны файлы ресурсов, обработчики команд и принципы поиска функций в документации, но необходимо знать больше. Следующий раздел проведет краткий обзор по некоторым ресурсам, сопровождая при необходимости изложение материала ссылками на соответствующие страницы.

===Сценарии клиентской и серверной стороны===
Вы возможно уже видели эти или похожие термины (сервер/клиент) на этом wiki-сайте. MTA поддерживает не только сценарии, выполняющиеся на сервере и обеспечивающие выполнение команд(похожих на ту, что была описаны выше) и другие возможности, но и также сценарии, выполняющиеся клиентским приложением MTA, которое игроки используют для соединения с игровым сервером. Причиной этому является тот факт, что некоторые возможности MTA обеспечиваются приложением клиентской стороны (например, графический пользовательский интерфейс). Другие возможности MTA работают лучше на стороне сервера или принципиально не могут быть реализованы на клиентской стороне и поэтому выполняются на стороне сервера.

Многие сценарии, которые вы будете писать (игровые режимы, карты) вероятно будут выполняться на стороне сервера, подобно тому, который был написан выше. Если вам необходимо выполнить что-либо, что нельзя выполнить на стороне сервера, вы вероятно сможете это выполнить на стороне клиента. Например, для сценария клиентской стороны, вы должны создать обычный файл сценария (например, с названием ''client.lua'') и определить его в файле meta.xml, следующим образом:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
Атрибут ''type'' по умолчанию имеет значение 'server', поэтому вам необходимо определять его значение для сценариев клиентской стороны. После того, как вы выполнили это, сценарий клиентской стороны будет скачиваться на компьютер игрока при его соединении с сервером. Об этом вы можете также прочитать в статье [[Client side scripts|Сценарии клиентской стороны]].

===Более сложные ресурсы===
Предыдущий раздел кратко показал, как надо добавлять сценарии клиентской стороны в ресурсы, но на самом деле все обстоит немного сложнее. Как упоминалось в самом начале этой страницы, ресурсы могут быть чем угодно. Их цель - определить то, для чего они нужны. Далее приведены наиболее часто используемые ресурсы. Рассмотрим их содержимое, содержимое файла ''meta.xml'' и то, для чего они предназначены:

====Пример 1: Вспомогательный сценарий====
<syntaxhighlight lang="xml">
/admin_commands
/meta.xml
/commands.lua
/client.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="admin commands" />
<script src="commands.lua" />
<script src="client.lua" type="client" />
</meta>
</syntaxhighlight>

* Файл ''commands.lua'' обеспечивает выполнение некоторых команд администратора, например, назначение наказаний провинившимся игрокам, или что-либо другое, что может быть полезным для администрирования сервера
* Файл ''client.lua'' обеспечивает графический пользовательский интерфейс для легкого выполнения описанных действий

Этот пример ресурса может быть в состоянии выполнения всё время (даже может запускаться автоматически при начале работы сервера), так как он может использоваться в течении всего игрового процесса и изменять игровой процесс, в случае если администратор решит выполнить какое-либо действие.

====Пример 2: Игровой режим ====
<syntaxhighlight lang="xml">
/counterstrike
/meta.xml
/counterstrike.lua
/buymenu.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike remake" type="gamemode" />
<script src="counterstrike.lua" />
<script src="buymenu.lua" type="client" />
</meta>
</syntaxhighlight>

* Файл ''counterstrike.lua'' содержит следующие возможности:
** Позволяет игрокам выбирать команду, за которую они хотят играть и присоединяться к команде
** Обеспечивает игрокам возможность выбора оружия, цели игры и команды (информация подобного характера может также содержаться в файле игровой карты - об этом будет сказано ниже)
** Определяет правила игры,например, момент наступления конца раунда, какие действия должны произойти после гибели персонажа игрока.
** .. и возможно что-либо ещё
* Файл ''buymenu.lua'' - сценарий клиентской стороны для создания меню покупки оружия.

Этот пример может быть отнесен к игровому режиму потому как он не только связан с процессом игры, но и фактически определяет правила игры. Атрибут ''type'' показывает, что этот пример работает в [[Map manager]], хотя и существует другой ресурс, написанный QA Team для управления игровыми режимами и загрузки игровых карт. Его рекомендуется использовать, потому как ваш игровой решим будет основан на принципах, поддерживаемых им.

Это также означает, что игровой режим вероятно не сможет быть запущен без игровой карты. Игровые режимы должны всегда стремиться настолько использовать общие принципы, насколько это возможно. Далее приведен пример игровой карты.

====Пример 3: Игровая карта====
<syntaxhighlight lang="xml">
/cs-airport
/meta.xml
/airport.map
/airport.lua
</syntaxhighlight>
<syntaxhighlight lang="xml">
<meta>
<info author="Someguy" description="Counterstrike airport map" type="map" gamemodes="counterstrike" />
<map src="airport.map" />
<script src="airport.lua" />
</meta>
</syntaxhighlight>

* Файл ''airport.map'' в XML файле, обеспечивает информацию о игровой карте игровому режиму, которая может включать:
** Места, где на карте должны появляться игроки, с каким оружием, какие команды имеются
** Какие цели имеются
** Погода, время, ограничение времени
** Возможные машины
* файл ''airport.lua'' может содержать возможности характерные для конкретной игровой карты, которые в свою очередь могуть включать:
** Реализацию действий, которые могут произойти после открытия двери, ворот и т.п., взрыва чего-либо.
** Создание и перемещение некоторых игровых объектов, или управление объектами, создаваемыми в файле .map
** .. что-либо ещё, что может относиться к конкретной карте

Как вы можете увидеть, значение атрибута ''type'' изменено на 'map', это говорит [[Map manager]] о том, что этот ресурс является игровой картой, а атрибут ''gamemodes'' говорит о том, к каким игровым режимам относится эта игровая карта. В примере игровая карта относится к игровому режиму, описанному в примере выше.
Для ресурса "игровая карта" может быть написан отдельный сценарий. Конечно, это не является необходимым для всех игровых карт, но в то же время открывает создателям игровых карт широкие возможности для создания своих собственных правил игры в игровом режиме, для которого они создают карту.

Файл ''airport.map'' может иметь следующий вид:
<syntaxhighlight lang="xml">
<map mode="deathmatch" version="1.0">
<terrorists>
<spawnpoint posX="2332.23" posY="-12232.33" posZ="4.42223" skins="23-40" />
</terrorists>
<counterterrorists>
<spawnpoint posX="2334.23443" posY="-12300.233" posZ="10.2344" skins="40-50" />
</counterterrorists>

<bomb posX="23342.23" posY="" posZ="" />

<vehicle posX="" posY="" posZ="" model="602" />
<vehicle posX="" posY="" posZ="" model="603" />
</map>
</syntaxhighlight>

Когда игровой режим запущен с игровой картой, mapmanager автоматически запускает ресурсы игровой карты и информация, которую они содержат может быть считана ресурсом игрового режима. При изменении игровой карты, выполнение ресурса текущей игровой карты останавливается и запускается выполнение ресурса следующей игровой карты.

===События===
События являются механизмом MTA сообщать сценариям о том, что произошло. Например, при смерти персонажа игрока, срабатывает событие [[onPlayerWasted]]. В нем выполняются какие-либо действия, которые необходимо выполнить при смерти персонажа игрока, вы можете подготовить что-то подобное для добавления обработчика команды, как показано в [[#Написание_сценария|разделе "Написание сценария"]].

В этом примере выводится сообщение, содержащее имя игрока, персонаж которого погиб:
<syntaxhighlight lang="lua">
function playerDied(totalAmmo, killer, killerWeapon, bodypart)
outputChatBox(getPlayerName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

Вместо отображения необходимых параметров, на страницах документации, посвященных событиям, показано какие параметры передаются в функцию-обработчик, подобно тому как сделано в [[#О_обработчиках_команд|обработчике команды]], только с тем отличием, что используется не команда, а событие. Другим немаловажным аспектом является переменная ''source'', которая имеется в обработчике функций. Она не добавляется в список параметров функции, но тем не менее используется. Она принимает различные значения в зависимости от события. Для событий, относящихся к игроку (как в в примере выше) она принимает значение типа ''player'', которое относится к ''элементам'' (''element'').

==Заключение==
Теперь вы знаете основные аспекты, использующиеся при написании сценариев в MTA, а также ознакомились с частью документации. [[RU/Main Page|Главная страница]] содержит ссылки на более подробную информацию, учебники и справочники, которые при желании позволят вам более глубже узнать многие вещи о MTA.

[[en:Scripting Introduction]]
[[it:Introduzione allo scripting]]

RU/setFPSLimit

2012-01-30T18:44:28Z

Gallardo994: /* Пример */

{{Server function}}
__NOTOC__
Для тех, кто не знает что такое FPS (Frames Per Second), рекомендовано зайти на [http://ru.wikipedia.org/wiki/FPS Эту страницу]

==Синтаксис==
<syntaxhighlight lang="lua">
bool setFPSLimit ( int fpsLimit )
</syntaxhighlight>

===Требуемые Аргументы===
*'''fpsLimit:''' Числовое значение от 1 до 100, которое будет означать лимит FPS. Так же, как вариант, можно убрать лимит вообще - тогда потребуется fpsLimit как ''0'' или ''false''.

===Возвращение===
Возвращает ''true'' если всё прошло успешно, в ином случае - ''false''

==Пример==
Этот пример позволяет администраторам ставить новый лимит на FPS при помощи команды ''setfps'':
<syntaxhighlight lang="lua">function fpsFunction( player, command, limit ) -- First define the function
if hasObjectPermissionTo ( player, "function.setFPSLimit" ) and limit then -- Если у игрока есть админ-права и если было указано FPS то...
setFPSLimit ( limit ) -- Поставить лимит FPS
end
end

addCommandHandler ( "setfps", fpsFunction ) -- Присоединяем команду setfps к функции fpsFunction
</syntaxhighlight>

==Рекомендовано к просмотру==
{{Server functions}}

RU/setFPSLimit

2012-01-30T18:43:50Z

Gallardo994: Переведено Gallardo

{{Server function}}
__NOTOC__
Для тех, кто не знает что такое FPS (Frames Per Second), рекомендовано зайти на [http://ru.wikipedia.org/wiki/FPS Эту страницу]

==Синтаксис==
<syntaxhighlight lang="lua">
bool setFPSLimit ( int fpsLimit )
</syntaxhighlight>

===Требуемые Аргументы===
*'''fpsLimit:''' Числовое значение от 1 до 100, которое будет означать лимит FPS. Так же, как вариант, можно убрать лимит вообще - тогда потребуется fpsLimit как ''0'' или ''false''.

===Возвращение===
Возвращает ''true'' если всё прошло успешно, в ином случае - ''false''

==Пример==
Этот пример позволяет администраторам ставить новый лимит на FPS при помощи команды ''setfps'':
<syntaxhighlight lang="lua">function fpsFunction( player, command, limit ) -- First define the function
if hasObjectPermissionTo ( player, "function.setFPSLimit" ) and limit then -- Если у игрока есть админ-права и если было указано FPS то...
setFPSLimit ( limit ) -- Поставить лимит FPS
end
end

addCommandHandler ( "setfps", fpsFunction ) -- Присоединяем команду ''setfps'' к функции 'fpsFunction'
</syntaxhighlight>

==Рекомендовано к просмотру==
{{Server functions}}

RU/takeWeapon

2012-01-30T18:33:53Z

Gallardo994: /* Пример */

{{Server function}}
Эта функция отбирает у игрока оружение

==Синтаксис==
<syntaxhighlight lang="lua">bool takeWeapon ( player thePlayer, int weaponId )</syntaxhighlight>

===Требуемые Аргументы===
*'''thePlayer''': Игрок, в виде объекта
*'''weaponId''': Числовое значение оружия, которое нужно убрать

===Возвращения===
Возвращает ''true'' если всё прошло успешно, в ином случае - ''false''

==Пример==
Этот код забирает у игрока оружие с ID 28 при написании /takeWeapon в чате. Если всё прошло успешно, то в чате увидите сообщение
<syntaxhighlight lang="lua">
function takeMyWeapon(player)
local ifItIsTrue = takeWeapon(player,28)
if (ifIsIsTrue == true) then
outputChatBox("Successfully took the weapon!",player,204,255,0)
end
end
addCommandHandler("takeWeapon",takeMyWeapon)</syntaxhighlight>

==Рекомендовано к просмотру==
{{RU/Weapon functions}}
[[en:takeWeapon]]

RU/takeWeapon

2012-01-30T18:33:30Z

Gallardo994: Переведено Gallardo

{{Server function}}
Эта функция отбирает у игрока оружение

==Синтаксис==
<syntaxhighlight lang="lua">bool takeWeapon ( player thePlayer, int weaponId )</syntaxhighlight>

===Требуемые Аргументы===
*'''thePlayer''': Игрок, в виде объекта
*'''weaponId''': Числовое значение оружия, которое нужно убрать

===Возвращения===
Возвращает ''true'' если всё прошло успешно, в ином случае - ''false''

==Пример==
This example removes weapon 28 from player ID 1. If successful, it displays a message in the chat box.
Этот код забирает у игрока оружие с ID 28 при написании /takeWeapon в чате. Если всё прошло успешно, то в чате увидите сообщение
<syntaxhighlight lang="lua">
function takeMyWeapon(player)
local ifItIsTrue = takeWeapon(player,28)
if (ifIsIsTrue == true) then
outputChatBox("Successfully took the weapon!",player,204,255,0)
end
end
addCommandHandler("takeWeapon",takeMyWeapon)</syntaxhighlight>

==Рекомендовано к просмотру==
{{RU/Weapon functions}}
[[en:takeWeapon]]