Multi Theft Auto: Wiki - User contributions [en]

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

2008-08-25T21:49:58Z

Sputnik:

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

'''Вам будет проще начать писать сценарии на языке Lua, если вы будете использовать Lua editor. Мы рекомендуем [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] или [http://luaedit.luaforge.net/ LuaEdit].'''

==Создание простого сценария==
Для начала давайте сделаем так, чтобы по команде игрока "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(getClientName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

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

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

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

Scripting Introduction

2008-02-14T15:03:38Z

Sputnik: "vehicleModel" instead "vehicle" in the begin of article

Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files, plus a meta file that describes to the server how the resource should be loaded and what files it does contain. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once.

Everything that has to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map or anything else.

==Creating a simple script==
Firstly, we want to write something that adds a 'createvehicle' command players can use to spawn a vehicle beside their position.
===Preparations===
As decribed above, a resource is a folder or zip file, so first you should create a folder. The folder name is the name of the resource, that is used to start or stop it or reference in scripts. In our example, we shall call it ''commands''.

What every resource has and needs is the ''meta.xml'' file. In our case, we want to create a script that provides some simple commands to the user, thus we need to tell the server to load a script file, we name ''script.lua'' in our case.
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" description="A few simple commands" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
Now we have to create the ''script.lua'' file we defined above in the same directory as the meta.xml. Now we have the both files:
<syntaxhighlight lang="xml">
/commands/meta.xml
/commands/script.lua
</syntaxhighlight>

===Writing the script===
Let's start with the contents of the ''script.lua'' file. As mentioned above, we want to provide a command to create a vehicle beside your current position in the game. Firstly we need to create a function we want to call and a command handler that creates the command the player will be able to enter in the console.

<syntaxhighlight lang="lua">
-- create the function the command handler calls, with the arguments: thePlayer, command, vehicleModel
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- create a vehicle and stuff
end

-- create a command handler
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>
''Note: Function names are clickable in code examples on the wiki and linked to the functions' documentation.''

====About command handlers====
The first argument of [[addCommandHandler]] is the name of the command the player will be able to enter, the second argument is the function this will call, in this case ''createVehicleForPlayer''.

If you have already experience in scripting, you will know that you call a function like this:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>

We called the [[addCommandHandler]] function this way already and since ''createVehicleForPlayer'' is a function too, it can be called that way as well. But we are using a command handler for that, which calls it in a similiar manner, internally.

For example: Someone types "createvehicle 468" ingame in the console to spawn a Sanchez, the command handler calls the createVehicleForPlayer function, as '''if''' we would have this line of code in the script:
<syntaxhighlight lang="lua">
createVehicleForPlayer(thePlayer,"createvehicle","468") -- thePlayer is the player element of the player who entered the command
</syntaxhighlight>
As we can see, it provides several parameters: the player who called the command, the command he entered and whatever text he had after that, in this case "468" as vehicle id for the Sanchez. The first two parameters are the same with all command handlers, which you can read on the [[addEventHandler]] page. For this fact, you always have to define at least those two parameters to use any after that (for example to process text that was entered after the command, like in our example the vehicle model id).

''Note: You have to add the command handler AFTER you defined the handler function, else it can't find it. The order of execution matters.''

====Writing the function====
In order to fill the function we created, we need to think about what we have to do:
* Get the players position, so we know where to spawn the vehicle (we want it to appear right beside the player)
* Calculate the position we want to spawn the vehicle at (we don't want it to appear in the player)
* Spawn the vehicle
* Check if it has been spawned successfully, or output a message

In order to achieve our goals, we have to use several functions. To find function we need to use, we should visit the [[Scripting Functions|Server Functions List]]. First we need a function to get the players position. Since players are Elements, we first jump to the '''Element functions''' where we find the [[getElementPosition]] function. By clicking on the function name in the list, you get to the function description. There we can see the syntax, what it returns and usually an example. The syntax shows us what arguments we can or have to submit.

For [[getElementPosition]], the syntax is:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

The three ''float'' in front of the function name are the return type. In this case it means the function returns three floating point numbers. Within the parentheses, you can see what arguments you have to submit. In this case only the element whose position you want to get, which is the player in our example.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (local means, the variables only exist in the current scope, in this case, the function)
local x,y,z = getElementPosition(thePlayer)
end
</syntaxhighlight>

Next we want to ensure that the vehicle won't spawn directly in the player, so we add a few units to the ''x'' variable, which will make it spawn east from the player.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
end
</syntaxhighlight>

Now we need another function, one to spawn a vehicle. We once again search for it on the [[Scripting Functions|Server Functions List]], this time - since we are talking about vehicles - in the '''Vehicle functions''' section, where we will choose [[createVehicle]]. In this function's syntax, we only have one return type (which is more common), a vehicle element that points to the vehicle we just created. Also, we see that some arguments are enclosed within [ ] which means that those are optional.

We already have all arguments we need for [[createVehicle]] in our function: The position we just calculated in the ''x,y,z'' variables and the model id that we provided through the command ("createvehicle 468") and can access in the function as ''vehicleModel'' variable.

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
-- create the vehicle and store the returned vehicle element in the ''createdVehicle'' variable
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
end
</syntaxhighlight>

Of course this code can be improved in many ways, but at least we want to add a check whether the vehicle was created successfully or not. As we can read on the [[createVehicle]] page under '''Returns''', the function returns ''false'' when it was unable to create the vehicle. Thus, we check the value of the ''createVehicle'' variable.

Now we have our complete script:
<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
local x,y,z = getElementPosition(thePlayer) -- get the position of the player
x = x + 5 -- add 5 units to the x position
local createdVehicle = createVehicle(tonumber(vehicleModel),x,y,z)
-- check if the return value was ''false''
if (createdVehicle == false) then
-- if so, output a message to the chatbox, but only to this player.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

As you can see, we introduced another function with [[outputChatBox]]. By now, you should be able to explore the function's documentation page yourself.

==What you need to know==
You already read some things about resources, command handlers and finding functions in the documentation in the first paragraph, but there is much more to learn. This section will give you a rather short overview over some of these things, while linking to related pages if possible.
===Clientside and Serverside scripts===
You may have already noticed these or similiar terms (Server/Client) somwhere on this wiki, mostly in conjunction with functions. MTA not only supports scripts that run on the server and provide commands (like the one we wrote above) or other features, but also scripts that run on the MTA client the players use to connect to the server. The reason for this is, that some features MTA provides have to be clientside (like a GUI - Graphical User Interface), others should be because they work better and still others are better off to be serverside or just don't work clientside.

Most scripts you will make (gamemodes, maps) will probably be serverside, like the one we wrote in the first section. If you run into something that can't be solved serverside, you will probably have to make it clientside. For a clientside script for example, you would create a ordinary script file (for example called ''client.lua'') and specify it in the meta.xml, like this:
<syntaxhighlight lang="xml">
<script src="client.lua" type="client" />
</syntaxhighlight>
The ''type'' attribute defaults to 'server', so you only need to specify it for clientside scripts. When you do this, the clientside script will be downloaded to the player's computer once he connects to the server. Read more about [[Client side scripts]].

===More complex resources===
The previous section showed briefly how to add clientside scripts to the resource, but there is also much more possible. As mentioned at the very top of this page, resources can be pretty much everything. Their purpose is defined by what they do. Let's have some theoretical resources, by looking at the files it contains, the ''meta.xml'' and what they might do:

====First example - A utility script====
<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>

* The ''commands.lua'' provides some admin commands, like banning a player, muting or something else that can be used to admin the server
* The ''client.lua'' provides a GUI to be able to perform the mentioned actions easily

This example might be running all the time (maybe even auto-started when the server starts) as it's useful during the whole gaming experience and also wont interfere with the gameplay, unless an admin decides to take some action of course.

====Second example - A gamemode====
<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>

* The ''counterstrike.lua'' contains similiar to the following features:
** Let players choose their team and spawn them
** Provide them with weapons, targets and instructions (maybe read from a Map, see below)
** Define the game's rules, e.g. when does the round end, what happens when a player dies
** .. and maybe some more
* The ''buymenu.lua'' is a clientside script and creates a menu to buy weapons

This example can be called a gamemode, since it not only intereferes with the gameplay, but actually defines the rules of it. The ''type'' attribute indicates that this example works with the [[Map manager]], yet another resource that was written by the QA Team to manage gamemodes and map loading. It is highly recommended that you base your gamemodes on the techniques it provides.

This also means that the gamemode probably won't run without a map. Gamemodes should always be as generic as possible. An example for a map is stated in the next example.

====Third example - A Map====
<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>

* The ''airport.map'' in a XML file that provides information about the map to the gamemode, these may include:
** Where the players should spawn, with what weapons, what teams there are
** What the targets are
** Weather, World Time, Timelimit
** Provide vehicles
* The ''airport.lua'' might contain map-specific features, that may include:
** Opening some door/make something explode when something specific happens
** Create or move some custom objects, or manipulate objects that are created through the .map file
** .. anything else map-specific you can think of

As you can see, the ''type'' attribute changed to 'map', telling the [[Map manager]] that this resource is a map, while the ''gamemodes'' attribute tells it for which gamemodes this map is valid, in this case the gamemode from the above example.
What may come as a surprise is that there is also a script in the Map resource. Of course this is not necessarily needed in a map, but opens a wide range of possibilities for map makers to create their own world within the rules of the gamemode they create it for.

The ''airport.map'' file might look similiar to this:
<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>

When a gamemode is started with a map, the map resources is automatically started by the mapmanager and the information it contains can be read by the gamemode resource. When the map changes, the current map resource is stopped and the next map resource is started.

===Events===
Events are the way MTA tells scripts about things that happen. For example when a player dies, the [[onPlayerWasted]] event is triggered. In order to perform any actions when a player dies, you have to prepare yourself similiar to adding a command handler, as shown in [[#Writing_the_script|the first chapter]].

This example will output a message with the name of the player who died:
<syntaxhighlight lang="lua">
function playerDied(totalAmmo, killer, killerWeapon, bodypart)
outputChatBox(getClientName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

Instead of showing what arguments are needed, the documentation page for Events shows what parameters are passed to the handler function, similiar to the way a [[#About_command_handlers|command handler]] does, just that it is different from event to event. Another important point is the ''source'' variable, that exists in handler functions. It doesn't have to be added to the parameter list of the function, but it still exists. It has a different value from event to event, for player events (as in the example above) it is the player element.

==Where to go from here==
You should now be familiar with the most basic aspects of MTA scripting and also a bit with the documentation. The [[Main Page]] provides you with links to more information, Tutorials and References that allow a deeper look into the topics you desire to learn about.

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

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

2008-02-14T15:00:17Z

Sputnik: "vehicle" changed on "vehicleModel" (typographic error in the english version of article)

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

==Создание простого сценария==
Для начала давайте сделаем так, чтобы по команде игрока "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(getClientName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

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

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

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

Главная страница

2008-02-09T08:08:34Z

Sputnik: откоректирована ссылка

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать на wiki-сайт разработчиков Multi Theft Auto: San Andreas Deathmatch. Здесь вы найдёте много полезной информации по разработке игровых режимов и карт для Multi Theft Auto.

Мы делаем подобные обзоры доступными для разработчиков, потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и нормально функционирующую версию MTA:SA DM. Создавайте игровые режимы и карты, помогайте документировать функции сценариев, пишите примеры кода, учебники или просто-напросто играйте и сообщайте обо всех найденых ошибках MTA на форумах.

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

Если у вас возникли вопросы или трудности по написанию сценариев, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki-сайт вам нужна учётная запись MTA Community.''' Зарегистрируйтесь на [http://community.mtasa.com MTA Comminity] и затем войдите в учётную запись wiki-сайта с тем же именем и паролем.

Этот wiki-сайт теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki-сайт вне сети (и быстро). Достаточно лишь установить Google Gears и нажать ссылку "Перейти в автономный режим" внизу любой страницы. Подождите пока приложение загрузит содержание страницы wiki-сайта на ваш компьютер и после этого текущая на момент загрузки версия страницы wiki-сайта будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало работы====

* [[RU/Deathmatch_Client_Manual|Руководство по клиентскому приложению]]
* [[RU/Deathmatch_Server_Manual|Руководство по серверному приложению]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Введение в написание сценариев]]
* [[Debugging|Учебник по отладке]] - Как найти ошибки в вашем сценарии
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[RU/Element|MTA Elements]] / [[Element tree]]
* [[Resources|Введение в ресурсы]]
** [[Resource Web Access|Ресурсы веб-доступа]]
* [[Writing_Gamemodes|Написание игровых режимов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, предоставляемые MTA и ресурсами.
* [[Map manager|Менеджер карт]] - Используйте его для своих игровых режимов
* [[Client side scripts|Сценарии для клиентского приложения]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Общая помощь по Lua====
Страницы, спроектированные с целью помочь вам понять язык LUA
*[http://www.lua.org/pil/index.html Руководство "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory Wiki-сайт LUA]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Метки на радаре]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цвета машин]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}

[[it:Pagina principale]]

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

2008-02-09T07:15:21Z

Sputnik: исправлена орфографическая ошибка

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

==Создание простого сценария==
Для начала давайте сделаем так, чтобы по команде игрока "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, vehicle
function createVehicleForPlayer(thePlayer, command, vehicle)
-- код сценария для создания машины
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(getClientName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

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

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

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

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

2008-02-08T23:35:46Z

Sputnik: Полный пересмотр перевода аналогичной статьи с англ. языка

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

==Создание простого сценария==
Для начала давайте сделаем так, чтобы по команде игрока "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, vehicle
function createVehicleForPlayer(thePlayer, command, vehicle)
-- код сценария для создания машины
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(getClientName(source).." died!")
end
addEventHandler("onPlayerWasted",getRootElement(),playerDied)
</syntaxhighlight>

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

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

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

RU/Server Manual

2008-02-03T13:18:52Z

Sputnik: /* Запуск сервера */

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

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

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получиться, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть наилучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера, находится в разработке.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно, то сервер нормально запущен и функционирует!

==Установка/обвновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование вашим сервером==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментальным средствам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[it:Manuale del Server]]

RU/Server Manual

2008-02-03T13:16:54Z

Sputnik: /* Настройка внешнего веб-сервера */

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

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

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получиться, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть наилучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера, находится в разработке.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно то сервер запущен удачно!

==Установка/обвновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование вашим сервером==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментальным средствам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[it:Manuale del Server]]

RU/Server Manual

2008-02-03T13:13:21Z

Sputnik: /* Добавление администраторов */

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

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

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получиться, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть наилучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно то сервер запущен удачно!

==Установка/обвновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование вашим сервером==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментальным средствам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[it:Manuale del Server]]

RU/Server Manual

2008-02-03T13:04:33Z

Sputnik: /* Ubuntu */

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

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

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получить, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть лучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно то сервер запущен удачно!

==Установка/обвновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование вашим сервером==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментальным средствам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[it:Manuale del Server]]

RU/Server Manual

2008-02-03T12:56:14Z

Sputnik: Пересмотр всей статьи. Перевод обновленной англ. версии

__TOC__

==Начало==
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.

==Установка сервера==
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.

===Установка серверного приложения в операционной системе Linux===
====Ubuntu====
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установки серверного приложения для других версий Linux.
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.
Некоторые предпочитают изменить это.
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните
'''sudo apt-get install pico'''. Это позволит легко установить используя pico text editor, который вы будете использовать для редактирования файлов настройки.
После выполнения установки, вам необходимо получить копию libcurl3 для сервера, чтобы запустите установку введите '''sudo apt-get install libcurl3'''
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете установить ftp сервер. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, а затем использовать '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''

====Gentoo====
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)

Ниже описаны действия для DP2:

Обновите вашу версию gcc до 4.2.2:
* уберите маску gcc в /etc/portage/package.unmask)
* выйдите из gcc
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)
* выйдите из libstdc++
Установите libcurl:
* выйдите из libcurl
Распакуйте mtasa, и запустите его...

===Установка серверного приложения в операционной системе Windows===
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".
*Нажмите на ссылку, предназначенную для ОС Windows.
*После загрузки программы установки запустите её.
*Выберете директорию, в которую вы хотите установить серверное приложение.
*Нажмите кнопку Install.
*На этом установка завершена!

==Настройка сервера==
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.

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

===Добавление администраторов===
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/>
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br>
<ol>
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li>
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже
<div style="padding: 10px">
''''Синтаксис, используемый в файле Accounts.xml''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Сохраните и закройте файл</li>
<li>Откройте файл acl.xml</li>
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li>
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

У вас должно получить, что-то похожее на:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br>
</li>
</ol>
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть лучшим для вас, если первый способ не работает)

=== Настройка внешнего веб-сервера ===
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.

Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.

<ol>
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li>
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:
<ul>
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li>
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br />
<br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера.
</ul>
</li>
</ol>

'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/>
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')

==Запуск сервера==
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!

Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно то сервер запущен удачно!

==Установка/обвновление файлов ресурсов на вашем сервере==
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.

# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Удаление ресурсов==
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.

# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.

==Администрирование сервера==
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".

Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.

Для получения информации о других командах, введите команду "help" в окне консоли.

==Запуск игровой карты/режима игры==
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.

==Удаленное администрирование вашим сервером==
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

Вы можете получить доступ к этим инструментальным средствам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox.
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)

==Полезные заметки==

# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server

====Нужна дополнительная помощь?====
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])

[[it:Manuale del Server]]

RU/Client Manual

2008-01-31T19:33:14Z

Sputnik: /* Клавиши управления в игре */

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.

==Перед началом установки==

Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.

Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.

'''Обратите внимание: MTA:SA работает только с GTA:SA EXE v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.

Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу по адресу irc://irc.multitheftauto.com/mta

===Системные требования===
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.
* процессор класса Intel Pentium 4 или AMD Athlon XP
* 512МБ ОЗУ
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)
* 3.7ГБ свободного места на жестком диске (3.6ГБ для установки Grand Theft Auto)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx с 64MB ОЗУ и поддержкой DirectX 9.0
* звуковая карта или кодек с поддержкой DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет для стабильной игры через сеть

Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).

Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.

==Установка игры==

'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''

# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте установщик клиентского приложения MTA:SA.
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.
<br>
'''Выбран первый вариант: создать учетную запись'''<br>
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br>
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br>
Введите данные учетной записи в программу установки
<br><br>
# Затем вам будет необходимо выбрать компоненты для установки.
#* '''Client''' интерфейсы игры, является обязательным компонентом.
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

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

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

После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.


==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.

В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

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

==Управление==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - переключиться между режимами карты: закрепить карту за локальным игроком (карта следует за меткой игрока) и свободное передвижение (карта остается неподвижной)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.

;'''maps''' :Отобразить список всех карт доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.

'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
'''Ошибки загрузки'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Неустранимые ошибки'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Ошибки типа 'Unable to enter vehicle''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[it:Manuale del Client]]

RU/Client Manual

2008-01-31T19:32:31Z

Sputnik:

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.

==Перед началом установки==

Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.

Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.

'''Обратите внимание: MTA:SA работает только с GTA:SA EXE v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.

Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу по адресу irc://irc.multitheftauto.com/mta

===Системные требования===
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.
* процессор класса Intel Pentium 4 или AMD Athlon XP
* 512МБ ОЗУ
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)
* 3.7ГБ свободного места на жестком диске (3.6ГБ для установки Grand Theft Auto)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx с 64MB ОЗУ и поддержкой DirectX 9.0
* звуковая карта или кодек с поддержкой DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет для стабильной игры через сеть

Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).

Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.

==Установка игры==

'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''

# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте установщик клиентского приложения MTA:SA.
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.
<br>
'''Выбран первый вариант: создать учетную запись'''<br>
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br>
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br>
Введите данные учетной записи в программу установки
<br><br>
# Затем вам будет необходимо выбрать компоненты для установки.
#* '''Client''' интерфейсы игры, является обязательным компонентом.
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

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

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

После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.


==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.

В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

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

==Управление==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - переключиться между режим карты: закрепить карту за локальным игроком (карта следует за меткой игрока) и свободное передвижение (карта остается неподвижной)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.

;'''maps''' :Отобразить список всех карт доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.

'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
'''Ошибки загрузки'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Неустранимые ошибки'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Ошибки типа 'Unable to enter vehicle''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[it:Manuale del Client]]

Главная страница

2008-01-30T14:27:11Z

Sputnik: более правильный вариант

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать на wiki-сайт разработчиков Multi Theft Auto: San Andreas Deathmatch. Здесь вы найдёте много полезной информации по разработке игровых режимов и карт для Multi Theft Auto.

Мы делаем подобные обзоры доступными для разработчиков, потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и нормально функционирующую версию MTA:SA DM. Создавайте игровые режимы и карты, помогайте документировать функции сценариев, пишите примеры кода, учебники или просто-напросто играйте и сообщайте обо всех найденых ошибках MTA на форумах.

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

Если у вас возникли вопросы или трудности по написанию сценариев, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki-сайт вам нужна учётная запись mtabeta.com.''' Зарегистрируйтесь на http://www.mtabeta.com и затем войдите в учётную запись wiki-сайта с тем же именем и паролем.

Этот wiki-сайт теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki-сайт вне сети (и быстро). Достаточно лишь установить Google Gears и нажать ссылку "Перейти в автономный режим" внизу любой страницы. Подождите пока приложение загрузит содержание страницы wiki-сайта на ваш компьютер и после этого текущая на момент загрузки версия страницы wiki-сайта будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало работы====

* [[RU/Deathmatch_Client_Manual|Руководство по клиентскому приложению]]
* [[RU/Deathmatch_Server_Manual|Руководство по серверному приложению]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Введение в написание сценариев]]
* [[Debugging|Учебник по отладке]] - Как найти ошибки в вашем сценарии
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[Element|MTA Elements]] / [[Element tree]]
* [[Resources|Введение в ресурсы]]
** [[Resource Web Access|Ресурсы веб-доступа]]
* [[Writing_Gamemodes|Написание игровых режимов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, предоставляемые MTA и ресурсами.
* [[Map manager|Менеджер карт]] - Используйте его для своих игровых режимов
* [[Client side scripts|Сценарии для клиентского приложения]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Общая помощь по Lua====
Страницы, спроектированные с целью помочь вам понять язык LUA
*[http://www.lua.org/pil/index.html Руководство "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory Wiki-сайт LUA]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Метки на радаре]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цвета машин]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}

[[it:Pagina principale]]

Главная страница

2008-01-28T07:28:16Z

Sputnik:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать на wiki-сайт разработчиков Multi Theft Auto: San Andreas Deathmatch. Здесь вы найдёте много полезной информации по разработке игровых режимов и карт для Multi Theft Auto.

Мы делаем подобные обзоры доступными для разработчиков, потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и нормально функционирующую версию MTA:SA DM. Создавайте игровые режимы и карты, помогайте документировать функции сценариев, пишите примеры кода, учебники или просто-напросто играйте и сообщайте обо всех найденых ошибках MTA на форумах.

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

Если у вас возникли вопросы или трудности по написанию сценариев, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki-сайт вам нужна учётная запись mtabeta.com.''' Зарегистрируйтесь на http://www.mtabeta.com и затем войдите в учётную запись wiki-сайта с тем же именем и паролем.

Этот wiki-сайт теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki-сайт вне сети (и быстро). Достаточно лишь установить Google Gears и нажать ссылку "Перейти в автономный режим" внизу любой страницы. Подождите пока приложение загрузит содержание страницы wiki-сайта на ваш компьютер и после этого текущая на момент загрузки версия страницы wiki-сайта будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало работы====

* [[RU/Deathmatch_Client_Manual|Руководство по клиентскому приложению]]
* [[RU/Deathmatch_Server_Manual|Руководство по серверному приложению]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Введение в написание сценариев]]
* [[Debugging|Учебник по отладке]] - Как найти ошибки в вашем сценарии
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[Element|MTA Elements]] / [[Element tree]]
* [[Resources|Введение в ресурсы]]
** [[Resource Web Access|Ресурсы веб-доступа]]
* [[Writing_Gamemodes|Написание игровых режимов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, предоставляемые MTA и ресурсами.
* [[Map manager|Менеджер карт]] - Используйте его для своих игровых режимов
* [[Client side scripts|Сценарии для клиентского приложения]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Общая помощь по Lua====
Страницы, спроектированные с целью помочь вам понять язык LUA
*[http://www.lua.org/pil/index.html Руководство "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory Wiki-сайт LUA]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Метки на радаре]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цвета машин]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}

[[it:Pagina principale]]

RU/Client Manual

2008-01-26T13:42:32Z

Sputnik:

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.

==Перед началом установки==

Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.

Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.

'''Обратите внимание: MTA:SA работает только с GTA:SA v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.

Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу @ irc://irc.multitheftauto.com/mta

===Системные требования===
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.
* процессор Intel Pentium 4 или AMD Athlon XP
* 512MB DDR RAM
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)
* 3.7GB свободного места на жестком диске (3.6GB для установки Grand Theft Auto)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx (64MB RAM и совместимость с DirectX 9.0)
* звуковая карта совместимая с DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет(для стабильной игры через сеть интернет)

Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).

Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.

==Установка игры==

'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''

# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте клиетнское приложение MTA:SA.
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.
<br>
'''Выбран первый вариант: создать учетную запись'''<br>
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br>
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br>
Введите данные учетной записи в программу установки
<br><br>
# Затем вам будет необходимо выбрать компоненты для установки.
#* '''Client''' интерфейсы игры, является обязательным компонентом.
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

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

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

После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.


==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.

В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

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

==Управление==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.

;'''maps''' :Отобразить список всех карт доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.

'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
'''Ошибки загрузки'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Неустранимые ошибки'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Ошибки типа 'Unable to enter vehicle''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

RU/Client Manual

2008-01-23T22:12:26Z

Sputnik:

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.

==Перед началом установки==

Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.

Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.

'''Обратите внимание: MTA:SA работает только с GTA:SA v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.

Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу @ irc://irc.multitheftauto.com/mta

===Системные требования===
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.
* процессор Intel Pentium 4 или AMD Athlon XP
* 512MB DDR RAM
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)
* 3.7GB свободного места на жестком диске (3.6GB для установки Grand Theft Auto)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx (64MB RAM и совместимость с DirectX 9.0)
* звуковая карта совместимая с DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет(для стабильной игры через сеть интернет)

Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).

Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.

==Установка игры==

'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''

# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте клиетнское приложение MTA:SA.
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.
<br>
'''Выбран первый вариант: создать учетную запись'''<br>
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br>
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br>
Введите данные учетной записи в программу установки
<br><br>
# Затем вам будет необходимо выбрать компоненты для установки.
#* '''Client''' интерфейсы игры, является обязательным компонентом.
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

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

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

После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.


==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.

В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

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

==Управление==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.

;'''maps''' :Отобразить список всех карт доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.

'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
'''Ошибки загрузки'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Неустранимые ошибки'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Ошибки типа 'Unable to enter vehicle''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

Главная страница

2008-01-23T11:58:19Z

Sputnik:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать на wiki-сайт разработчиков Multi Theft Auto: San Andreas Deathmatch. Здесь вы найдёте много полезной информации по разработке игровых режимов и карт для Multi Theft Auto.

Мы делаем подобные обзоры доступными для разработчиков, потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и нормально функционирующую версию MTA:SA DM. Создавайте игровые режимы и карты, помогайте документировать функции сценариев, пишите примеры кода, учебники или просто-напросто играйте и сообщайте обо всех найденых ошибках MTA на форумах.

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

Если у вас возникли вопросы или трудности по написанию сценариев, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki-сайт вам нужна учётная запись mtabeta.com.''' Зарегистрируйтесь на http://www.mtabeta.com и затем войдите в учётную запись wiki-сайта с тем же именем и паролем.

Этот wiki-сайт теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki-сайт вне сети (и быстро). Достаточно лишь установить Google Gears и нажать ссылку "Перейти в автономный режим" внизу любой страницы. Подождите пока приложение загрузит содержание страницы wiki-сайта на ваш компьютер и после этого текущая на момент загрузки версия страницы wiki-сайта будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало работы====

* [[RU/Deathmatch_Client_Manual|Руководство по клиентскому приложению]]
* [[RU/Deathmatch_Server_Manual|Руководство по серверному приложению]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Введение в написание сценариев]]
* [[Debugging|Учебник по отладке]] - Как найти ошибки в вашем сценарии
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[Element|MTA Elements]] / [[Element tree]]
* [[Resources|Введение в ресурсы]]
** [[Resource Web Access|Ресурсы веб-доступа]]
* [[Writing_Gamemodes|Написание игровых режимов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, предоставляемые MTA и ресурсами.
* [[Map manager|Менеджер карт]] - Используйте его для своих игровых режимов
* [[Client side scripts|Сценарии для клиентского приложения]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Общая помощь по Lua====
Страницы, спроектированные с целью помочь вам понять язык LUA
*[http://www.lua.org/pil/index.html Руководство "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory Wiki-сайт LUA]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Метки на радаре]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цвета машин]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}

Client Manual

2008-01-23T11:56:54Z

Sputnik:

__TOC__

==Introduction==
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.

Please note that MTA:SA Deathmatch is a beta, which means it could crash or cause unexpected results.

==Before you start==

Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.

Also make sure that you are running '''Windows XP''', '''Windows 2000''', '''Windows Vista''' or '''Windows Server 2003''' and that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.

'''Note: MTA:SA will only work on GTA:SA v1.0.''' If you bought the game recently, it is likely that you have a later version.

Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on IRC @ irc://irc.multitheftauto.com/mta

===System requirements===
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 or 1.1 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

For extra features, a pixel shader 2.0 compatible videocard (nVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.

For extra loading performance, more RAM is recommended.

==Installing the game==

'''This section will need to be updated when we get an installer'''

# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.
# Run the installer. You will be given an introductory dialog, then presented with the End User License Agreement (EULA). You must agree to this in order to continue installation.
# You will be presented with three (3) options where your able to create an account, use one your already have, or don't use an account - In this case select option Two (2)
<br>
'''Option One Selected'''<br>
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer<br>
'''Option Two Selected'''<br>
Proceed to entering your account details into the installer
<br><br>
# You will then be asked which components to install.
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# You are then asked for a folder in which to install the mod. You must set this to the same folder that San Andreas is installed in. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Click the '''Install''' button to commence installation.
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

<br /><br />
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. A new window will appear:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.

===Running the game from ASE (The All-Seeing Eye)===

If you are not satisfied with the in-game server browser of MTA:San Andreas, you might want to check out '''The All-Seeing Eye''', which allows you to browse the server list out of the game, and can apply custom filters. This tutorial will help with the setup of ASE, and show how to make join on double-click work.
# Download ASE from http://videogames.yahoo.com/multiplayer , and install.
# '''This applies to MTA:SA up to version 1.0 dp2, and will probably be fixed in a later version''' <br /> Download [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] and extract ASELauncher.exe to your MTA directory (default C:\Program Files\MTA San Andreas). This tiny program converts the ASE command-line to a format MTA can understand.
# Now add MTA:SA to your ASE games list:
#* In ASE, click ''Tools'' -> ''Options'', and select the tab ''Games''
#* Open the category ''Not installed'' and select ''Multi Theft Auto'' in the list
#* Check ''Visible in filter list'', click ''Browse'' and select '''ASELauncher.exe''' in your MTA San Andreas directory
#* Leave the field ''Player name'' empty, and close the dialog with ''OK''
# A new game '''Multi Theft Auto''' has appeared. When you click ''Refresh'' in the toolbar, you will see all servers for all versions of MTA. Now add a modifier to only show the current version, '''1.0 dp2'''
#* Right-click ''Multi Theft Auto'' and select ''New...''
#* In the lower-left, select ''Modifier'' and replace MYMOD by '''MTADP2'''
#* Enter a name for the modifier in the ''Name'' field, e.g. '''MTA:SA 1.0 dp2'''
#* Insert the following filter code (with the line number):<br /><tt>1 if version != "1.0dp2" remove</tt>
#* Click ''OK''
#* Your new modifier is shown under ''My filters''
# All done! Now activate your modifier to only show your game version, select the game ''Multi Theft Auto'', and double-click any server to play.

==How to Play==

MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.

There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.

MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay.

Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.

==Controls==

===In-Game Keys===

* F8 (or Tilde Key) - Console
* F9 - In-game help
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad +/- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.

;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.

;'''ver''' :This displays the version number and copyright information for the software.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.

==Error codes and their meanings==
'''Download errors'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Fatal errors'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

''''Unable to enter vehicle' errors'''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

[[ru:Deathmatch Client Manual]]

RU/Client Manual

2008-01-23T11:52:29Z

Sputnik: New page: __TOC__ ==Введение== Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, создан...

__TOC__

==Введение==
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.

Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.

==Перед началом установки==

Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.

Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.

'''Обратите внимание: MTA:SA работает только с GTA:SA v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.

Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу @ irc://irc.multitheftauto.com/mta

===Системные требования===
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.
* процессор Intel Pentium 4 или AMD Athlon XP
* 512MB DDR RAM
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)
* 3.7GB свободного места на жестком диске (3.6GB для установки Grand Theft Auto)
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx (64MB RAM и совместимость с DirectX 9.0)
* звуковая карта совместимая с DirectX 9.0
* клавиатура и мышь
* широкополосный доступ в интернет(для стабильной игры через сеть интернет)

Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).

Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.

==Установка игры==

'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''

# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте клиетнское приложение MTA:SA.
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.
<br>
'''Выбран первый вариант: создать учетную запись'''<br>
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br>
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br>
Введите данные учетной записи в программу установки
<br><br>
# Затем вам будет необходимо выбрать компоненты для установки.
#* '''Client''' интерфейсы игры, является обязательным компонентом.
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.

==Запуск игры==
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font>

<br />
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font>

<br />
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font>

<br /><br />
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font>

<br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font>

<br /><br />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font>

<br /><br />
|}

Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.

* В столбце '''Name''' отображается название каждого сервера.
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.

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

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

После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.


==Как играть==

MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.

В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.

Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным.

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

==Управление==

===Клавиши управления в игре===

* F8 (или клавиша "тильда") - Консоль
* F9 - Помощь игрового сервера
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''
**numpad +/- - Увеличить/уменьшить масштаб карты
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Сделать снимок изображения экрана
* T - Чат
* Y - Командный чат
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)

==Команды консоли==

'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию

Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.

;'''maps''' :Отобразить список всех карт доступных на сервере.

;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.

;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.

;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.

;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.

;'''time''' :Отобразить текущее время.

;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.

;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.

;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.

'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).

Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.

==Коды ошибок и их описание==
'''Ошибки загрузки'''<br>
0: UNKNOWN_ERROR<br>
1: INVALID_FILE_DESCRIPTORS<br>
2: INVALID_MAX_FILE_DESCRIPTOR<br>
3: INVALID_SELECT_RETURN<br>
4: INVALID_INITIAL_MULTI_PERFORM<br>
5: INVALID_MULTI_PERFORM_CODE<br>
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br>
7: UNEXPECTED_CURL_MESSAGE<br>
8: UNABLE_TO_CONNECT<br>
9: UNABLE_TO_DOWNLOAD_FILE<br>
10: FAILED_TO_INITIALIZE_DOWNLOAD<br>

'''Неустранимые ошибки'''<br>
1: no local player model on ingame event<br>
2: no local player on ingame event<br>
3: server downloads disabled<br>
4: no local player model on player-list packet<br>
5: no local player on player-list packet<br>
6: invalid custom data length on entity-add packet<br>
7: invalid bitstream data on entity-add packet<br>
8: system entity on entity-add packet<br>
9: failed to create object on entity-add packet<br>
10: failed to create pickup on entity-add packet<br>
11: failed to create vehicle on entity-add packet<br>
12: invalid team-name length on entity-add packet<br>
13: invalid lua-event name length in lua-event packet<br>
14: invalid resource name length in resource-start packet<br>

'''Ошибки типа 'Unable to enter vehicle''''<br>
1: script cancelled<br>
2: script cancelled (jack)<br>
3: current occupier is entering/exiting<br>
4: invalid seat<br>
5: not close enough<br>
6: already in a vehicle<br>
7: already entering/exiting<br>
8: invalid vehicle (trailer)<br>

Главная страница

2008-01-22T20:54:49Z

Sputnik:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать на wiki-сайт разработчиков Multi Theft Auto: San Andreas Deathmatch. Здесь вы найдёте много полезной информации по разработке игровых режимов и карт для Multi Theft Auto.

Мы делаем подобные обзоры доступными для разработчиков, потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и нормально функционирующую версию MTA:SA DM. Создавайте игровые режимы и карты, помогайте документировать функции сценариев, пишите примеры кода, учебники или просто-напросто играйте и сообщайте обо всех найденых ошибках MTA на форумах.

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

Если у вас возникли вопросы или трудности по написанию сценариев, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki-сайт вам нужна учётная запись mtabeta.com.''' Зарегистрируйтесь на http://www.mtabeta.com и затем войдите в учётную запись wiki-сайта с тем же именем и паролем.

Этот wiki-сайт теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki-сайт вне сети (и быстро). Достаточно лишь установить Google Gears и нажать ссылку "Перейти в автономный режим" внизу любой страницы. Подождите пока приложение загрузит содержание страницы wiki-сайта на ваш компьютер и после этого текущая на момент загрузки версия страницы wiki-сайта будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало работы====

* [[Deathmatch_Client_Manual|Руководство по клиентскому приложению]]
* [[RU/Deathmatch_Server_Manual|Руководство по серверному приложению]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Введение в написание сценариев]]
* [[Debugging|Учебник по отладке]] - Как найти ошибки в вашем сценарии
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[Element|MTA Elements]] / [[Element tree]]
* [[Resources|Введение в ресурсы]]
** [[Resource Web Access|Ресурсы веб-доступа]]
* [[Writing_Gamemodes|Написание игровых режимов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, предоставляемые MTA и ресурсами.
* [[Map manager|Менеджер карт]] - Используйте его для своих игровых режимов
* [[Client side scripts|Сценарии для клиентского приложения]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Общая помощь по Lua====
Страницы, спроектированные с целью помочь вам понять язык LUA
*[http://www.lua.org/pil/index.html Руководство "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory Wiki-сайт LUA]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Метки на радаре]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цвета машин]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}

Главная страница

2008-01-22T19:35:36Z

Sputnik:

__NOTOC__
<div style="float:left;"><div style="float:right;">[[Image:Scripting.jpg]]</div>Добро пожаловать в Multi Theft Auto: San Andreas Deathmatch developer wiki. В этом wiki вы найдёте множество полезной информации по разработке режимов и карт для Multi Theft Auto.

Мы выпускаем предрелизные превью потому что нам нужна ваша помощь! Существует множество [[How you can help|способов помочь нам]] доработать и выпустить полностью законченную и отполированную версию MTA:SA DM. Создавайте режимы и карты, помогайте зафиксировать скриптинговые функции, пишите примеры, учебники или просто-напросто играйте и сообщайте обо всех ошибках MTA на форумах.

Если у вас возникли вопросы на тему скриптинга, свяжитесь с нами на нашем [[IRC Channel|IRC канале]].

'''Чтобы редактировать этот wiki вам нужна учётная запись mtabeta.com.''' Зарегистрируйтесь на http://www.mtabeta.com и затем войдите в учётную запись wiki с тем же именем и паролем.

Этот wiki теперь поддерживает '''[http://gears.google.com/ Google Gears]''', который позволяет просматривать wiki вне сети (и быстро). Всего лишь установите Google Gears и нажмите ссылку "Уйти в оффлайн" внизу любой страницы. Подождите пока приложение загрузит содержание wiki на ваш компьютер и после этого текущая на момент загрузки версия wiki будет доступна без подключения к серверу.

<div style="border: 2px dotted navy; padding: 4px; margin: 10px">Новейшая версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://www.mtasa.com/dp.html страницу загрузки], чтобы скачать её.</div>

</div>

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Начало====

* [[Deathmatch_Client_Manual|Помощь по клиенту]]
* [[RU/Deathmatch_Server_Manual|Помощь по серверу]]
* [[Known_Issues_-_FAQ|Известные ошибки MTA:SA DM]]
* [[RU/Scripting Introduction|Вступление в скриптинг]]
* [[Debugging|Debugging Tutorial]] - Как найти ошибки в вашем скрипте
* [[MTA Classes]] - Подробные описания всех типов значений MTA
** [[Element|MTA Elements]] / [[Element tree]]
* [[Resources|Introduction to Resources]]
** [[Resource Web Access]]
* [[Writing_Gamemodes|Написание модов]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Базы данных====
В этой части описаны все возможности LUA, которые предоставляют MTA или resources.
* [[Map manager|Менеджер карт]] - Используйте это для своих режимов
* [[Client side scripts|Скрипты для клиента]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Помощь по Lua вообще====
Страницы-учебники, цель которых - повысить ваш уровень понимания языка LUA
*[http://www.lua.org/pil/index.html Учебник "Программирование на LUA"]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">
====Справочник====
* [[Client Scripting Functions|Функции клиентского приложения]]
* [[Client Scripting Events|События клиентского приложения]]
* [[Server Scripting Functions|Функции серверного приложения]]
* [[Server Scripting Events|События серверного приложения]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Списки идентификаторов====
* [[Character Skins|Персонажи]] ([[All Skins Page]])
* [[CJ Clothes|Одежда]]
* [[Template:Projectiles|Метательное оружие]]
* [[Template:Blip_Icons|Иконки]]
* [[Template:Sounds|Звуки]]
* [[Vehicle IDs|Машины]]
* [[Vehicle_default_colors|Перечень цветов машин по умолчанию]]
* [[Template:Vehicle_colors|Цветов]]
* Vehicle Upgrades
* [[Weapons|Оружие]]
* [[Weather|Погода]]
</div>

|-
| colspan="2" |
|}