Multi Theft Auto: Wiki - User contributions [en]

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

2012-08-01T23:06:59Z

Vincent:

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

Все, связанное со скриптингом, находится в ресурсах. Назначение ресурса и определяет, является ли он модом, картой или чем-либо еще. MTA поставляется с ресурсами, которые вы можете выборочно использовать в своих модах, например, maplimits, позволяющий удерживать игроков в рамках указанных границ карты, или deathpickups, создающий пикапы с оружием.
{{tip|Первым шагом в изучении Lua-скриптинга должен быть выбор Lua-редактора. Это намного упрощает скриптинг. Мы рекомендуем [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] или [http://luaedit.sourceforge.net/ LuaEdit]. Также имеется неофициальный [[MTASE|MTA Script Editor]] (на стадии разработки), который вы можете испытать.}}

==Создание работающего скрипта==
Для начала мы узнаем, как пошагово сделать базовый скрипт, который позволит игроку прогуливаться по городу.
===Где находятся все скрипты?===
Давайте взглянем на файловую структуру скрипта. Зайдите в папку сервера MTA и пройдите по следующему пути:

/server/mods/deathmatch/resources/

Вы увидите множество .zip-архивов, являющихся упакованными пробными скриптами, поставляемыми с MTA DM. Каждый файл - это "ресурс", все они будут распакованы и загружены сервером при его старте. Чтобы создать свой собственный ресурс, просто создайте папку и назовите ее так, как хотите. В нашем случае мы назовем ее "myserver".

Теперь вам нужно зайти в эту папку:

/server/mods/deathmatch/resources/myserver/

===Идентификация вашего ресурса===
Чтобы сервер мог узнать о содержимом того или иного ресурса, в нем должен быть создан файл ''meta.xml'', перечисляющий его содержимое. Этот файл должен быть расположен в корневой директории ресурса, в нашем случае - это папка "myserver". Просто создайте текстовый файл, назовите его "meta.xml" и откройте с помощью Блокнота (notepad).

В файл ''meta.xml'' введите следующий код:
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
В теге ''<info />'' есть поле "type", которое говорит о том, что данный ресурс - ''gamemode'' ("мод", игровой режим), а не обычный include или ''map'' (карта), о которых мы поговорим чуть позже. Gamemode - то, что вам нужно, чтобы создать независимый сервер.

Тег ''<script />'' оговаривает сценарии (скрипты), которые содержит ресурс, о них мы сейчас и поговорим.
===Создание простого скрипта===
Заметьте, что в теге ''<script />'' выше .lua-файл не находится в какой-либо вложенной директории. Следовательно, мы создадим файл в той же папке, что и meta.xml. Теперь можно скопировать и вставить в script.lua следующий код:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Этот скрипт заспавнит вас по координатам (x, y, z), указанным выше, когда вы зайдете на сервер. Обратите внимание, что функция ''fadeCamera'' обязательно должна быть, иначе экран будет черным. К тому же, в релизах новее DP2 вам нужно установить цель для камеры (иначе все, что увидит игрок - синее небо).

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

Если присмотреться к [[addEventHandler]], вы заметите три вещи: 'onPlayerJoin', указывающий на то, когда (почему) произойдет срабатывание; getRootElement(), который показывет благодаря кому/чему может произойти срабатывание (getRootElement() - это все/всё) и joinHandler, который отвечает за функцию, на которую произойдет переключение при срабывании события. Остальные подробности будут изложены позже и на отдельном примере, а теперь давайте просто запустим сервер и попрактикуемся!

===Запуск скрипта===
Чтобы запустить сервер, просто запустите исполняемый файл (на Windows - .exe) по адресу ''MTA San Andreas x.x/server'', где x.x - номер версии MTA. Сначала будут показаны данные сервера; запомните номер порта (server port), который понадобится вам при подключении. Затем сервер загрузит все ресурсы в папку mods/deathmatch/resources/ и позже будет "ready to accept connections!", то есть готов принимать игроков.

Перед тем, как вы подключитесь к серверу, нужно обязательно запустить мод (gamemode). Введите "start myserver" и нажмите Enter. Сервер запустит мод, который вы только что создали, а также начнет отображать различные ошибки и предупреждения, если таковые будут. Теперь можно запустить клиент MTA DM и подключиться через "Quick Connect", воспользовавшись IP-адресом вашего сервера и номером порта, на который мы ранее обратили ваше внимание. Если все пройдет по плану, через несколько секунд ваш персонаж сможет пройтись по улицам Los Santos'а.

Затем мы добавим в скрипт команду, которую игроки смогут использовать для того, чтобы спавнить рядом с собой транспортное средство. Вы можете это пропустить и взглянуть на статью про более продвинутый скриптинг с использованием [[RU/Map manager|Map Manager]], которая продолжит это руководство. Еще одним ответвлением данного руководства является [[Введение в скриптинг GUI]]: прочитав его, вы узнаете, как рисуется и программируется Graphical User Interface в MTA:DM.

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

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

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

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

Если у вас уже есть опыт в скриптинге, вы знаете, что функции вызываются примерно следующим образом:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
Присмотревшись ко второму образцу (выше), мы увидим, что argument1 - thePlayer, а argument2 - commandName. thePlayer - тот, кто набрал команду, так что как бы вы ее не вводили, переменная будет содержать игрока, который ее активировал. commandName - команда, которую ввели. Так что при вводе "/greet", этот аргумент будет содержать "greet". Argument 3 - еще что-то, введенное игроком после, об этом вы узнаете чуть позже из данного руководства. Никогда не забывайте, что первые 2 аргумента являются стандартными, но назвать вы их можете по своему усмотрению. То есть важен порядок, а не название.

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

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

''Заметка: Обработчик команды надо добавлять именно ПОСЛЕ функции, на которую он сошлется, иначе она не будет найдена. Порядок имеет значение!''

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

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

Для [[getElementPosition]] синтаксис таков:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

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

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (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>

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

Внутри нашей функции у нас уже есть все аргументы, которые нужны функции [[createVehicle]]: Только что вычисленная позиция в переменных ''x,y,z'' и id модели, который мы получили через команду ("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
-- если да, то выводим сообщение в чат, но только для игрока, который спавнил ТС.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

Как вы уже, наверное, заметили, вашему взору предстала новая функция - [[outputChatBox]]. Теперь вы самостоятельно можете изучить содержимое ее страницы-документации. Чтобы узнать больше о продвинутом скриптинге, почитайте про [[RU/Map manager|Map Manager]].

==Что вам следует знать==
Вы уже кое-что прочитали о ресурсах, обработчиках команд и поиске функций в документации в первом разделе, но многое еще предстоит узнать. Этот раздел проведет довольно краткий обзор о некоторых из этих вещей, по возможности ссылаясь на соответствующие страницы.
===Клиентские и серверные скрипты===
Может быть, вы уже заметили эти или схожие термины (сервер/клиент) где-либо на данной вики, наиболее вероятно, вкупе с функциями. MTA не только поддерживает работающие на сервере скрипты, предоставляет команды (типа как мы писали выше) и другие возможности, но также и скрипты, выполняющиеся на клиенте MTA, который игроки используют для подключения к серверу. Причиной этому служит то, что некоторые предоставляемые MTA функции не могут быть серверными (например, GUI - Graphical User Interface, т.е. графический интерфейс пользователя), другие там просто работают лучше, но другим все же лучше быть серверными или попросту не работать на клиентской стороне.

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

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

====Первый пример - Вспомогательный скрипт====
<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'' предоставляет GUI, чтобы возможно было с легкостью выполнять вышеуказанные действия

Этот пример может выполняться все время (даже автозапускаться со стартом сервера), так как является полезным на протяжении всего игрового процесса и не конфликтует с ним, если администратор, конечно, сам этого не захочет.

====Второй пример - Мод====
<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'' говорит о том, что этот пример работает с [[RU/Map manager|Map Manager]], уже другим ресурсом, написанным QA Team для управлениями модами и подгрузки карт. Очень рекомендуется основывать свои моды на предоставляемом им функционале.

Это также означает, что мод, возможно, не запустится без карты. Моды всегда должны пользоваться общим функционалом настолько широко, насколько это возможно. Образец карты - в следующем примере.

====Третий пример - Карта====
<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', сообщая [[RU/Map manager|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'ом, и информация, которую он содержит, может быть прочитана ресурсом-модом. При смене карты, текущий ресурс-карта останавливается, а следующий - запускается. Для более детального разъяснения и образцов того, как ресурсы-карты используются основным скриптом, посетите страницу [[RU/Writing Gamemodes]].

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

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

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

==Что делать теперь==
Теперь вы знакомы с наиболее базовыми аспектами скриптинга в MTA, а также чуть-чуть с документацией. [[Главная страница]] обеспечит вас ссылками на множество различной информации, руководства и указания, которые позволят глубже взглянуть на интересующие вас темы.
{{note|Теперь мы рекомендуем вам прочитать руководство по [[RU/Debugging|отладке]]. Умение хорошо отлаживать - абсолютная необходимость при написании скриптов. Мы также рекомендуем вам пользоваться [[RU/Predefined variables list|списком предписанных переменных]], который поможет вам в выполнении определенных задач, а писать скрипты станет намного легче и быстрее.}}
'''Также смотрите:'''
* [[Advanced Topics|Продвинутый функционал]]
[[en:Scripting Introduction]]
[[es:Introducción a la Programación]]
[[it:Introduzione allo scripting]]
[[nl:Scripting_introductie]]

RU/MTA 0.5r2 Known Issues

2012-07-27T23:51:16Z

Vincent:

{{MTA0.5 page}}
__NOTOC__Это руководство применимо к MTA 0.5r2 (обе GTA3:MTA и MTA:VC). Руководство для MTA:SA 1.x [[RU/Known_Issues_-_FAQ | здесь]].

== Проблемы с клиентской частью ==
*'''Австралийские и немецкие EXE (и, возможно, другие) могут вызывать ошабку "invalid executable" во время попытки зайти в игру.'''
Так как австралийские и немецкие EXE ненадежно работают с MTA, это не такая уж и большая проблема. Попробуйте обзавестись стандартным EXE. Можете попробовать [http://forum.mtasa.com/viewtopic.php?f=50&t=12180 патчер несовместимых EXE от '''Talidan'''].

*'''Краш во время загрузки MTA:VC DM.'''
Хотя бы единожды удостоверьтесь, что можете запустить GTA3 или Vice City в режиме одиночной игры без MTA, перед тем как пробовать играть с MTA. Если не получится, пробуйте [http://updates.rockstargames.com/patches/vicecity/vicepatch_11.zip патч Vice 1.1]. Если и это не сработает, напишите на [http://forum.mtasa.com/viewforum.php?f=50 форум поддержки].

*'''Зависание во время попытки отобразить диалог запроса пути к игре.'''
Известно несколько таких случаев, и нам самим было бы интересно узнать, почему это происходит. Вы можете предотвратить зависание, вручную задав путь в mta.ini, что в папке с Multi Theft Auto.
Для Vice City, ваш mta.ini должен содержать (измените путь при надобности):
<pre>[Game-VC]
Version=0
Location=C:\Program Files\Rockstar Games\Grand Theft Auto Vice City\gta-vc.exe</pre>
Для GTA3:MTA, ваш mta.ini должен содержать (измените путь при надобности):
<pre>[Game-GTA3]
Version=1
Location=C:\Program Files\Rockstar Games\GTAIII\gta3.exe</pre>

*'''XFire крашит игру во время загрузки.'''
И XFire, и MTA используют одинаковые методы интегрирования самих себя в игру. Мы связались с командой разработчиков XFire, чтобы предложить нашу помощь во внедрении MTA, но они нам не ответили. Если вы хотели бы использовать XFire с MTA, свяжитесь с командой разработчиков XFire сами. На данный момент, просто отключайте XFire на время игры.

*'''MTA пишет "Suspected Trainer Usage."'''
Для начала попробуйте закрыть все открытые окна, если не поможет, перезапустите MTA. Если и это не сработает, попробуйте переустановить MTA 0.5r2.

*'''При подключении к серверу мне говорят, что я забанен, хотя меня нет в бан-листе.'''
Причина этого неизвестна. Может быть, вы забанены глобальным баном в банлисте сервера.

*'''Клиент вылетает при попытке подключения к серверу.'''
Это может быть вызвано тем, что клиент пытается загрузить rich text MOTD, указанный на сервере и в процессе происходит сбой (напр., сайт, на котором он расположен, выключен или его URL указан неверно).

*'''У меня на компьютере есть несколько файлов с названием mtachat.txt.'''
mtachat.txt, как вы уже, наверное, догадались, хранит лог чата. Эта функция была добавлена в последнйи момент и не была должным образом протестирована, поэтому и возникли проблемы. Возможно, это связано с тем, как был запущен клиент (стартовый путь влияет на место хранения файла, а не путь установки). Вы можете без проблем их удалять.

*'''Во время щелчка по "Start Game" появляется сообщение "your client is modified."'''
Нажмите '''Start Game''' еще раз.

*'''Во время игры в GTA3 я получаю ошибку "Invalid Executable".'''
Возможно, это вызвано использованием GTA3 версии 1.0 вместо 1.1. Вы можете скачать патч GTA3 до 1.1 [http://updates.rockstargames.com/patches/grandtheftauto3/GTA3patch1.1.zip здесь]. Если это не помогло, или у вас уже GTA3 версии 1.1, удостоверьтесь, что у вас USA/UK EXE; вы можете попробовать [http://forum.mtasa.com/viewtopic.php?f=50&t=12180 патчер несовместимых EXE от '''Talidan''']. Если это тоже не получится, попробуйте обзавестись USA/UK EXE еще где-нибудь.

*'''Антивирус предупредил меня, что исполняемый файл Multi Theft Auto 0.5r2 - вирус или вредноносная программа.'''
MTA <u>не</u> содержит вирусов, вредноносных, рекламных или шпионских программ. Ложное срабатывание вызвано способом упаковки исполняемого файла. Удостоверьтесь, что вы скачали мультиплеер именно с нашего сайта. [http://dl.dropbox.com/u/12783812/mta05r2_full_installer.exe Эта ссылка] размещена на нашем аккаунте. Используйте ее, если сомневаетесь, что у вас оригинальная копия MTA.

*'''Я получил ошибку по адресу 652F30 при старте игры.'''
Установите в игре английский (English) язык.

== Ошибки в игровом процессе: ==
*'''MTA:VC (на любой карте) вылетает, когда я пытаюсь сесть пассажиром на мотоцикл без водителя, вкупе с другими крашами при мотоциклах.'''
Извините, мы не смогли это починить в 0.5r2. Может быть, в будущем мы это исправим.

*'''MTA:VC DM: Невозможно бегать и прыгать с коктейлем молотова в руках, но с гранатами - можно.'''
Это будет исправлено в следующем релизе, если таковой будет.

*'''MTA:VC (на любой карте): после выхода из режима наблюдателя, можно увидеть быстрый проблеск падающего Томми, который потенциально может получить урон от падения; после респавна, у скина менее 100 хп (hp).'''
Это будет исправлено в следующем релизе, если таковой будет.

*'''GTA3:MTA, Turismo/Shoreside Scramble режим: Во время гонки, если умирает один гонщик, то все остальные живые вылетают с сервера.'''
Мы тоже не смогли починить это в 0.5r2. Может быть, в будущем мы это исправим.

*'''GTA3:SSV, Van Heist режим: Маркер дома-базы мерцает, при взрыве Securicar указатель урона принимает отрицательные значения.'''
Придется с этим смириться, мы не смогли починить это в 0.5r2. Может быть, в будущем мы это исправим.

== Проблемы с серверной частью ==
*'''Я получаю ошибку "ERROR: The ServerName, ServerPort, GameMap, GameHour, GameMins, Weather and BannedFile MUST be specified in the configuration file", когда запускаю свой сервер, хотя все поля заполнены. <br>''Затрагивает только Server Patch 1 Hotfix'''''
Убедитесь, что имя вашего сервера занимает 49 символов или меньше. Это скользкая ошибка.

*'''При подключении к серверу я получаю time out, и другие игроки тоже.'''
До недавнего времени это была неизвестная проблема, но, похоже, ее вызывает не MTA или MTAServer, а MTA:mA или другие скрипты, запущенные на нем. Если скрипт отправляет игроку несколько сообщений во время его подключения, вероятность вылета высока. В результате никто не может играть.

Сейчас доступно исправление к MTA:mA, скачать можно [http://forum.mtasa.com/viewtopic.php?p=181919#181919 здесь] (надеюсь, GRS тоже вскоре будет обновлен).

Следуйте инструкциям '''Aeron''''а по пользованию.

Большое спасибо '''Mike''' за установление данной проблемы и '''Aeron''''у за столь оперативную "заплатку".

[[en:MTA_0.5r2_Known_Issues]]

[[Category:Vice_City]]
[[Category:GTA3]]
[[Category:MTA_0.5]]

RU/Anti-cheat guide

2012-07-27T23:49:09Z

Vincent: wrong place

=Руководство по АЧ (АнтиЧиту)=

==Серверное устройство==

Поведение античита на сервере контролируют 3 настройки [[RU/Server_mtaserver.conf|'''mtaserver.conf''']]:

===<disableac></disableac>===
----
Список отключенных античитов, разделенный запятыми. Данная настройка античита отключит АЧ определенных кодов. Коды АЧ показываются игроку при срабатывании соответствующих проверок. Доступные коды:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <disableac>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Обнаружитель классических хаков на хп/броню
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Обнаруживает присутствие трейнеров. Заглавные буквы в сообщении служат для отметки конкретных трейнеров
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Обнаруживает использование трейнера, влияющего на: передвижение игрока, хп/урон, оружие, деньги, скорость игры; также игровые читы, аимбот
|-
| scope="row" style="background:#efefef;" align="center"|'''7'''
| style="background:#f8f8f8;" align="center"|VF #7
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Обнаруживает посторонние моды. Заглавные буквы в сообщении служат для отметки конкретных модов, например, CLEO - обнаружен Cleo, RENDER - обнаружен воллхак
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| Еще трейнеры
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Трейнер
|-
| scope="row" style="background:#efefef;" align="center"|'''13'''
| style="background:#f8f8f8;" align="center"|SD #13
| style="background:#f8f8f8;"|Вопрос по data-файлам
|}
<br/>
===<enablesd></enablesd>===
----
Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым. Доступные коды:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <enablesd>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Запрет на собственный D3D9.DLL
|}
<br/>

===<client_file name="data/carmods.dat" verify="0"/>===
----
По умолчанию клиенты могут не смочь присоединиться к серверу, если data-файлы их GTA:SA изменены. Добавление одной или более строк по образцу выше исключит файлы из списка проверяемых. Названия файлов, пригодных к использованию:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Заметка 1:''''' ''"data/maps" представляет все файлы и папки внутри "data/maps"''<br/>

'''''Заметка 2:''''' ''"data/handling.cfg" не учитывается, так как он игнорируется MTA в любом случае в связи со встроенным функционалом управления транспортом. Если вы хотите подгрузить собственные файлы handling.cfg, то аналогичный эффект можно достичь благодаря использованию соответствующего ресурса.''<br/>

==Клиент==
При подсоединению к серверу информация по АЧ сервера отображается в клиентской консоли (F8)<br/>
Пример:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC содержит данные серверной настройки, указанные в <disableac></disableac><br/>
Enabled SD содержит данные серверной настройки, указанные в <enablesd></enablesd><br/>
Allowed client files содержит номера, указывающие на файлы, разрешенные клиенту сервером для модификации. Номера отвечают за следующие файлы:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Использование модифицированных файлов====
Если вы хотите использовать модифицированные data-файлы из вашей папки с установенной GTA:SA, поставьте маркер маркер в:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(маркер появляется только когда у вас изменены data-файлы GTA:SA)<br/>

Заметьте, что это ограничит ваш доступ к публичным серверам, так как большиснтво из них не приемлет измененные файлы данных.

[[Category: Support]]
[[en:Anti-cheat guide]]

RU/Anti-cheat guide

2012-07-27T23:47:30Z

Vincent: /* */

=Руководство по АЧ (АнтиЧиту)=

==Серверное устройство==

Поведение античита на сервере контролируют 3 настройки [[RU/Server_mtaserver.conf|'''mtaserver.conf''']]:

===<disableac></disableac>===
----
Список отключенных античитов, разделенный запятыми. Данная настройка античита отключит АЧ определенных кодов. Коды АЧ показываются игроку при срабатывании соответствующих проверок. Доступные коды:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <disableac>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Обнаружитель классических хаков на хп/броню
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Обнаруживает присутствие трейнеров. Заглавные буквы в сообщении служат для отметки конкретных трейнеров
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Обнаруживает использование трейнера, влияющего на: передвижение игрока, хп/урон, оружие, деньги, скорость игры; также игровые читы, аимбот
|-
| scope="row" style="background:#efefef;" align="center"|'''7'''
| style="background:#f8f8f8;" align="center"|VF #7
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Обнаруживает посторонние моды. Заглавные буквы в сообщении служат для отметки конкретных модов, например, CLEO - обнаружен Cleo, RENDER - обнаружен воллхак
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| Еще трейнеры
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Трейнер
|}
<br/>
===<enablesd></enablesd>===
----
Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым. Доступные коды:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <enablesd>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Запрет на собственный D3D9.DLL
|-
| scope="row" style="background:#efefef;" align="center"|'''13'''
| style="background:#f8f8f8;" align="center"|SD #13
| style="background:#f8f8f8;"|Вопрос по data-файлам
|}
<br/>

===<client_file name="data/carmods.dat" verify="0"/>===
----
По умолчанию клиенты могут не смочь присоединиться к серверу, если data-файлы их GTA:SA изменены. Добавление одной или более строк по образцу выше исключит файлы из списка проверяемых. Названия файлов, пригодных к использованию:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Заметка 1:''''' ''"data/maps" представляет все файлы и папки внутри "data/maps"''<br/>

'''''Заметка 2:''''' ''"data/handling.cfg" не учитывается, так как он игнорируется MTA в любом случае в связи со встроенным функционалом управления транспортом. Если вы хотите подгрузить собственные файлы handling.cfg, то аналогичный эффект можно достичь благодаря использованию соответствующего ресурса.''<br/>

==Клиент==
При подсоединению к серверу информация по АЧ сервера отображается в клиентской консоли (F8)<br/>
Пример:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC содержит данные серверной настройки, указанные в <disableac></disableac><br/>
Enabled SD содержит данные серверной настройки, указанные в <enablesd></enablesd><br/>
Allowed client files содержит номера, указывающие на файлы, разрешенные клиенту сервером для модификации. Номера отвечают за следующие файлы:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Использование модифицированных файлов====
Если вы хотите использовать модифицированные data-файлы из вашей папки с установенной GTA:SA, поставьте маркер маркер в:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(маркер появляется только когда у вас изменены data-файлы GTA:SA)<br/>

Заметьте, что это ограничит ваш доступ к публичным серверам, так как большиснтво из них не приемлет измененные файлы данных.

[[Category: Support]]
[[en:Anti-cheat guide]]

RU/Building MTASA Server on GNU Linux

2012-07-17T16:13:47Z

Vincent: /* Подготовка системы */

{{Note|Эта статья предназначена только для тех владельцев, кто внес изменения в код сервера. Если вам нужен прекомпилированный сервер (для обычных владельцев серверов), перейдите на [http://linux.mtasa.com/ linux.mtasa.com]}}

== Подготовка системы ==

Чтобы собрать выделенный сервер Multi Theft Auto, вам понадобится снабдить свою систему определенными библиотеками и инструментами. Как их устанавливать, зависит от вашего дистрибутива.

Наш сетевой модуль (net.dll или net.so) поставляется как прекомпилированная двоичная библиотека. Файл для GNU/Linux можно получить из новейшего nightly-билда для Linux, то есть [http://nightly.mtasa.com/ отсюда]. Используйте net.so от 1.4, если компилируете из trunk, или net.so от 1.3.x, если компилируете ветвь 1.3.x. Удостоверьтесь, что вы прочитали верхнюю часть ''MTA10_Server/version.h'', так как там содержатся указания по компилированию билдов разного типа.

'''Debian Linux'''

Включает производные дистрибутивы типа Ubuntu.

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки, поставляемые через соответствующие пакеты Debian (напр. Debian Lenny):

* '''build-essential:''' содержит необходимые инструменты, заголовки и библиотеки для сборки приложений
* '''automake:''' содержит инструменты automake (автосборка)
* '''libtool:''' содержит программное обеспечение libtool, нужное для сборки библиотек
* '''libcurl3-dev:''' содержит библиотеку cURL (версия 3 без поддержки SSL)
* '''libpcre3-dev:''' содержит библиотеку PCRE (версия 3)
* '''libsqlite3-dev:''' содержит библиотеку SQLite (версия 3)
* '''libreadline5-dev:''' содержит библиотеку readline (версия 5)
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''libncurses5-dev:''' содержит программное обеспечение для контроля над записью в окне консоли
* '''libncursesw5-dev:''' содержит поддержку для широких символов
* '''libsparsehash-dev:''' содержит поддержку для Google hash-map '''(Так что вам не придется компилировать sparehash!)'''
* '''libmysqlclient-dev:''' содержит библиотеку MySQL
Чтобы установить эти пакеты через apt, используйте команду apt-get install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev libsparsehash-dev libmysqlclient-dev</syntaxhighlight>

'''Gentoo Linux'''

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки. Но так как система портирования Gentoo сделана так, что компиляция любых пакетов происходит внтури самой системы, необходимые инструменты для сборки будут итак предустановелены. Все, что остается - установить необходимые библиотеки:

* '''sqlite:''' содержит библиотеку SQLite
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''curl:''' содержит библиотеку cURL; чтобы скомпилировать с поддержкой SSL, примените флаг net-misc/curl ssl USE
Чтобы скомпилировать и установить эти пакеты через emerge, используйте команду emerge -v <package list>. Опция -v показывает дополнительную * * информацию и может быть опущена. (Если вы хотите задействовать какие-либо флаги USE, пре-запустите emerge с USE="здесь пишите флаги". Вы также можете использовать опцию -pv для проверки на предмет использования правильных флагов.) Ссылайтесь на [http://www.gentoo.org/doc/ru/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] или руководство для получения более подробной информации по emerge.

Образец:

<syntaxhighlight lang="lua">emerge -v subversion sqlite
USE=“net-misc/curl ssl” emerge -v curl
</syntaxhighlight>

'''Fedora'''

Для успешной компиляции MTA сервера на Fedora вам понадобятся следующие пакеты:
* '''glibc-devel:'''
* '''curl-devel:''' содержит библиотеку cURL
* '''pcre-devel:''' содержит библиотеку PCRE
* '''sqlite3-devel:''' содержит библиотеку SQLite
* '''readline-devel:''' содержит библиотеку readline
* '''lua-devel:''' содержит Lua-библиотеки
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
Чтобы установить эти пакеты через yum, воспользуйтесь командой yum install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion</syntaxhighlight>

'''Замечание для x64'''

На данный момент сервер MTA:SA не может быть корректно скомпилирован в 64-битном режиме. Вместо этого, скомпилируйте его в 32-битном режиме и запустите в режиме 32-битной совместимости (используйте флаг -m32).

== Общее руководство для {{Current Version|full}} ==

'''Получение исходного кода.'''

Для начала вам понадобится скачать исходный код.

svn checkout <nowiki>http</nowiki>://mtasa-blue.googlecode.com/svn/branches/{{Current Version|full}}/ mtasa-blue
cd mtasa-blue

Затем вот так его скомпилировать:
autoreconf -fiv
export PKG_CONFIG_PATH=/usr/lib32/pkgconfig
./configure LDFLAGS="-m32" CPPFLAGS="-m32" CFLAGS="-m32" CXXFLAGS="-m32" $@
make
make -C MTA10_Server install
make -C Shared/XML install

Получить net.so так:
wget <nowiki>http</nowiki>://nightly.mtasa.com/?multitheftauto_linux-{{Current Version|full}}-rc-latest -O multitheftauto_linux-{{Current Version|full}}-latest.tar.gz
tar -xzf multitheftauto_linux-{{Current Version|full}}-latest.tar.gz --transform 's:[^/]*:latest_nightly:'
mv latest_nightly/net.so MTA10_Server/output/
rm -rf latest_nightly multitheftauto_linux-{{Current Version|full}}-latest.tar.gz

Скопировать конфигурационные файлы:
cp MTA10_Server/mods/deathmatch/acl.xml MTA10_Server/output/mods/deathmatch/acl.xml
cp MTA10_Server/mods/deathmatch/mtaserver.conf MTA10_Server/output/mods/deathmatch/mtaserver.conf

Получить ресурсы:
svn export <nowiki>http</nowiki>://mtasa-resources.googlecode.com/svn/trunk/ MTA10_Server/output/mods/deathmatch/resources

И готовый сервер будет лежать по адресу MTA10_Server/output

=== '''Поиск и устранение неисправностей''' ===

Любые ошибки в процессе компиляции json-c могут быть разрешены через вызов autoreconf -fi из директории json-c.

Если вы получили какие-либо неожиданные ошибки в процессе компиляции, пожалуйста, посетите наш [http://bugs.mtasa.com/ багтрекер] или [irc://irc.multitheftauto.com/ IRC канал]

== '''Вылеты сервера''' ==

Если ваш Linux-сервер вылетает, получите backtrace и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace:====
===Есть ли у вас файл дампа ядра (core dump) в директории с MTA сервером?===
Обычно он называется 'core', его размер свыше 100МБ, сам он выглядит примерно так:
[[Image:Core.png]]
====Если да, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*И из директории, в которую установлена MTA, выполните команду
gdb mta-server -c core
*Когда gdb запустится, введите следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

====Если нет, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь вылета. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда вылет произойдет, выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Зависания сервера''' ==

Если ваш Linux-сервер зависает, получите backtrace с thread-информацией и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace с thread-информацией:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера, запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь зависания. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда зависание произойдет, нажмите ctrl-c для запуска gdb
*Затем выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*Затем выполните следующую команду для получения thread-информации:
info threads
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Запуск на 64-битном Linux''' ==
* Установите 32-битные библиотеки для вашего дистрибутива
Если вы получаете ошибку типа "libreadline.so.5: cannot open shared object file: No such file or directory.", то на Debian она может быть разрешена следующим способом:
<syntaxhighlight lang="lua">
wget http://ftp.uk.debian.org/debian/pool/main/r/readline5/libreadline5_5.2-7_i386.deb
dpkg -X libreadline5_5.2-7_i386.deb temp
cp -d temp/lib/libreadline.so.5* /usr/lib32/
</syntaxhighlight>

[[en:Building MTASA Server on GNU Linux]]

RU/Anti-cheat guide

2012-07-15T19:19:39Z

Vincent:

=Руководство по АЧ (АнтиЧиту)=

==Серверное устройство==

Поведение античита на сервере контролируют 3 настройки [[RU/Server_mtaserver.conf|'''mtaserver.conf''']]:

===<disableac></disableac>===
----
Список отключенных античитов, разделенный запятыми. Данная настройка античита отключит АЧ определенных кодов. Коды АЧ показываются игроку при срабатывании соответствующих проверок. Доступные коды:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <disableac>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Обнаружитель классических хаков на хп/броню
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Обнаруживает присутствие трейнеров. Заглавные буквы в сообщении служат для отметки конкретных трейнеров
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Обнаруживает использование трейнера, влияющего на: передвижение игрока, хп/урон, оружие, деньги, скорость игры; также игровые читы, аимбот
|-
| scope="row" style="background:#efefef;" align="center"|'''7'''
| style="background:#f8f8f8;" align="center"|VF #7
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Обнаруживает посторонние моды. Заглавные буквы в сообщении служат для отметки конкретных модов, например, CLEO - обнаружен Cleo, RENDER - обнаружен воллхак
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| Еще трейнеры
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Трейнер
|}
<br/>
===<enablesd></enablesd>===
----
Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым. Доступные коды:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <enablesd>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Запрет на собственный D3D9.DLL
|}
<br/>
===<client_file name="data/carmods.dat" verify="0"/>===
----
По умолчанию клиенты могут не смочь присоединиться к серверу, если data-файлы их GTA:SA изменены. Добавление одной или более строк по образцу выше исключит файлы из списка проверяемых. Названия файлов, пригодных к использованию:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Заметка 1:''''' ''"data/maps" представляет все файлы и папки внутри "data/maps"''<br/>

'''''Заметка 2:''''' ''"data/handling.cfg" не учитывается, так как он игнорируется MTA в любом случае в связи со встроенным функционалом управления транспортом. Если вы хотите подгрузить собственные файлы handling.cfg, то аналогичный эффект можно достичь благодаря использованию соответствующего ресурса.''<br/>

==Клиент==
При подсоединению к серверу информация по АЧ сервера отображается в клиентской консоли (F8)<br/>
Пример:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC содержит данные серверной настройки, указанные в <disableac></disableac><br/>
Enabled SD содержит данные серверной настройки, указанные в <enablesd></enablesd><br/>
Allowed client files содержит номера, указывающие на файлы, разрешенные клиенту сервером для модификации. Номера отвечают за следующие файлы:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Использование модифицированных файлов====
Если вы хотите использовать модифицированные data-файлы из вашей папки с установенной GTA:SA, поставьте маркер маркер в:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(маркер появляется только когда у вас изменены data-файлы GTA:SA)<br/>

Заметьте, что это ограничит ваш доступ к публичным серверам, так как большиснтво из них не приемлет измененные файлы данных.

[[Category: Support]]
[[en:Anti-cheat guide]]

RU/Building MTASA Server on GNU Linux

2012-07-15T11:20:00Z

Vincent:

{{Note|Эта статья предназначена только для тех владельцев, кто внес изменения в код сервера. Если вам нужен прекомпилированный сервер (для обычных владельцев серверов), перейдите на [http://linux.mtasa.com/ linux.mtasa.com]}}

== Подготовка системы ==

Чтобы собрать выделенный сервер Multi Theft Auto, вам понадобится снабдить свою систему определенными библиотеками и инструментами. Как их устанавливать, зависит от вашего дистрибутива.

Наш сетевой модуль (net.dll или net.so) поставляется как прекомпилированная двоичная библиотека. Файл для GNU/Linux можно получить из новейшего nightly-билда для Linux, то есть [http://nightly.mtasa.com/ отсюда]. Используйте net.so от 1.4, если компилируете из trunk, или net.so от 1.3.x, если компилируете ветвь 1.3.x. Удостоверьтесь, что вы прочитали верхнюю часть ''MTA10_Server/version.h'', так как там содержатся указания по компилированию билдов разного типа.

'''Debian Linux'''

Включает производные дистрибутивы типа Ubuntu.

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки, поставляемые через соответствующие пакеты Debian (напр. Debian Lenny):

* '''build-essential:''' содержит необходимые инструменты, заголовки и библиотеки для сборки приложений
* '''automake:''' содержит инструменты automake
* '''libtool:''' содержит программное обеспечение libtool, нужное для сборки библиотек
* '''libcurl3-dev:''' содержит библиотеку cURL (версия 3 без поддержки SSL)
* '''libpcre3-dev:''' содержит библиотеку PCRE (версия 3)
* '''libsqlite3-dev:''' содержит библиотеку SQLite (версия 3)
* '''libreadline5-dev:''' содержит библиотеку readline (версия 5)
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''libncurses5-dev:''' содержит программное обеспечение для контроля над записью в окне консоли
* '''libncursesw5-dev:''' содержит поддержку для широких символов
* '''libsparsehash-dev:''' содержит поддержу для Google hash-map '''(Так что вам не придется компилировать sparehash!)'''
* '''libmysqlclient-dev:''' содержит библиотеку MySQL
Чтобы установить эти пакеты через apt, используйте команду apt-get install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev libsparsehash-dev libmysqlclient-dev</syntaxhighlight>

'''Gentoo Linux'''

Вам понадобятся необходимые инструменты для сборки, заголовки и библиотеки. Но так как система портирования Gentoo сделана так, что компиляция любых пакетов происходит внтури самой системы, необходимые инструменты для сборки будут итак предустановелены. Все, что остается - установить необходимые библиотеки:

* '''sqlite:''' содержит библиотеку SQLite
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
* '''curl:''' содержит библиотеку cURL; чтобы скомпилировать с поддержкой SSL, примените флаг net-misc/curl ssl USE
Чтобы скомпилировать и установить эти пакеты через emerge, используйте команду emerge -v <package list>. Опция -v показывает дополнительную * * информацию и может быть опущена. (Если вы хотите задействовать какие-либо флаги USE, пре-запустите emerge с USE="здесь пишите флаги". Вы также можете использовать опцию -pv для проверки на предмет использования правильных флагов.) Ссылайтесь на [http://www.gentoo.org/doc/ru/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] или руководство для получения более подробной информации по emerge.

Образец:

<syntaxhighlight lang="lua">emerge -v subversion sqlite
USE=“net-misc/curl ssl” emerge -v curl
</syntaxhighlight>

'''Fedora'''

Для успешной компиляции MTA сервера на Fedora вам понадобятся следующие пакеты:
* '''glibc-devel:'''
* '''curl-devel:''' содержит библиотеку cURL
* '''pcre-devel:''' содержит библиотеку PCRE
* '''sqlite3-devel:''' содержит библиотеку SQLite
* '''readline-devel:''' содержит библиотеку readline
* '''lua-devel:''' содержит Lua-библиотеки
* '''subversion:''' содержит SVN-клиент, используемый для checkout'а нашего репозитория
Чтобы установить эти пакеты через yum, воспользуйтесь командой yum install <package list>, как в следующем образце (выполнять от root):

<syntaxhighlight lang="lua">yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion</syntaxhighlight>

'''Замечание для x64'''

На данный момент сервер MTA:SA не может быть корректно скомпилирован в 64-битном режиме. Вместо этого, скомпилируйте его в 32-битном режиме и запустите в режиме 32-битной совместимости (используйте флаг -m32).

== Общее руководство для {{Current Version|full}} ==

'''Получение исходного кода.'''

Для начала вам понадобится скачать исходный код.

svn checkout <nowiki>http</nowiki>://mtasa-blue.googlecode.com/svn/branches/{{Current Version|full}}/ mtasa-blue
cd mtasa-blue

Затем вот так его скомпилировать:
autoreconf -fiv
export PKG_CONFIG_PATH=/usr/lib32/pkgconfig
./configure LDFLAGS="-m32" CPPFLAGS="-m32" CFLAGS="-m32" CXXFLAGS="-m32" $@
make
make -C MTA10_Server install
make -C Shared/XML install

Получить net.so так:
wget <nowiki>http</nowiki>://nightly.mtasa.com/?multitheftauto_linux-{{Current Version|full}}-rc-latest -O multitheftauto_linux-{{Current Version|full}}-latest.tar.gz
tar -xzf multitheftauto_linux-{{Current Version|full}}-latest.tar.gz --transform 's:[^/]*:latest_nightly:'
mv latest_nightly/net.so MTA10_Server/output/
rm -rf latest_nightly multitheftauto_linux-{{Current Version|full}}-latest.tar.gz

Скопировать конфигурационные файлы:
cp MTA10_Server/mods/deathmatch/acl.xml MTA10_Server/output/mods/deathmatch/acl.xml
cp MTA10_Server/mods/deathmatch/mtaserver.conf MTA10_Server/output/mods/deathmatch/mtaserver.conf

Получить ресурсы:
svn export <nowiki>http</nowiki>://mtasa-resources.googlecode.com/svn/trunk/ MTA10_Server/output/mods/deathmatch/resources

И готовый сервер будет лежать по адресу MTA10_Server/output

=== '''Поиск и устранение неисправностей''' ===

Любые ошибки в процессе компиляции json-c могут быть разрешены через вызов autoreconf -fi из директории json-c.

Если вы получили какие-либо неожиданные ошибки в процессе компиляции, пожалуйста, посетите наш [http://bugs.mtasa.com/ багтрекер] или [irc://irc.multitheftauto.com/ IRC канал]

== '''Вылеты сервера''' ==

Если ваш Linux-сервер вылетает, получите backtrace и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace:====
===Есть ли у вас файл дампа ядра (core dump) в директории с MTA сервером?===
Обычно он называется 'core', его размер свыше 100МБ, сам он выглядит примерно так:
[[Image:Core.png]]
====Если да, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*И из директории, в которую установлена MTA, выполните команду
gdb mta-server -c core
*Когда gdb запустится, введите следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

====Если нет, то:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь вылета. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда вылет произойдет, выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Зависания сервера''' ==

Если ваш Linux-сервер зависает, получите backtrace с thread-информацией и опубликуйте отчет на нашем [http://bugs.mtasa.com/ багтрекере]

====Как получить backtrace с thread-информацией:====
*Установите gdb. Для установки gdb на Debian, воспользуйтесь командой:
apt-get install gdb
*Из директории MTA сервера, запустите mta-server примерно таким образом:
gdb mta-server --eval-command run
*Теперь дождитесь зависания. (пока что игнорируйте странную информацию, выводимую на экран)
*Когда зависание произойдет, нажмите ctrl-c для запуска gdb
*Затем выполните следующую команду для получения backtrace:
bt full
*Сохраните полученную информацию
*Затем выполните следующую команду для получения thread-информации:
info threads
*Сохраните полученную информацию
*(Чтобы выйти из gdb, используйте команду quit)

== '''Запуск на 64-битном Linux''' ==
* Установите 32-битные библиотеки для вашего дистрибутива
Если вы получаете ошибку типа "libreadline.so.5: cannot open shared object file: No such file or directory.", то на Debian она может быть разрешена следующим способом:
<syntaxhighlight lang="lua">
wget http://ftp.uk.debian.org/debian/pool/main/r/readline5/libreadline5_5.2-7_i386.deb
dpkg -X libreadline5_5.2-7_i386.deb temp
cp -d temp/lib/libreadline.so.5* /usr/lib32/
</syntaxhighlight>

[[en:Building MTASA Server on GNU Linux]]

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

2012-07-12T14:08:33Z

Vincent: changes from en wiki

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

Все, связанное со скриптингом, находится в ресурсах. Назначение ресурса и определяет, является ли он модом, картой или чем-либо еще. MTA поставляется с ресурсами, которые вы можете выборочно использовать в своих модах, например, maplimits, позволяющий удерживать игроков в рамках указанных границ карты, или deathpickups, создающий пикапы с оружием.
{{tip|Первым шагом в изучении Lua-скриптинга должен быть выбор Lua-редактора. Это намного упрощает скриптинг. Мы рекомендуем [http://notepad-plus.sourceforge.net/uk/site.htm Notepad++] или [http://luaedit.sourceforge.net/ LuaEdit]. Также имеется неофициальный [[MTASE|MTA Script Editor]] (на стадии разработки), который вы можете испытать.}}

==Создание работающего скрипта==
Для начала мы узнаем, как пошагово сделать базовый скрипт, который позволит игроку прогуливаться по городу.
===Где находятся все скрипты?===
Давайте взглянем на файловую структуру скрипта. Зайдите в папку сервера MTA и пройдите по следующему пути:

/server/mods/deathmatch/resources/

Вы увидите множество .zip-архивов, являющихся упакованными пробными скриптами, поставляемыми с MTA DM. Каждый файл - это "ресурс", все они будут распакованы и загружены сервером при его старте. Чтобы создать свой собственный ресурс, просто создайте папку и назовите ее так, как хотите. В нашем случае мы назовем ее "myserver".

Теперь вам нужно зайти в эту папку:

/server/mods/deathmatch/resources/myserver/

===Идентификация вашего ресурса===
Чтобы сервер мог узнать о содержимом того или иного ресурса, в нем должен быть создан файл ''meta.xml'', перечисляющий его содержимое. Этот файл должен быть расположен в корневой директории ресурса, в нашем случае - это папка "myserver". Просто создайте текстовый файл, назовите его "meta.xml" и откройте с помощью Блокнота (notepad).

В файл ''meta.xml'' введите следующий код:
<syntaxhighlight lang="xml">
<meta>
<info author="YourName" type="gamemode" name="My Server" description="My first MTA server" />
<script src="script.lua" />
</meta>
</syntaxhighlight>
В теге ''<info />'' есть поле "type", которое говорит о том, что данный ресурс - ''gamemode'' ("мод", игровой режим), а не обычный include или ''map'' (карта), о которых мы поговорим чуть позже. Gamemode - то, что вам нужно, чтобы создать независимый сервер.

Тег ''<script />'' оговаривает сценарии (скрипты), которые содержит ресурс, о них мы сейчас и поговорим.
===Создание простого скрипта===
Заметьте, что в теге ''<script />'' выше .lua-файл не находится в какой-либо вложенной директории. Следовательно, мы создадим файл в той же папке, что и meta.xml. Теперь можно скопировать и вставить в script.lua следующий код:
<syntaxhighlight lang="lua">
local spawnX, spawnY, spawnZ = 1959.55, -1714.46, 10
function joinHandler()
spawnPlayer(source, spawnX, spawnY, spawnZ)
fadeCamera(source, true)
setCameraTarget(source, source)
outputChatBox("Welcome to My Server", source)
end
addEventHandler("onPlayerJoin", getRootElement(), joinHandler)
</syntaxhighlight>
Этот скрипт заспавнит вас по координатам (x, y, z), указанным выше, когда вы зайдете на сервер. Обратите внимание, что функция ''fadeCamera'' обязательно должна быть, иначе экран будет черным. К тому же, в релизах новее DP2 вам нужно установить цель для камеры (иначе все, что увидит игрок - синее небо).

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

Если присмотреться к [[addEventHandler]], вы заметите три вещи: 'onPlayerJoin', указывающий на то, когда (почему) произойдет срабатывание; getRootElement(), который показывет благодаря кому/чему может произойти срабатывание (getRootElement() - это все/всё) и joinHandler, который отвечает за функцию, на которую произойдет переключение при срабывании события. Остальные подробности будут изложены позже и на отдельном примере, а теперь давайте просто запустим сервер и попрактикуемся!

===Запуск скрипта===
Чтобы запустить сервер, просто запустите исполняемый файл (на Windows - .exe) по адресу ''MTA San Andreas x.x/server'', где x.x - номер версии MTA. Сначала будут показаны данные сервера; запомните номер порта (server port), который понадобится вам при подключении. Затем сервер загрузит все ресурсы в папку mods/deathmatch/resources/ и позже будет "ready to accept connections!", то есть готов принимать игроков.

Перед тем, как вы подключитесь к серверу, нужно обязательно запустить мод (gamemode). Введите "start myserver" и нажмите Enter. Сервер запустит мод, который вы только что создали, а также начнет отображать различные ошибки и предупреждения, если таковые будут. Теперь можно запустить клиент MTA DM и подключиться через "Quick Connect", воспользовавшись IP-адресом вашего сервера и номером порта, на который мы ранее обратили ваше внимание. Если все пройдет по плану, через несколько секунд ваш персонаж сможет пройтись по улицам Los Santos'а.

Затем мы добавим в скрипт команду, которую игроки смогут использовать для того, чтобы спавнить рядом с собой транспортное средство. Вы можете это пропустить и взглянуть на статью про более продвинутый скриптинг с использованием [[RU/Map manager|Map Manager]], которая продолжит это руководство. Еще одним ответвлением данного руководства является [[Введение в скриптинг GUI]]: прочитав его, вы узнаете, как рисуется и программируется Graphical User Interface в MTA:DM.

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

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

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

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

Если у вас уже есть опыт в скриптинге, вы знаете, что функции вызываются примерно следующим образом:
<syntaxhighlight lang="lua">
functionName(argument1, argument2, argument3, ..)
</syntaxhighlight>
<syntaxhighlight lang="lua">
functionName(thePlayer, commandName, argument3, ..)
</syntaxhighlight>
Присмотревшись ко второму образцу (выше), мы увидим, что argument1 - thePlayer, а argument2 - commandName. thePlayer - тот, кто набрал команду, так что как бы вы ее не вводили, переменная будет содержать игрока, который ее активировал. commandName - команда, которую ввели. Так что при вводе "/greet", этот аргумент будет содержать "greet". Argument 3 - еще что-то, введенное игроком после, об этом вы узнаете чуть позже из данного руководства. Никогда не забывайте, что первые 2 аргумента являются стандартными, но назвать вы их можете по своему усмотрению. То есть важен порядок, а не название.

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

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

''Заметка: Обработчик команды надо добавлять именно ПОСЛЕ функции, на которую он сошлется, иначе она не будет найдена. Порядок имеет значение!''

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

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

Для [[getElementPosition]] синтаксис таков:
<syntaxhighlight lang="lua">
float, float, float getElementPosition ( element theElement )
</syntaxhighlight>

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

<syntaxhighlight lang="lua">
function createVehicleForPlayer(thePlayer, command, vehicleModel)
-- get the position and put it in the x,y,z variables
-- (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>

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

Внутри нашей функции у нас уже есть все аргументы, которые нужны функции [[createVehicle]]: Только что вычисленная позиция в переменных ''x,y,z'' и id модели, который мы получили через команду ("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
-- если да, то выводим сообщение в чат, но только для игрока, который спавнил ТС.
outputChatBox("Failed to create vehicle.",thePlayer)
end
end
addCommandHandler("createvehicle", createVehicleForPlayer)
</syntaxhighlight>

Как вы уже, наверное, заметили, вашему взору предстала новая функция - [[outputChatBox]]. Теперь вы самостоятельно можете изучить содержимое ее страницы-документации. Чтобы узнать больше о продвинутом скриптинге, почитайте про [[RU/Map manager|Map Manager]].

==Что вам следует знать==
Вы уже кое-что прочитали о ресурсах, обработчиках команд и поиске функций в документации в первом разделе, но многое еще предстоит узнать. Этот раздел проведет довольно краткий обзор о некоторых из этих вещей, по возможности ссылаясь на соответствующие страницы.
===Клиентские и серверные скрипты===
Может быть, вы уже заметили эти или схожие термины (сервер/клиент) где-либо на данной вики, наиболее вероятно, вкупе с функциями. MTA не только поддерживает работающие на сервере скрипты, предоставляет команды (типа как мы писали выше) и другие возможности, но также и скрипты, выполняющиеся на клиенте MTA, который игроки используют для подключения к серверу. Причиной этому служит то, что некоторые предоставляемые MTA функции не могут быть серверными (например, GUI - Graphical User Interface, т.е. графический интерфейс пользователя), другие там просто работают лучше, но другим все же лучше быть серверными или попросту не работать на клиентской стороне.

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

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

====Первый пример - Вспомогательный скрипт====
<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'' предоставляет GUI, чтобы возможно было с легкостью выполнять вышеуказанные действия

Этот пример может выполняться все время (даже автозапускаться со стартом сервера), так как является полезным на протяжении всего игрового процесса и не конфликтует с ним, если администратор, конечно, сам этого не захочет.

====Второй пример - Мод====
<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'' говорит о том, что этот пример работает с [[RU/Map manager|Map Manager]], уже другим ресурсом, написанным QA Team для управлениями модами и подгрузки карт. Очень рекомендуется основывать свои моды на предоставляемом им функционале.

Это также означает, что мод, возможно, не запустится без карты. Моды всегда должны пользоваться общим функционалом настолько широко, насколько это возможно. Образец карты - в следующем примере.

====Третий пример - Карта====
<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', сообщая [[RU/Map manager|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'ом, и информация, которую он содержит, может быть прочитана ресурсом-модом. При смене карты, текущий ресурс-карта останавливается, а следующий - запускается. Для более детального разъяснения и образцов того, как ресурсы-карты используются основным скриптом, посетите страницу [[RU/Writing Gamemodes]].

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

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

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

==Что делать теперь==
Теперь вы знакомы с наиболее базовыми аспектами скриптинга в MTA, а также чуть-чуть с документацией. [[Главная страница]] обеспечит вас ссылками на множество различной информации, руководства и указания, которые позволят глубже взглянуть на интересующие вас темы.
{{note|Теперь мы рекомендуем вам прочитать руководство по [[RU/Debugging|отладке]]. Умение хорошо отлаживать - абсолютная необходимость при написании скриптов. Мы также рекомендуем вам пользоваться [[RU/Predefined variables list|списком предписанных переменных]], который поможет вам в выполнении определенных задач, а писать скрипты станет намного легче и быстрее.}}
'''Также смотрите:'''
* [[Advanced Topics|Продвинутый функционал]]
[[en:Scripting Introduction]]
[[es:Introducción a la Programación]]
[[it:Introduzione allo scripting]]
[[nl:Scripting_introductie]]

RU/Places To Chat

2012-07-09T23:18:22Z

Vincent:

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

== Форум ==
Первым местом, на которое вы скорее всего наткнетесь, будет официальный форум MTA сообщества. Его можно найти по адресу [http://forum.mtasa.com http://forum.mtasa.com]. Вы можете совершенно свободно по нему бродить и читать, что говорят другие люди, но чтобы изложить свою собственную точку зрения или начать дискуссию на свою собственную тему, вам понадобится на форуме зарегистироваться. Это бесплатно и делается посредством клика по ссылке Register в верхней части страницы.

Форум разделен на некоторое количество категорий и подфорумов. Они упорядочивают темы, и перед созданием своей собственной темы вам следует убедиться, что вы делаете это в правильном подфоруме. К тому же, перед тем, как писать какие-либо сообщения, удостоверьтесь, что вы прочитали [http://forum.mtasa.com/viewtopic.php?f=15&t=15740#p219286 правила].

Имеется [http://forum.mtasa.com/viewforum.php?f=123 раздел] для русскоязычных пользователей.

== IRC (Internet Relay Chat) ==
Для получения моментального ответа на что-либо вами сказанное лучше всего подойдет IRC. IRC - сеть чатов, подобная любым другим чат-комнатам, которые можно найти в интернете. Лучший IRC-клиент для Windows - это mIRC, который можно найти [http://www.mirc.com здесь]. Скачайте, установите, настройте, и вы будете готовы. Язык - английский, но существует некоторая вероятность того, что в канале будут и русскоязычные пользователи.
Нужная вам для подключения информация:<br>
'''Server (сервер) -''' [irc://irc.gtanet.com/mta irc.gtanet.com/mta]<br>
'''Port (порт) -''' 6667<br>
Как только вы подключились и получили MOTD (message of the day, "сообщение дня"), чтобы присоединиться к дискуссии MTA, введите /join #mta
Это перенесет вас в ''канал'' MTA, который в других чат-сетях назывался бы комнатой.
Если вы затрудняетесь, обязательно прочитайте справочные файлы mIRC.
Для получения более детальной помощи по командам сервера, перейдите в окно, которое первым появилось при подключении, и введите /helpop для получения списка категорий помощи.

=== Помощь по скриптингу ===
Для оказания помощи по скриптингу в MTA имеется IRC-канал. Располагается он по адресу #mta.scripting на GTANet (irc.multitheftauto.com).
====Как получить помощь====
* Попробуйте найти ответ на свой вопрос на [[Главная страница|главной странице]], особое внимание на два верхних блока
* Задайте свой вопрос один раз и повторите его только по прошествии большого промежутка времени, сделав скидку на занятость канала и людей, которые приходят онлайн после и просто не видели вашего вопроса (то есть около 10 минут). Но НЕ по прошествии 10 секунд!
* Вопрос, как минимум, должен содержать:
** Что вы пытаетесь сделать.
** Что вы уже смогли сделать.
** Что конкретно не работает, является проблемой. Какие возникают ошибки.
** Возможно, отрывок кода с пояснениями, загруженный на [http://mta.pastebin.com mta.pastebin.com] (''отрывок кода подразумевает относящуюся к делу часть, а НЕ весь скрипт'')

== Другое ==
Это не все места/способы общения с другими членами MTA сообщества. Имеется много форумов, отличных от официального MTA, например, [http://www.gtaforums.com GTAForums], являющийся наиболее популярным неофициальным форумом GTA сообщества. Хоть там обсуждают и не только MTA, но игра по сети является довольно популярной темой общения.

Пожалуйста, не стесняйтесь редактировать эту страницу, если вам есть, что добавить.

[[en:Places To Chat]]
[[es:Places_To_Chat_ES]]

[[Category:Support]]

RU/IRC Channel

2012-07-09T23:16:14Z

Vincent: Redirected page to RU/Places To Chat#Помощь по скриптингу

#redirect [[RU/Places_To_Chat#Помощь по скриптингу]]

Places To Chat

2012-07-09T23:11:03Z

Vincent:

There are a number of ways you can chat with other MTA players. Whether you want to discuss your gaming techniques, arrange clan matches, or even join a clan, there's always somewhere to go.
Of course you can chat with some people whilst playing via the ingame chat. But there are many places where a large proportion of the MTA community often visit. Some of these are described below.

== Forums ==
The first place you are likely to come across is the official MTA Community Forums. These are found at [http://forum.mtasa.com http://forum.mtasa.com]. You are free to browse around and read what other people have to say, but to put your own point of view across and start your own discussions, you will have to Register at the forums. This is free and can be done by clicking the Register link at the top of the page.

The forums are split up into a number of categories and sub-forums. These organise all the topics, and you should make sure that before you start your own topic, you are in the right forum. Also, before making any posts, be sure to read the [http://forum.mtasa.com/viewtopic.php?f=15&t=15740#p219286 rules].

== IRC (Internet Relay Chat) ==
For an instant response to whatever you have to say, the best place is IRC. IRC is a chat network similar to any other chat rooms you find on the internet. The best Windows client for IRC is mIRC, which you can find [http://www.mirc.com here]. Download, install, configure the settings and you are ready to go.
The connection information you need is:<br>
'''Server -''' [irc://irc.gtanet.com/mta irc.gtanet.com/mta]<br>
'''Port -''' 6667<br>
Once you have connected and received the MOTD (message of the day), to join the MTA discussion, type /join #mta
This takes you into the MTA ''channel'', which you would know as a room in other chat networks.
Make sure you read the mIRC help files if you are unsure.
For more specific help for the server commands, go to the window you first had when connecting, and type /helpop for a list of help categories.

=== Scripting Help ===
There is an IRC Channel available for help with MTA Scripting. You can find it at #mta.scripting on GTANet (irc.multitheftauto.com).

==== How To Get Help ====
* Try to find your Answer on the [[Main Page]], especially on its upper part
* Ask your question once and only repeat it after a reasonable amount of time, given the channel is busy and people just coming online won't see your question else (like 10 minutes). NOT after 10 seconds.
* Your question should at least contain:
** What are you trying to do.
** What have you done so far.
** What exactly doesn't work/is your problem. What errors are occuring.
** Maybe a code snippet with an explanation using [http://mta.pastebin.com mta.pastebin.com] (''code snippet means the relevant parts, NOT the whole script'')

== Other ==
These aren't all the places/ways of talking with other members of the MTA community. There are many many more forums than the official MTA one, for example [http://www.gtaforums.com GTAForums] which is the most popular unofficial GTA community forum. Although not just MTA discussion, online play is a popular topic of discussion.

Please feel free to edit this page if you have something else to add.

[[es:Places_To_Chat_ES]]
[[ru:Places To Chat]]
[[Category:Support]]

RU/Places To Chat

2012-07-09T23:09:36Z

Vincent: Created page with "Есть масса способов пообщаться с другими игроками MTA. Вне зависимости от того, хотите ли вы обсуди..."

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

== Форум ==
Первым местом, на которое вы скорее всего наткнетесь, будет официальный форум MTA сообщества. Его можно найти по адресу [http://forum.mtasa.com http://forum.mtasa.com]. Вы можете совершенно свободно по нему бродить и читать, что говорят другие люди, но чтобы изложить свою собственную точку зрения или начать дискуссию на свою собственную тему, вам понадобится на форуме зарегистироваться. Это бесплатно и делается посредством клика по ссылке Register в верхней части страницы.

Форум разделен на некоторое количество категорий и подфорумов. Они упорядочивают темы, и перед созданием своей собственной темы вам следует убедиться, что вы делаете это в правильном подфоруме. К тому же, перед тем, как писать какие-либо сообщения, удостоверьтесь, что вы прочитали [http://forum.mtasa.com/viewtopic.php?f=15&t=15740#p219286 правила].

Имеется [http://forum.mtasa.com/viewforum.php?f=123 раздел] для русскоязычных пользователей.

== IRC (Internet Relay Chat) ==
Для получения моментального ответа на что-либо вами сказанное лучше всего подойдет IRC. IRC - сеть чатов, подобная любым другим чат-комнатам, которые можно найти в интернете. Лучший IRC-клиент для Windows - это mIRC, который можно найти [http://www.mirc.com здесь]. Скачайте, установите, настройте, и вы будете готовы. Язык - английский, но существует некоторая вероятность того, что в канале будут и русскоязычные пользователи.
Нужная вам для подключения информация:<br>
'''Server (сервер) -''' [irc://irc.gtanet.com/mta irc.gtanet.com/mta]<br>
'''Port (порт) -''' 6667<br>
Как только вы подключились и получили MOTD (message of the day, "сообщение дня"), чтобы присоединиться к дискуссии MTA, введите /join #mta
Это перенесет вас в ''канал'' MTA, который в других чат-сетях назывался бы комнатой.
Если вы затрудняетесь, обязательно прочитайте справочные файлы mIRC.
Для получения более детальной помощи по командам сервера, перейдите в окно, которое первым появилось при подключении, и введите /helpop для получения списка категорий помощи.

=== Помощь по скриптингу ===
Для оказания помощи по скриптингу в MTA имеется IRC-канал. Располагается он по адресу #mta.scripting на GTANet (irc.multitheftauto.com).
==Как получить помощь==
* Попробуйте найти ответ на свой вопрос на [[Главная страница|главной странице]], особое внимание на два верхних блока
* Задайте свой вопрос один раз и повторите его только по прошествии большого промежутка времени, сделав скидку на занятость канала и людей, которые приходят онлайн после и просто не видели вашего вопроса (то есть около 10 минут). Но НЕ по прошествии 10 секунд!
* Вопрос, как минимум, должен содержать:
** Что вы пытаетесь сделать.
** Что вы уже смогли сделать.
** Что конкретно не работает, является проблемой. Какие возникают ошибки.
** Возможно, отрывок кода с пояснениями, загруженный на [http://mta.pastebin.com mta.pastebin.com] (''отрывок кода подразумевает относящуюся к делу часть, а НЕ весь скрипт'')

== Другое ==
Это не все места/способы общения с другими членами MTA сообщества. Имеется много форумов, отличных от официального MTA, например, [http://www.gtaforums.com GTAForums], являющийся наиболее популярным неофициальным форумом GTA сообщества. Хоть там обсуждают и не только MTA, но игра по сети является довольно популярной темой общения.

Пожалуйста, не стесняйтесь редактировать эту страницу, если вам есть, что добавить.

[[en:Places To Chat]]
[[es:Places_To_Chat_ES]]

[[Category:Support]]

Client on Linux Manual

2012-07-08T20:41:21Z

Vincent: already merged

{{Warning|This page is for Linux players ONLY, for Windows go [[Client Manual|here]].|true}}
==Before you start==

First of all, please ensure your computer fits the requirements needed.
Read the [[Client_Manual|Client Manual]] page for further informations, or join us on IRC @ irc://irc.multitheftauto.com/mta

===Requirements===
The hardware requirements for Multi Theft Auto: San Andreas are the same than on Windows.
For software requirements, you need:
* Wine (get it on your package manager (synaptic, apt, pacman, yum etc.); click [http://tinyurl.com/installWine1-3 here] if you're using Ubuntu
* Windows fonts installed:
** tahoma.ttf
** tahomabd.ttf
** verdana.ttf
Get them on the Internet, e.g. [http://fontonic.com/ fontonic.com]

Or get the zip archive with the 3 fonts here: [http://fabienwang.fr/wine_mta_fonts.zip wine_mta_fonts.zip]

Install them in: <syntaxhighlight lang="lua">~/.wine/dosdevices/c:/windows/Fonts/</syntaxhighlight>
(~/ points to your user home folder on Linux)

==Installing the game==
Download the MTA installer from [http://www.mtasa.com mtasa.com], ensure you can launch it (chmod +x) then install it when you want.

==Running the game==
Once installed, double-clicking on the Multi Theft Auto.exe should work. If not, try in a terminal the following command: "wine Multi Theft Auto.exe" in the directory you installed Multi Theft Auto to.
If it doesn't work, check the contents of the file c:/Program_Files/Multi Theft Auto/MTA/CEGUI.log, which may contain useful information.

==Known issues==
===Specific issues===
* Impossible connection through the server browser [Fixed in the [http://bugs.mtasa.com/view.php?id=5084 5084 bug] ]

* MTA won't start on Ubuntu 12.04 LTS [Temporary fix is available [http://forum.mtasa.com/viewtopic.php?p=434011#p434011 here] ]

===Other issues===
* MTA isn't starting (even with fonts installed)
#Try to start MTA:SA in a virtual desktop
#:Go to WineConfig, choose the tab "Graphics" and select "Emulate a virtual desktop".<br>
#Try to delete your gta_sa.set file
#:which is located in the "GTA San Andreas User Files" folder, which can be found in your home directory.<br>'''(Remember to create a copy, if you're playing San Andreas in singleplayer)'''
#Try to delete your MTA config file
#:which is: "MTA San Andreas 1.3/MTA/coreconfig.xml"<br>'''(Also remember to create a copy, if you don't want to lose your edited MTA configuration)'''

* Crash when connecting
*:Sometimes the audio-server makes problems (could be related to pulseaudio), in this case you've to go to WineConfig and choose the tab Audio, then deselect "ALSA" and select "EsoundD". Save the settings and restart MTA.

== See Also ==
* [http://nightly.mtasa.com/ nightly.mtasa.com] - For nightly builds.

[[Category:Support]]
[[ru:Client on Linux Manual]]

Getting MTA:SA to work with wine

2012-07-08T20:40:47Z

Vincent: merged long time ago

#REDIRECT [[Client on Linux Manual]]

Server Commands

2012-07-08T13:32:42Z

Vincent:

This page lists all built in commands that the server can process. All these commands can be entered via the server console or the client console depending upon permissions unless otherwise stated.

==Resource commands==
====checkall====
:<ins>Server console only</ins>
:Check all resources for deprecated functions and MTA version issues
====info====
:<ins>Server console only</ins>
:Usage: info ''<resource-name>''<br>
:Get info for a resource eg: info admin
====list====
:<ins>Server console only</ins>
:Shows a list of resources

====refresh====
:Refresh resource list to find new resources
====refreshall====
:Refresh resources and restart any changed resources
====restart====
:Usage: info ''<resource-name>''<br>
:Restarts a running resource eg: restart admin
====start====
:Usage: start ''<resource-name>''<br>
:Start a loaded resource eg: start admin
====stop====
:Usage: stop ''<resource-name>''<br>
:Stop a resource eg: stop admin
====stopall====
:Stop all running resources
====upgrade====
:<ins>Server console only</ins>
:Perform a basic upgrade of all resources that use deprecated functions
====aclrequest====
:Usage: aclrequest [''list''|''allow''|''deny''] ''<resource-name>'' [''<right>''|''all'']<br>
:Manage ACL requests from resources implementing <aclrequest> in their [[meta.xml]]

==Account commands==
====aexec====
:Usage: aexec ''<nick>'' ''<command>''<br>
:Force a player to execute a command eg: aexec playername say hello
====addaccount====
:Usage: addaccount ''<accountname>'' ''<password>''<br>
:Add an account eg: addaccount accountname password
====chgpass====
:Usage: chgpass ''<accountname>'' ''<password>''<br>
:Change an accounts password eg: chgpass account newpw
====delaccount====
:Usage: delaccount ''<accountname>''<br>
:Delete an account eg: delaccount accountname

==Server commands==
====ase====
:<ins>Server console only</ins>
:See the amount of master server list queries
====debugdb====
:Usage: debugdb ''<''0-2''>''<br>
:<ins>Server console only</ins>
:Set logging level for database functions. [0-Off  1-Errors only  2-All]
====help====
:<ins>Server console only</ins>
:Displays these list of commands
====loadmodule====
:<ins>Server console only</ins>
:Usage: loadmodule ''<module-filename>''<br>
:Load a module eg: loadmodule ml_sockets.dll
====unloadmodule====
:<ins>Server console only</ins>
:Usage: unloadmodule ''<module-filename>''<br>
:Unload a module eg: unloadmodule ml_sockets.dll
====reloadmodule====
:<ins>Server console only</ins>
:Usage: reloadmodule ''<module-filename>''<br>
:Reload a module eg: reloadmodule ml_sockets.dll
====openports====
:<ins>Server console only</ins>
:Test if server ports are open
====shutdown====
:Usage: shutdown ''<reason>''<br>
:Shutdown the server eg: shutdown put reason here
====sver====
:Get the server MTA version

==Other commands==
====say====
:Usage: say ''<text>''<br>
:Show a message to all players on the server eg: say hello
====whois====
:Usage: whois ''<nick>''<br>
:Get the IP of a player currently connected (use whowas for IP/serial/version)
====whowas====
:Usage: whowas ''<nick>''<br>
:Get IP/Serial of a player that was previously connected to the server
====ver====
:Get the MTA version

==Client relevant only==
====chgmypass====
:<ins>Client only</ins>
:Usage: chgmypass ''<oldpass>'' ''<newpass>''<br>
:Change your password eg: chgmypass oldpw newpw
====debugscript====
:<ins>Client only</ins>
:Usage: debugscript ''<''0-3''>''<br>
:Remove (This does not work "Incorrect client type for this command")
====login====
:<ins>Client only</ins>
:Usage: login ''<accountname>'' ''<password>''<br>
:Login to an account eg: login accountname password
====logout====
:<ins>Client only</ins>
:Log out of the current account
====me====
:<ins>Client only</ins>
:Usage: me ''<text>''<br>
:Show a message to all players on the server, with your nick prepended
====msg====
:<ins>Client only</ins>
:Usage: msg ''<nick>'' ''<text>''<br>
:Send a message to a player eg: msg playername hello
====nick====
:<ins>Client only</ins>
:Usage: nick ''<old-nick>'' ''<new-nick>''<br>
:Change your ingame nickname
====teamsay====
:<ins>Client only</ins>
:Usage: teamsay ''<test>''<br>
:Send a message to all players on the same team

[[Category: Support]]
[[ru:Server Commands]]

RU/Client Commands

2012-07-08T13:30:22Z

Vincent:

Эта страница описывает все встроенные команды, доступные для выполнения на клиенте. Данные команды можно вводить напрямую в клиентскую консоль или в чат, поставив перед ними / (слэш). Некоторые [[RU/Server_Commands|серверные команды]] также доступны из клиента. Аргументы внутри [...] опциональны.

==Команды ядра==
====help====
:Отображает данный список команд
====exit====
:Выходит из приложения
====quit====
:Выходит из приложения
====ver====
:Выводит версию MTA в клиентскую консоль
====time====
:Выводит в чат текущее время
====showhud====
:Использование: showhud [''<''0-1''>'']
:Отображает HUD
====binds====
:Выводит все назначенные на клавиши действия в клиентскую консоль
====serial====
:Выводит ваш серийный номер в клиентскую консоль

====connect====
:Использование: connect ''<адрес> <порт>'' [''<ник> <пароль>'']
:Присоединяет к серверу
====reconnect====
:Присоединяет к последнему посещенному серверу
====bind====
:Использование: bind ''<defaults/клавиша>'' [''<up/down>''] ''<команда>'' [''<аргументы>'']
:Назначает действие на клавишу
::Пример по назначению клавиши X на прятанье HUD: '''bind x down showhud 0'''
::Пример по сбросу всех назначенных действий (со всех клавиш): '''bind defaults'''
====unbind====
:Использование: unbind ''<all/клавиша>'' [''<up/down> <команда>'']
:Убирает назначенное(ые) действие(я) с клавиши
::Пример по убору назначения клавиши X с прятанья HUD: '''unbind x down showhud 0'''
::Пример по убору всех назначенных команд с клавиши X: '''unbind x'''
====copygtacontrols====
:Копирует все управление с GTA - для правильной работы может потребоваться перезапуск
====screenshot====
:Сохраняет снимок экрана (скриншот)
====saveconfig====
:Сразу же сохраняет конфигурацию MTA

==Команды при наличии подключения к серверу==
====disconnect====
:Отсоединяет от сервера и возвращает в главное меню
====shownametags====
:Использование: shownametags [''<''0-1''>'']
:Показывает метки ников у игроков
====showchat====
:Использование: showchat [''<''0-1''>'']
:Показывает окно чата
====shownetstat====
:Использование: shownetstat [''<''0-1''>'']
:Показывает статистику использования сети
====chatbox====
:Использование: chatbox ''<''0-255''>'' ''<''0-255''>'' ''<''0-255''>''
:Устанавливает цвет чата
====textscale====
:Использование: textscale ''<''0.8 to 3.0''>''
:Устанавливает коэффициент масштаба всех отобразителей текста (textdisplay)
====showcol====
:Использование: showcol [''<''0-1''>'']
:Показывает колшейпы (colshape) в каркасах для помощи в написании скриптов
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]
====showsound====
:Использование: showsound [''<''0-1''>'']
:Пишет id звуков мира в окнах вывода отладочной инфорации, помогая в написании скриптов с [[setWorldSoundEnabled]]
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]

==Команды, на которые можно назначить клавиши==
====cleardebug====
:Очищает окно отладки
====chatscrollup====
:Использование: chatscrollup 1
:Пролистывает окно чата вверх
====chatscrolldown====
:Использование: chatscrolldown -1
:Пролистывает окно чата вниз
====debugscrollup====
:Использование: debugscrollup 1
:Пролистывает окно отладки вверх
====debugscrolldown====
:Использование: debugscrolldown -1
:Пролистывает окно чата вниз
====voiceptt====
:Передает голос другим игрокам
====enter_passenger====
:Сажает в транспортное средство в качестве пассажира
====radio_next====
:Следующая радиостанция
====radio_previous====
:Предыдущая радиостанция
====radar====
:Использование: radar [''<''0-1''>'']
:Показывает карту
====radar_zoom_in====
:Увеличивает масштаб карты
====radar_zoom_out====
:Уменьшает масштаб карты
====radar_move_north====
:Сдвигает карту к северу (наверх)
====radar_move_south====
:Сдвигает карту к югу (вниз)
====radar_move_east====
:Сдвигает карту к востоку (вправо)
====radar_move_west====
:Сдвигает карту к западу (слево)
====radar_attach====
:Закрепляет карту за меткой игрока
====msg_target====
:Использование: msg_target ''<текст>''
:Отправляет сообщение указанному игроку
====vehicle_next_weapon====
:Меняет оружие на следующее при нахождении в транспортном средстве
====vehicle_previous_weapon====
:Меняет оружие на предыдущее при нахождении в транспортном средстве
====radio_next====
:Меняет радиостанцию на следующую
====radio_previous====
:Меняет радиостанцию на предыдущую

[[Category: Support]]
[[en:Client Commands]]

RU/Server mtaserver.conf

2012-07-08T13:30:06Z

Vincent:

На этой странице описаны все настройки, которые можно установить в файле конфигурации. ''Курсивом выделены настройки из файла конфигурации '''mtaserver.conf''' по умолчанию''

====servername====
:''<servername>Default MTA Server</servername>''
:Этот параметр указывает название, под которым сервер будет видимым во внутриигровом браузере серверов и Game-Monitor'е. Этот параметр является обязательным.

====serverip====
:''<serverip></serverip>
:'''ИСПОЛЬЗУЙТЕ ЭТОТ ПАРАМЕТР ТОЛЬКО ЕСЛИ ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ'''
:В основном он требуется только профессиональным серверам и в других случаях его следует оставлять пустым. Этот параметр указывает используемый IP для серверов, у которых имеется множество IP-адресов. Если оставить пустым, по умолчанию будет использоваться стандартный локальный IP-адрес сервера.
:SERVERIP СЛЕДУЕТ ОСТАВИТЬ ПУСТЫМ ЗА ИСКЛЮЧЕНИЕМ СЛУЧАЕВ, КОГДА ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ
:Люди, которые все же решатся, а потом будут просить о помощи, будут первыми поставлены к стенке после революции

====serverport====
:''<serverport>22003</serverport>
:Этот параметр указывает UDP порт сервера, на который будут поступать соединения игроков;
:значение по умолчанию: 22003. Этот параметр является обязательным.

====maxplayers====
:''<maxplayers>32</maxplayers>
:Этот параметр указывает максимальное количество игровых слотов, доступных на сервере;
:значение по умолчанию: 32. Этот параметр является обязательным.

====httpserver====
:''<httpserver>1</httpserver>
:Этот параметр указывает, будет ли использоваться встроенный http-сервер.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpport====
:''<httpport>22005</httpport>
:Этот параметр указывает TCP порт сервера, на который будут поступать http-соединения. Он может быть установлен на то же значение, что и <serverport>. Этот параметр является обязательным, если <httpserver> установлен на 1.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:Если установлен, то этот параметр указывает внешний URL, с которого клиенты смогут скачивать нужные ресурсы, находясь в игре. Иначе они будут их скачивать напрямую с сервера.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpautoclientfiles====
:''<httpautoclientfiles>1</httpautoclientfiles>
:Этот параметр указывает, следует ли клиентским файлам для хостинга на внешнем веб-сервере быть автоматически скопированными в mods/deathmatch/resource-cache/http-client-files/ Уместно только при установленном <httpdownloadurl>.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:Этот параметр ограничивает количество http-соединений, доступных каждому из клиентов. В зависимости от типа используемого http-сервера, меньшее число может снизить ожидание при закачке.
:Диапазон доступных значений: 1 - 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:Этот параметр ограничивает количество http-соединений, которое IP может инициировать за короткий промежуток времени.
:Диапазон доступных значений: 1 - 100. значение по умолчанию: 20

====client_file====
:''<nowiki></nowiki>
:По умолчанию, сервер будет блокировать использование измененных data-файлов GTA:SA.
:Для разрешения определенных клиентских файлов, добавьте одну или более строк по типу выше.
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====disableac====
:''<disableac></disableac>
:Список отключенных античитов, разделенный запятыми.
:напр. Чтобы отключить античиты #2 и #3, используйте: 2,3
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====enablesd====
:''<enablesd></enablesd>
:Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым.
:напр. Для включения спецпроверки #12 (запрет на собственный D3D9.DLL) используйте: 12

====networkencryption====
:''<networkencryption>1</networkencryption>
:Этот параметр указывает, будет ли обмен информацией между сервером и клиентом шифроваться. Шифрование может помочь в предотвращении просмотра и изменения сетевых данных.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====minclientversion====
:''<minclientversion></minclientversion>
:Минимальная версия клиента. Клиентам ниже этой версии будет отказано в соединении. После отсоединения клиентам будет дана возможность закачать обновление. Если оставить пустым, эта настройка отключена и ограничения на возможность подключаться нет. Номера версий описаны на [[getPlayerVersion]] и выглядят примерно так: 1.1.0-9.03100.0
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который он получит, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Рекомендуемая версия клиента. Если у клиента версия ниже, то при подсоединении ему будет предложено закачать обновление. Если оставить пустым, эта настройка отключена.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который он получит, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====ase====
:''<ase>1</ase>
:Этот параметр может использоваться для разрешения серверу сообщаться с главными серверами Game-Monitor, позволяя ему быть видимым во внутриигровом браузере серверов. Для функционирования потребуется дополнительный доступный UDP порт (он получается как <serverport> + 123 , так что при значении <serverport> по умолчанию (22003) правильным портом будет 22126 ).
:Доступные значения: 0 - отключено , 1 - включено. Опциональный параметр, по умолчанию 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:Этот параметр позволяет вам отключить вещание по LAN (локальной сети).

====password====
:''<password></password>
:Если установлен, игрокам перед подключением к серверу понадобится вводить пароль, указанный выше. Если оставить пустым, пароль им не потребуется.
::Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerPassword]] или [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:Этот параметр снижает использование сервером канала благодаря использованию различных оптимизаций.
:Значения: none, medium или maximum ; значение по умолчанию: medium
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:Этот параметр определяет время между пакетами синхронизации игрока в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:Этот параметр определяет время между легкими пакетами синхронизации (игрока) в миллисекундах.
:Диапазон доступных значений: 200 - 40000; значение по умолчанию: 1500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:Этот параметр определяет время между пакетами синхронизации камеры в миллисекундах.
:Диапазон доступных значений: 200 - 400; значение по умолчанию: 500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>400</ped_sync_interval>
:Этот параметр определяет время между пакетами синхронизации педов в миллисекунах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 400
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval>
:Этот параметр определяет время между пакетами синхронизации пустого транспортного средства в миллисекундах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 1000
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения мышью в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения джойстиком в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>0</bullet_sync>
:Этот параметр может улучшить достоверность выстрелов при использования определенных видов оружия. Как бы то ни было, "синхронизация пуль" повлечет больший расход канала.
:'''Для работы параметра обязательно требуется билд сервера 4247 и выше, подключающиеся клиенты будут также при необходимости автообновлены, если параметр включен.'''
:Заметьте, что синхронизация пуль будет включена независимо от этой настройки, если включены определенные [[setGlitchEnabled|баги]].
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 0.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====threadnet====
:''<threadnet>1</threadnet>
:Этот параметр указывает, запускать ли сетевую синхронизацию отдельным потоком или нет.
:Включение сделает синхронизацию глаже, но может также слегка увеличить использование ЦП.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Указывает местонахождение и название файла, являющегося уникальным личным ключом данного сервера. Это используется для предотвращения чтения личных файлов, сохраненных на клиенте, другими серверами.
:Храните резервную копию этого файла в безопасном месте. Значение по умолчанию: server-id.keys
:Больше информации о личных файлах клиентов: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Указывает местонахождение и название файла, являющегося основным логом сервера. Если оставить пустым, сервер не будет вести этот лог.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:Так же как и в основной лог, успешные и провальные попытки залогиниться записываются и сюда для легкости рассмотрения вопросов, связанных с безопасностью. Если оставить пустым, файл не будет использоваться

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Указывает местонахождение и название файла, используемого для ведения записей запросов баз данных. Серверная команда [[RU/Server_Commands#debugdb|debugdb]] устанаваливает размах ведения записей.

====acl====
:''<acl>acl.xml</acl>
:Этот параметр указывает местоположение и название файла настроек Access Control List (Списка Контроля Доступа). Если оставить
:пустым, сервер будет использовать файл acl.xml, расположенный в той же папке, что и этот конфигурационный файл (mtaserver.conf).

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Указывает местоположение и название лог-файла debugscript. Если оставить пустым, сервер не будет вести этот лог.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Указывает уровень лог-файла debugscript. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Указывает уровень html-отладки. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====fpslimit====
:''<fpslimit>36</fpslimit>
:Указывает ограничение частоты кадров, которое будет применено к подсоединяющимся клиентам.
:Диапазон доступных значений: 25 - 100. По умолчанию: 36.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====autologin====
:''<autologin>0</autologin>
:Указывает, следует ли автоматически логинить игроков, базируясь на их IP-адресах, или нет

====voice====
:''<voice>0</voice>
:Этот параметр указывает, включать ли для игроков внутриигровой голосовой чат или нет
:Значения: 0 - отключено , 1 - включено

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:Этот параметр указывает частоту дискретизации голосового чата. Чтобы это действовало, параметр 'voice' должен быть установлен на 1. Большие значения используют больше пропускной способности канала и поднимают дискретизационное качество голосового чата
:Значения: 0 - Узкополосный (8kHz), 1 - Широкополосный (16kHz), 2 - Ультраширокополосный (32kHz). По умолчанию - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:Этот параметр указывает качество голоса для голосового чата. Чтобы это действовало, параметр 'voice' должен быть установлен на 1. Большие значения используют больше пропускной способности канала и поднимают качество голосового чата в целом
:Диапазон доступных значений: 0 - 10. По умолчанию - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Указывает битрейт голоса в bps. Этот опциональный параметр перекрывает две предыдущие настройки. Если не установлен, MTA сама контролирует это. Будьте осторожны в использовании.

====backup_path====
:''<backup_path>backups</backup_path>
:Этот параметр указывает путь, используемый для хранения базовых резервных копий некоторых файлов сервера. Заметьте, что базовые резервные копии делаются только во время запуска сервера. Значение по умолчанию: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:Этот параметр указывает количество дней между каждой из базовых резервных копий. Резервные копии делаются только во время запуска сервера, так что фактический интервал может быть намного больше. Установка backup_interval на 0 отключит резервные копии
:Диапазон доступных значений: 0 - 30. По умолчанию - 3

====backup_copies====
:''<backup_copies>5</backup_copies>
:Этот параметр указывает максимальное количество хранимых резервных копий. Установка backup_copies на 0 отключит резервные копии
:Диапазон доступных значений: 0 на 100. По умолчанию - 5

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Указывает модули, которые загружаются с сервером. Чтобы загрузить несколько модулей, добавьте больше строк (параметров) <module>. Опциональный параметр.

====resource====
:''<resource src="admin" startup="1" protected="0"/>
:''<resource src="defaultstats" startup="1" protected="0"/>
:''<resource src="helpmanager" startup="1" protected="0"/>
:''<resource src="joinquit" startup="1" protected="0"/>
:''<resource src="mapcycler" startup="1" protected="0"/>
:''<resource src="mapmanager" startup="1" protected="0"/>
:''<resource src="parachute" startup="1" protected="0"/>
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/>
:''<resource src="resourcemanager" startup="1" protected="1"/>
:''<resource src="scoreboard" startup="1" protected="0"/>
:''<resource src="spawnmanager" startup="1" protected="0"/>
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0"/>
:''<resource src="webadmin" startup="1" protected="0"/>
:Указывает ресурсы, которые загружаются при запуске сервера и/или являются защищенными от возможности быть остановленными. Чтобы указать несколько ресурсов, добавьте больше строк (параметров) <resource>.

[[Category: Support]]
[[en:Server mtaserver.conf]]

RU/Server Manual

2012-07-08T13:29:13Z

Vincent:

{{DISPLAYTITLE:Руководство по серверу}}
__TOC__

==Начало==
Поднять и поддерживать сервер для своих LAN или интернет-друзей намного легче, чем кажется; просто следуйте этой статье и, надеюсь, вы быстро разберетесь, как хостить свой собственный MTA:SA сервер!

==Установка сервера==
Приложение для выделенного сервера доступно в разных редакциях, зависящих от платформы севрера.

===Linux===
Есть несколько путей поднять и запустить сервер на Linux:
* [http://linux.mtasa.com Прекомпилированный пакет]
* [[RU/Building MTASA Server on GNU Linux|Сборка сервера MTASA на GNU/Linux]]

===Windows===
Установка сервера MTA:SA на Windows очень проста.
*Перейдите на [http://mtasa.com/ страницу закачки] и скачайте установщик.
*Когда установщик закачан, запустите его.
*Выберите папку, куда вы хотели бы установить сервер.
*Нажмите Install.
*Все!

''Для полной инструкции по acl.xml (access control list - лист контроля над правами) читайте: [[RU/Access_Control_List|Access Control List]]''<br/><br/>

==Настройка сервера==
Выделенный сервер Multi Theft Auto изначально поддается настройке через окно консоли, прямо из игры и через браузер. Чтобы активировать последние две опции, необходимо добавить хотя бы одного администратора в ваш конфигурационный файл.

===Основная настройка===
Все основные опции настройки находятся в файле 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и могут быть заданы через обычный текстовый редактор.

Этот файл очень прост; каждая переменная имеет [[RU/Server_mtaserver.conf|описание своего назначения и информацию по ее изменению]].

===Проброс портов===
Если вы запускаете сервер на своем личном компьютере и у вас есть роутер, вам понадобится пробросить 3 порта.

Для начала откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и найдите следующие строки:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Эти порты нужны для правильной установки сервера. Позже мы объясним как их задавать, но сначала, если вы хотите, чтобы ваш сервер появился в браузере серверов, то есть еще один нужный нам порт - порт ASE.
(краткий пример по включению / выключению ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Теперь нам нужно пробросить порты на вашем роутере, что не понадобится, если у вас уже открыты все порты, или если у вас нет роутера с фаерволлом. Если так оно и есть, пропустите эту часть.

Если вы не знаете, как пробросить порты на вашем роутере, пройдите [http://portforward.com/ на сайт по проброске портов], найдите там модель своего роутера и следуйте инструкциям.

Почти в каждом роутере можно задать тип порта: UDP или TCP. Этот список объяснит, какой тип порта и для чего нужен:

Главный порт сервера: UDP

HTTP порт: TCP

ASE порт: UDP (он понадобится, если вы захотите появления своего сервера в браузере серверов)

ASE порт легко вычислить:

ASE порт = главный порт сервера + 123

Итак, если главный порт вашего сервера - 22003, ASE порт будет 22126.

Удачи!

''В последней версии сервера вы можете проверить статус портов через следующую серверную команду [[RU/Server_Commands#openports|openports]].''

===Проверки клиента===

При желании, античит MTA сервера может быть отключен. В нем можно также разрешить определенным или всем файлам быть измененными (напр. carmods.dat) или задать минимально допустимую весрию клиента.

Все эти настройки расположены внутри файла 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]'. Смотрите [[Anti-cheat_guide|Anti-cheat guide]] для получения дополнительной информации.<br/>

Если вы хотите задать минимальную версию клиента, найдите следующую строку:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Правильные значения выглядят наподобие: 1.1.1-9.02320

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

Чтобы добавить администратора, следуйте этим шагам:<br>
<ol>
<li>Если сервер запущен, добавьте новый аккаунт через ввод команды '''[[RU/Server_Commands#addaccount|addaccount name password]]''' в окно севрера. Например, чтобы добавить пользователя VasyaPupkin, вам понадобится набрать:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount VasyaPupkin 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Заметка: Если у вас нет доступа к окну сервера, а ресурс 'admin' запущен, вы можете добавить аккаунт-образец через ввод '''/register VasyaPupkin 123password''''' в чат.
</div>
<li>Сервер должен будет отобразить сообщение о том, что аккаунт добавлен.
<li>Затем выключите сервер, введя '''shutdown''' в окне сервера.
<li>Удостоверьтесь, что сервер выключен; если он все еще запущен, изменения, которые вы вносите, будут перезаписаны</li>
<li>Откройте файл 'mods/deathmatch/'acl.xml'''' любым текстовым редактором</li>
<li>Добавьте аккаунт в группу ''Admin'', используя XML-синтаксис, как это сделано ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.VasyaPupkin" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Вообще, можно добавлять пользователей в какие угодно группы. Каждая из групп связана с ACL ([[RU/Access Control List|Access Control List]]). Каждый ACL содержит специфический список разрешенных и запрещенных прав. Группы существуют для того, чтобы разным пользователям могли соответствовать разные права. Группа ''Admin'' связана с ''Admin''ским ACL, который пуст (стало быть, разрешены все права). Группа ''Everyone'' связана с ''Default''ным ACL, который накладывает список ограничений на доступные команды (чтобы не позволять обычным пользователям пользоваться админскими командами).
</li>
<li>
Это все! Вы можете добавлять столько администраторов и пользователей этим способом столько, сколько захотите, еще посмотрите на другие группы и ACL'ы, например. ACL также доступен через [[RU/Access_Control_List|скриптовый движок Lua]].<br>

Рекомендуется взглянуть на веб-интерфейс, как это сделать мы опишем ниже.
</li>
</ol>
'''Заметка''': Для сервера, когда он запущен, есть другие способы добавлять аккаунты и редактировать права. "[[RU/Server_Commands#addaccount|addaccount <user> <password>]]" - внутренняя команда для добавления аккаунтов, но вам придется воспользоваться веб-интерфейсом, чтобы добавить эти аккаунты в специфические группы/ACLы!<br />

===Использование веб-интерфейса===
Выделенный сервер поставляется с некоторыми Lua [[RU/Resources|ресурсами]], которые предоставляют хороший простой веб-интерфейс для управления сервером. Это легко может быть использовано для поддержки сервера, так как позволяет вам добавлять пользователей, запускать/останавливать ресурсы и другое.

Ресурсы веб-интерфейса по умолчанию включены и обслуживаются через встроенный HTTP веб-сервер. Чтобы убедиться, что встроенный HTTP веб-сервер запущен на нужном вам порту (22005 по умолчанию), следуйте данной инструкции:
<ol>
<li>Убедитесь, что сервер выключен
<li>Откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' любым текстовым редактором</li>
<li>Проверьте, что HTTP сервер включен:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Измените порт HTTP сервера на свое усмотрение:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Сохраните изменения и закройте файл конфигурации</li>
<li>Запустите сервер</li>
<li>Если вы меняли список автозапускаемых ресурсов в конфигурационном файле, убедитесь, что следующие ресурсы запущены:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Они автоматически стартуют согласно стандартному файлу, в случае, если вы только что установили свой сервер.
</li>
<li>Откройте веб-браузер (Internet Explorer 6 or 7 НЕ поддерживаются; используйте [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] или другие) и перейдите по URL HTTP server'а: '''http://server:port/'''. Например, если у вас зупщен локальный сервер на HTTP порту 22005, используйте '''http://127.0.0.1:22005/'''.</li>
<li>Введите имя пользователя и пароль администратора, которого вы добавили в предыдущей секции.</li>
</ol>

<br />
Теперь вы способны управлять своим севрером через веб-интерфейс.

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

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

Чтобы включить скачивание с внешнего веб-сервера, вам следует настроить тег [[RU/Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] в конфигурации своего сервера:

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

С тех пор, как все стандартные ресурсы, поставляемые с выделенным сервером, упакованы в zip-архивы, и обычно автоматически распаковываются благодаря встроенному веб серверу, теперь вам понадобится предоставить клиентам возможность закачивать себе сжатые файлы. Чтобы настроить MTA на поддержание копии только распакованных клиентских ресурсов, установите [[RU/Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] в конфигурации вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>

Теперь, когда вы запускаете сервер, папка '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' будет содержать действительные клиентские файлы для хостинга на внешнем веб-сервере. Если веб сервер расположен на том же компьютере, что и сервер, вы можете просто связать директорию надлежащего веб-сервера с '''http-client-files'''. Если веб-севрер расположен на отдельном компьюетре, убедитесь, что у него есть доступ к '''http-client-files''' по сети, или поддерживайте удаленную копию с помощью синхронизационного ПО.

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

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

Чтобы запустить сервер, выполните двойной щелчок по MTA Server.exe, убедитесь, что добавили его в исключение фаерволлов и пробросили порты, если это необходимо.

==Установка/Обновление ресурсов сервера==
Ресурсы могут быть двух видов, либо в формате ZIP-архива, либо просто обычной папкой со скриптами внутри. MTA:SA сервер поддерживает оба метода.

# Переместите или скопируйте новый ресурс в вашу папку <SERVER>\mods\deathmatch\resources.
# В окне сервера введите команду [[RU/Server_Commands#refresh|refresh]], эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

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

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

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

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

Для других команд, введите [[RU/Server_Commands#help|help]] в консоли.

==Запуск карты/мода==
Смотрите секцию команд у [[RU/Resource:Map manager|mapmanager]] для дальнешей информации.

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

# Вы можете также обновлять ресурсы прямо из игры, если у вас есть соответствующие права, введя "refresh" в клиентской консоли или "/refresh" в чате. Это может вызвать секундное подлагивание, если ресурсов много.
# В инструкциях выше, <SERVER> - путь к главной директории сервер. В большинстве случаев это C:\Program Files\MTA San Andreas\server
# Вы можете выбрать к использованию сервером другой конфигурационный файл, добавив его в командной строке после аргумента --config, напр. mtaserver.exe --config anotherconfig.cfg.
# Не пугайтесь предупреждения об анализе файла settings.xml. Это происходит, когда ваша установка сервера все еще чиста и не была задействована.

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

[[en:Deathmatch Server Manual]]
[[es:Manual del Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]

[[Category:Support]]

RU/Server Commands

2012-07-08T13:25:48Z

Vincent: /* chgmypass */

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

==Команды ресурсов==
====checkall====
:<ins>Только в серверной консоли</ins>
:Проверяет все ресурсы на наличие устаревших функций и проблем с версиями MTA
====info====
:<ins>Только в серверной консоли</ins>
:Использование: info ''<название-ресурса>''<br>
:Получает информацию о ресурсе, напр.: info admin
====list====
:<ins>Только в серверной консоли</ins>
:Показывает список ресурсов

====refresh====
:Обновляет список ресурсов с целью найти новые
====refreshall====
:Обновляет список ресурсов и перезапускает любые, которых коснулись изменения
====restart====
:Использование: info ''<название-ресурса>''<br>
:Перезапускает запущенный ресурс, напр.: restart admin
====start====
:Использование: start ''<название-ресурса>''<br>
:Запускает загруженный ресурс, напр.: start admin
====stop====
:Использование: stop ''<название-ресурса>''<br>
:Останавливает ресурс, напр.: stop admin
====stopall====
:Останавливает все запущенные ресурсы
====upgrade====
:<ins>Только в серверной консоли</ins>
:Выполняет базовое обновление всех ресурсов, использующих устаревшие функции
====aclrequest====
:Использование: aclrequest [''list''|''allow''|''deny''] ''<название-ресурса>'' [''<полномочие>''|''all'']<br>
:Распоряжается ACL-запросами ресурсов, реализуя <aclrequest> из их [[RU/Meta.xml|meta.xml]]

==Команды аккаунтов==
====aexec====
:Использование: aexec ''<ник>'' ''<команда>''<br>
:Принудительно выполянет команду от имени игрока, напр.: aexec имяигрока say привет
====addaccount====
:Использование: addaccount ''<названиеаккаунта>'' ''<пароль>''<br>
:Добавляет аккаунт, напр.: addaccount названиеаккаунта пароль
====chgpass====
:Использование: chgpass ''<названиеаккаунта>'' ''<пароль>''<br>
:Меняет пароль аккаунта, напр.: chgpass аккаунт новыйпароль
====delaccount====
:Использование: delaccount ''<названиеаккаунта>''<br>
:Удаляет аккаунт, напр.: delaccount названиеаккаунта

==Команды сервера==
====ase====
:<ins>Только в серверной консоли</ins>
:Показывает количество запросов ко главному списку серверов
====debugdb====
:Использование: debugdb ''<''0-2''>''<br>
:<ins>Только в серверной консоли</ins>
:Устанаваливает размах ведения записей для функций баз данных. [0-Выкл.  1-Только ошибки  2-Все]
====help====
:<ins>Только в серверной консоли</ins>
:Отображает данный список команд
====loadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: loadmodule ''<название-файла-модуля>''<br>
:Загружает модуль, напр.: loadmodule ml_sockets.dll
====unloadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: unloadmodule ''<название-файла-модуля>''<br>
:Выгружает модуль, напр.: unloadmodule ml_sockets.dll
====reloadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: reloadmodule ''<название-файла-модуля>''<br>
:Перезагружает модуль, напр.: reloadmodule ml_sockets.dll
====openports====
:<ins>Только в серверной консоли</ins>
:Тестирует, открыты ли порты сервера
====shutdown====
:Использование: shutdown ''<причина>''<br>
:Выключает сервер, напр.: shutdown поместите сюда причину
====sver====
:Получает версию MTA сервера

==Другие команды==
====say====
:Использование: say ''<текст>''<br>
:Показывает всем игрокам сервера сообщение, напр.: say привет
====whois====
:Использование: whois ''<ник>''<br>
:Получает IP игрока, подключенного в данный момент (используйте whowas для IP/серийника/версии)
====whowas====
:Использование: whowas ''<ник>''<br>
:Получает IP/серийный номер игрока, который ранее был подключен к серверу
====ver====
:Получает версию MTA

==Уместные только на клиенте==
====chgmypass====
:<ins>Только на клиенте</ins>
:Использование: chgmypass ''<старыйпароль>'' ''<новыйпароль>''<br>
:Меняет ваш пароль, напр.: chgmypass старыйпароль новыйпароль

====debugscript====
:<ins>Только на клиенте</ins>
:Использование: debugscript ''<''0-3''>''<br>
:Показывает консоль отладки, в которую выводятся отладочные сообщения от функций и скриптов MTA. [0-Выкл.  1-Только ошибки  2-Ошибки и предупреждения  3-Ошибки, предупреждения и информационные сообщения]
====login====
:<ins>Только на клиенте</ins>
:Использование: login ''<названиеаккаунта>'' ''<пароль>''<br>
:Залогинивает в аккаунт, напр.: login названиеаккаунта пароль
====logout====
:<ins>Только на клиенте</ins>
:Разлогинивает из текущего аккаунта
====me====
:<ins>Только на клиенте</ins>
:Использование: me ''<текст>''<br>
:Показывает всем игрокам сервера сообщение якобы от третьего лица
====msg====
:<ins>Только на клиенте</ins>
:Использование: msg ''<ник>'' ''<текст>''<br>
:Посылает игроку сообщение, напр.: msg имяигрока привет
====nick====
:<ins>Только на клиенте</ins>
:Использование: nick ''<старый-ник>'' ''<новый-ник>''<br>
:Меняет ваш ник в игре
====teamsay====
:<ins>Только на клиенте</ins>
:Использование: teamsay ''<текст>''<br>
:Посылает сообщение всем игрокам, находящимся в той же команде

[[Category: Support]]
[[en:Server Commands]]

RU/Server Commands

2012-07-08T12:26:46Z

Vincent: Created page with "Эта страница описывает все встроенные команды, доступные для выполнения на сервере. Все эти кома..."

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

==Команды ресурсов==
====checkall====
:<ins>Только в серверной консоли</ins>
:Проверяет все ресурсы на наличие устаревших функций и проблем с версиями MTA
====info====
:<ins>Только в серверной консоли</ins>
:Использование: info ''<название-ресурса>''<br>
:Получает информацию о ресурсе, напр.: info admin
====list====
:<ins>Только в серверной консоли</ins>
:Показывает список ресурсов

====refresh====
:Обновляет список ресурсов с целью найти новые
====refreshall====
:Обновляет список ресурсов и перезапускает любые, которых коснулись изменения
====restart====
:Использование: info ''<название-ресурса>''<br>
:Перезапускает запущенный ресурс, напр.: restart admin
====start====
:Использование: start ''<название-ресурса>''<br>
:Запускает загруженный ресурс, напр.: start admin
====stop====
:Использование: stop ''<название-ресурса>''<br>
:Останавливает ресурс, напр.: stop admin
====stopall====
:Останавливает все запущенные ресурсы
====upgrade====
:<ins>Только в серверной консоли</ins>
:Выполняет базовое обновление всех ресурсов, использующих устаревшие функции
====aclrequest====
:Использование: aclrequest [''list''|''allow''|''deny''] ''<название-ресурса>'' [''<полномочие>''|''all'']<br>
:Распоряжается ACL-запросами ресурсов, реализуя <aclrequest> из их [[RU/Meta.xml|meta.xml]]

==Команды аккаунтов==
====aexec====
:Использование: aexec ''<ник>'' ''<команда>''<br>
:Принудительно выполянет команду от имени игрока, напр.: aexec имяигрока say привет
====addaccount====
:Использование: addaccount ''<названиеаккаунта>'' ''<пароль>''<br>
:Добавляет аккаунт, напр.: addaccount названиеаккаунта пароль
====chgpass====
:Использование: chgpass ''<названиеаккаунта>'' ''<пароль>''<br>
:Меняет пароль аккаунта, напр.: chgpass аккаунт новыйпароль
====delaccount====
:Использование: delaccount ''<названиеаккаунта>''<br>
:Удаляет аккаунт, напр.: delaccount названиеаккаунта

==Команды сервера==
====ase====
:<ins>Только в серверной консоли</ins>
:Показывает количество запросов ко главному списку серверов
====debugdb====
:Использование: debugdb ''<''0-2''>''<br>
:<ins>Только в серверной консоли</ins>
:Устанаваливает размах ведения записей для функций баз данных. [0-Выкл.  1-Только ошибки  2-Все]
====help====
:<ins>Только в серверной консоли</ins>
:Отображает данный список команд
====loadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: loadmodule ''<название-файла-модуля>''<br>
:Загружает модуль, напр.: loadmodule ml_sockets.dll
====unloadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: unloadmodule ''<название-файла-модуля>''<br>
:Выгружает модуль, напр.: unloadmodule ml_sockets.dll
====reloadmodule====
:<ins>Только в серверной консоли</ins>
:Использование: reloadmodule ''<название-файла-модуля>''<br>
:Перезагружает модуль, напр.: reloadmodule ml_sockets.dll
====openports====
:<ins>Только в серверной консоли</ins>
:Тестирует, открыты ли порты сервера
====shutdown====
:Использование: shutdown ''<причина>''<br>
:Выключает сервер, напр.: shutdown поместите сюда причину
====sver====
:Получает версию MTA сервера

==Другие команды==
====say====
:Использование: say ''<текст>''<br>
:Показывает всем игрокам сервера сообщение, напр.: say привет
====whois====
:Использование: whois ''<ник>''<br>
:Получает IP игрока, подключенного в данный момент (используйте whowas для IP/серийника/версии)
====whowas====
:Использование: whowas ''<ник>''<br>
:Получает IP/серийный номер игрока, который ранее был подключен к серверу
====ver====
:Получает версию MTA

==Уместные только на клиенте==
====chgmypass====
:<ins>Только на клиенте</ins>
:Использование: chgmypass ''<старыйпароль>'' ''<новыйпароль>''<br>
:Меняет ваш пароль, напр.: chgmypass oldpw newpw
====debugscript====
:<ins>Только на клиенте</ins>
:Использование: debugscript ''<''0-3''>''<br>
:Показывает консоль отладки, в которую выводятся отладочные сообщения от функций и скриптов MTA. [0-Выкл.  1-Только ошибки  2-Ошибки и предупреждения  3-Ошибки, предупреждения и информационные сообщения]
====login====
:<ins>Только на клиенте</ins>
:Использование: login ''<названиеаккаунта>'' ''<пароль>''<br>
:Залогинивает в аккаунт, напр.: login названиеаккаунта пароль
====logout====
:<ins>Только на клиенте</ins>
:Разлогинивает из текущего аккаунта
====me====
:<ins>Только на клиенте</ins>
:Использование: me ''<текст>''<br>
:Показывает всем игрокам сервера сообщение якобы от третьего лица
====msg====
:<ins>Только на клиенте</ins>
:Использование: msg ''<ник>'' ''<текст>''<br>
:Посылает игроку сообщение, напр.: msg имяигрока привет
====nick====
:<ins>Только на клиенте</ins>
:Использование: nick ''<старый-ник>'' ''<новый-ник>''<br>
:Меняет ваш ник в игре
====teamsay====
:<ins>Только на клиенте</ins>
:Использование: teamsay ''<текст>''<br>
:Посылает сообщение всем игрокам, находящимся в той же команде

[[Category: Support]]
[[en:Server Commands]]

RU/Client Commands

2012-07-06T20:56:20Z

Vincent:

Эта страница описывает все встроенные команды, доступные для выполнения на клиенте. Данные команды можно вводить напрямую в клиентскую консоль или в чат, поставив перед ними / (слэш). Некоторые [[Server_Commands|серверные команды]] также доступны из клиента. Аргументы внутри [...] опциональны.

==Команды ядра==
====help====
:Отображает данный список команд
====exit====
:Выходит из приложения
====quit====
:Выходит из приложения
====ver====
:Выводит версию MTA в клиентскую консоль
====time====
:Выводит в чат текущее время
====showhud====
:Использование: showhud [''<''0-1''>'']
:Отображает HUD
====binds====
:Выводит все назначенные на клавиши действия в клиентскую консоль
====serial====
:Выводит ваш серийный номер в клиентскую консоль

====connect====
:Использование: connect ''<адрес> <порт>'' [''<ник> <пароль>'']
:Присоединяет к серверу
====reconnect====
:Присоединяет к последнему посещенному серверу
====bind====
:Использование: bind ''<defaults/клавиша>'' [''<up/down>''] ''<команда>'' [''<аргументы>'']
:Назначает действие на клавишу
::Пример по назначению клавиши X на прятанье HUD: '''bind x down showhud 0'''
::Пример по сбросу всех назначенных действий (со всех клавиш): '''bind defaults'''
====unbind====
:Использование: unbind ''<all/клавиша>'' [''<up/down> <команда>'']
:Убирает назначенное(ые) действие(я) с клавиши
::Пример по убору назначения клавиши X с прятанья HUD: '''unbind x down showhud 0'''
::Пример по убору всех назначенных команд с клавиши X: '''unbind x'''
====copygtacontrols====
:Копирует все управление с GTA - для правильной работы может потребоваться перезапуск
====screenshot====
:Сохраняет снимок экрана (скриншот)
====saveconfig====
:Сразу же сохраняет конфигурацию MTA

==Команды при наличии подключения к серверу==
====disconnect====
:Отсоединяет от сервера и возвращает в главное меню
====shownametags====
:Использование: shownametags [''<''0-1''>'']
:Показывает метки ников у игроков
====showchat====
:Использование: showchat [''<''0-1''>'']
:Показывает окно чата
====shownetstat====
:Использование: shownetstat [''<''0-1''>'']
:Показывает статистику использования сети
====chatbox====
:Использование: chatbox ''<''0-255''>'' ''<''0-255''>'' ''<''0-255''>''
:Устанавливает цвет чата
====textscale====
:Использование: textscale ''<''0.8 to 3.0''>''
:Устанавливает коэффициент масштаба всех отобразителей текста (textdisplay)
====showcol====
:Использование: showcol [''<''0-1''>'']
:Показывает колшейпы (colshape) в каркасах для помощи в написании скриптов
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]
====showsound====
:Использование: showsound [''<''0-1''>'']
:Пишет id звуков мира в окнах вывода отладочной инфорации, помогая в написании скриптов с [[setWorldSoundEnabled]]
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]

==Команды, на которые можно назначить клавиши==
====cleardebug====
:Очищает окно отладки
====chatscrollup====
:Использование: chatscrollup 1
:Пролистывает окно чата вверх
====chatscrolldown====
:Использование: chatscrolldown -1
:Пролистывает окно чата вниз
====debugscrollup====
:Использование: debugscrollup 1
:Пролистывает окно отладки вверх
====debugscrolldown====
:Использование: debugscrolldown -1
:Пролистывает окно чата вниз
====voiceptt====
:Передает голос другим игрокам
====enter_passenger====
:Сажает в транспортное средство в качестве пассажира
====radio_next====
:Следующая радиостанция
====radio_previous====
:Предыдущая радиостанция
====radar====
:Использование: radar [''<''0-1''>'']
:Показывает карту
====radar_zoom_in====
:Увеличивает масштаб карты
====radar_zoom_out====
:Уменьшает масштаб карты
====radar_move_north====
:Сдвигает карту к северу (наверх)
====radar_move_south====
:Сдвигает карту к югу (вниз)
====radar_move_east====
:Сдвигает карту к востоку (вправо)
====radar_move_west====
:Сдвигает карту к западу (слево)
====radar_attach====
:Закрепляет карту за меткой игрока
====msg_target====
:Использование: msg_target ''<текст>''
:Отправляет сообщение указанному игроку
====vehicle_next_weapon====
:Меняет оружие на следующее при нахождении в транспортном средстве
====vehicle_previous_weapon====
:Меняет оружие на предыдущее при нахождении в транспортном средстве
====radio_next====
:Меняет радиостанцию на следующую
====radio_previous====
:Меняет радиостанцию на предыдущую

[[Category: Support]]
[[en:Client Commands]]

Client Commands

2012-07-06T20:19:45Z

Vincent:

This page lists all built in commands that the client can process. These commands can be entered directly to the client console or via the chatbox by putting a / (forward slash) in front of them. Some [[Server_Commands|server commands]] are also accessible from the client. Arguments inside [...] are optional.

==Core commands==
====help====
:Displays these list of commands
====exit====
:Exits the application
====quit====
:Exits the application
====ver====
:Outputs the MTA version in the client console
====time====
:Outputs the local time in the chatbox
====showhud====
:Usage: showhud [''<''0-1''>'']
:Shows the HUD
====binds====
:Outputs all the binds in the client console
====serial====
:Outputs your serial in the client console

====connect====
:Usage: connect ''<host> <port>'' [''<nick> <pass>'']
:Connects to a server
====reconnect====
:Connects to a previous server
====bind====
:Usage: bind ''<defaults/key>'' [''<up/down>''] ''<command>'' [''<arguments>'']
:Binds a key
::Example to bind X to hiding the HUD: '''bind x down showhud 0'''
::Example to reset all binds: '''bind defaults'''
====unbind====
:Usage: unbind ''<all/key>'' [''<up/down> <command>'']
:Unbinds a key
::Example to unbind X to from hiding the HUD: '''unbind x down showhud 0'''
::Example to unbind all commands from X: '''unbind x'''
====copygtacontrols====
:Copies the default gta controls - This may require a restart to work properly
====screenshot====
:Saves a screenshot
====saveconfig====
:Immediately saves the config

==Commands when connected to a server==
====disconnect====
:Disconnect from the server and return to the main menu
====shownametags====
:Usage: shownametags [''<''0-1''>'']
:Shows the nametags
====showchat====
:Usage: showchat [''<''0-1''>'']
:Shows the chatbox
====shownetstat====
:Usage: shownetstat [''<''0-1''>'']
:Shows the network statistics
====chatbox====
:Usage: chatbox ''<''0-255''>'' ''<''0-255''>'' ''<''0-255''>''
:Defines the chatbox color
====textscale====
:Usage: textscale ''<''0.8 to 3.0''>''
:Defines the scale multiplier of all text-displays
====showcol====
:Usage: showcol [''<''0-1''>'']
:Shows colshapes in wireframe for help when writing scripts
:Only works in development mode.
:More information: [[setDevelopmentMode]]
====showsound====
:Usage: showsound [''<''0-1''>'']
:Prints world sound ids in the debug output windows to help when writing scripts with [[setWorldSoundEnabled]]
:Only works in development mode.
:More information: [[setDevelopmentMode]]

==Commands for key binds==
====cleardebug====
:Clears the debug view
====chatscrollup====
:Usage: chatscrollup 1
:Scrolls the chatbox upwards
====chatscrolldown====
:Usage: chatscrolldown -1
:Scrolls the chatbox downwards
====debugscrollup====
:Usage: debugscrollup 1
:Scrolls the debug view upwards
====debugscrolldown====
:Usage: debugscrolldown -1
:Scrolls the debug view downwards
====voiceptt====
:Transmits voice to other players
====enter_passenger====
:Enters a car as passenger
====radio_next====
:Next radio channel
====radio_previous====
:Previous radio channel
====radar====
:Usage: radar [''<''0-1''>'']
:Shows the radar view
====radar_zoom_in====
:Zooms the radar in
====radar_zoom_out====
:Zooms the radar out
====radar_move_north====
:Moves the radar north
====radar_move_south====
:Moves the radar south
====radar_move_east====
:Moves the radar east
====radar_move_west====
:Moves the radar west
====radar_attach====
:Attaches the radar
====msg_target====
:Usage: msg_target ''<text>''
:Sends a message to the targeted player
====vehicle_next_weapon====
:Changes to the next weapon whilst in a vehicle
====vehicle_previous_weapon====
:Changes to the previous weapon whilst in a vehicle
====radio_next====
:Selects the next radio station
====radio_previous====
:Selects the previous radio station

[[Category: Support]]
[[ru:Client Commands]]

RU/Client Commands

2012-07-06T20:19:05Z

Vincent:

Эта страница описывает все встроенные команды, доступные для использования клиенту. Данные команды можно вводить напрямую в клиентскую консоль или в чат, поставив перед ними / (слэш). Некоторые [[Server_Commands|серверные команды]] также доступны из клиента. Аргументы внутри [...] опциональны.

==Команды ядра==
====help====
:Отображает данный список команд
====exit====
:Выходит из приложения
====quit====
:Выходит из приложения
====ver====
:Выводит версию MTA в клиентскую консоль
====time====
:Выводит в чат текущее время
====showhud====
:Использование: showhud [''<''0-1''>'']
:Отображает HUD
====binds====
:Выводит все назначенные на клавиши действия в клиентскую консоль
====serial====
:Выводит ваш серийный номер в клиентскую консоль

====connect====
:Использование: connect ''<адрес> <порт>'' [''<ник> <пароль>'']
:Присоединяет к серверу
====reconnect====
:Присоединяет к последнему посещенному серверу
====bind====
:Использование: bind ''<defaults/клавиша>'' [''<up/down>''] ''<команда>'' [''<аргументы>'']
:Назначает действие на клавишу
::Пример по назначению клавиши X на прятанье HUD: '''bind x down showhud 0'''
::Пример по сбросу всех назначенных действий (со всех клавиш): '''bind defaults'''
====unbind====
:Использование: unbind ''<all/клавиша>'' [''<up/down> <команда>'']
:Убирает назначенное(ые) действие(я) с клавиши
::Пример по убору назначения клавиши X с прятанья HUD: '''unbind x down showhud 0'''
::Пример по убору всех назначенных команд с клавиши X: '''unbind x'''
====copygtacontrols====
:Копирует все управление с GTA - для правильной работы может потребоваться перезапуск
====screenshot====
:Сохраняет снимок экрана (скриншот)
====saveconfig====
:Сразу же сохраняет конфигурацию MTA

==Команды при наличии подключения к серверу==
====disconnect====
:Отсоединяет от сервера и возвращает в главное меню
====shownametags====
:Использование: shownametags [''<''0-1''>'']
:Показывает метки ников у игроков
====showchat====
:Использование: showchat [''<''0-1''>'']
:Показывает окно чата
====shownetstat====
:Использование: shownetstat [''<''0-1''>'']
:Показывает статистику использования сети
====chatbox====
:Использование: chatbox ''<''0-255''>'' ''<''0-255''>'' ''<''0-255''>''
:Устанавливает цвет чата
====textscale====
:Использование: textscale ''<''0.8 to 3.0''>''
:Устанавливает коэффициент масштаба всех отобразителей текста (textdisplay)
====showcol====
:Использование: showcol [''<''0-1''>'']
:Показывает колшейпы (colshape) в каркасах для помощи в написании скриптов
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]
====showsound====
:Использование: showsound [''<''0-1''>'']
:Пишет id звуков мира в окнах вывода отладочной инфорации, помогая в написании скриптов с [[setWorldSoundEnabled]]
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]

==Команды, на которые можно назначить клавиши==
====cleardebug====
:Очищает окно отладки
====chatscrollup====
:Использование: chatscrollup 1
:Пролистывает окно чата вверх
====chatscrolldown====
:Использование: chatscrolldown -1
:Пролистывает окно чата вниз
====debugscrollup====
:Использование: debugscrollup 1
:Пролистывает окно отладки вверх
====debugscrolldown====
:Использование: debugscrolldown -1
:Пролистывает окно чата вниз
====voiceptt====
:Передает голос другим игрокам
====enter_passenger====
:Сажает в транспортное средство в качестве пассажира
====radio_next====
:Следующая радиостанция
====radio_previous====
:Предыдущая радиостанция
====radar====
:Использование: radar [''<''0-1''>'']
:Показывает карту
====radar_zoom_in====
:Увеличивает масштаб карты
====radar_zoom_out====
:Уменьшает масштаб карты
====radar_move_north====
:Сдвигает карту к северу (наверх)
====radar_move_south====
:Сдвигает карту к югу (вниз)
====radar_move_east====
:Сдвигает карту к востоку (вправо)
====radar_move_west====
:Сдвигает карту к западу (слево)
====radar_attach====
:Закрепляет карту за меткой игрока
====msg_target====
:Использование: msg_target ''<текст>''
:Отправляет сообщение указанному игроку
====vehicle_next_weapon====
:Меняет оружие на следующее при нахождении в транспортном средстве
====vehicle_previous_weapon====
:Меняет оружие на предыдущее при нахождении в транспортном средстве
====radio_next====
:Меняет радиостанцию на следующую
====radio_previous====
:Меняет радиостанцию на предыдущую

[[Category: Support]]
[[en:Client Commands]]

RU/Client Commands

2012-07-06T19:29:18Z

Vincent: Created page with "Эта страница описывает все встроенные команды, доступные для использования клиенту. Данные кома..."

Эта страница описывает все встроенные команды, доступные для использования клиенту. Данные команды можно вводить напрямую в клиентскую консоль или в чат, поставив перед ними / (слэш). Некоторые [[Server_Commands|серверные команды]] также доступны из клиента. Аргументы внутри [...] опциональны.

==Команды ядра==
====help====
:Отображает данный список команд
====exit====
:Выходит из приложения
====quit====
:Выходит из приложения
====ver====
:Выводит версию MTA в клиентскую консоль
====time====
:Выводит в чат текущее время
====showhud====
:Использование: showhud [''<''0-1''>'']
:Отображает HUD
====binds====
:Выводит все назначенные на клавиши действия в клиентскую консоль
====serial====
:Выводит ваш серийный номер в клиентскую консоль

====connect====
:Использование: connect ''<адрес> <порт>'' [''<ник> <пароль>'']
:Присоединяет к серверу
====reconnect====
:Присоединяет к последнему посещенному серверу
====bind====
:Использование: bind ''<defaults/клавиша>'' [''<up/down>''] ''<команда>'' [''<аргументы>'']
:Назначает действие на клавишу
::Пример по назначению клавиши X на прятанье HUD: '''bind x down showhud 0'''
::Пример по сбросу всех назначенных действий (со всех клавиш): '''bind defaults'''
====unbind====
:Использование: unbind ''<all/клавиша>'' [''<up/down> <команда>'']
:Убирает назначенное(ые) действие(я) с клавиши
::Пример по убору назначения клавиши X с прятанья HUD: '''unbind x down showhud 0'''
::Пример по убору всех назначенных команд с клавиши X: '''unbind x'''
====copygtacontrols====
:Копирует все управление с GTA - для правильной работы может потребоваться перезапуск
====screenshot====
:Сохраняет снимок экрана (скриншот)
====saveconfig====
:Сразу же сохраняет конфигурацию MTA

==Команды при наличии подключения к серверу==
====disconnect====
:Отсоединяет от сервера и возвращает в главное меню
====shownametags====
:Использование: shownametags [''<''0-1''>'']
:Показывает метки ников у игроков
====showchat====
:Использование: showchat [''<''0-1''>'']
:Показывает окно чата
====shownetstat====
:Использование: shownetstat [''<''0-1''>'']
:Показывает статистику использования сети
====chatbox====
:Использование: chatbox ''<''0-255''>'' ''<''0-255''>'' ''<''0-255''>''
:Устанавливает цвет чата
====textscale====
:Использование: textscale ''<''0.8 to 3.0''>''
:Устанавливает коэффициент масштаба всех отобразителей текста (textdisplay)
====showcol====
:Использование: showcol [''<''0-1''>'']
:Показывает колшейпы (colshape) в каркасах для помощи в написании скриптов
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]
====showsound====
:Использование: showsound [''<''0-1''>'']
:Пишет id звуков мира в окнах вывода отладочной инфорации, помогая в написании скриптов с [[setWorldSoundEnabled]]
:Работает только в режиме разработки.
:Больше информации: [[setDevelopmentMode]]

==Команды для назначения клавиш==
====cleardebug====
:Очищает окно отладки
====chatscrollup====
:Использование: chatscrollup 1
:Пролистывает окно чата вверх
====chatscrolldown====
:Использование: chatscrolldown -1
:Пролистывает окно чата вниз
====debugscrollup====
:Использование: debugscrollup 1
:Пролистывает окно отладки вверх
====debugscrolldown====
:Использование: debugscrolldown -1
:Пролистывает окно чата вниз
====voiceptt====
:Передает голос другим игрокам
====enter_passenger====
:Сажает в транспортное средство в качестве пассажира
====radio_next====
:Следующая радиостанция
====radio_previous====
:Предыдущая радиостанция
====radar====
:Использование: radar [''<''0-1''>'']
:Показывает карту
====radar_zoom_in====
:Увеличивает масштаб карты
====radar_zoom_out====
:Уменьшает масштаб карты
====radar_move_north====
:Сдвигает карту к северу (наверх)
====radar_move_south====
:Сдвигает карту к югу (вниз)
====radar_move_east====
:Сдвигает карту к востоку (вправо)
====radar_move_west====
:Сдвигает карту к западу (слево)
====radar_attach====
:Закрепляет карту за меткой игрока
====msg_target====
:Использование: msg_target ''<текст>''
:Отправляет сообщение указанному игроку
====vehicle_next_weapon====
:Меняет оружие на следующее при нахождении в транспортном средстве
====vehicle_previous_weapon====
:Меняет оружие на предыдущее при нахождении в транспортном средстве
====radio_next====
:Меняет радиостанцию на следующую
====radio_previous====
:Меняет радиостанцию на предыдущую

[[Category: Support]]
[[en:Client Commands]]

RU/Anti-cheat guide

2012-07-06T16:26:19Z

Vincent:

=Руководство по АЧ (АнтиЧиту)=

==Серверное устройство==

Поведение античита на сервере контролируют 3 настройки [[RU/Server_mtaserver.conf|'''mtaserver.conf''']]:

===<disableac></disableac>===
----
Список отключенных античитов, разделенный запятыми. Данная настройка античита отключит АЧ определенных кодов. Коды АЧ показываются игроку при срабатывании соответствующих проверок. Доступные коды:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <disableac>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Обнаружитель классических хаков на хп/броню
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Обнаруживает присутствие трейнеров. Заглавные буквы в сообщении служат для отметки конкретных трейнеров
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Обнаруживает использование трейнера, влияющего на: передвижение игрока, хп/урон, оружие, деньги, скорость игры; также игровые читы, аимбот
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Обнаруживает посторонние моды. Заглавные буквы в сообщении служат для отметки конкретных модов, например, CLEO - обнаружен Cleo, RENDER - обнаружен воллхак
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| Еще трейнеры
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Трейнер
|}
<br/>
===<enablesd></enablesd>===
----
Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым. Доступные коды:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <enablesd>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Запрет на собственный D3D9.DLL
|}
<br/>
===<client_file name="data/carmods.dat" verify="0"/>===
----
По умолчанию клиенты могут не смочь присоединиться к серверу, если data-файлы их GTA:SA изменены. Добавление одной или более строк по образцу выше исключит файлы из списка проверяемых. Названия файлов, пригодных к использованию:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Заметка 1:''''' ''"data/maps" представляет все файлы и папки внутри "data/maps"''<br/>

'''''Заметка 2:''''' ''"data/handling.cfg" не учитывается, так как он игнорируется MTA в любом случае в связи со встроенным функционалом управления транспортом. Если вы хотите подгрузить собственные файлы handling.cfg, то аналогичный эффект можно достичь благодаря использованию соответствующего ресурса.''<br/>

==Клиент==
При подсоединению к серверу информация по АЧ сервера отображается в клиентской консоли (F8)<br/>
Пример:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC содержит данные серверной настройки, указанные в <disableac></disableac><br/>
Enabled SD содержит данные серверной настройки, указанные в <enablesd></enablesd><br/>
Allowed client files содержит номера, указывающие на файлы, разрешенные клиенту сервером для модификации. Номера отвечают за следующие файлы:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Использование модифицированных файлов====
Если вы хотите использовать модифицированные data-файлы из вашей папки с установенной GTA:SA, поставьте маркер маркер в:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(маркер появляется только когда у вас изменены data-файлы GTA:SA)<br/>

Заметьте, что это ограничит ваш доступ к публичным серверам, так как большиснтво из них не приемлет измененные файлы данных.

[[Category: Support]]
[[en:Anti-cheat guide]]

RU/Server Manual

2012-07-06T16:22:38Z

Vincent:

{{DISPLAYTITLE:Руководство по серверу}}
__TOC__

==Начало==
Поднять и поддерживать сервер для своих LAN или интернет-друзей намного легче, чем кажется; просто следуйте этой статье и, надеюсь, вы быстро разберетесь, как хостить свой собственный MTA:SA сервер!

==Установка сервера==
Приложение для выделенного сервера доступно в разных редакциях, зависящих от платформы севрера.

===Linux===
Есть несколько путей поднять и запустить сервер на Linux:
* [http://linux.mtasa.com Прекомпилированный пакет]
* [[RU/Building MTASA Server on GNU Linux|Сборка сервера MTASA на GNU/Linux]]

===Windows===
Установка сервера MTA:SA на Windows очень проста.
*Перейдите на [http://mtasa.com/ страницу закачки] и скачайте установщик.
*Когда установщик закачан, запустите его.
*Выберите папку, куда вы хотели бы установить сервер.
*Нажмите Install.
*Все!

''Для полной инструкции по acl.xml (access control list - лист контроля над правами) читайте: [[RU/Access_Control_List|Access Control List]]''<br/><br/>

==Настройка сервера==
Выделенный сервер Multi Theft Auto изначально поддается настройке через окно консоли, прямо из игры и через браузер. Чтобы активировать последние две опции, необходимо добавить хотя бы одного администратора в ваш конфигурационный файл.

===Основная настройка===
Все основные опции настройки находятся в файле 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и могут быть заданы через обычный текстовый редактор.

Этот файл очень прост; каждая переменная имеет [[RU/Server_mtaserver.conf|описание своего назначения и информацию по ее изменению]].

===Проброс портов===
Если вы запускаете сервер на своем личном компьютере и у вас есть роутер, вам понадобится пробросить 3 порта.

Для начала откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' и найдите следующие строки:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Эти порты нужны для правильной установки сервера. Позже мы объясним как их задавать, но сначала, если вы хотите, чтобы ваш сервер появился в браузере серверов, то есть еще один нужный нам порт - порт ASE.
(краткий пример по включению / выключению ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Теперь нам нужно пробросить порты на вашем роутере, что не понадобится, если у вас уже открыты все порты, или если у вас нет роутера с фаерволлом. Если так оно и есть, пропустите эту часть.

Если вы не знаете, как пробросить порты на вашем роутере, пройдите [http://portforward.com/ на сайт по проброске портов], найдите там модель своего роутера и следуйте инструкциям.

Почти в каждом роутере можно задать тип порта: UDP или TCP. Этот список объяснит, какой тип порта и для чего нужен:

Главный порт сервера: UDP

HTTP порт: TCP

ASE порт: UDP (он понадобится, если вы захотите появления своего сервера в браузере серверов)

ASE порт легко вычислить:

ASE порт = главный порт сервера + 123

Итак, если главный порт вашего сервера - 22003, ASE порт будет 22126.

Удачи!

''В последней версии сервера вы можете проверить статус портов через следующую серверную команду [[Server_Commands#openports|openports]].''

===Проверки клиента===

При желании, античит MTA сервера может быть отключен. В нем можно также разрешить определенным или всем файлам быть измененными (напр. carmods.dat) или задать минимально допустимую весрию клиента.

Все эти настройки расположены внутри файла 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]'. Смотрите [[Anti-cheat_guide|Anti-cheat guide]] для получения дополнительной информации.<br/>

Если вы хотите задать минимальную версию клиента, найдите следующую строку:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Правильные значения выглядят наподобие: 1.1.1-9.02320

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

Чтобы добавить администратора, следуйте этим шагам:<br>
<ol>
<li>Если сервер запущен, добавьте новый аккаунт через ввод команды '''[[Server_Commands#addaccount|addaccount name password]]''' в окно севрера. Например, чтобы добавить пользователя VasyaPupkin, вам понадобится набрать:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount VasyaPupkin 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Заметка: Если у вас нет доступа к окну сервера, а ресурс 'admin' запущен, вы можете добавить аккаунт-образец через ввод '''/register VasyaPupkin 123password''''' в чат.
</div>
<li>Сервер должен будет отобразить сообщение о том, что аккаунт добавлен.
<li>Затем выключите сервер, введя '''shutdown''' в окне сервера.
<li>Удостоверьтесь, что сервер выключен; если он все еще запущен, изменения, которые вы вносите, будут перезаписаны</li>
<li>Откройте файл 'mods/deathmatch/'acl.xml'''' любым текстовым редактором</li>
<li>Добавьте аккаунт в группу ''Admin'', используя XML-синтаксис, как это сделано ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.VasyaPupkin" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Вообще, можно добавлять пользователей в какие угодно группы. Каждая из групп связана с ACL ([[RU/Access Control List|Access Control List]]). Каждый ACL содержит специфический список разрешенных и запрещенных прав. Группы существуют для того, чтобы разным пользователям могли соответствовать разные права. Группа ''Admin'' связана с ''Admin''ским ACL, который пуст (стало быть, разрешены все права). Группа ''Everyone'' связана с ''Default''ным ACL, который накладывает список ограничений на доступные команды (чтобы не позволять обычным пользователям пользоваться админскими командами).
</li>
<li>
Это все! Вы можете добавлять столько администраторов и пользователей этим способом столько, сколько захотите, еще посмотрите на другие группы и ACL'ы, например. ACL также доступен через [[RU/Access_Control_List|скриптовый движок Lua]].<br>

Рекомендуется взглянуть на веб-интерфейс, как это сделать мы опишем ниже.
</li>
</ol>
'''Заметка''': Для сервера, когда он запущен, есть другие способы добавлять аккаунты и редактировать права. "[[Server_Commands#addaccount|addaccount <user> <password>]]" - внутренняя команда для добавления аккаунтов, но вам придется воспользоваться веб-интерфейсом, чтобы добавить эти аккаунты в специфические группы/ACLы!<br />

===Использование веб-интерфейса===
Выделенный сервер поставляется с некоторыми Lua [[RU/Resources|ресурсами]], которые предоставляют хороший простой веб-интерфейс для управления сервером. Это легко может быть использовано для поддержки сервера, так как позволяет вам добавлять пользователей, запускать/останавливать ресурсы и другое.

Ресурсы веб-интерфейса по умолчанию включены и обслуживаются через встроенный HTTP веб-сервер. Чтобы убедиться, что встроенный HTTP веб-сервер запущен на нужном вам порту (22005 по умолчанию), следуйте данной инструкции:
<ol>
<li>Убедитесь, что сервер выключен
<li>Откройте файл 'mods/deathmatch/[[RU/Server_mtaserver.conf|'''mtaserver.conf''']]' любым текстовым редактором</li>
<li>Проверьте, что HTTP сервер включен:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Измените порт HTTP сервера на свое усмотрение:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Сохраните изменения и закройте файл конфигурации</li>
<li>Запустите сервер</li>
<li>Если вы меняли список автозапускаемых ресурсов в конфигурационном файле, убедитесь, что следующие ресурсы запущены:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Они автоматически стартуют согласно стандартному файлу, в случае, если вы только что установили свой сервер.
</li>
<li>Откройте веб-браузер (Internet Explorer 6 or 7 НЕ поддерживаются; используйте [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] или другие) и перейдите по URL HTTP server'а: '''http://server:port/'''. Например, если у вас зупщен локальный сервер на HTTP порту 22005, используйте '''http://127.0.0.1:22005/'''.</li>
<li>Введите имя пользователя и пароль администратора, которого вы добавили в предыдущей секции.</li>
</ol>

<br />
Теперь вы способны управлять своим севрером через веб-интерфейс.

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

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

Чтобы включить скачивание с внешнего веб-сервера, вам следует настроить тег [[RU/Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] в конфигурации своего сервера:

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

С тех пор, как все стандартные ресурсы, поставляемые с выделенным сервером, упакованы в zip-архивы, и обычно автоматически распаковываются благодаря встроенному веб серверу, теперь вам понадобится предоставить клиентам возможность закачивать себе сжатые файлы. Чтобы настроить MTA на поддержание копии только распакованных клиентских ресурсов, установите [[RU/Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] в конфигурации вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>

Теперь, когда вы запускаете сервер, папка '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' будет содержать действительные клиентские файлы для хостинга на внешнем веб-сервере. Если веб сервер расположен на том же компьютере, что и сервер, вы можете просто связать директорию надлежащего веб-сервера с '''http-client-files'''. Если веб-севрер расположен на отдельном компьюетре, убедитесь, что у него есть доступ к '''http-client-files''' по сети, или поддерживайте удаленную копию с помощью синхронизационного ПО.

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

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

Чтобы запустить сервер, выполните двойной щелчок по MTA Server.exe, убедитесь, что добавили его в исключение фаерволлов и пробросили порты, если это необходимо.

==Установка/Обновление ресурсов сервера==
Ресурсы могут быть двух видов, либо в формате ZIP-архива, либо просто обычной папкой со скриптами внутри. MTA:SA сервер поддерживает оба метода.

# Переместите или скопируйте новый ресурс в вашу папку <SERVER>\mods\deathmatch\resources.
# В окне сервера введите команду [[Server_Commands#refresh|refresh]], эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

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

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

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

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

Для других команд, введите [[Server_Commands#help|help]] в консоли.

==Запуск карты/мода==
Смотрите секцию команд у [[RU/Resource:Map manager|mapmanager]] для дальнешей информации.

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

# Вы можете также обновлять ресурсы прямо из игры, если у вас есть соответствующие права, введя "refresh" в клиентской консоли или "/refresh" в чате. Это может вызвать секундное подлагивание, если ресурсов много.
# В инструкциях выше, <SERVER> - путь к главной директории сервер. В большинстве случаев это C:\Program Files\MTA San Andreas\server
# Вы можете выбрать к использованию сервером другой конфигурационный файл, добавив его в командной строке после аргумента --config, напр. mtaserver.exe --config anotherconfig.cfg.
# Не пугайтесь предупреждения об анализе файла settings.xml. Это происходит, когда ваша установка сервера все еще чиста и не была задействована.

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

[[en:Deathmatch Server Manual]]
[[es:Manual del Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]

[[Category:Support]]

RU/Server mtaserver.conf

2012-07-06T12:17:02Z

Vincent:

На этой странице описаны все настройки, которые можно установить в файле конфигурации. ''Курсивом выделены настройки из файла конфигурации '''mtaserver.conf''' по умолчанию''

====servername====
:''<servername>Default MTA Server</servername>''
:Этот параметр указывает название, под которым сервер будет видимым во внутриигровом браузере серверов и Game-Monitor'е. Этот параметр является обязательным.

====serverip====
:''<serverip></serverip>
:'''ИСПОЛЬЗУЙТЕ ЭТОТ ПАРАМЕТР ТОЛЬКО ЕСЛИ ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ'''
:В основном он требуется только профессиональным серверам и в других случаях его следует оставлять пустым. Этот параметр указывает используемый IP для серверов, у которых имеется множество IP-адресов. Если оставить пустым, по умолчанию будет использоваться стандартный локальный IP-адрес сервера.
:SERVERIP СЛЕДУЕТ ОСТАВИТЬ ПУСТЫМ ЗА ИСКЛЮЧЕНИЕМ СЛУЧАЕВ, КОГДА ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ
:Люди, которые все же решатся, а потом будут просить о помощи, будут первыми поставлены к стенке после революции

====serverport====
:''<serverport>22003</serverport>
:Этот параметр указывает UDP порт сервера, на который будут поступать соединения игроков;
:значение по умолчанию: 22003. Этот параметр является обязательным.

====maxplayers====
:''<maxplayers>32</maxplayers>
:Этот параметр указывает максимальное количество игровых слотов, доступных на сервере;
:значение по умолчанию: 32. Этот параметр является обязательным.

====httpserver====
:''<httpserver>1</httpserver>
:Этот параметр указывает, будет ли использоваться встроенный http-сервер.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpport====
:''<httpport>22005</httpport>
:Этот параметр указывает TCP порт сервера, на который будут поступать http-соединения. Он может быть установлен на то же значение, что и <serverport>. Этот параметр является обязательным, если <httpserver> установлен на 1.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:Если установлен, то этот параметр указывает внешний URL, с которого клиенты смогут скачивать нужные ресурсы, находясь в игре. Иначе они будут их скачивать напрямую с сервера.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpautoclientfiles====
:''<httpautoclientfiles>1</httpautoclientfiles>
:Этот параметр указывает, следует ли клиентским файлам для хостинга на внешнем веб-сервере быть автоматически скопированными в mods/deathmatch/resource-cache/http-client-files/ Уместно только при установленном <httpdownloadurl>.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:Этот параметр ограничивает количество http-соединений, доступных каждому из клиентов. В зависимости от типа используемого http-сервера, меньшее число может снизить ожидание при закачке.
:Диапазон доступных значений: 1 - 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:Этот параметр ограничивает количество http-соединений, которое IP может инициировать за короткий промежуток времени.
:Диапазон доступных значений: 1 - 100. значение по умолчанию: 20

====client_file====
:''<nowiki></nowiki>
:По умолчанию, сервер будет блокировать использование измененных data-файлов GTA:SA.
:Для разрешения определенных клиентских файлов, добавьте одну или более строк по типу выше.
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====disableac====
:''<disableac></disableac>
:Список отключенных античитов, разделенный запятыми.
:напр. Чтобы отключить античиты #2 и #3, используйте: 2,3
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====enablesd====
:''<enablesd></enablesd>
:Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым.
:напр. Для включения спецпроверки #12 (запрет на собственный D3D9.DLL) используйте: 12

====networkencryption====
:''<networkencryption>1</networkencryption>
:Этот параметр указывает, будет ли обмен информацией между сервером и клиентом шифроваться. Шифрование может помочь в предотвращении просмотра и изменения сетевых данных.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====minclientversion====
:''<minclientversion></minclientversion>
:Минимальная версия клиента. Клиентам ниже этой версии будет отказано в соединении. После отсоединения клиентам будет дана возможность закачать обновление. Если оставить пустым, эта настройка отключена и ограничения на возможность подключаться нет. Номера версий описаны на [[getPlayerVersion]] и выглядят примерно так: 1.1.0-9.03100.0
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который он получит, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Рекомендуемая версия клиента. Если у клиента версия ниже, то при подсоединении ему будет предложено закачать обновление. Если оставить пустым, эта настройка отключена.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который он получит, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====ase====
:''<ase>1</ase>
:Этот параметр может использоваться для разрешения серверу сообщаться с главными серверами Game-Monitor, позволяя ему быть видимым во внутриигровом браузере серверов. Для функционирования потребуется дополнительный доступный UDP порт (он получается как <serverport> + 123 , так что при значении <serverport> по умолчанию (22003) правильным портом будет 22126 ).
:Доступные значения: 0 - отключено , 1 - включено. Опциональный параметр, по умолчанию 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:Этот параметр позволяет вам отключить вещание по LAN (локальной сети).

====password====
:''<password></password>
:Если установлен, игрокам перед подключением к серверу понадобится вводить пароль, указанный выше. Если оставить пустым, пароль им не потребуется.
::Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerPassword]] или [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:Этот параметр снижает использование сервером канала благодаря использованию различных оптимизаций.
:Значения: none, medium или maximum ; значение по умолчанию: medium
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:Этот параметр определяет время между пакетами синхронизации игрока в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:Этот параметр определяет время между легкими пакетами синхронизации (игрока) в миллисекундах.
:Диапазон доступных значений: 200 - 40000; значение по умолчанию: 1500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:Этот параметр определяет время между пакетами синхронизации камеры в миллисекундах.
:Диапазон доступных значений: 200 - 400; значение по умолчанию: 500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>400</ped_sync_interval>
:Этот параметр определяет время между пакетами синхронизации педов в миллисекунах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 400
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval>
:Этот параметр определяет время между пакетами синхронизации пустого транспортного средства в миллисекундах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 1000
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения мышью в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения джойстиком в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>0</bullet_sync>
:Этот параметр может улучшить достоверность выстрелов при использования определенных видов оружия. Как бы то ни было, "синхронизация пуль" повлечет больший расход канала.
:'''Для работы параметра обязательно требуется билд сервера 4247 и выше, подключающиеся клиенты будут также при необходимости автообновлены, если параметр включен.'''
:Заметьте, что синхронизация пуль будет включена независимо от этой настройки, если включены определенные [[setGlitchEnabled|баги]].
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 0.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====threadnet====
:''<threadnet>1</threadnet>
:Этот параметр указывает, запускать ли сетевую синхронизацию отдельным потоком или нет.
:Включение сделает синхронизацию глаже, но может также слегка увеличить использование ЦП.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Указывает местонахождение и название файла, являющегося уникальным личным ключом данного сервера. Это используется для предотвращения чтения личных файлов, сохраненных на клиенте, другими серверами.
:Храните резервную копию этого файла в безопасном месте. Значение по умолчанию: server-id.keys
:Больше информации о личных файлах клиентов: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Указывает местонахождение и название файла, являющегося основным логом сервера. Если оставить пустым, сервер не будет вести этот лог.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:Так же как и в основной лог, успешные и провальные попытки залогиниться записываются и сюда для легкости рассмотрения вопросов, связанных с безопасностью. Если оставить пустым, файл не будет использоваться

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Указывает местонахождение и название файла, используемого для ведения записей запросов баз данных. Серверная команда [[Server_Commands#debugdb|debugdb]] устанаваливает размах ведения записей.

====acl====
:''<acl>acl.xml</acl>
:Этот параметр указывает местоположение и название файла настроек Access Control List (Списка Контроля Доступа). Если оставить
:пустым, сервер будет использовать файл acl.xml, расположенный в той же папке, что и этот конфигурационный файл (mtaserver.conf).

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Указывает местоположение и название лог-файла debugscript. Если оставить пустым, сервер не будет вести этот лог.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Указывает уровень лог-файла debugscript. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Указывает уровень html-отладки. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====fpslimit====
:''<fpslimit>36</fpslimit>
:Указывает ограничение частоты кадров, которое будет применено к подсоединяющимся клиентам.
:Диапазон доступных значений: 25 - 100. По умолчанию: 36.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====autologin====
:''<autologin>0</autologin>
:Указывает, следует ли автоматически логинить игроков, базируясь на их IP-адресах, или нет

====voice====
:''<voice>0</voice>
:Этот параметр указывает, включать ли для игроков внутриигровой голосовой чат или нет
:Значения: 0 - отключено , 1 - включено

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:Этот параметр указывает частоту дискретизации голосового чата. Чтобы это действовало, параметр 'voice' должен быть установлен на 1. Большие значения используют больше пропускной способности канала и поднимают дискретизационное качество голосового чата
:Значения: 0 - Узкополосный (8kHz), 1 - Широкополосный (16kHz), 2 - Ультраширокополосный (32kHz). По умолчанию - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:Этот параметр указывает качество голоса для голосового чата. Чтобы это действовало, параметр 'voice' должен быть установлен на 1. Большие значения используют больше пропускной способности канала и поднимают качество голосового чата в целом
:Диапазон доступных значений: 0 - 10. По умолчанию - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Указывает битрейт голоса в bps. Этот опциональный параметр перекрывает две предыдущие настройки. Если не установлен, MTA сама контролирует это. Будьте осторожны в использовании.

====backup_path====
:''<backup_path>backups</backup_path>
:Этот параметр указывает путь, используемый для хранения базовых резервных копий некоторых файлов сервера. Заметьте, что базовые резервные копии делаются только во время запуска сервера. Значение по умолчанию: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:Этот параметр указывает количество дней между каждой из базовых резервных копий. Резервные копии делаются только во время запуска сервера, так что фактический интервал может быть намного больше. Установка backup_interval на 0 отключит резервные копии
:Диапазон доступных значений: 0 - 30. По умолчанию - 3

====backup_copies====
:''<backup_copies>5</backup_copies>
:Этот параметр указывает максимальное количество хранимых резервных копий. Установка backup_copies на 0 отключит резервные копии
:Диапазон доступных значений: 0 на 100. По умолчанию - 5

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Указывает модули, которые загружаются с сервером. Чтобы загрузить несколько модулей, добавьте больше строк (параметров) <module>. Опциональный параметр.

====resource====
:''<resource src="admin" startup="1" protected="0"/>
:''<resource src="defaultstats" startup="1" protected="0"/>
:''<resource src="helpmanager" startup="1" protected="0"/>
:''<resource src="joinquit" startup="1" protected="0"/>
:''<resource src="mapcycler" startup="1" protected="0"/>
:''<resource src="mapmanager" startup="1" protected="0"/>
:''<resource src="parachute" startup="1" protected="0"/>
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/>
:''<resource src="resourcemanager" startup="1" protected="1"/>
:''<resource src="scoreboard" startup="1" protected="0"/>
:''<resource src="spawnmanager" startup="1" protected="0"/>
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0"/>
:''<resource src="webadmin" startup="1" protected="0"/>
:Указывает ресурсы, которые загружаются при запуске сервера и/или являются защищенными от возможности быть остановленными. Чтобы указать несколько ресурсов, добавьте больше строк (параметров) <resource>.

[[Category: Support]]
[[en:Server mtaserver.conf]]

RU/Server Manual

2012-07-06T11:13:07Z

Vincent: thanks to Lex128

{{DISPLAYTITLE:Руководство по серверу}}
__TOC__

==Начало==
Поднять и поддерживать сервер для своих LAN или интернет-друзей намного легче, чем кажется; просто следуйте этой статье и, надеюсь, вы быстро разберетесь, как хостить свой собственный MTA:SA сервер!

==Установка сервера==
Приложение для выделенного сервера доступно в разных редакциях, зависящих от платформы севрера.

===Linux===
Есть несколько путей поднять и запустить сервер на Linux:
* [http://linux.mtasa.com Прекомпилированный пакет]
* [[RU/Building MTASA Server on GNU Linux|Сборка сервера MTASA на GNU/Linux]]

===Windows===
Установка сервера MTA:SA на Windows очень проста.
*Перейдите на [http://mtasa.com/ страницу закачки] и скачайте установщик.
*Когда установщик закачан, запустите его.
*Выберите папку, куда вы хотели бы установить сервер.
*Нажмите Install.
*Все!

''Для полной инструкции по acl.xml (access control list - лист контроля над правами) читайте: [[RU/Access_Control_List|Access Control List]]''<br/><br/>

==Настройка сервера==
Выделенный сервер Multi Theft Auto изначально поддается настройке через окно консоли, прямо из игры и через браузер. Чтобы активировать последние две опции, необходимо добавить хотя бы одного администратора в ваш конфигурационный файл.

===Основная настройка===
Все основные опции настройки находятся в файле 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' и могут быть заданы через обычный текстовый редактор.

Этот файл очень прост; каждая переменная имеет [[Server_mtaserver.conf|описание своего назначения и информацию по ее изменению]].

===Проброс портов===
Если вы запускаете сервер на своем личном компьютере и у вас есть роутер, вам понадобится пробросить 3 порта.

Для начала откройте файл 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' и найдите следующие строки:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Эти порты нужны для правильной установки сервера. Позже мы объясним как их задавать, но сначала, если вы хотите, чтобы ваш сервер появился в браузере серверов, то есть еще один нужный нам порт - порт ASE.
(краткий пример по включению / выключению ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Теперь нам нужно пробросить порты на вашем роутере, что не понадобится, если у вас уже открыты все порты, или если у вас нет роутера с фаерволлом. Если так оно и есть, пропустите эту часть.

Если вы не знаете, как пробросить порты на вашем роутере, пройдите [http://portforward.com/ на сайт по проброске портов], найдите там модель своего роутера и следуйте инструкциям.

Почти в каждом роутере можно задать тип порта: UDP или TCP. Этот список объяснит, какой тип порта и для чего нужен:

Главный порт сервера: UDP

HTTP порт: TCP

ASE порт: UDP (он понадобится, если вы захотите появления своего сервера в браузере серверов)

ASE порт легко вычислить:

ASE порт = главный порт сервера + 123

Итак, если главный порт вашего сервера - 22003, ASE порт будет 22126.

Удачи!

''В последней версии сервера вы можете проверить статус портов через следующую серверную команду [[Server_Commands#openports|openports]].''

===Проверки клиента===

При желании, античит MTA сервера может быть отключен. В нем можно также разрешить определенным или всем файлам быть измененными (напр. carmods.dat) или задать минимально допустимую весрию клиента.

Все эти настройки расположены внутри файла 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]'. Смотрите [[Anti-cheat_guide|Anti-cheat guide]] для получения дополнительной информации.<br/>

Если вы хотите задать минимальную версию клиента, найдите следующую строку:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Правильные значения выглядят наподобие: 1.1.1-9.02320

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

Чтобы добавить администратора, следуйте этим шагам:<br>
<ol>
<li>Если сервер запущен, добавьте новый аккаунт через ввод команды '''[[Server_Commands#addaccount|addaccount name password]]''' в окно севрера. Например, чтобы добавить пользователя VasyaPupkin, вам понадобится набрать:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount VasyaPupkin 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Заметка: Если у вас нет доступа к окну сервера, а ресурс 'admin' запущен, вы можете добавить аккаунт-образец через ввод '''/register VasyaPupkin 123password''''' в чат.
</div>
<li>Сервер должен будет отобразить сообщение о том, что аккаунт добавлен.
<li>Затем выключите сервер, введя '''shutdown''' в окне сервера.
<li>Удостоверьтесь, что сервер выключен; если он все еще запущен, изменения, которые вы вносите, будут перезаписаны</li>
<li>Откройте файл 'mods/deathmatch/'acl.xml'''' любым текстовым редактором</li>
<li>Добавьте аккаунт в группу ''Admin'', используя XML-синтаксис, как это сделано ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.VasyaPupkin" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Вообще, можно добавлять пользователей в какие угодно группы. Каждая из групп связана с ACL ([[RU/Access Control List|Access Control List]]). Каждый ACL содержит специфический список разрешенных и запрещенных прав. Группы существуют для того, чтобы разным пользователям могли соответствовать разные права. Группа ''Admin'' связана с ''Admin''ским ACL, который пуст (стало быть, разрешены все права). Группа ''Everyone'' связана с ''Default''ным ACL, который накладывает список ограничений на доступные команды (чтобы не позволять обычным пользователям пользоваться админскими командами).
</li>
<li>
Это все! Вы можете добавлять столько администраторов и пользователей этим способом столько, сколько захотите, еще посмотрите на другие группы и ACL'ы, например. ACL также доступен через [[RU/Access_Control_List|скриптовый движок Lua]].<br>

Рекомендуется взглянуть на веб-интерфейс, как это сделать мы опишем ниже.
</li>
</ol>
'''Заметка''': Для сервера, когда он запущен, есть другие способы добавлять аккаунты и редактировать права. "[[Server_Commands#addaccount|addaccount <user> <password>]]" - внутренняя команда для добавления аккаунтов, но вам придется воспользоваться веб-интерфейсом, чтобы добавить эти аккаунты в специфические группы/ACLы!<br />

===Использование веб-интерфейса===
Выделенный сервер поставляется с некоторыми Lua [[RU/Resources|ресурсами]], которые предоставляют хороший простой веб-интерфейс для управления сервером. Это легко может быть использовано для поддержки сервера, так как позволяет вам добавлять пользователей, запускать/останавливать ресурсы и другое.

Ресурсы веб-интерфейса по умолчанию включены и обслуживаются через встроенный HTTP веб-сервер. Чтобы убедиться, что встроенный HTTP веб-сервер запущен на нужном вам порту (22005 по умолчанию), следуйте данной инструкции:
<ol>
<li>Убедитесь, что сервер выключен
<li>Откройте файл 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' любым текстовым редактором</li>
<li>Проверьте, что HTTP сервер включен:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Измените порт HTTP сервера на свое усмотрение:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Сохраните изменения и закройте файл конфигурации</li>
<li>Запустите сервер</li>
<li>Если вы меняли список автозапускаемых ресурсов в конфигурационном файле, убедитесь, что следующие ресурсы запущены:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Они автоматически стартуют согласно стандартному файлу, в случае, если вы только что установили свой сервер.
</li>
<li>Откройте веб-браузер (Internet Explorer 6 or 7 НЕ поддерживаются; используйте [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] или другие) и перейдите по URL HTTP server'а: '''http://server:port/'''. Например, если у вас зупщен локальный сервер на HTTP порту 22005, используйте '''http://127.0.0.1:22005/'''.</li>
<li>Введите имя пользователя и пароль администратора, которого вы добавили в предыдущей секции.</li>
</ol>

<br />
Теперь вы способны управлять своим севрером через веб-интерфейс.

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

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

Чтобы включить скачивание с внешнего веб-сервера, вам следует настроить тег [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] в конфигурации своего сервера:

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

С тех пор, как все стандартные ресурсы, поставляемые с выделенным сервером, упакованы в zip-архивы, и обычно автоматически распаковываются благодаря встроенному веб серверу, теперь вам понадобится предоставить клиентам возможность закачивать себе сжатые файлы. Чтобы настроить MTA на поддержание копии только распакованных клиентских ресурсов, установите [[Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] в конфигурации вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>

Теперь, когда вы запускаете сервер, папка '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' будет содержать действительные клиентские файлы для хостинга на внешнем веб-сервере. Если веб сервер расположен на том же компьютере, что и сервер, вы можете просто связать директорию надлежащего веб-сервера с '''http-client-files'''. Если веб-севрер расположен на отдельном компьюетре, убедитесь, что у него есть доступ к '''http-client-files''' по сети, или поддерживайте удаленную копию с помощью синхронизационного ПО.

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

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

Чтобы запустить сервер, выполните двойной щелчок по MTA Server.exe, убедитесь, что добавили его в исключение фаерволлов и пробросили порты, если это необходимо.

==Установка/Обновление ресурсов сервера==
Ресурсы могут быть двух видов, либо в формате ZIP-архива, либо просто обычной папкой со скриптами внутри. MTA:SA сервер поддерживает оба метода.

# Переместите или скопируйте новый ресурс в вашу папку <SERVER>\mods\deathmatch\resources.
# В окне сервера введите команду [[Server_Commands#refresh|refresh]], эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

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

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

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

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

Для других команд, введите [[Server_Commands#help|help]] в консоли.

==Запуск карты/мода==
Смотрите секцию команд у [[RU/Resource:Map manager|mapmanager]] для дальнешей информации.

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

# Вы можете также обновлять ресурсы прямо из игры, если у вас есть соответствующие права, введя "refresh" в клиентской консоли или "/refresh" в чате. Это может вызвать секундное подлагивание, если ресурсов много.
# В инструкциях выше, <SERVER> - путь к главной директории сервер. В большинстве случаев это C:\Program Files\MTA San Andreas\server
# Вы можете выбрать к использованию сервером другой конфигурационный файл, добавив его в командной строке после аргумента --config, напр. mtaserver.exe --config anotherconfig.cfg.
# Не пугайтесь предупреждения об анализе файла settings.xml. Это происходит, когда ваша установка сервера все еще чиста и не была задействована.

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

[[en:Deathmatch Server Manual]]
[[es:Manual del Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]

[[Category:Support]]

Server mtaserver.conf

2012-07-05T22:46:23Z

Vincent:

This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''

====servername====
:''<servername>Default MTA Server</servername>''
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.

====serverip====
:''<serverip></serverip>
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING'''
:It is generally only needed for professional servers and should be left blank otherwise. This parameter specifies the IP to use for servers that have multiple IP addresses. If left blank, it will default to server's standard local IP address.
:SERVERIP SHOULD BE LEFT BLANK UNLESS YOU ARE SURE OF WHAT YOU ARE DOING
:People who set this and then ask for support will be the first ones against the wall when the revolution comes

====serverport====
:''<serverport>22003</serverport>
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;
:default value: 22003. It is a required parameter.

====maxplayers====
:''<maxplayers>32</maxplayers>
:This parameter specifies the number of maximum player slots available on the server;
:default value: 32. It is a required parameter.

====httpserver====
:''<httpserver>1</httpserver>
:This parameter specifies whether the builtin http server will be used.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpport====
:''<httpport>22005</httpport>
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]

====httpautoclientfiles====
:''<httpautoclientfiles>1</httpautoclientfiles>
:This parameter specifies whether the client files for hosting on an external web server should be automatically copied into mods/deathmatch/resource-cache/http-client-files/ Only relevant if <httpdownloadurl> is set.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts.
:Available range: 1 to 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:This parameter limits the number http connections that an IP can initiate over a short period of time.
:Available range: 1 to 100. default value: 20

====client_file====
:''<nowiki></nowiki>
:By default, the server will block the use of customized GTA:SA data files.
:To allow specific client files, add one or more of the above lines.
:More information: [[Anti-cheat_guide|Anti-cheat guide]]

====disableac====
:''<disableac></disableac>
:Comma seperated list of disabled anti-cheats.
:e.g. To disable anti-cheat #2 and #3, use: 2,3
:More information: [[Anti-cheat_guide|Anti-cheat guide]]

====enablesd====
:''<enablesd></enablesd>
:Comma seperated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank.
:e.g. To enable special detection #12 (disallow custom D3D9.DLL) use: 12

====networkencryption====
:''<networkencryption>1</networkencryption>
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]

====minclientversion====
:''<minclientversion></minclientversion>
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[http://nightly.mtasa.com/ver highest available]].'''

====ase====
:''<ase>1</ase>
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the ingame server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:This parameter allows you to disable LAN broadcasting.

====password====
:''<password></password>
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:This parameter reduces the server's bandwidth usage by using various optimizations.
:Values: none, medium or maximum ; default value: medium
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:This parameter determines the time in milliseconds between player sync packets.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:This parameter determines the time in milliseconds between lightweight (player) sync packets.
:Available range: 200 - 40000; default value: 1500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:This parameter determines the time in milliseconds between camera sync packets.
:Available range: 200 - 400; default value: 500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>400</ped_sync_interval>
:This parameter determines the time in milliseconds between ped sync packets.
:Available range: 200 - 4000; default value: 400
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval>
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.
:Available range: 200 - 4000; default value: 1000
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.
:Available range: 50 - 500; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>0</bullet_sync>
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.
:'''It only works on server build 4247 or later, and when enabled, connecting clients will be auto-updated if required.'''
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.
:Values: 0 - disabled , 1 - enabled ; default value: 0.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====threadnet====
:''<threadnet>1</threadnet>
:This parameter specifies whether or not to run the network synchronization on another thread.
:Enabling will make the sync smoother, but may increase cpu usage slightly.
:Values: 0 - disabled , 1 - enabled ; default value: 1.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers.
:Keep a backup of this file in a safe place. Default value: server-id.keys
:More information about client private files: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.

====acl====
:''<acl>acl.xml</acl>
:This parameter specifies the location and name of the Access Control List settings file. If left
:blank, server will use acl.xml file, located in the same folder as this configuration file.

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Specifies the level of the html debug. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====fpslimit====
:''<fpslimit>36</fpslimit>
:Specifies the frame rate limit that will be applied to connecting clients.
:Available range: 25 to 100. Default: 36.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====autologin====
:''<autologin>0</autologin>
:Specifies whether or not players should automatically be logged in based on their IP adresses

====voice====
:''<voice>0</voice>
:This parameter specifies whether or not to enable player voice chat in-game
:Values: 0 - disabled , 1 - enabled

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat
:Available range: 0 to 10. Default - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.

====backup_path====
:''<backup_path>backups</backup_path>
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups
:Available range: 0 to 30. Default - 3

====backup_copies====
:''<backup_copies>5</backup_copies>
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups
:Available range: 0 to 100. Default - 5

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.

====resource====
:''<resource src="admin" startup="1" protected="0"/>
:''<resource src="defaultstats" startup="1" protected="0"/>
:''<resource src="helpmanager" startup="1" protected="0"/>
:''<resource src="joinquit" startup="1" protected="0"/>
:''<resource src="mapcycler" startup="1" protected="0"/>
:''<resource src="mapmanager" startup="1" protected="0"/>
:''<resource src="parachute" startup="1" protected="0"/>
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/>
:''<resource src="resourcemanager" startup="1" protected="1"/>
:''<resource src="scoreboard" startup="1" protected="0"/>
:''<resource src="spawnmanager" startup="1" protected="0"/>
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0"/>
:''<resource src="webadmin" startup="1" protected="0"/>
:Specifies resources that are loaded when the server starts and/or which are protected from being stopped. To specify several resources, add more <resource> parameter(s).

[[Category: Support]]
[[ru:Server mtaserver.conf]]

RU/Server mtaserver.conf

2012-07-05T22:45:22Z

Vincent: not so good, but will be

На этой странице описаны все настройки, которые можно установить в файле настроек. ''Курсивом выделены настройки из файла настроек '''mtaserver.conf''' по умолчанию''

====servername====
:''<servername>Default MTA Server</servername>''
:Этот параметр указывает название, под которым сервер будет видимым во внутриигровом браузере серверов и Game-Monitor'е. Этот параметр является обязательным.

====serverip====
:''<serverip></serverip>
:'''ИСПОЛЬЗУЙТЕ ЭТОТ ПАРАМЕТР ТОЛЬКО ЕСЛИ ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ'''
:В основном он требуется только профессиональным серверам и в других случаях его следует оставлять пустым. Этот параметр указывает используемый IP для серверов, у которых имеется множество IP-адресов. Если оставить пустым, по умолчанию будет использоваться стандартный локальный IP-адрес сервера.
:SERVERIP СЛЕДУЕТ ОСТАВИТЬ ПУСТЫМ ЗА ИСКЛЮЧЕНИЕМ СЛУЧАЕВ, КОГДА ВЫ УВЕРЕНЫ В ТОМ, ЧТО ДЕЛАЕТЕ
:Люди, которые все же решатся, а потом будут просить о помощи, будут поставлены к стенке первыми после революции

====serverport====
:''<serverport>22003</serverport>
:Этот параметр указывает UDP порт сервера, на который будут поступать соединения игроков;
:значение по умолчанию: 22003. Этот параметр является обязательным.

====maxplayers====
:''<maxplayers>32</maxplayers>
:Этот параметр указывает максимальное количество игровых слотов, доступных на сервере;
:значение по умолчанию: 32. Этот параметр является обязательным.

====httpserver====
:''<httpserver>1</httpserver>
:Этот параметр указывает, будет ли использоваться встроенный http-сервер.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpport====
:''<httpport>22005</httpport>
:Этот параметр указывает TCP порт сервера, на который будут поступать http-соединения. Он может быть установлен на то же значение, что и <serverport>. Этот параметр является обязательным, если <httpserver> установлен на 1.
:Больше информации: [[RU/Server_Manual#Использование веб-интерфейса|Использование веб-интерфейса]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:Если установлен, то этот параметр указывает внешний URL, с которого клиенты смогут скачивать нужные ресурсы, находясь в игре. Иначе они будут их скачивать напрямую с сервера.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpautoclientfiles====
:''<httpautoclientfiles>1</httpautoclientfiles>
:Этот параметр указывает, следует ли клиентским файлам для хостинга на внешнем веб-сервере быть автоматически скопированными в mods/deathmatch/resource-cache/http-client-files/ Уместно только при установленном <httpdownloadurl>.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Больше информации: [[RU/Server_Manual#Configuring_an_external_web_server|Настройка внешнего веб-сервера]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:Этот параметр ограничивает количество http-соединений, доступных каждому из клиентов. В зависимости от типа используемого http-сервера, меньшее число может снизить ожидание при закачке.
:Диапазон доступных значений: 1 - 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:Этот параметр ограничивает количество http-соединений, которые IP может инициировать за короткий промежуток времени.
:Диапазон доступных значений: 1 - 100. значение по умолчанию: 20

====client_file====
:''<nowiki></nowiki>
:По умолчанию, сервер будет блокировать использование измененных data-файлов GTA:SA.
:Для разрешения определенных клиентских файлов, добавьте одну или более строк по типу выше.
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====disableac====
:''<disableac></disableac>
:Список отключенных античитов, разделенный запятыми.
:напр. Чтобы отключить античиты #2 и #3, используйте: 2,3
:Больше информации: [[RU/Anti-cheat_guide|Руководство по античиту]]

====enablesd====
:''<enablesd></enablesd>
:Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым.
:напр. Для включения спецпроверки #12 (запрет на собственный D3D9.DLL), используйте: 12

====networkencryption====
:''<networkencryption>1</networkencryption>
:Этот параметр указывает, будет ли обмен информацией между сервером и клиентом шифроваться. Шифрование может помочь в предотвращении просмотра и изменения сетевых данных.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1. Опциональный параметр.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====minclientversion====
:''<minclientversion></minclientversion>
:Минимальная версия клиента. Клиентам ниже этой версии будет отказано в соединении. После отсоединения клиентам будет дана возможность закачать обновление. Если оставить пустым, эта настройка отключена и ограничения на возможность подключаться нет. Номера версий описаны на [[getPlayerVersion]] и выглядят примерно так: 1.1.0-9.03100.0
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который они получат, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Рекомендуемая версия клиента. Если у клиента версия ниже, то при подсоединении им будет предложено закачать обновление. Если оставить пустым, эта настройка отключена.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:'''Заметьте, что эта настройка отвечает только за то, следует ли предложить клиенту обновиться. Фактический номер билда, который они получат, будет [[http://nightly.mtasa.com/ver наибольшим среди доступных]].'''

====ase====
:''<ase>1</ase>
:Этот параметр может использоваться для разрешения серверу сообщаться с главными серверами Game-Monitor, позволяя ему быть видимым во внутриигровом браузере серверов. Для функционирования потребуется дополнительный доступный UDP-порт (значение получается от <serverport> + 123 , так что при значении <serverport> по умолчанию (22003) правильным портом будет 22126 ).
:Доступные значения: 0 - отключено , 1 - влючено. Опциональный параметр, по умочанию 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:Этот параметр позволяет вам отключить вещание по LAN (локальной сети).

====password====
:''<password></password>
:Если установлен, игрокам перед подключением к серверу понадобится указывать пароль, указанный выше. Если оставить пустым, пароль им не потребуется.
::Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerPassword]] или [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:Этот параметр снижает использование сервером канала благодаря использованию различных оптимизаций.
:Значения: none, medium или maximum ; значение по умолчанию: medium
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:Этот параметр определяет время между пакетами синхронизации игрока в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:Этот параметр определяет время между легкими пакетами синхронизации (игрока) в миллисекундах.
:Диапазон доступных значений: 200 - 40000; значение по умолчанию: 1500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:Этот параметр определяет время между пакетами синхронизации камеры в миллисекундах.
:Диапазон доступных значений: 200 - 400; значение по умолчанию: 500
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>400</ped_sync_interval>
:Этот параметр определяет время между пакетами синхронизации педов в миллисекунах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 400
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>1000</unoccupied_vehicle_sync_interval>
:Этот параметр определяет время между пакетами синхронизации пустого транспортного средства в миллисекундах.
:Диапазон доступных значений: 200 - 4000; значение по умолчанию: 1000
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения мышью в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:Этот параметр определяет минимальное время между пакетами синхронизации клавиш из-за движения джойстиком в миллисекундах.
:Диапазон доступных значений: 50 - 500; значение по умолчанию: 100
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]
:Предлагаемые для этого значения и другие настройки sync_interval можно найти здесь: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>0</bullet_sync>
:Этот параметр может улучшить достоверность выстрелов при использования определенного оружия. Как бы то ни было, он повлечет больший расход канала.
:'''Он работает только на билдах сервера 4247 и выше, и когда включен, подключающиеся клиенты будут при необходимости автообновлены.'''
:Заметьте, что синхронизация пуль будет действовать независимо от этой настройки, если включены определенные [[setGlitchEnabled|баги]].
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 0.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====threadnet====
:''<threadnet>1</threadnet>
:Этот параметр указывает, запускать ли сетевую синхронизацию отдельным потоком или нет.
:Включение сделает синхронизацию более гладкой, но может также слегка увеличить использование cpu.
:Значения: 0 - отключено , 1 - включено ; значение по умолчанию: 1.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Указывает местонахождение и название файла, являющегося уникальным приватным ключом данного сервера. Это используется для предотвращения чтения приватных файлов, сохраненных на клиенте, другими серверами.
:Храните резервную копию этого файла в безопасном месте. Значение по умолчанию: server-id.keys
:Больше информации о приватных файлах клиентов: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Указывает местонахождение и название файла, являющегося основным логом сервера. Если оставить пустым, сервер не будет вести этот лог.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:Так же как и в основной лог, успешные и провальные попытки залогиниванья записываются и сюда для легкости рассмотрения вопросов, связанных с безопасностью. Если оставить пустым, файл не используется

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Указывает местонахождение и название файла, используемого для записи запросов баз данных. Серверная команда [[Server_Commands#debugdb|debugdb]] устанаваливает размах ведения записей.

====acl====
:''<acl>acl.xml</acl>
:Этот параметр указывает местоположение и название файла настроек Access Control List (Списка Контроля Доступа). Если оставить
:пустым, сервер будет использовать файл acl.xml, расположенный в той же папке, что и этот файл настроек (mtaserver.conf).

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Указывает местоположение и название файла с записями debugscript. Если оставить пустым, сервер не будет вести этот лог.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Указывает уровень файла-лога debugscript. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Указывает уровень html-отладки. Доступные значения: 0, 1, 2, 3. Если не установлен, то по умолчанию 0.

====fpslimit====
:''<fpslimit>36</fpslimit>
:Указывает ограничение частоты кадров, которое будет применено к подсоединяющимся клиентам.
:Диапазон доступных значений: 25 - 100. По умолчанию: 36.
:Этот параметр может быть изменен и сохранен во время работы сервера через [[setServerConfigSetting]]

====autologin====
:''<autologin>0</autologin>
:Указывает, следует ли автоматичсеки логинить игроков, базируясь на их IP-адресах, или нет

====voice====
:''<voice>0</voice>
:Этот параметр указывает, включать ли внутриигровой голосовой чат для игроков или нет
:Значения: 0 - отключено , 1 - включено

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:Этот параметр указывает частоту дискретизации голосового чата. Параметр 'voice' должен быть установлен на 1, чтобы это действовало. Большие значения используют больше пропускной способности канала и поднимают дискретизационное качество голосового чата
:Значения: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). По умолчанию - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:Этот параметр указывает качество голоса голосового чата. Параметр 'voice' должен быть установлен на 1, чтобы это действовало. Большие значения используют больше пропускной способности канала и поднимают качество голосового чата в целом
:Диапазон доступных значений: 0 - 10. По умолчанию - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Указывает битрейт голоса, в bps. Этот опциональный параметр перекрывает две предыдущие настройки. Если не установлен, MTA сама это контролирует. Будьте осторожны в использовании.

====backup_path====
:''<backup_path>backups</backup_path>
:Этот параметр указывает путь, используемый для базовых резервных копий некоторых файлов сервера. Заметьте, что базовые резервные копии делаются только при запуске сервера. Значение по умолчанию: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:Этот параметр указывает количество дней между каждой из базовых резервных копий. Резервные копии делаются только при запуске сервера, так что фактический интервал может быть намного больше. Установка backup_interval на 0 отключит резервные копии
:Диапазон доступных значений: 0 - 30. По умолчанию - 3

====backup_copies====
:''<backup_copies>5</backup_copies>
:Этот параметр указывает максимальное количество хранимых резервных копий. Установка backup_copies на 0 отключит резервные копии
:Диапазон доступных значений: 0 на 100. По умолчанию - 5

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Указывает модули, которые загружаются с сервером. Чтобы загрузить несколько модулей, добавьте больше строк (параметров) <module>. Опциональный параметр.

====resource====
:''<resource src="admin" startup="1" protected="0"/>
:''<resource src="defaultstats" startup="1" protected="0"/>
:''<resource src="helpmanager" startup="1" protected="0"/>
:''<resource src="joinquit" startup="1" protected="0"/>
:''<resource src="mapcycler" startup="1" protected="0"/>
:''<resource src="mapmanager" startup="1" protected="0"/>
:''<resource src="parachute" startup="1" protected="0"/>
:''<resource src="resourcebrowser" startup="1" protected="1" default="true"/>
:''<resource src="resourcemanager" startup="1" protected="1"/>
:''<resource src="scoreboard" startup="1" protected="0"/>
:''<resource src="spawnmanager" startup="1" protected="0"/>
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0"/>
:''<resource src="webadmin" startup="1" protected="0"/>
:Указывает ресурсы, которые загружаются при запуске сервера и/или являются защищенными от возможности быть остановленными. Чтобы указать несколько ресурсов, добавьте больше строк (параметров) <resource>.

[[Category: Support]]
[[en:Server mtaserver.conf]]

RU/Resource:Votemanager

2012-07-04T14:39:31Z

Vincent: /* onPollEnd */

{{RU/Resource page}}
__NOTOC__
Этот скрипт управляет любыми опросами с различными вариантами ответов. '''votemap''', '''votekick''', '''votekill''' и '''voteban''' встроены.
==Встроенные опросы==

'''votemap''' (начинает голосование за выбранные случайным образом карты (до 9), совместимые с модом, если он запущен)

'''votemap gamemode''' (начинает голосование за выбранные случайным образом карты (до 9), совместимые с указанным модом)

'''votemap gamemode map''' (начинает голосование за указанные мод и карту)

'''votemap map''' (начинает голосование за смену карты, если таковая запущена, на указанную)

'''votemode''' (начинает голосование за выбранные случайным образом моды (до 9). по окончании голосования и старте мода, атоматичсеки начинается 'votemap gamemode')

'''votekick player''' (начинает голосование за кик указанного игрока)

'''votekill player''' (начинает голосование за убийство указанного игрока сервером)

'''voteban player''' (начинает голосование за бан указанного игрока)

==Серверные функции==
===startPoll===
<syntaxhighlight lang="lua">bool, int startPoll ( table pollData )</syntaxhighlight>
Создает опрос. Возвращает ''true'' при успешном создании, в противном случае - ''false'' и код ошибки (см. source для кода ошибки).

* '''pollData''' таблица, содержащая настройки опроса и массив из ''как минимум двух'' опций. Каждая опция указывается по такой форме:
<syntaxhighlight lang="lua">
{
string optionName,
string eventToTrigger,
[element triggerFrom = getRootElement()],
default = [bool isDefaultOption = false],
var argument1,
var argument2,
...
}
</syntaxhighlight>
Выбранная опция вызовет eventToTrigger от элемента triggerFrom с параметрами ''arguments...'' по окончании опроса.

Если голосов недостаточно, будет выполнена опция по умолчанию, если таковая имеется.

Образец:
<syntaxhighlight lang="lua">
local playerToKill = getRandomPlayer()
local notEnoughVotesMessage = "Not enough votes to kill "..getPlayerName(playerToKill).."."
startPoll {
--start settings (dictionary part)
title="Kill "..getPlayerName(playerToKill).."?",
percentage=75,
timeout=30,
allowchange=false,
maxnominations=3,
visibleTo=getRootElement(),
--start options (array part)
[1]={"Yes", "doKillPlayer", playerToKill},
[2]={"No", "doOutputChatBox", notEnoughVotesMessage, getRootElement(), vR, vG, vB; default=true},
}
</syntaxhighlight>
*'''title''' (требуется): заголовок опроса, который увидят клиенты на GUI менеджера
*'''percentage''' (опционально, по умолчанию - default.percentage): нужный % для победы опции в номинации
*'''timeout''' (опционально, по умолчанию - default.timeout): время опроса в секундах
*'''allowchange''' (опционально, по умолчанию - default.allowchange): отвечает за возможность изменять свой голос
*'''maxnominations''' (опционально, по умолчанию - default.maxnominations): отвечает за максимальное количество номинаций в случае ничьи
*'''visibleTo''' (опционально, по умолчанию - [[getRootElement]]()): таблица игроков, которым будет виден опрос, или элемент, который содержит игроков.
Если это root (корень), игроки, зашедшие уже после старта опроса смогут проголосовать.

Умолчания из ''voteconfig.xml'' будут использованы для пропущенных опциональных параметров.

===stopPoll===
<syntaxhighlight lang="lua">bool, int stopPoll ( )</syntaxhighlight>
Останаваливает запущенный опрос. Возвращает ''true'', если опрос был успешно остановлен, иначе - ''false''.

===voteMap===
<syntaxhighlight lang="lua">bool, int voteMap ( string mapName )</syntaxhighlight>
Стартует голосование за карту. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteBetweenMaps===
<syntaxhighlight lang="lua">bool, int voteBetweenMaps ( resource map1, resource map2, [ resource map3, ... ] )</syntaxhighlight>
Стартует голосование между картами. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteKick===
<syntaxhighlight lang="lua">bool, int voteKick ( player thePlayer )</syntaxhighlight>
Стартует голосование за кик. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteKill===
<syntaxhighlight lang="lua">bool, int voteKill ( player thePlayer )</syntaxhighlight>
Стартует голосование за убийство. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteBan===
<syntaxhighlight lang="lua">bool, int voteBan ( player thePlayer )</syntaxhighlight>
Стартует голосование за бан. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

==Серверные события==
===onPollStarting===
<syntaxhighlight lang="lua">void onPollStarting ( table pollData )</syntaxhighlight>
Срабатывает перед тем, как опрос начинает стартовать. Позволяет другим ресурсам изменять опрос. Используйте onPollModified, чтобы отозвать опрос.

===onPollModified===
<syntaxhighlight lang="lua">void onPollModified ( table pollData )</syntaxhighlight>
Вы можете использовать ее для отправки опроса с изменениями.

===onPollStart===
<syntaxhighlight lang="lua">void onPollStart ( )</syntaxhighlight>
Срабатывает перед стартом опроса. Отмена отменяет опрос.

===onPollStop===
<syntaxhighlight lang="lua">void onPollStop ( )</syntaxhighlight>
Срабатывает перед остановкой опроса. Отмена предотвращает отмену опроса.

===onPollEnd===
<syntaxhighlight lang="lua">void onPollEnd ( chosenOption )</syntaxhighlight>
Срабатывает по окончании опроса. Отмена не дает никакого эффекта.<br />
'''chosenOption''': Возвращает номер выбранной опции.

===onPollDraw===
<syntaxhighlight lang="lua">void onPollDraw ( )</syntaxhighlight>
Срабатывает, когда опрос оканчивается ничьей. Отмена предотвращает повторные номинации.

===onClientSendVote===
<syntaxhighlight lang="lua">void onClientSendVote ( int vote )</syntaxhighlight>
Срабатывает, когда на сервер посылается голос. ''client'' - клиент, отправивший голос. Отмена выливается в игнорирование голоса клиента менеджером.

==Настройки по умолчанию==
<syntaxhighlight lang="xml">
<settings>
<setting name="*color" value="#DF6464" />
<setting name="*log_votes" value="[true]" />

<setting name="*default.timeout" value="[30]"/>
<setting name="*default.allowchange" value="[false]"/>
<setting name="*default.percentage" value="[75]"/>
<setting name="*default.maxnominations" value="[3]"/>

<setting name="*votemap.enabled" value="[true]"/>
<setting name="*votemap.timeout" value="[30]"/>
<setting name="*votemap.locktime" value="[60]"/>
<setting name="*votemap.percentage" value="[70]"/>
<setting name="*votemap.allowchange" value="[true]"/>

<setting name="*votekick.enabled" value="[true]"/>
<setting name="*votekick.timeout" value="[30]"/>
<setting name="*votekick.locktime" value="[120]"/>
<setting name="*votekick.percentage" value="[75]"/>
<setting name="*votekick.allowchange" value="[true]"/>

<setting name="*voteban.enabled" value="[false]"/>
<setting name="*voteban.timeout" value="[30]"/>
<setting name="*voteban.locktime" value="[120]"/>
<setting name="*voteban.percentage" value="[85]"/>
<setting name="*voteban.allowchange" value="[true]"/>

<setting name="*votekill.enabled" value="[true]"/>
<setting name="*votekill.timeout" value="[30]"/>
<setting name="*votekill.locktime" value="[120]"/>
<setting name="*votekill.percentage" value="[75]"/>
<setting name="*votekill.allowchange" value="[true]"/>

</settings>
</syntaxhighlight>

[[en:Resource:Votemanager]]

RU/Resource:Votemanager

2012-07-04T14:39:11Z

Vincent:

{{RU/Resource page}}
__NOTOC__
Этот скрипт управляет любыми опросами с различными вариантами ответов. '''votemap''', '''votekick''', '''votekill''' и '''voteban''' встроены.
==Встроенные опросы==

'''votemap''' (начинает голосование за выбранные случайным образом карты (до 9), совместимые с модом, если он запущен)

'''votemap gamemode''' (начинает голосование за выбранные случайным образом карты (до 9), совместимые с указанным модом)

'''votemap gamemode map''' (начинает голосование за указанные мод и карту)

'''votemap map''' (начинает голосование за смену карты, если таковая запущена, на указанную)

'''votemode''' (начинает голосование за выбранные случайным образом моды (до 9). по окончании голосования и старте мода, атоматичсеки начинается 'votemap gamemode')

'''votekick player''' (начинает голосование за кик указанного игрока)

'''votekill player''' (начинает голосование за убийство указанного игрока сервером)

'''voteban player''' (начинает голосование за бан указанного игрока)

==Серверные функции==
===startPoll===
<syntaxhighlight lang="lua">bool, int startPoll ( table pollData )</syntaxhighlight>
Создает опрос. Возвращает ''true'' при успешном создании, в противном случае - ''false'' и код ошибки (см. source для кода ошибки).

* '''pollData''' таблица, содержащая настройки опроса и массив из ''как минимум двух'' опций. Каждая опция указывается по такой форме:
<syntaxhighlight lang="lua">
{
string optionName,
string eventToTrigger,
[element triggerFrom = getRootElement()],
default = [bool isDefaultOption = false],
var argument1,
var argument2,
...
}
</syntaxhighlight>
Выбранная опция вызовет eventToTrigger от элемента triggerFrom с параметрами ''arguments...'' по окончании опроса.

Если голосов недостаточно, будет выполнена опция по умолчанию, если таковая имеется.

Образец:
<syntaxhighlight lang="lua">
local playerToKill = getRandomPlayer()
local notEnoughVotesMessage = "Not enough votes to kill "..getPlayerName(playerToKill).."."
startPoll {
--start settings (dictionary part)
title="Kill "..getPlayerName(playerToKill).."?",
percentage=75,
timeout=30,
allowchange=false,
maxnominations=3,
visibleTo=getRootElement(),
--start options (array part)
[1]={"Yes", "doKillPlayer", playerToKill},
[2]={"No", "doOutputChatBox", notEnoughVotesMessage, getRootElement(), vR, vG, vB; default=true},
}
</syntaxhighlight>
*'''title''' (требуется): заголовок опроса, который увидят клиенты на GUI менеджера
*'''percentage''' (опционально, по умолчанию - default.percentage): нужный % для победы опции в номинации
*'''timeout''' (опционально, по умолчанию - default.timeout): время опроса в секундах
*'''allowchange''' (опционально, по умолчанию - default.allowchange): отвечает за возможность изменять свой голос
*'''maxnominations''' (опционально, по умолчанию - default.maxnominations): отвечает за максимальное количество номинаций в случае ничьи
*'''visibleTo''' (опционально, по умолчанию - [[getRootElement]]()): таблица игроков, которым будет виден опрос, или элемент, который содержит игроков.
Если это root (корень), игроки, зашедшие уже после старта опроса смогут проголосовать.

Умолчания из ''voteconfig.xml'' будут использованы для пропущенных опциональных параметров.

===stopPoll===
<syntaxhighlight lang="lua">bool, int stopPoll ( )</syntaxhighlight>
Останаваливает запущенный опрос. Возвращает ''true'', если опрос был успешно остановлен, иначе - ''false''.

===voteMap===
<syntaxhighlight lang="lua">bool, int voteMap ( string mapName )</syntaxhighlight>
Стартует голосование за карту. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteBetweenMaps===
<syntaxhighlight lang="lua">bool, int voteBetweenMaps ( resource map1, resource map2, [ resource map3, ... ] )</syntaxhighlight>
Стартует голосование между картами. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteKick===
<syntaxhighlight lang="lua">bool, int voteKick ( player thePlayer )</syntaxhighlight>
Стартует голосование за кик. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteKill===
<syntaxhighlight lang="lua">bool, int voteKill ( player thePlayer )</syntaxhighlight>
Стартует голосование за убийство. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

===voteBan===
<syntaxhighlight lang="lua">bool, int voteBan ( player thePlayer )</syntaxhighlight>
Стартует голосование за бан. Возвращает ''true'', если опрос успешно стартовал, иначе - ''false'' и код ошибки.

==Серверные события==
===onPollStarting===
<syntaxhighlight lang="lua">void onPollStarting ( table pollData )</syntaxhighlight>
Срабатывает перед тем, как опрос начинает стартовать. Позволяет другим ресурсам изменять опрос. Используйте onPollModified, чтобы отозвать опрос.

===onPollModified===
<syntaxhighlight lang="lua">void onPollModified ( table pollData )</syntaxhighlight>
Вы можете использовать ее для отправки опроса с изменениями.

===onPollStart===
<syntaxhighlight lang="lua">void onPollStart ( )</syntaxhighlight>
Срабатывает перед стартом опроса. Отмена отменяет опрос.

===onPollStop===
<syntaxhighlight lang="lua">void onPollStop ( )</syntaxhighlight>
Срабатывает перед остановкой опроса. Отмена предотвращает отмену опроса.

===onPollEnd===
<syntaxhighlight lang="lua">void onPollEnd ( chosenOption )</syntaxhighlight>
Срабатывает по окончании опроса. Отмена не дает никакого эффекта.
'''chosenOption''': Возвращает номер выбранной опции.

===onPollDraw===
<syntaxhighlight lang="lua">void onPollDraw ( )</syntaxhighlight>
Срабатывает, когда опрос оканчивается ничьей. Отмена предотвращает повторные номинации.

===onClientSendVote===
<syntaxhighlight lang="lua">void onClientSendVote ( int vote )</syntaxhighlight>
Срабатывает, когда на сервер посылается голос. ''client'' - клиент, отправивший голос. Отмена выливается в игнорирование голоса клиента менеджером.

==Настройки по умолчанию==
<syntaxhighlight lang="xml">
<settings>
<setting name="*color" value="#DF6464" />
<setting name="*log_votes" value="[true]" />

<setting name="*default.timeout" value="[30]"/>
<setting name="*default.allowchange" value="[false]"/>
<setting name="*default.percentage" value="[75]"/>
<setting name="*default.maxnominations" value="[3]"/>

<setting name="*votemap.enabled" value="[true]"/>
<setting name="*votemap.timeout" value="[30]"/>
<setting name="*votemap.locktime" value="[60]"/>
<setting name="*votemap.percentage" value="[70]"/>
<setting name="*votemap.allowchange" value="[true]"/>

<setting name="*votekick.enabled" value="[true]"/>
<setting name="*votekick.timeout" value="[30]"/>
<setting name="*votekick.locktime" value="[120]"/>
<setting name="*votekick.percentage" value="[75]"/>
<setting name="*votekick.allowchange" value="[true]"/>

<setting name="*voteban.enabled" value="[false]"/>
<setting name="*voteban.timeout" value="[30]"/>
<setting name="*voteban.locktime" value="[120]"/>
<setting name="*voteban.percentage" value="[85]"/>
<setting name="*voteban.allowchange" value="[true]"/>

<setting name="*votekill.enabled" value="[true]"/>
<setting name="*votekill.timeout" value="[30]"/>
<setting name="*votekill.locktime" value="[120]"/>
<setting name="*votekill.percentage" value="[75]"/>
<setting name="*votekill.allowchange" value="[true]"/>

</settings>
</syntaxhighlight>

[[en:Resource:Votemanager]]

RU/Server Scripting Functions

2012-07-04T14:36:19Z

Vincent:

<pageclass class="server"></pageclass>
На этой странице располагается список всех '''серверных''' функций скриптинга, которые когда-либо были внедрены и теперь являются встроенными. Чтобы запросить новую функцию или событие, напишите об этом [[Requested Functions and Events|сюда]] или на http://bugs.mtasa.com.

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

Отправляйтесь на страницу с [[RU/Modules|модулями]], если хотите получить список доступных невстроенных серверных функций и модулей.

Если вам захочется узнать о других функциях, посетите [[RU/Useful_Functions|страницу с полезными функциями]].

'''Клиентские функции скриптинга можно найти здесь: [[RU/Client Scripting Functions]].'''

{{Warning|Страницы русской вики обновляются нечасто, поэтому мы также рекомендуем посетить [[Server Scripting Functions|английскую версию данной страницы]]. Там список '''всегда''' полный.|true}}

__TOC__

==Функции аккаунтов==
{{Account_functions}}

==ACL функции==
{{ACL_functions}}

==Функции администрирования==
{{Admin_functions}}

==Функции звука==
{{Audio_functions}}

==Функции объявления==
{{Announce_functions}}

==Функции меток на радаре==
{{Blip_functions}}

==Функции камеры==
{{Camera functions}}

==Функции колшейпов (colshape)==
{{Collision shape functions}}

==Функции тела и одежды==
{{Clothes and body functions}}

==Функции курсора==
{{Cursor_functions}}

==Функции элементов==
{{Element functions}}

==Функции событий==
{{Event_functions}}

==Функции взрывов==
{{Explosion_functions}}

==Файловые функции==
{{File_functions}}

==HTTP функции==
{{HTTP_functions}}

==Функции ввода==
{{Input_functions}}

==Функции карт==
{{Map_functions}}

==Функции маркеров==
{{Marker functions}}

==Функции модулей==
{{Module functions}}

==Функции объектов==
{{Object functions}}

==Функции педов==
{{Ped_functions}}

==Функции пикапов==
{{Pickup functions}}

==Функции игроков==
{{Player functions}}

==Функции территорий радара==
{{Radar area functions}}

==Функции ресурсов==
{{Resource functions}}

==Функции серийников==
{{Serial functions}}

==Функции сервера==
{{Server functions}}

==Функции настройки реестра==
{{Settings registry functions}}

==SQL функции==
{{SQL_functions}}

==Функции команд==
{{Team functions}}

==Функции текста==
{{Text functions}}

==Утилитарные функции==
{{Utility functions}}

==Функции транспорта==
{{Vehicle functions}}

==Функции воды==
{{Water functions}}

==Функции оружия==
{{Weapon functions}}

==Функции мира==
{{World functions}}

==XML функции==
{{XML functions}}

[[de:Server-Seitige Scripting Funktionen]]
[[en:Server Scripting Functions]]
[[es:Funciones_del_Server]]

RU/How you can help

2012-07-04T14:35:06Z

Vincent:

__NOTOC__
В Multi Theft Auto есть разделы, в которых Вы можете нам помочь. Мы будем рады, если у Вас есть интересные идеи, которые можно будет в дальнейшем реализовать. На этой странице приведены некоторые основные аспекты, не все конечно, в которых Вы можете оказать нам свою помощь!

==Программирование для MTASA==
* Представляйте на рассмотрение исходники патчей для мода, содержащие необходимые возможности или устранения багов

==Скриптинг==
* Создайте мод
* Создайте страницу администрирования на HTTP сервере
* Сделайте ресурс, направленный на предоставление полезных функций для других ресурсов

==Картостроительство==
* Создайте карту с помощью редактора карт для существующего мода

==Веб разработка==
* Работайте с lil_Toady, чтобы добавлять новые возможности и улучшения на community.mtasa.com
* Создайте свою собственную систему статистики на основе [[PHP SDK]]. За помощью обращайтесь к eAi или jbeta.

==Документация==
* Закончите документацию для [[:Category:Incomplete|незаконченых функций]] - обратитесь в #mta.scripting, если Вы в чем-то не уверены
* Добавляйте примеры в [[:Category:Needs Example|функции нуждающиеся в примерах]] - пожалуйста, проверяйте их, если требуется помощь
* Просматривайте и проверяйте [[:Category:Needs Checking|страницы, требующие проверки,]] - удостоверьтесь, что спорный вопрос улажен, перед тем, как удалить страницы из категории
* Развивайте поясняющие страницы [[:Category:Scripting_Concepts|MTA core concepts]]
* Переводите страницы из [[:Category:Pages to translate|этой категории]] на русский язык, создавайте также новые страницы, которых ещё нет в русском разделе
* Создавайте документацию для [[Undocumented Items|незадокументированных функций и событий]]
==Особые задания==
* Создайте дебаггер, чтобы проверять на аварийные сбои наши скриптовые функции.
* Помогайте развивать/дорабатывать существующие моды. Свяжитесь с автором оригинала через IRC (или попросите разработчика), чтобы сообщить, что вы можете работать вместе.
* Ресурсы веб-интерфейса (ресурс-менеджер, ресурс-браузер и веб-админка) по-настоящему совместимы только с Firefox. А кто-то тратит свое время, чтобы сделать эту работу в Internet Explorer, Opera и Safari. За помощью обращайтесь к [[User_talk:EAi|eAi]].

[[pl:Jak możesz pomóc]]
[[en:How you can help]]

Скины персонажей

2012-07-04T14:32:51Z

Vincent:

Скины, которые игрок может использовать.

*[[All Skins Page|Страница со всеми скинами]] - Не рекомендуется, если у вас медленный интернет.
*[[Special Skins Page|Страница с особыми скинами]] - Новые скины, которые стали доступны начиная с MTA версии 1.1
*[[Gang Skins|Страница со скинами членов банд]]

'''Разбитые по секциям страницы со скинами:'''
----
*[[Skins Page 1]]: 7, 9-29
*[[Skins Page 2]]: 30-41, 43-52
*[[Skins Page 3]]: 53-64, 66-73, 75-76
*[[Skins Page 4]]: 77-85, 87-99
*[[Skins Page 5]]: 100-118, 120-122
*[[Skins Page 6]]: 123-144
*[[Skins Page 7]]: 145-148, 150-167
*[[Skins Page 8]]: 168-189
*[[Skins Page 9]]: 190-207, 209-212
*[[Skins Page 10]]: 213-234
*[[Skins Page 11]]: 235-238, 240-257
*[[Skins Page 12]]: 258-264, 274-288

==Примечания:==
Последний действующий ID скина: 312

*Эти пары ID относятся к одному персонажу (1-й ID используется в списках, 2-й отключен)
**118:119
**148:149

*Неработающие ID
**3 4 5 6 8 42 65 74 86 119 149 208 239 273 289

==Также смотрите==
[[RU/Id|Списки идентификаторов]]

[[en:Character Skins]]
[[es:Skins de Personajes]]
[[it:Skin Personaggi]]

RU/How to repair the database files

2012-07-04T14:30:27Z

Vincent:

=Может быть, все в порядке=
Бывают ситуации, когда не о чем беспокоиться. Ответьте на следующие вопросы:
* Пришли ли вы на эту страницу из-за увиденного сообщения в консоли сервера или логах?
* Есть ли следующий текст в начале блока сообщений-ошибок?
ERROR: near "3": syntax error
* Если это так, то все OK. Вам не нужно делать ничего из описанного ниже, а ошибку можно смело проигнорировать.

=Предупреждения=
'''Сделайте резервные копии всех файлов перед попыткой восстановления!'''
<br>
'''Выключите сервер перед восстановлением!'''

=Windows=

==Простой способ==
*Скачайте [http://updatesa.mtasa.com/sa/files/sqlite/mtasa-db-repair-win.zip это]
*Распакуйте архив и положите файлы по пути ''server/mods/deathmatch/''
*Дважды кликните по ''sqlite_repair_internal_db.bat'', чтобы восстановить internal.db
*Дважды кликните по ''sqlite_repair_registry_db.bat'', чтобы восстановить registry.db

==Сложный способ==

*Скачайте sqlite-shell-win32 [http://www.sqlite.org/sqlite-shell-win32-x86-3070700.zip отсюда]. Если ссылка не сработает, главная страница закачки [http://www.sqlite.org/download.html здесь].
*Распакуйте архив и поместите sqlite3.exe в ''server/mods/deathmatch/''
*Откройте командную строку и перейдите в папку ''server/mods/deathmatch/''
*Чтобы восстановить internal.db:
**Скопируйте '''internal.db''', переименовав в '''internal_original.db'''
**Пропишите следующую команду: '''sqlite3.exe internal_original.db .dump | sqlite3.exe internal_repaired.db'''
**Скопируйте '''internal_repaired.db''', переименовав в '''internal.db'''

*Чтобы восстановить registry.db:
**Скопируйте '''registry.db''', переименовав в '''registry_original.db'''
**Пропишите следующую команду: '''sqlite3.exe registry_original.db .dump | sqlite3.exe registry_repaired.db'''
**Скопируйте '''registry_repaired.db''', переименовав в '''registry.db'''

=Linux=

==Единственный способ==
(Вы можете воспользоваться простым способом, скопировав БД из linux в windows, а затем воспользовавшись методами для компьютеров с windows)
*Скачайте sqlite-shell-linux [http://www.sqlite.org/sqlite-shell-linux-x86-3070700.zip отсюда]. Если ссылка не сработает, главная страница закачки [http://www.sqlite.org/download.html здесь].
*Распакуйте архив и поместите sqlite3 в ''server/mods/deathmatch/''
*Чтобы восстановить internal.db:
**Скопируйте '''internal.db''', переименовав в '''internal_original.db'''
**Пропишите следующую команду: '''./sqlite3 internal_original.db .dump | ./sqlite3 internal_repaired.db'''
**Скопируйте '''internal_repaired.db''', переименовав в '''internal.db'''

*Чтобы восстановить registry.db:
**Скопируйте '''registry.db''', переименовав в '''registry_original.db'''
**Пропишите следующую команду: '''./sqlite3 registry_original.db .dump | ./sqlite3 registry_repaired.db'''
**Скопируйте '''registry_repaired.db''', переименовав в '''registry.db'''
[[Category: Support]]
[[en:How to repair the database files]]

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

2012-07-04T14:25:35Z

Vincent:

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;">
[[File:Mtalogo.png|left|100px|link=http://wiki.multitheftauto.com/wiki/Главная_страница]]'''Добро пожаловать в русскоязычную вики по Multi Theft Auto.''' Здесь вы найдёте подробную информацию по Multi Theft Auto (в том числе разработке игровых режимов и карт).

Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше: создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.

Если у вас есть какие-либо вопросы или проблемы по скриптингу, вы можете задать их в нашем [[RU/IRC Channel|IRC-канале]].
<br/><br/>[ Stop playing with yourself ]
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Играть</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Скачать Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[RU/Client_Manual|Руководство по клиенту]]
* [[RU/Changes_in_{{padleft:|3|{{Current Version|full}}}}|Изменения в версии {{padleft:|3|{{Current Version|full}}}}]]
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]
* [[RU/Upgrading_from_MTA:Race|Миграция с MTA:Race на MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[RU/Server_Manual|Руководство по серверу]]
* [[RU/Resource:Mapmanager|Менеджер карт]]

<h3>Редактор карт</h3>
*[[RU/Resource:Editor|Руководство]]
*[[RU/Resource:Editor/EDF|Формат описаний редактора]]
*[[RU/Resource:Editor/Plugins|Плагины]]
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Базы данных</h3>
В этой секции описаны все возможности Lua, предоставляемые MTA и ресурсами.
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты
* [[RU/Client side scripts | Клиентские скрипты]]
* [[RU/Modules|Модули]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
====Разработка MTA====
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[RU/Compiling_MTASA|Компилирование MTASA на Windows]]
* [[RU/Building_MTASA_Server_on_Mac_OS_X|Компилирование MTASA на Mac OS X]]
* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTASA на GNU/Linux]]
* [[RU/Coding guidelines|Рекомендации по написанию кода]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[RU/Roadmap|План разработки]]
* [http://bugs.mtasa.com/ Багтрекер]
* [[Branches|Ответвления]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
=== Вики - чем могу помочь я ===
* Заполнить документацию для [[:Category:Incomplete|незавершенных функций]].
* [[:Category:Needs_Example |Добавить примеры использования функций и событий]].
* Проверить и подтвердить [[:Category:Needs Checking|еще не проверенные страницы]].
* Написать руководства для помощи новичкам.
* Переводить страницы.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Сообщество</h3>
* [http://forum.multitheftauto.com/ Форум], [http://forum.multitheftauto.com/viewforum.php?f=123 русскоязычная секция]
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [http://community.mtasa.com/ MTA Community] - Обмен и закачка ресурсов.
* [http://twitter.com/#!/MTAQA/ Twitter] - [http://www.youtube.com/user/MTAQA Youtube] - [http://plus.google.com/102014133442331779727/ Google+] - [http://www.moddb.com/mods/multi-theft-auto-san-andreas ModDB]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Скриптинг</h3>
* [[RU/Scripting Introduction|Введение в скриптинг]]
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг пользовательского интерфейса]]
* [[RU/Debugging| Руководство по отладке]]
* [[RU/Resources| Введение в ресурсы]]
** [[RU/Resource Web Access | Веб-доступ к ресурсам]] - Как можно связать сайт и ресурсы
** [[:Category:RU/Resource|Каталог ресурсов]]
** [[RU/Meta.xml | Meta.xml]] - Имеющийся у каждого ресурса файл-описание
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов
* [[RU/Writing_Gamemodes| Создание игровых режимов]]
* [[RU/Useful Functions|Полезные функции]]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Основная помощь по Lua</h3>
Страницы, которые могут вам помочь в изучении Lua
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)]
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]
*[http://lua-users.org/wiki/TutorialDirectory Lua Wiki (англ.)]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]
*[http://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Справка</h3>
* [[RU/Client Scripting Functions|Клиентские функции]]
* [[RU/Client Scripting Events|Клиентские события]]
* [[RU/Server Scripting Functions|Серверные функции]]
* [[RU/Server Scripting Events|Серверные события]]

* [[RU/MTA Classes|Классы MTA]] - Подробное описания всех специфических типов MTA
** [[RU/Element|Элементы MTA]] / [[RU/Element tree|Дерево элементов]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
====[[RU/Id|Списки идентификаторов]]====
*[[RU/Animations|Анимации]]
*[[RU/Character Skins|Скины персонажей]]
*[[RU/CJ_Clothes|Одежда СиДжея]]
*[[RU/Death Reasons|Причины смерти]]
*[[RU/Garage|Идентификаторы гаражей]]
*[[RU/Interior IDs|Интерьеры]]
*[[Material IDs|Идентификаторы материалов]]{{en}}
*[[RU/Projectiles|Снаряды]]
*[[RU/Radar_blips|Метки радара]]
*[[RU/Sounds|Звуки]]
*[[RU/Vehicle IDs|Транспорт]]
*[[RU/Vehicle_colors|Цвета транспорта]]
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]
*[[RU/Vehicle variants|Варианты транспорта]]
*[[RU/Weapons|Оружие]]
*[[RU/Weather|Погода]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/|left]]
'''Multi Theft Auto''' имеет '''открытый исходный код'''.
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''О [[Multi Theft Auto]]'''</li>
<li>[[Archive|Архив]]</li>
<li>[[Press Coverage|В прессе]]</li>
<li>[http://code.google.com/p/mtasa-blue/people/list Разработчики]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li>
<li>[[RU/MTA 0.5r2 Known Issues|Известные проблемы]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Статистика вики'''</li>
<li>Статей: {{NUMBEROFARTICLES}}</li>
<li>Страниц: {{NUMBEROFPAGES}}</li>
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
{{Languages list|ru}}

RU/MTA 0.5r2 Known Issues

2012-07-04T14:24:23Z

Vincent:

{{MTA0.5 page}}
__NOTOC__Это руководство применимо к MTA 0.5r2 (обе GTA3:MTA и MTA:VC). Руководство для MTA:SA 1.x [[RU/Known_Issues_-_FAQ | здесь]].

== Проблемы с клиентской частью ==
*'''Австралийские и немецкие EXE (и, возможно, другие) могут вызывать ошабку "invalid executable" во время попытки зайти в игру.'''
Так как австралийские и немецкие EXE ненадежно работают с MTA, это не такая уж и большая проблема. Попробуйте обзавестись стандартным EXE. Можете попробовать [http://forum.mtasa.com/viewtopic.php?f=50&t=12180 патчер несовместимых EXE от '''Talidan'''].

*'''Краш во время загрузки MTA:VC DM.'''
Хотя бы единожды удостоверьтесь, что можете запустить GTA3 или Vice City в режиме одиночной игры без MTA, перед тем как пробовать играть с MTA. Если не получится, пробуйте [http://updates.rockstargames.com/patches/vicecity/vicepatch_11.zip патч Vice 1.1]. Если и это не сработает, напишите на [http://forum.mtasa.com/viewforum.php?f=50 форум поддержки].

*'''Зависание во время попытки отобразить диалог запроса пути к игре.'''
Известно несколько таких случаев, и нам самим было бы интересно узнать, почему это происходит. Вы можете предотвратить зависание, вручную задав путь в mta.ini, что в папке с Multi Theft Auto.
Для Vice City, ваш mta.ini должен содержать (измените путь при надобности):
<pre>[Game-VC]
Version=0
Location=C:\Program Files\Rockstar Games\Grand Theft Auto Vice City\gta-vc.exe</pre>
Для GTA3:MTA, ваш mta.ini должен содержать (измените путь при надобности):
<pre>[Game-GTA3]
Version=1
Location=C:\Program Files\Rockstar Games\GTAIII\gta3.exe</pre>

*'''XFire крашит игру во время загрузки.'''
И XFire, и MTA используют одинаковые методы интегрирования самих себя в игру. Мы связались с командой разработчиков XFire, чтобы предложить нашу помощь во внедрении MTA, но они нам не ответили. Если вы хотели бы использовать XFire с MTA, свяжитесь с командой разработчиков XFire сами. На данный момент, просто отключайте XFire на время игры.

*'''MTA пишет "Suspected Trainer Usage."'''
Для начала попробуйте закрыть все открытые окна, если не поможет, перезапустите MTA. Если и это не сработает, попробуйте переустановить MTA 0.5r2.

*'''При подключении к серверу мне говорят, что я забанен, хотя меня нет в бан-листе.'''
Причина этого неизвестна. Может быть, вы забанены глобальным баном в банлисте сервера.

*'''Клиент вылетает при попытке подключения к серверу.'''
Это может быть вызвано тем, что клиент пытается загрузить rich text MOTD, указанный на сервере и в процессе происходит сбой (напр., сайт, на котором он расположен, выключен или его URL указан неверно).

*'''У меня на компьютере есть несколько файлов с названием mtachat.txt.'''
mtachat.txt, как вы уже, наверное, догадались, хранит лог чата. Эта функция была добавлена в последнйи момент и не была должным образом протестирована, поэтому и возникли проблемы. Возможно, это связано с тем, как был запущен клиент (стартовый путь влияет на место хранения файла, а не путь установки). Вы можете без проблем их удалять.

*'''Во время щелчка по "Start Game" появляется сообщение "your client is modified."'''
Нажмите '''Start Game''' еще раз.

*'''Во время игры в GTA3 я получаю ошибку "Invalid Executable".'''
Возможно, это вызвано использованием GTA3 версии 1.0 вместо 1.1. Вы можете скачать патч GTA3 до 1.1 [http://updates.rockstargames.com/patches/grandtheftauto3/GTA3patch1.1.zip здесь]. Если это не помогло, или у вас уже GTA3 версии 1.1, удостоверьтесь, что у вас USA/UK EXE; вы можете попробовать [http://forum.mtasa.com/viewtopic.php?f=50&t=12180 патчер несовместимых EXE от '''Talidan''']. Если это тоже не получится, попробуйте обзавестись USA/UK EXE еще где-нибудь.

*'''Антивирус предупредил меня, что исполняемый файл Multi Theft Auto 0.5r2 - вирус или вредноносная программа.'''
MTA <u>не</u> содержит вирусов, вредноносных, рекламных или шпионских программ. Ложное срабатывание вызвано способом упаковки исполняемого файла. Удостоверьтесь, что вы скачали мультиплеер именно с нашего сайта. [http://files.mtasa.com/apps/0.5r2/mta05r2_full_installer.exe Эта ссылка] размещена на нашем веб-хосте. Используйте ее, если сомневаетесь, что у вас оригинальная копия MTA.

*'''Я получил ошибку по адресу 652F30 при старте игры.'''
Установите в игре английский (English) язык.

== Ошибки в игровом процессе: ==
*'''MTA:VC (на любой карте) вылетает, когда я пытаюсь сесть пассажиром на мотоцикл без водителя, вкупе с другими крашами при мотоциклах.'''
Извините, мы не смогли это починить в 0.5r2. Может быть, в будущем мы это исправим.

*'''MTA:VC DM: Невозможно бегать и прыгать с коктейлем молотова в руках, но с гранатами - можно.'''
Это будет исправлено в следующем релизе, если таковой будет.

*'''MTA:VC (на любой карте): после выхода из режима наблюдателя, можно увидеть быстрый проблеск падающего Томми, который потенциально может получить урон от падения; после респавна, у скина менее 100 хп (hp).'''
Это будет исправлено в следующем релизе, если таковой будет.

*'''GTA3:MTA, Turismo/Shoreside Scramble режим: Во время гонки, если умирает один гонщик, то все остальные живые вылетают с сервера.'''
Мы тоже не смогли починить это в 0.5r2. Может быть, в будущем мы это исправим.

*'''GTA3:SSV, Van Heist режим: Маркер дома-базы мерцает, при взрыве Securicar указатель урона принимает отрицательные значения.'''
Придется с этим смириться, мы не смогли починить это в 0.5r2. Может быть, в будущем мы это исправим.

== Проблемы с серверной частью ==
*'''Я получаю ошибку "ERROR: The ServerName, ServerPort, GameMap, GameHour, GameMins, Weather and BannedFile MUST be specified in the configuration file", когда запускаю свой сервер, хотя все поля заполнены. <br>''Затрагивает только Server Patch 1 Hotfix'''''
Убедитесь, что имя вашего сервера занимает 49 символов или меньше. Это скользкая ошибка.

*'''При подключении к серверу я получаю time out, и другие игроки тоже.'''
До недавнего времени это была неизвестная проблема, но, похоже, ее вызывает не MTA или MTAServer, а MTA:mA или другие скрипты, запущенные на нем. Если скрипт отправляет игроку несколько сообщений во время его подключения, вероятность вылета высока. В результате никто не может играть.

Сейчас доступно исправление к MTA:mA, скачать можно [http://forum.mtasa.com/viewtopic.php?p=181919#181919 здесь] (надеюсь, GRS тоже вскоре будет обновлен).

Следуйте инструкциям '''Aeron''''а по пользованию.

Большое спасибо '''Mike''' за установление данной проблемы и '''Aeron''''у за столь оперативную "заплатку".

[[en:MTA_0.5r2_Known_Issues]]

[[Category:Vice_City]]
[[Category:GTA3]]
[[Category:MTA_0.5]]

RU/Debugging

2012-07-04T14:23:15Z

Vincent: /* Добавляйте отладочные сообщения для проверки значения переменной */

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

==Консоль отладки==
MTA предоставляет встроенную консоль отладки, которая показывает отладочные сообщения от функций и скриптов MTA. Ее можно открыть, введя в консоли ''debugscript x'', где ''x'' - уровень отладки:
* '''1:''' только ошибки
* '''2:''' ошибки и предупреждения
* '''3:''' ошибки, предупреждения и информационные сообщения
Таким образом, при вводе ''debugscript 3'' видны все сообщения, так что либо этот, либо уровень 2 рекомендованы в большинстве случаев. debugscript следует иметь включенным на протяжении практически всего времени, когда тестируете свои скрипты, это поможет в обнаружении опечаток и других мелких ошибок, позволяя с легкостью их поправить.

===Пример===
В этом отрывке две ошибки:
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor")
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Когда скрипт, в котором присутствует данный отрывок кода попробует загрузиться, debugscript выведет что-то типа этого:
:{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
Это значит, что скрипт не может быть обработан в силу синтаксической ошибки. Показывается путь ко скрипту, чтобы можно было также увидеть, частью какого ресурса он является ('myResource' в данном случае), и, конечно, имя самого скрипта. После имени файла показан номер строки и что в ней, собственно, не так. Теперь все с легкостью можно исправить, мы просто забыли оператор 'then':
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Сейчас скрипт нормально загрузится и не выведет никаких ошибок, но только пока не выполнится для игрока с ником 'Fedor'. В этом случае, debugscript выведет:
:{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
То есть, что вызванной функции не существует, что и не удивительно, так как ее правильное название - ''outputChatBox'' (с заглавной ''B''):
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatBox("Hello Fedor")
end
</syntaxhighlight>

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

==Ведение отладочного лога на сервере и клиенте==
====Сервер====
Перейдите в: ''(корневая папка MTA)>server>mods>deathmatch''

Там есть два практически одинаковых файла:

*local.conf - содержит настройки сервера, доступного по нажатию на пункт "host game" главного меню MTA. Это быстрый и простой путь ненадолго запустить сервер извнутри клиента. При выключении клиента выключится и сервер.

*mtaserver.conf - используется при выполнении запуска "MTA Server.exe" из (корневая папка MTA)>server. Это способ запустить сервер независимо от клиента на продолжительное время.

В зависимости от выбранного вами способа, вам захочется отредактировать один из этих файлов. Настройки, интересные нам:

<syntaxhighlight lang="xml">
<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>


<scriptdebugloglevel>0</scriptdebugloglevel></syntaxhighlight>

Убедитесь, что указали имя лога. Также укажите уровень ошибок, которые будут записываться. При указании 0 ничего не будет записываться. Другие уровни были объяснены в начале данной статьи. При смене уровня записи на 3, все ошибки '''серверных''' скриптов будут записаны в (корневая папка MTA)>server>mods>deathmatch>logs>scripts.log

====Клиент====
Перейдите в: ''(корневая папка MTA)>server>clientscript.log''

В этот файл ведется запись ошибок всех '''клиентских''' скриптов. Запись включена по умолчанию, вмешательств не требуется.

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

===Полезные функции===
Для начала, некоторые функции, которые могут оказаться удобными при отладке.
* [[outputDebugString]] или [[outputChatBox]] для вывода информации любого вида
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] обращает переменную в строковую, например, когда она является бинарной (двоичной)
* [[getElementType]] для выполнения проверки элемента MTA на получение его типа

===Добавляйте отладочные сообщения, чтобы проверять ''когда'', ''как часто'' и вообще, ''выполняется ли'' участок кода===
Типичный пример проверки на выполнение участка с ''if''. Чтобы его сделать, просто добавьте любое сообщение, которое вы потом будете в состоянии понять, внутрь участка с ''if''.
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("вошел в if")
-- что-нибудь делаем
end
</syntaxhighlight>

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

===Добавляйте отладочные сообщения для проверки ''значения'' переменной===
Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.
<syntaxhighlight lang="lua">
outputChatBox("posX - "..x.." posY - "..y.." posZ - "..z)
createMarker(x,y,z)
</syntaxhighlight>
Это выведет в консоль отладки все три переменные, используемые в качестве коодинат для маркера. Подразумевая, что у вас они считываются из map-файла, теперь вы сможете сравнить выведенное в консоль с желаемыми значениями. [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] гарантирует, что значения переменных смогут быть выведены вместе строкой, даже если они, например, двоичные.

==Пример==
Представьте, что где-то вы создали колшейп (collision shape) и хотите производить какое-либо действие над игроком, простоявшим в нем 10 секунд.
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
При попадании игрока в колшейп, в консоль отладки выводится следующее сообщение:
:{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Что значит, что вы пытались проиндексировать несуществующую таблицу. В образце выше это сделано, так как id таймера сохраняется в таблице. Нам нужно добавить проверку на то, существует ли таблица, а если нет - создать ее.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Но мы все же получаем предупреждение, когда игрок попадает в колшейп, ждет сообщения и снова его покидает:

:{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

За исключением этого сообщения (о нем поговорим позже) все, похоже, работает правильно. Игрок попадает в колшейп, таймер стартует, если он остается, появляется сообщение, если он уходит, таймер убирается.

===Более незаметная ошибка===
Но, в силу некоторых обстоятельств, сообщение выводится дважды, если вы остаетесь в колшейпе на транспортном средстве. Если так получается, значит какой-то код выполняется дважды, мы добавим отладочные сообщения для проверки.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем отладочное сообщение
outputDebugString("colShapeHit")
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем отладочное сообщение
outputDebugString("colShapeLeave")
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

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

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Отладочные сообщения говорят, что одна из переменных ''player'' - действительно игрок, а другая - элемент типа vehicle, т.е. ТС. Так как мы хотим, чтобы срабатывание происходило при попадании в колшейп именно игрока, добавляем ''if'', который предотвратит выполнение функции, если в него попал '''не''' игрок (не элемент типа player).

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Теперь скрипт должен работать как задумано, но все еще будет выводить предупреждение, о котором было сказано ранее. Это происходит, так как таймер, который мы пытаемся убрать при покидании игроком колшейпа, не будет более существовать по прошествии 10 секунд (уже истек). Есть множество способов избавиться от этого предупреждения (вы же знаете, что таймер может более не существовать, и вы хотите его убрать, только если он еще существует). Одним из способов является проверка на то, существует ли упоминаемый в таблице таймер на самом деле. Чтобы ее сделать, нам понадобится [[isTimer]], которой мы и воспользуемся при убирании таймера:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

Итак, полностью рабочий код таков:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Отладка проблем с производительностью==

Если ваш сервер использует намного больше ресурсов, чем ему следовало бы, или вы просто хотите убедиться, что ваши скрипты эффективны, вы можете узнать правду, воспользовавшись отличным инструментом, который поставляется вместе с сервером MTA SA - performancebrowser. Удостоверьтесь, что он запущен, введя "start performancebrowser", а если у вас его нет, возьмите из комплекта стандартных ресурсов, поставляемых с сервером. Данный инструмент предоставляет потрясающее количество информации, полезной для отладки проблем с производительностью. Утечки памяти, утечки элементов и интенсивно использующие процессор скрипты легко найти через performancebrowser. Например, при использовании опции -d в Lua timing, вы можете увидеть, какие функции сильно загружают процессор.

Для доступа к performancebrowser вам понадобится перейти по адресу: http://здесьIPсервера:здесьHTTPпортсервера/performancebrowser/ в своем интернет-браузере. Заметьте, что в конце требуется символ / (слэш). То есть, например: http://127.0.0.1:22005/performancebrowser/ Затем вам понадобится войти со внутриигрового администраторского аккаунта или любого другого аккаунта, имеющего доступ к "general.HTTP". Большинство нужной вам информации находится в разделах Lua timing и Lua memory, там смотрите на те показатели, которые значительно превышают другие.

===Примеры скриптов, которые могут вызывать провалы производительности===

Добавление данных в таблицу без последующего удаления. Хотя пройдут месяцы/годы, пока это реально вызовет какие-либо проблемы.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- Здесь не учитывается выход игрока, что вызовет утечку памяти
-- Используя вкладку Lua timing, вы можете обнаружить использование RAM каждым из ресурсов.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Утечка элементов возможна при использовании по какой-либо причине множества временных колшейпов и последующем их неустранении. Через некоторое время это повлечет за собой проблемы с пропускной способностью, расходом процессора и памяти сервера.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(здесь какой-нибудь код)
if (нормальные для этого условия) then
destroyElement(col)
end
-- Но иногда этого не происходит, так что даже по окончании скрипта зона коллизии остается, что впоследствии
-- может вылиться в сотни, а то и тысячи бесполезных зон коллизии.
-- Вкладка Lua timing позволит вам увидеть количество элементов, созданных каждым скриптом.
end
</syntaxhighlight>

Большой расход процессора чреват тем, что выливается в просадку FPS сервера до порога, когда тот становится неиграбельным. Менее чем за 24 часа это может превратить даже самый популярный сервер в пустующий. Количество "refs" в Lua timing обнаруживает данный тип скопления, удивительно, но вкладка Lua timing в данном случае не помогла, когда Lua memory - напротив.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- Код для заходов
addEventHandler("onPlayerQuit", root, function()
-- Код для того, когда выходят
-- Видите проблему? Он привязан к корню (root), к которому обработчик добавляется снова, снова и снова
end)
end)
</syntaxhighlight>

Функция интенсивно использует процессор, потому что то, что она выполняет, занимает много времени. Это просто функция, которой для завершения требуется много времени. Без performancebrowser вы бы и не догадывались, в чем причина, но с performancebrowser вы можете увидеть, что ресурс сильно загружает процессор во вкладке Lua timing. Если вы затем введете: -d в редактируемое поле options, он даже скажет название файла и первую строку функции, которая так сильно загружает процессор.
<syntaxhighlight lang="lua">
function someDodgyCode()
for i=1, 100000 do
-- какой-нибудь код
end
end
</syntaxhighlight>

[[Category:Scripting Concepts]]

[[en:Debugging]]
[[it:Guida al Debug]]

RU/Debugging

2012-07-04T14:22:26Z

Vincent:

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

==Консоль отладки==
MTA предоставляет встроенную консоль отладки, которая показывает отладочные сообщения от функций и скриптов MTA. Ее можно открыть, введя в консоли ''debugscript x'', где ''x'' - уровень отладки:
* '''1:''' только ошибки
* '''2:''' ошибки и предупреждения
* '''3:''' ошибки, предупреждения и информационные сообщения
Таким образом, при вводе ''debugscript 3'' видны все сообщения, так что либо этот, либо уровень 2 рекомендованы в большинстве случаев. debugscript следует иметь включенным на протяжении практически всего времени, когда тестируете свои скрипты, это поможет в обнаружении опечаток и других мелких ошибок, позволяя с легкостью их поправить.

===Пример===
В этом отрывке две ошибки:
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor")
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Когда скрипт, в котором присутствует данный отрывок кода попробует загрузиться, debugscript выведет что-то типа этого:
:{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
Это значит, что скрипт не может быть обработан в силу синтаксической ошибки. Показывается путь ко скрипту, чтобы можно было также увидеть, частью какого ресурса он является ('myResource' в данном случае), и, конечно, имя самого скрипта. После имени файла показан номер строки и что в ней, собственно, не так. Теперь все с легкостью можно исправить, мы просто забыли оператор 'then':
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Сейчас скрипт нормально загрузится и не выведет никаких ошибок, но только пока не выполнится для игрока с ником 'Fedor'. В этом случае, debugscript выведет:
:{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
То есть, что вызванной функции не существует, что и не удивительно, так как ее правильное название - ''outputChatBox'' (с заглавной ''B''):
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatBox("Hello Fedor")
end
</syntaxhighlight>

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

==Ведение отладочного лога на сервере и клиенте==
====Сервер====
Перейдите в: ''(корневая папка MTA)>server>mods>deathmatch''

Там есть два практически одинаковых файла:

*local.conf - содержит настройки сервера, доступного по нажатию на пункт "host game" главного меню MTA. Это быстрый и простой путь ненадолго запустить сервер извнутри клиента. При выключении клиента выключится и сервер.

*mtaserver.conf - используется при выполнении запуска "MTA Server.exe" из (корневая папка MTA)>server. Это способ запустить сервер независимо от клиента на продолжительное время.

В зависимости от выбранного вами способа, вам захочется отредактировать один из этих файлов. Настройки, интересные нам:

<syntaxhighlight lang="xml">
<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>


<scriptdebugloglevel>0</scriptdebugloglevel></syntaxhighlight>

Убедитесь, что указали имя лога. Также укажите уровень ошибок, которые будут записываться. При указании 0 ничего не будет записываться. Другие уровни были объяснены в начале данной статьи. При смене уровня записи на 3, все ошибки '''серверных''' скриптов будут записаны в (корневая папка MTA)>server>mods>deathmatch>logs>scripts.log

====Клиент====
Перейдите в: ''(корневая папка MTA)>server>clientscript.log''

В этот файл ведется запись ошибок всех '''клиентских''' скриптов. Запись включена по умолчанию, вмешательств не требуется.

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

===Полезные функции===
Для начала, некоторые функции, которые могут оказаться удобными при отладке.
* [[outputDebugString]] или [[outputChatBox]] для вывода информации любого вида
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] обращает переменную в строковую, например, когда она является бинарной (двоичной)
* [[getElementType]] для выполнения проверки элемента MTA на получение его типа

===Добавляйте отладочные сообщения, чтобы проверять ''когда'', ''как часто'' и вообще, ''выполняется ли'' участок кода===
Типичный пример проверки на выполнение участка с ''if''. Чтобы его сделать, просто добавьте любое сообщение, которое вы потом будете в состоянии понять, внутрь участка с ''if''.
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("вошел в if")
-- что-нибудь делаем
end
</syntaxhighlight>

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

===Добавляйте отладочные сообщения для проверки ''значения'' переменной===
Скажем, вы создали маркер, но он не появляется на той позиции, на которой вы этого хотели бы. Первое, что вы захотите сделать - проверить, была ли выполнена функция [[createMarker]]. Но одновременно с этим вы также можете проверить и значения, используемые при выполнении функции [[createMarker]], всего за один запуск.
<syntaxhighlight lang="lua">
outputChatBox("posX is: "..x.." posY is: "..y.." posZ is: "..z)
createMarker(x,y,z)
</syntaxhighlight>
Это выведет в консоль отладки все три переменные, используемые в качестве коодинат для маркера. Подразумевая, что у вас они считываются из map-файла, теперь вы сможете сравнить выведенное в консоль с желаемыми значениями. [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] гарантирует, что значения переменных смогут быть выведены вместе строкой, даже если они, например, двоичные.

==Пример==
Представьте, что где-то вы создали колшейп (collision shape) и хотите производить какое-либо действие над игроком, простоявшим в нем 10 секунд.
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
При попадании игрока в колшейп, в консоль отладки выводится следующее сообщение:
:{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Что значит, что вы пытались проиндексировать несуществующую таблицу. В образце выше это сделано, так как id таймера сохраняется в таблице. Нам нужно добавить проверку на то, существует ли таблица, а если нет - создать ее.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Но мы все же получаем предупреждение, когда игрок попадает в колшейп, ждет сообщения и снова его покидает:

:{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

За исключением этого сообщения (о нем поговорим позже) все, похоже, работает правильно. Игрок попадает в колшейп, таймер стартует, если он остается, появляется сообщение, если он уходит, таймер убирается.

===Более незаметная ошибка===
Но, в силу некоторых обстоятельств, сообщение выводится дважды, если вы остаетесь в колшейпе на транспортном средстве. Если так получается, значит какой-то код выполняется дважды, мы добавим отладочные сообщения для проверки.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем отладочное сообщение
outputDebugString("colShapeHit")
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем отладочное сообщение
outputDebugString("colShapeLeave")
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

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

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Отладочные сообщения говорят, что одна из переменных ''player'' - действительно игрок, а другая - элемент типа vehicle, т.е. ТС. Так как мы хотим, чтобы срабатывание происходило при попадании в колшейп именно игрока, добавляем ''if'', который предотвратит выполнение функции, если в него попал '''не''' игрок (не элемент типа player).

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Теперь скрипт должен работать как задумано, но все еще будет выводить предупреждение, о котором было сказано ранее. Это происходит, так как таймер, который мы пытаемся убрать при покидании игроком колшейпа, не будет более существовать по прошествии 10 секунд (уже истек). Есть множество способов избавиться от этого предупреждения (вы же знаете, что таймер может более не существовать, и вы хотите его убрать, только если он еще существует). Одним из способов является проверка на то, существует ли упоминаемый в таблице таймер на самом деле. Чтобы ее сделать, нам понадобится [[isTimer]], которой мы и воспользуемся при убирании таймера:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

Итак, полностью рабочий код таков:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeHit "..getElementType(player))
-- устанавливаем таймер на вывод сообщения (можно также вызвать другую функцию)
-- сохраняем id таймера в таблице, используя игрока как индекс
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Игрок задержался в колшейпе на 10 секунд!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- добавляем проверку на тип элемента
if (getElementType(player) ~= "player") then return end
-- добавляем отладочное сообщение, с типом элемента
outputDebugString("colShapeLeave "..getElementType(player))
-- убираем таймер при покидании игроком колшейпа
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Отладка проблем с производительностью==

Если ваш сервер использует намного больше ресурсов, чем ему следовало бы, или вы просто хотите убедиться, что ваши скрипты эффективны, вы можете узнать правду, воспользовавшись отличным инструментом, который поставляется вместе с сервером MTA SA - performancebrowser. Удостоверьтесь, что он запущен, введя "start performancebrowser", а если у вас его нет, возьмите из комплекта стандартных ресурсов, поставляемых с сервером. Данный инструмент предоставляет потрясающее количество информации, полезной для отладки проблем с производительностью. Утечки памяти, утечки элементов и интенсивно использующие процессор скрипты легко найти через performancebrowser. Например, при использовании опции -d в Lua timing, вы можете увидеть, какие функции сильно загружают процессор.

Для доступа к performancebrowser вам понадобится перейти по адресу: http://здесьIPсервера:здесьHTTPпортсервера/performancebrowser/ в своем интернет-браузере. Заметьте, что в конце требуется символ / (слэш). То есть, например: http://127.0.0.1:22005/performancebrowser/ Затем вам понадобится войти со внутриигрового администраторского аккаунта или любого другого аккаунта, имеющего доступ к "general.HTTP". Большинство нужной вам информации находится в разделах Lua timing и Lua memory, там смотрите на те показатели, которые значительно превышают другие.

===Примеры скриптов, которые могут вызывать провалы производительности===

Добавление данных в таблицу без последующего удаления. Хотя пройдут месяцы/годы, пока это реально вызовет какие-либо проблемы.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- Здесь не учитывается выход игрока, что вызовет утечку памяти
-- Используя вкладку Lua timing, вы можете обнаружить использование RAM каждым из ресурсов.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Утечка элементов возможна при использовании по какой-либо причине множества временных колшейпов и последующем их неустранении. Через некоторое время это повлечет за собой проблемы с пропускной способностью, расходом процессора и памяти сервера.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(здесь какой-нибудь код)
if (нормальные для этого условия) then
destroyElement(col)
end
-- Но иногда этого не происходит, так что даже по окончании скрипта зона коллизии остается, что впоследствии
-- может вылиться в сотни, а то и тысячи бесполезных зон коллизии.
-- Вкладка Lua timing позволит вам увидеть количество элементов, созданных каждым скриптом.
end
</syntaxhighlight>

Большой расход процессора чреват тем, что выливается в просадку FPS сервера до порога, когда тот становится неиграбельным. Менее чем за 24 часа это может превратить даже самый популярный сервер в пустующий. Количество "refs" в Lua timing обнаруживает данный тип скопления, удивительно, но вкладка Lua timing в данном случае не помогла, когда Lua memory - напротив.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- Код для заходов
addEventHandler("onPlayerQuit", root, function()
-- Код для того, когда выходят
-- Видите проблему? Он привязан к корню (root), к которому обработчик добавляется снова, снова и снова
end)
end)
</syntaxhighlight>

Функция интенсивно использует процессор, потому что то, что она выполняет, занимает много времени. Это просто функция, которой для завершения требуется много времени. Без performancebrowser вы бы и не догадывались, в чем причина, но с performancebrowser вы можете увидеть, что ресурс сильно загружает процессор во вкладке Lua timing. Если вы затем введете: -d в редактируемое поле options, он даже скажет название файла и первую строку функции, которая так сильно загружает процессор.
<syntaxhighlight lang="lua">
function someDodgyCode()
for i=1, 100000 do
-- какой-нибудь код
end
end
</syntaxhighlight>

[[Category:Scripting Concepts]]

[[en:Debugging]]
[[it:Guida al Debug]]

RU/Server Manual

2012-07-04T14:19:28Z

Vincent:

{{DISPLAYTITLE:Руководство по серверу}}
__TOC__

==Начало==
Поднять и поддерживать сервер для своих LAN или интернет-друзей намного легче, чем кажется; просто следуйте этой статье и, надеюсь, вы быстро разберетесь, как хостить свой собственный MTA:SA сервер!

==Установка сервера==
Приложение для выделенного сервера доступно в разных редакциях, зависящих от платформы севрера.

===Linux===
Есть несколько путей поднять и запустить сервер на Linux:
* [http://linux.mtasa.com Прекомпилированный пакет]
* [[RU/Building MTASA Server on GNU Linux|Сборка сервера MTASA на GNU/Linux]]

===Windows===
Установка сервера MTA:SA на Windows очень проста.
*Перейдите на [http://mtasa.com/ страницу закачки] и скачайте установщик.
*Когда установщик закачан, запустите его.
*Выберите папку, куда вы хотели бы установить сервер.
*Нажмите Install.
*Все!

''Для полной инструкции по acl.xml (access control list - лист контроля над правами) читайте: [[RU/Access_Control_List|Access Control List]]''<br/><br/>

==Настройка сервера==
Выделенный сервер Multi Theft Auto изначально поддается настройке через окно консоли, прямо из игры и через браузер. Чтобы активировать последние две опции, необходимо добавить хотя бы одного администратора в ваш конфигурационный файл.

===Основная настройка===
Все основные опции настройки находятся в файле 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' и могут быть заданы через обычный текстовый редактор.

Этот файл очень прост; каждая переменная имеет [[Server_mtaserver.conf|описание своего назначения и информацию по ее изменению]].

===Проброс портов===
Если вы запускаете сервер на своем личном компьютере и у вас есть роутер, вам понадобится пробросить 3 порта.

Для начала откройте файл 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' и найдите следующие строки:
<syntaxhighlight lang="xml">
<serverport>22003</serverport>
<httpport>22005</httpport>
</syntaxhighlight>

Эти порты нужны для правильной установки сервера. Позже мы объясним как их задавать, но сначала, если вы хотите, чтобы ваш сервер появился в браузере серверов, то есть еще один нужный нам порт - порт ASE.
(краткий пример по включению / выключению ASE):
<syntaxhighlight lang="xml">
<ase>1</ase> 
</syntaxhighlight>

Теперь нам нужно пробросить порты на вашем роутере, что не понадобится, если у вас уже открыты все порты, или если у вас нет роутера с фаерволлом. Если так оно и есть, пропустите эту часть.

Если вы не знаете, как пробросить порты на вашем роутере, пройдите [http://portforward.com/ на сайт по проброске портов], найдите там модель своего роутера и следуйте инструкциям.

Почти в каждом роутере можно задать тип порта: UDP или TCP. Этот список объяснит, какой тип порта и для чего нужен:

Главный порт сервера: UDP

HTTP порт: TCP

ASE порт: UDP (он понадобится, если вы захотите появления своего сервера в браузере серверов)

ASE порт легко вычислить:

ASE порт = главный порт сервера + 123

Итак, если главный порт вашего сервера - 22003, ASE порт будет 22126.

Удачи!

''В последней версии сервера вы можете проверить статус портов через следующую серверную команду [[Server_Commands#openports|openports]].''

===Проверки клиента===

При желании, античит MTA сервера может быть отключен. В нем можно также разрешить определенным или всем файлам быть измененными (напр. carmods.dat) или задать минимально допустимую весрию клиента.

Все эти настройки расположены внутри файла 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]'. Смотрите [[Anti-cheat_guide|Anti-cheat guide]] для получения дополнительной информации.<br/>

Если вы хотите задать минимальную версию клиента, найдите следующую строку:
<syntaxhighlight lang="xml">
<minclientversion></minclientversion>
</syntaxhighlight>
Правильные значения выглядят наподобие: 1.1.1-9.02320

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

Чтобы добавить администратора, следуйте этим шагам:<br>
<ol>
<li>Если сервер запущен, добавьте новый аккаунт через ввод команды '''[[Server_Commands#addaccount|addaccount name password]]''' в окно севрера. Например, чтобы добавить пользователя VasyaPupkin, вам понадобится набрать:
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
addaccount VasyaPupkin 123password
</syntaxhighlight>
</div>
<div style="margin: 10px 10px 10px 20px;">
''Заметка: Если у вас нет доступа к окну сервера, а ресурс 'admin' запущен, вы можете добавить аккаунт-образец через ввод '''/register VasyaPupkin 123password''''' в чат.
</div>
<li>Сервер должен будет отобразить сообщение о том, что аккаунт добавлен.
<li>Затем выключите сервер, введя '''shutdown''' в окне сервера.
<li>Удостоверьтесь, что сервер выключен; если он все еще запущен, изменения, которые вы вносите, будут перезаписаны</li>
<li>Откройте файл 'mods/deathmatch/'acl.xml'''' любым текстовым редактором</li>
<li>Добавьте аккаунт в группу ''Admin'', используя XML-синтаксис, как это сделано ниже
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<acl>
...
<group name="Admin">
<acl name="Admin"/>
...
<object name="user.VasyaPupkin" />
</group>
...
</acl>
</syntaxhighlight>
</div>

Вообще, можно добавлять пользователей в какие угодно группы. Каждая из групп связана с ACL ([[RU/Access Control List|Access Control List]]). Каждый ACL содержит специфический список разрешенных и запрещенных прав. Группы существуют для того, чтобы разным пользователям могли соответствовать разные права. Группа ''Admin'' связана с ''Admin''ским ACL, который пуст (стало быть, разрешены все права). Группа ''Everyone'' связана с ''Default''ным ACL, который накладывает список ограничений на доступные команды (чтобы не позволять обычным пользователям пользоваться админскими командами).
</li>
<li>
Это все! Вы можете добавлять столько администраторов и пользователей этим способом столько, сколько захотите, еще посмотрите на другие группы и ACL'ы, например. ACL также доступен через [[RU/Access_Control_List|скриптовый движок Lua]].<br>

Рекомендуется взглянуть на веб-интерфейс, как это сделать мы опишем ниже.
</li>
</ol>
'''Заметка''': Для сервера, когда он запущен, есть другие способы добавлять аккаунты и редактировать права. "[[Server_Commands#addaccount|addaccount <user> <password>]]" - внутренняя команда для добавления аккаунтов, но вам придется воспользоваться веб-интерфейсом, чтобы добавить эти аккаунты в специфические группы/ACLы!<br />

===Использование веб-интерфейса===
Выделенный сервер поставляется с некоторыми Lua [[RU/Resources|ресурсами]], которые предоставляют хороший простой веб-интерфейс для управления сервером. Это легко может быть использовано для поддержки сервера, так как позволяет вам добавлять пользователей, запускать/останавливать ресурсы и другое.

Ресурсы веб-интерфейса по умолчанию включены и обслуживаются через встроенный HTTP веб-сервер. Чтобы убедиться, что встроенный HTTP веб-сервер запущен на нужном вам порту (22005 по умолчанию), следуйте данной инструкции:
<ol>
<li>Убедитесь, что сервер выключен
<li>Откройте файл 'mods/deathmatch/[[Server_mtaserver.conf|'''mtaserver.conf''']]' любым текстовым редактором</li>
<li>Проверьте, что HTTP сервер включен:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
</syntaxhighlight>
</div>
</li>
<li>Измените порт HTTP сервера на свое усмотрение:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</div>
</li>
<li>Сохраните изменения и закройте файл конфигурации</li>
<li>Запустите сервер</li>
<li>Если вы меняли список автозапускаемых ресурсов в конфигурационном файле, убедитесь, что следующие ресурсы запущены:

# resourcebrowser
# resourcemanager
# webadmin
# webmap

Они автоматически стартуют согласно стандартному файлу, в случае, если вы только что установили свой сервер.
</li>
<li>Откройте веб-браузер (Internet Explorer 6 or 7 НЕ поддерживаются; используйте [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] или другие) и перейдите по URL HTTP server'а: '''http://server:port/'''. Например, если у вас зупщен локальный сервер на HTTP порту 22005, используйте '''http://127.0.0.1:22005/'''.</li>
<li>Введите имя пользователя и пароль администратора, которого вы добавили в предыдущей секции.</li>
</ol>

<br />
Теперь вы способны управлять своим севрером через веб-интерфейс.

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

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

Чтобы включить скачивание с внешнего веб-сервера, вам следует настроить тег [[Server_mtaserver.conf#httpdownloadurl|httpdownloadurl]] в конфигурации своего сервера:

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

С тех пор, как все стандартные ресурсы, поставляемые с выделенным сервером, упакованы в zip-архивы, и обычно автоматически распаковываются благодаря встроенному веб серверу, теперь вам понадобится предоставить клиентам возможность закачивать себе сжатые файлы. Чтобы настроить MTA на поддержание копии только распакованных клиентских ресурсов, установите [[Server_mtaserver.conf#httpautoclientfiles|httpautoclientfiles]] в конфигурации вашего сервера:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpautoclientfiles>1</httpautoclientfiles>
</syntaxhighlight></div>

Теперь, когда вы запускаете сервер, папка '''<SERVER>/mods/deathmatch/resource-cache/http-client-files''' будет содержать действительные клиентские файлы для хостинга на внешнем веб-сервере. Если веб сервер расположен на том же компьютере, что и сервер, вы можете просто связать директорию надлежащего веб-сервера с '''http-client-files'''. Если веб-севрер расположен на отдельном компьюетре, убедитесь, что у него есть доступ к '''http-client-files''' по сети, или поддерживайте удаленную копию с помощью синхронизационного ПО.

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

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

Чтобы запустить сервер, выполните двойной щелчок по MTA Server.exe, убедитесь, что добавили его в исключение фаерволлов и пробросили порты, если это необходимо.

==Установка/Обновление ресурсов сервера==
Ресурсы могут быть двух видов, либо в формате ZIP-архива, либо просто обычной папкой со скриптами внутри. MTA:SA сервер поддерживает оба метода.

# Переместите или скопируйте новый ресурс в вашу папку <SERVER>\mods\deathmatch\resources.
# В окне сервера введите команду [[Server_Commands#refresh|refresh]], эта команда выполнит сканирование папки ресурсов и обновит ресурсы, если требуется.

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

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

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

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

Для других команд, введите [[Server_Commands#help|help]] в консоли.

==Запуск карты/мода==
Смотрите секцию команд у [[RU/Resource:Map manager|mapmanager]] для дальнешей информации.

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

# Вы можете также обновлять ресурсы прямо из игры, если у вас есть соответствующие права, введя "refresh" в клиентской консоли или "/refresh" в чате. Это может вызвать секундное подлагивание, если ресурсов много.
# В инструкциях выше, <SERVER> - путь к главной директории сервер. В большинстве случаев это C:\Program Files\MTA San Andreas\server
# Вы можете выбрать к использованию сервером другой конфигурационный файл, добавив его в командной строке после аргумента --config, напр. mtaserver.exe --config anotherconfig.cfg.
# Не пугайтесь предупреждения о анализе файла settings.xml. Это происходит, когда ваша установка сервера все еще чиста и не была задействована.

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

[[en:Deathmatch Server Manual]]
[[es:Manual del Servidor]]
[[de:Server Anleitung]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]

[[Category:Support]]

RU/Known Issues - FAQ

2012-07-04T14:16:41Z

Vincent: /* "Data files have been modified" */

{{Warning|Windows 8 (Developer/Consumer/Release Preview) в данный момент не поддерживается! [[http://forum.mtasa.com/viewtopic.php?p=371531#p371531 Заметка 1]][[http://forum.mtasa.com/viewtopic.php?f=104&t=37037 Заметка 2]]|true}}
{{Note_box|Перед тем, как читать эту статью, убидитесь, что все [[RU/Up-to-date | обновлено]].}}
Пишите здесь ваши вопросы и ответы, касающиеся известных проблем с MTA:SA 1.x и их решений, как тех, с которыми вы сталкиваетесь сейчас, так и тех, с которыми пользователи могут столкнуться в финальной версии. Редактирование этой статьи с точки зрения грамматики/стиля только приветствуется.

* [[RU/Resource:Editor#FAQ|Справка по Map Editor]]<br>
* [[RU/MTA 0.5r2 Known Issues|Справка по MTA 0.5r2]]

== Клиент ==
{{Warning|Windows 8 (Developer/Consumer/Release Preview) в данный момент не поддерживается! [[http://forum.mtasa.com/viewtopic.php?p=371531#p371531 Заметка 1]][[http://forum.mtasa.com/viewtopic.php?f=104&t=37037 Заметка 2]]|true}}
=== Общее ===
==== У меня Steam-версия GTA San Andreas. Как я могу сыграть в MTASA? ====
:Steam-версия GTASA на данный момент не поддерживается MTASA. Как бы то ни было, следуя данным простым шагам, вы можете "починить" Steam-версию:
:*'''Решение 1:''' Найдите '''GTA SA 1.00 No CD''' (Например, в Google). Вы должны обзавестись Cracked/NoCd EXE версии 1.00, а не образом диска. Любой релиз от HOODLUM хорошо подойдет.
:** Откройте закачку Winrar'ом или любым другим архиватором, внутри должен быть файл gta_sa.exe. Поместите его в папку, куда установлена игра. Обычно это '''C:\Program Files\Steam\steamapps\common\grand theft auto san andreas'''. Никакие файлы заменять не потребуется.

:Данная процедура не затронет вашу Steam-версию GTASA, но позволит MTASA работать вместе с ней.
:* '''Решение 2:''' Воспользуйтесь неофициальным [http://forums.steampowered.com/forums/showthread.php?t=1952458 steam downgrade патчем], удостоверьтесь, что понижаете версию до 1.0, а не 1.01.
==== Работает ли MTASA 1.x с версиями GTA San Andreas 1.01 или 2.00? ====
:Нет. Пожалуйста, прочитайте [http://forum.mtavc.com/viewtopic.php?t=15151 эту тему на форуме], чтобы узнать как пропатчить игру до версии 1.0

==== Начальный черный экран, приводящий к зависанию заставок GTA ====
:* '''MTA показывает постоянный черный экран или приводит к зависанию заставок GTA'''

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

:* '''MTA постоянно показывает черный экран после заставок GTA (иногда с тектстом в нижнем правом углу).'''

:Это может быть вызвано неподдерживаемостью DirectX или отсутсвием функций видеокарты, которые необходимы для запуска динамических меню. По умолчанию оно включено. Вы можете открыть [[coreconfig.xml]], который находится в директории ''GTA San Andreas\MTA'' и изменить параметр ''menu_options'' на ''248''.

==== Зависание после заставки MTA ====
:* '''После заставки 'Stop playing with yourself' ничего не происходит'''

:Еслы вы используете видеокарту nVidia GeForce, попробуйте в Desktop Manager отключить nView перед тем как запустить MTA.

:Также попробуйте удалить файл настроек ''gta_sa.set'' из папки ''Documents\GTA San Andreas User Files''

:Если ничего из этого не принесло успеху, а вы - пользователь Kaspersky Anti-Virus или Internet Security, задайте "multi theft auto.exe" статус "без ограничений". Другие антивирусы тоже могут не давать MTA запускаться.

==== Вылет после заставки MTA ====
:* '''MTA вылетает после заставки 'Stop playing with yourself'. Одиночная игра и MTA: Race раньше работали прекрасно.'''

:Загрузите последнюю версию DirectX с сайта [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 Microsoft]. Также удостоверьтесь через "Диспетчере задач", что процесс ''gta_sa.exe'' не запущен.

:Если вы работаете с нестандартными разрешениями экрана (напр. 960x720), то попробуйте использовать стандартные разрешения (напр. 640×480, 800×600, 1024×768, 1152×864, 1280×1024). Для этого запустите Grand Theft Auto: San Andreas в нормальном режиме, установите нормальное разрешение и выйдите.

:Если вы пользуетесь Windows Vista или 7, попробуйте слудующее:
:* Включите режим совместимости с Windows XP SP3 для обеих Multi Theft Auto.exe и gta_sa.exe, установив флаг "Запускать от администратора".
:* Задайте правило предотвращения исполнения данных: Используйте настройку ''Включить DEP для всех программ и служб кроме выбранных ниже''. Нажмите ''добавить'', отыщите "Multi Theft Auto.exe" и "gta_sa.exe", а затем добавьте их.
:* Запустите MTASA от администратора.

==== "Data files have been modified" ====
:* '''При запуске вы получаете ошибку "San Andreas data files have been modified"'''
:Вы можете починить это благодаря установке данного [http://updatesa.mtasa.com/sa/files/GTASA-data-1.0.4.exe патча]. Если не поможет, переустановите GTA: San Andreas.



==== Вылет при попытке подключения к любому из серверов ====
:* '''MTASA вылетает во время подключения в серверу. Одиночная игра нормально работает.'''

:Моды на GTA в одиночной игре потенциально могут служить причиной краша MTA:SA, поэтому всегда следует использовать чистую GTASA для MTA:SA.

:Такое может возникать и при чистой установке, когда исполняемый файл GTASA неподдерживаемой MTA:SA версии (напр. 1.0 German или Australian). Чтобы починить это, используйте [http://forum.multitheftauto.com/viewtopic.php?f=89&t=15151 наш конвертер].

==== Не работает клавиатура ====
:* '''Мои средства ввода не работают.'''

:Введите в консоль (F8) команду 'copygtacontrols'.

==== Неправильные модели ====
:* '''Жeнские модели выглядят некрасиво / Я наблюдаю непонятные, паукообразные модели игроков.'''

:Это связанно со способом обращения GTA к игровым параметрам. Чтобы исправить это, убедитесь, что параметры жира и мускул установлены на 0 при смене скина.

==== Неправильно работает стрельба из авто ====
:* '''Стрельба из авто не такая, как должна быть'''

:Транспорт изменен сервером в зависимости от игрового мода на сервере.

==== Не сохраняются настройки ====
:* '''Мои настройки MTA не были сохранены и из-за этого произошел вылет'''

:После изменения параметров попробуйте сразу выйти из MTA, настройки должны сохраниться. Также попробуйте удалить ''coreconfig.xml'', а потом снова настройте MTA.

==== Проблемы с геймпадами ====
:* '''MTA не может распознать геймпад'''

:Для начала удостоверьтесь, что ваш геймпад - первый контроллер, распознанный Windows (MTA будет использовать только первый). Вы можете настроить геймпад через Settins в главном меню MTA.

==== Не работает мышь ====
:* '''MTA не определяет мышь'''

:Некоторые люди испытывают проблемы в мышью в MTA. Они могут пользоваться ею в главном меню, подключиться к серверу, но позже - нет.
:Проблема решается следующими способами: войдите на сервер, нажмите кнопку Win (флажок) на клавиатуре, затем нажмите на левую кнопку мыши.
:Если это не помогло, зайдите в одиночную игру и в настройках укажите управление мышь+клавиатура вместо джойстика.

==== Список серверов не работает ====
:* '''Игровой список серверов все время показывает "Loading" и ничего более '''

:В зависимости от типа и скорости вашего интернет-соединения может понадобиться некоторое время для загрузки списка серверов. Пожалуйста, подождите немного.

:В Settings>Advanced можно также задать способ своего соединения (Very Slow, Slow, Fast).

:Если и это не помогает, вы можете залогиниться в [http://www.game-monitor.com/search.php?game=mta GameMonitor], кликнуть зеленую иконку play, чтобы сыграть на том сервере.

==== Неверный серийный номер ====
:* '''Я вижу ошибку 'Invalid serial number' при загрузке игры'''

:Вы используете старую версию Multi Theft Auto. Загрузите последнюю со [http://www.mtasa.com/ страницы загрузки].

==== 'Network module not compatible!' при запуске MTA ====
:* '''Я вижу ошибку 'Network module could not be located' при загрузке MTA:SA DM

:Это может означать, что ваша установка MTA:SA прошла не полностью или сломалась. Переустановите MTA.

==== 'No such mod installed (deathmatch)' ====
:* '''Я вижу ошибку 'No such mod installed (deathmatch)' при попытке подключится к любому серверу

:'''Решение 1:''' Просто переустановите MTA. <br>
:'''Решение 2:''' Запускайте и ''gta_sa.exe'', и ''Multi Theft Auto.exe'' с правами Администатора системы.

==== D3dx9_**.dll не был найден ====
:* '''Когда я запускаю Multi Theft Auto: San Andreas, я вижу ошибку D3dx9_**.dll (** = это номер) не был найден.

:Это значит, что у вас стоит более старая, чем DirectX 9, версия.
:Скачайте/улучшите ваш DirectX через [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 DirectX End-User Runtime Web Installer] с сайта Microsoft.

==== CRC mismatch ====
:* '''Когда захожу на сервер, в чате вижу 'CRC mismatch'
:Это проблема сервера. Скажите владельцу сервера, чтобы посетил серверную версию данной страницы.

==== 'Error loading network module!' при запуске ====
* Полный текст ошибки:
:''Error loading network module! (The application has failed to start because its side-by-side configuration is incorrect. Please see the application event log for more detail.''

:Убедитесь, что у вас установлены Microsoft Visual C++ 2008 и SP1 redistributable (x86):

:[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=9b2da534-3e03-4391-8a4d-074b9f2bc1bf Microsoft Visual C++ 2008 Redistributable package (x86)]

:[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=a5c84275-3b97-4ab7-a40d-3802b2af5fc2 Microsoft Visual C++ 2008 SP1 Redistributable package (x86)]

==== Антивирус ругается на MTA:SA ====
:* '''Антивирус предупреждает вас, что ваша установелнная MTA или ее установщик - вирусы'''
:MTA '''НЕ''' содержит никаких вирусов, вредноносных, рекламных или шпионских программ. Снова скачайте MTASA [http://mtasa.com отсюда], если сомневаетесь в том, что ваша копия - оригинальная.

==== Процесс закачки больших карт застапаривается ====
:* '''Во время закачки больших карт, процесс зачастую останавливается, но сам поток информации при этом идет'''
:Этот баг исправлен в [http://forum.mtasa.com/viewtopic.php?f=31&t=39555#p402093 MTA:SA 1.3].

=== Проблемы с Windows Vista® ===

==== Вылет при загрузке ====
:* '''Кажется, я вылетаю во время подсоединения к серверу как раз перед тем, как зайти в игру, на Vista'''

:Скорее всего, это проблема Microsoft DirectX April 2006 SDK Redistributable DLL файла (d3dx9_30.dll), когда запуск идет в режиме совместимости. Пожалуйста, убедитесь, что режим совместимости полностью выключен у '''обеих''' исполнительных файлов: GTA_SA.exe и Multi Theft Auto.exe.

==== Clock manipulation error ====
:* '''Я вижу ошибку 'Clock manipulation detected!' при запуске MTA:SA DM

:Это может быть вызвано неправильно установленными датой/временем (из-за неправильных настроек или севшей батарейки на материнской плате компьютера). Установка времени и даты должны помочь.

:Это также может происходить, если вы используете процессор AMD Athlon 64 X2 с некоторыми старыми драйверами. Обновите их на [http://support.amd.com/us/Pages/drivers.aspx сайте AMD].

==== Зависание при запуске ====
:* '''Когда я запускаю MTA:SA 1.x, ничего не происходит (GTA_SA.exe работает, но не загружается)

:Запустите MTA:SA 1.x с правами Администатора системы. Чтобы это сделать, щелкните правой кнопкой мыши на установщике MTA, выберите "Свойства", там - вкладку "Совместимость" и отметьте самую нижнюю галочку, затем попытайтесь установить MTA снова.

==== Общие Проблемы с GTA ====
:* '''У меня необъяснимые проблемы и сбои с GTA'''

Убедитесь, что ваш компьютер удолетворяет [[RU/Deathmatch_Client_Manual#Системные требования| минимальным требованиям]] для работы GTA: San Andreas, а также, что вы не работаете в режимах совместимости 98/2000/XP/2003.

:Также посетите следующие страницы:
:* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502
:* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista

==== Сбои в производительности с Sandy Bridge / вторым поколением процессоров Intel Core ====
:* '''Медленная производительность MTA на процессорах Sandy Bridge, когда другие игры и одиночная игра San Andreas нормально работают.'''
:Это, похоже, ошибка комбинации профиля энергопотребления Windows в режиме энергосбережения, вы можете обойти это проблему, выставив режим "высокая производительность", когда играете в MTA:SA.
:* Тема об этой проблеме: [http://forum.mtasa.com/viewtopic.php?f=104&t=31745 Sandy Bridge performance issues?]

== Сервер ==

=== Общее ===
==== Неустранимая ошибка 3 ====
:* '''Я вижу ошибку ''Fatal Error 3'' всякий раз при попытке подключения к своему серверу'''

:Эта ошибка случается, когда сервер, с которым Вы пытаетесь соединиться, неспособен предоставить Вам необходимые загрузки, потому что у него выключен http. Убедитесь, что параметр '''httpdownload''' в конфиге сервера установлен на '''1'''.

==== Ошибка закачки 9: Ошибка при загрузке запрошенных файлов ====
:* '''Я вижу ошибку ''Download Error 9: Error downloading requested files'' всякий раз при попытке подключения к своему серверу'''

:Это происходит, если сервер не может дать вам правильную ссылку, что приводит к HTTP ошибке 404 (Not found).

:* Если вы используете built-in (встроенный) сервер (значение '''httpserver''' установлено на '''1''' и '''httpdownloadurl''' пуст), убедитесь, что ваш HTTP-сервер доступен (вы можете подключиться к нему с помощью браузера) для всех.

:* Если вы настроили внешний веб-сервер ('''httpdownloadurl''' установлен на ваш URL), убедитесь, что ваш HTTP доступен и что вы прочли [[RU/Server_Manual#Настройка внешнего веб-сервера | инструкцию по настройке внешнего веб сервера]].

==== CRC mismatch ====
:* '''Когда люди заходят на мой сервер, в их чате появляется 'CRC mismatch'
:CRC mismatch возникает, если:
:* Либо файлы ресурса были изменены, но сам ресурс перезапущен/обновлен не был,
:* Либо используется внешний http сервер и файлы не синхронизированы

==== Отсутствуют аккаунты ====
:Файл ''accounts.xml'' не используется, начиная с версии 1.0.4, его заменил файл с названием ''internal.db''. Чтобы убедиться, что информация о ваших старых аккаунтах переместилась из одной базы в другую:
:*Остановите сервер
:*Убедитесь, что ваш старый ''accounts.xml'' исправен
:*Удалите ''internal.db''
:*Запустите сервер

==== Отсутствуют ресурсы ====
:Начиная с 1.0.4, имена ресурсов не могут содержать символ точки.

==== Ошибка закачки 28 ====
:(Download error 28)<br>
:Выключите ваш антивирус и фаерволл. Если это сработало, попробуйте добавить исключение в ваш фаерволл, чтобы разрешить в нем ваш http порт.

==== Пропадают аккаунты ====
:Информация об аккаунтах (или чем-либо еще) не сохраняется из-за повреждения базы данных. Начиная с билда 2836, сервер проверяет целостность файлов баз данных sqlite при старте. Если там сообщается о database error (ошибке базы данных), подалуйста, прочитайте, [[RU/How to repair the database files | как восстановить файлы баз данных]].
:Если вы используете более раннюю версию и испытываете проблемы с пропажей аккаунтов, вам следует обновить сервер до [http://nightly.multitheftauto.com/ последнего билда].

=== Windows ===
:Нет вопросов по {{Current Version|full}}.

=== Linux ===
====Стандартный nohup создает очень большой nohup.out====

:Временный фикс: отключите файл nohup ('nohup ./mta_server > /dev/null &').

[[de:Known Issues - FAQ]]
[[en:Known Issues - FAQ]]
[[es:Problemas Conocidos - FAQ]]
[[it:Bugs noti e FAQ]]
[[pt-br:Soluções de Problemas - FAQ]]

[[Category:Support]]

RU/Known Issues - FAQ

2012-07-04T14:12:55Z

Vincent:

{{Warning|Windows 8 (Developer/Consumer/Release Preview) в данный момент не поддерживается! [[http://forum.mtasa.com/viewtopic.php?p=371531#p371531 Заметка 1]][[http://forum.mtasa.com/viewtopic.php?f=104&t=37037 Заметка 2]]|true}}
{{Note_box|Перед тем, как читать эту статью, убидитесь, что все [[RU/Up-to-date | обновлено]].}}
Пишите здесь ваши вопросы и ответы, касающиеся известных проблем с MTA:SA 1.x и их решений, как тех, с которыми вы сталкиваетесь сейчас, так и тех, с которыми пользователи могут столкнуться в финальной версии. Редактирование этой статьи с точки зрения грамматики/стиля только приветствуется.

* [[RU/Resource:Editor#FAQ|Справка по Map Editor]]<br>
* [[RU/MTA 0.5r2 Known Issues|Справка по MTA 0.5r2]]

== Клиент ==
{{Warning|Windows 8 (Developer/Consumer/Release Preview) в данный момент не поддерживается! [[http://forum.mtasa.com/viewtopic.php?p=371531#p371531 Заметка 1]][[http://forum.mtasa.com/viewtopic.php?f=104&t=37037 Заметка 2]]|true}}
=== Общее ===
==== У меня Steam-версия GTA San Andreas. Как я могу сыграть в MTASA? ====
:Steam-версия GTASA на данный момент не поддерживается MTASA. Как бы то ни было, следуя данным простым шагам, вы можете "починить" Steam-версию:
:*'''Решение 1:''' Найдите '''GTA SA 1.00 No CD''' (Например, в Google). Вы должны обзавестись Cracked/NoCd EXE версии 1.00, а не образом диска. Любой релиз от HOODLUM хорошо подойдет.
:** Откройте закачку Winrar'ом или любым другим архиватором, внутри должен быть файл gta_sa.exe. Поместите его в папку, куда установлена игра. Обычно это '''C:\Program Files\Steam\steamapps\common\grand theft auto san andreas'''. Никакие файлы заменять не потребуется.

:Данная процедура не затронет вашу Steam-версию GTASA, но позволит MTASA работать вместе с ней.
:* '''Решение 2:''' Воспользуйтесь неофициальным [http://forums.steampowered.com/forums/showthread.php?t=1952458 steam downgrade патчем], удостоверьтесь, что понижаете версию до 1.0, а не 1.01.
==== Работает ли MTASA 1.x с версиями GTA San Andreas 1.01 или 2.00? ====
:Нет. Пожалуйста, прочитайте [http://forum.mtavc.com/viewtopic.php?t=15151 эту тему на форуме], чтобы узнать как пропатчить игру до версии 1.0

==== Начальный черный экран, приводящий к зависанию заставок GTA ====
:* '''MTA показывает постоянный черный экран или приводит к зависанию заставок GTA'''

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

:* '''MTA постоянно показывает черный экран после заставок GTA (иногда с тектстом в нижнем правом углу).'''

:Это может быть вызвано неподдерживаемостью DirectX или отсутсвием функций видеокарты, которые необходимы для запуска динамических меню. По умолчанию оно включено. Вы можете открыть [[coreconfig.xml]], который находится в директории ''GTA San Andreas\MTA'' и изменить параметр ''menu_options'' на ''248''.

==== Зависание после заставки MTA ====
:* '''После заставки 'Stop playing with yourself' ничего не происходит'''

:Еслы вы используете видеокарту nVidia GeForce, попробуйте в Desktop Manager отключить nView перед тем как запустить MTA.

:Также попробуйте удалить файл настроек ''gta_sa.set'' из папки ''Documents\GTA San Andreas User Files''

:Если ничего из этого не принесло успеху, а вы - пользователь Kaspersky Anti-Virus или Internet Security, задайте "multi theft auto.exe" статус "без ограничений". Другие антивирусы тоже могут не давать MTA запускаться.

==== Вылет после заставки MTA ====
:* '''MTA вылетает после заставки 'Stop playing with yourself'. Одиночная игра и MTA: Race раньше работали прекрасно.'''

:Загрузите последнюю версию DirectX с сайта [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 Microsoft]. Также удостоверьтесь через "Диспетчере задач", что процесс ''gta_sa.exe'' не запущен.

:Если вы работаете с нестандартными разрешениями экрана (напр. 960x720), то попробуйте использовать стандартные разрешения (напр. 640×480, 800×600, 1024×768, 1152×864, 1280×1024). Для этого запустите Grand Theft Auto: San Andreas в нормальном режиме, установите нормальное разрешение и выйдите.

:Если вы пользуетесь Windows Vista или 7, попробуйте слудующее:
:* Включите режим совместимости с Windows XP SP3 для обеих Multi Theft Auto.exe и gta_sa.exe, установив флаг "Запускать от администратора".
:* Задайте правило предотвращения исполнения данных: Используйте настройку ''Включить DEP для всех программ и служб кроме выбранных ниже''. Нажмите ''добавить'', отыщите "Multi Theft Auto.exe" и "gta_sa.exe", а затем добавьте их.
:* Запустите MTASA от администратора.

==== "Data files have been modified" ====
:* '''При запуске вы получаете ошибку "San Andreas data files have been modified"'''
Вы можете починить это благодаря установке данного [http://updatesa.mtasa.com/sa/files/GTASA-data-1.0.4.exe патча]. Если не поможет, переустановите GTA: San Andreas.



==== Вылет при попытке подключения к любому из серверов ====
:* '''MTASA вылетает во время подключения в серверу. Одиночная игра нормально работает.'''

:Моды на GTA в одиночной игре потенциально могут служить причиной краша MTA:SA, поэтому всегда следует использовать чистую GTASA для MTA:SA.

:Такое может возникать и при чистой установке, когда исполняемый файл GTASA неподдерживаемой MTA:SA версии (напр. 1.0 German или Australian). Чтобы починить это, используйте [http://forum.multitheftauto.com/viewtopic.php?f=89&t=15151 наш конвертер].

==== Не работает клавиатура ====
:* '''Мои средства ввода не работают.'''

:Введите в консоль (F8) команду 'copygtacontrols'.

==== Неправильные модели ====
:* '''Жeнские модели выглядят некрасиво / Я наблюдаю непонятные, паукообразные модели игроков.'''

:Это связанно со способом обращения GTA к игровым параметрам. Чтобы исправить это, убедитесь, что параметры жира и мускул установлены на 0 при смене скина.

==== Неправильно работает стрельба из авто ====
:* '''Стрельба из авто не такая, как должна быть'''

:Транспорт изменен сервером в зависимости от игрового мода на сервере.

==== Не сохраняются настройки ====
:* '''Мои настройки MTA не были сохранены и из-за этого произошел вылет'''

:После изменения параметров попробуйте сразу выйти из MTA, настройки должны сохраниться. Также попробуйте удалить ''coreconfig.xml'', а потом снова настройте MTA.

==== Проблемы с геймпадами ====
:* '''MTA не может распознать геймпад'''

:Для начала удостоверьтесь, что ваш геймпад - первый контроллер, распознанный Windows (MTA будет использовать только первый). Вы можете настроить геймпад через Settins в главном меню MTA.

==== Не работает мышь ====
:* '''MTA не определяет мышь'''

:Некоторые люди испытывают проблемы в мышью в MTA. Они могут пользоваться ею в главном меню, подключиться к серверу, но позже - нет.
:Проблема решается следующими способами: войдите на сервер, нажмите кнопку Win (флажок) на клавиатуре, затем нажмите на левую кнопку мыши.
:Если это не помогло, зайдите в одиночную игру и в настройках укажите управление мышь+клавиатура вместо джойстика.

==== Список серверов не работает ====
:* '''Игровой список серверов все время показывает "Loading" и ничего более '''

:В зависимости от типа и скорости вашего интернет-соединения может понадобиться некоторое время для загрузки списка серверов. Пожалуйста, подождите немного.

:В Settings>Advanced можно также задать способ своего соединения (Very Slow, Slow, Fast).

:Если и это не помогает, вы можете залогиниться в [http://www.game-monitor.com/search.php?game=mta GameMonitor], кликнуть зеленую иконку play, чтобы сыграть на том сервере.

==== Неверный серийный номер ====
:* '''Я вижу ошибку 'Invalid serial number' при загрузке игры'''

:Вы используете старую версию Multi Theft Auto. Загрузите последнюю со [http://www.mtasa.com/ страницы загрузки].

==== 'Network module not compatible!' при запуске MTA ====
:* '''Я вижу ошибку 'Network module could not be located' при загрузке MTA:SA DM

:Это может означать, что ваша установка MTA:SA прошла не полностью или сломалась. Переустановите MTA.

==== 'No such mod installed (deathmatch)' ====
:* '''Я вижу ошибку 'No such mod installed (deathmatch)' при попытке подключится к любому серверу

:'''Решение 1:''' Просто переустановите MTA. <br>
:'''Решение 2:''' Запускайте и ''gta_sa.exe'', и ''Multi Theft Auto.exe'' с правами Администатора системы.

==== D3dx9_**.dll не был найден ====
:* '''Когда я запускаю Multi Theft Auto: San Andreas, я вижу ошибку D3dx9_**.dll (** = это номер) не был найден.

:Это значит, что у вас стоит более старая, чем DirectX 9, версия.
:Скачайте/улучшите ваш DirectX через [http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 DirectX End-User Runtime Web Installer] с сайта Microsoft.

==== CRC mismatch ====
:* '''Когда захожу на сервер, в чате вижу 'CRC mismatch'
:Это проблема сервера. Скажите владельцу сервера, чтобы посетил серверную версию данной страницы.

==== 'Error loading network module!' при запуске ====
* Полный текст ошибки:
:''Error loading network module! (The application has failed to start because its side-by-side configuration is incorrect. Please see the application event log for more detail.''

:Убедитесь, что у вас установлены Microsoft Visual C++ 2008 и SP1 redistributable (x86):

:[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=9b2da534-3e03-4391-8a4d-074b9f2bc1bf Microsoft Visual C++ 2008 Redistributable package (x86)]

:[http://www.microsoft.com/downloads/ru-ru/details.aspx?familyid=a5c84275-3b97-4ab7-a40d-3802b2af5fc2 Microsoft Visual C++ 2008 SP1 Redistributable package (x86)]

==== Антивирус ругается на MTA:SA ====
:* '''Антивирус предупреждает вас, что ваша установелнная MTA или ее установщик - вирусы'''
:MTA '''НЕ''' содержит никаких вирусов, вредноносных, рекламных или шпионских программ. Снова скачайте MTASA [http://mtasa.com отсюда], если сомневаетесь в том, что ваша копия - оригинальная.

==== Процесс закачки больших карт застапаривается ====
:* '''Во время закачки больших карт, процесс зачастую останавливается, но сам поток информации при этом идет'''
:Этот баг исправлен в [http://forum.mtasa.com/viewtopic.php?f=31&t=39555#p402093 MTA:SA 1.3].

=== Проблемы с Windows Vista® ===

==== Вылет при загрузке ====
:* '''Кажется, я вылетаю во время подсоединения к серверу как раз перед тем, как зайти в игру, на Vista'''

:Скорее всего, это проблема Microsoft DirectX April 2006 SDK Redistributable DLL файла (d3dx9_30.dll), когда запуск идет в режиме совместимости. Пожалуйста, убедитесь, что режим совместимости полностью выключен у '''обеих''' исполнительных файлов: GTA_SA.exe и Multi Theft Auto.exe.

==== Clock manipulation error ====
:* '''Я вижу ошибку 'Clock manipulation detected!' при запуске MTA:SA DM

:Это может быть вызвано неправильно установленными датой/временем (из-за неправильных настроек или севшей батарейки на материнской плате компьютера). Установка времени и даты должны помочь.

:Это также может происходить, если вы используете процессор AMD Athlon 64 X2 с некоторыми старыми драйверами. Обновите их на [http://support.amd.com/us/Pages/drivers.aspx сайте AMD].

==== Зависание при запуске ====
:* '''Когда я запускаю MTA:SA 1.x, ничего не происходит (GTA_SA.exe работает, но не загружается)

:Запустите MTA:SA 1.x с правами Администатора системы. Чтобы это сделать, щелкните правой кнопкой мыши на установщике MTA, выберите "Свойства", там - вкладку "Совместимость" и отметьте самую нижнюю галочку, затем попытайтесь установить MTA снова.

==== Общие Проблемы с GTA ====
:* '''У меня необъяснимые проблемы и сбои с GTA'''

Убедитесь, что ваш компьютер удолетворяет [[RU/Deathmatch_Client_Manual#Системные требования| минимальным требованиям]] для работы GTA: San Andreas, а также, что вы не работаете в режимах совместимости 98/2000/XP/2003.

:Также посетите следующие страницы:
:* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502
:* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista

==== Сбои в производительности с Sandy Bridge / вторым поколением процессоров Intel Core ====
:* '''Медленная производительность MTA на процессорах Sandy Bridge, когда другие игры и одиночная игра San Andreas нормально работают.'''
:Это, похоже, ошибка комбинации профиля энергопотребления Windows в режиме энергосбережения, вы можете обойти это проблему, выставив режим "высокая производительность", когда играете в MTA:SA.
:* Тема об этой проблеме: [http://forum.mtasa.com/viewtopic.php?f=104&t=31745 Sandy Bridge performance issues?]

== Сервер ==

=== Общее ===
==== Неустранимая ошибка 3 ====
:* '''Я вижу ошибку ''Fatal Error 3'' всякий раз при попытке подключения к своему серверу'''

:Эта ошибка случается, когда сервер, с которым Вы пытаетесь соединиться, неспособен предоставить Вам необходимые загрузки, потому что у него выключен http. Убедитесь, что параметр '''httpdownload''' в конфиге сервера установлен на '''1'''.

==== Ошибка закачки 9: Ошибка при загрузке запрошенных файлов ====
:* '''Я вижу ошибку ''Download Error 9: Error downloading requested files'' всякий раз при попытке подключения к своему серверу'''

:Это происходит, если сервер не может дать вам правильную ссылку, что приводит к HTTP ошибке 404 (Not found).

:* Если вы используете built-in (встроенный) сервер (значение '''httpserver''' установлено на '''1''' и '''httpdownloadurl''' пуст), убедитесь, что ваш HTTP-сервер доступен (вы можете подключиться к нему с помощью браузера) для всех.

:* Если вы настроили внешний веб-сервер ('''httpdownloadurl''' установлен на ваш URL), убедитесь, что ваш HTTP доступен и что вы прочли [[RU/Server_Manual#Настройка внешнего веб-сервера | инструкцию по настройке внешнего веб сервера]].

==== CRC mismatch ====
:* '''Когда люди заходят на мой сервер, в их чате появляется 'CRC mismatch'
:CRC mismatch возникает, если:
:* Либо файлы ресурса были изменены, но сам ресурс перезапущен/обновлен не был,
:* Либо используется внешний http сервер и файлы не синхронизированы

==== Отсутствуют аккаунты ====
:Файл ''accounts.xml'' не используется, начиная с версии 1.0.4, его заменил файл с названием ''internal.db''. Чтобы убедиться, что информация о ваших старых аккаунтах переместилась из одной базы в другую:
:*Остановите сервер
:*Убедитесь, что ваш старый ''accounts.xml'' исправен
:*Удалите ''internal.db''
:*Запустите сервер

==== Отсутствуют ресурсы ====
:Начиная с 1.0.4, имена ресурсов не могут содержать символ точки.

==== Ошибка закачки 28 ====
:(Download error 28)<br>
:Выключите ваш антивирус и фаерволл. Если это сработало, попробуйте добавить исключение в ваш фаерволл, чтобы разрешить в нем ваш http порт.

==== Пропадают аккаунты ====
:Информация об аккаунтах (или чем-либо еще) не сохраняется из-за повреждения базы данных. Начиная с билда 2836, сервер проверяет целостность файлов баз данных sqlite при старте. Если там сообщается о database error (ошибке базы данных), подалуйста, прочитайте, [[RU/How to repair the database files | как восстановить файлы баз данных]].
:Если вы используете более раннюю версию и испытываете проблемы с пропажей аккаунтов, вам следует обновить сервер до [http://nightly.multitheftauto.com/ последнего билда].

=== Windows ===
:Нет вопросов по {{Current Version|full}}.

=== Linux ===
====Стандартный nohup создает очень большой nohup.out====

:Временный фикс: отключите файл nohup ('nohup ./mta_server > /dev/null &').

[[de:Known Issues - FAQ]]
[[en:Known Issues - FAQ]]
[[es:Problemas Conocidos - FAQ]]
[[it:Bugs noti e FAQ]]
[[pt-br:Soluções de Problemas - FAQ]]

[[Category:Support]]

RU/Resource:Editor/EDF

2012-07-04T13:50:02Z

Vincent: /* Специальные */

{{RU/Resource page}}
__NOTOC__
EDF означает ''Editor Definition File'' (файл-описание редактора; формат объявлений редактора). EDF'ы являются XML-файлами с расширением .edf, которые описывают специфические элементы, используемые ресурсом: новые типы элементов, которых самих по себе в MTA нет. Образцами служат <spawnpoint> (спавн), <flag> (флаг), <checkpoint> (чекпоинт) и т.д. Они также используются для того, чтобы устанавливать настройки, используемые модами (gamemode), эти настройки находятся под тегом <settings> внутри ''meta.xml'' ресурса.

==Вступление==
Некоторые ресурсы используют специфические элементы карты. Например, мод захвата флага (CTF) скорее всего будет использовать элементы <flag>, которые будут содержать позиции флагов и их принадлежность командам. Когда загружается карта, мод ищет любые элементы <flag> и соответствующе расставляет флаги - например, через создание объекта флага и его коллизии.

Проблема с этими специфическими элементами в том, что в отличие от встроенных в MTA элементов, редактор карт не понимает, что они из себя представляют. Как должен быть визуально представлен собой элемент <flag>? Какие у него есть характеристики? Без передачи редактору этой информации, вы не сможете использовать его для создания таких специфических элементов, и вам придется прибегнуть к ручному редактированию .map-файла через текстовый редактор. К счастью, это необязательно: любой ресурс может содержать editor definition file, который опишет специфические элементы карты, используемые ресурсом.

==Использование definition files в редакторе==
Как и описано в [[RU/Resource:Editor|главной инструкции по редактору]], чтобы иметь возможность создавать специфические элементы ресурса на вашей карте, вам придется его добавить в окне ''Definitions''. Нажмите кнопку ''Definitions'' в главном меню и дважды щелкните по ресурсу из левого списка. Затем закройте окно и крутаните колесиком мыши в панели элементов, пока не появится желаемый ресурс. С этого момента вы можете создавать и управлять специфическими элементами этого ресурса, как и любым другим элементом.

==Построение EDF-файлов==
EDF-файлы - просто XML-файлы с расширением .edf. Начнем с образца: EDF'а мода Capture the Orb.

<syntaxhighlight lang="xml">
<def name="Capture the Orb">
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="0.5" type="corona" color="#ffff00ff" />
</element>
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="3" type="cylinder" color="#9370dbaa" />
</element>
<element name="spawnpoint" friendlyname="Spawnpoint">
<object editorOnly="true" model="3092" posZ="1" />
<data name="position" type="coord3d" default="0,0,0" />
<data name="rotation" type="coord3d" default="0,0,0" />
<data name="skin" type="skinID" default="0" />
</element>
</def>
</syntaxhighlight>

Как вы уже убедились, синтаксис очень легок для понимания. Root element (корневой элемент), <def>, содержит несколько <element>. Каждый из этих <element> описывает специфический элемент и задает его имя, визуальное представление и доступные ему настройки.

===Визуальное представление===

Каждый child node (дочерний узел) <element>, не являющийся <data>, отвечает за визуальное представление. Объектов, маркеров, пикапов и т.д. могут быть один или несколько. Для каждого элемента вы можете опционально задать позицию (posX, posY, posZ) и угол вращения (rotX, rotY, rotZ): они ''родственны'' с позицией и вращенем каждого отдельно взятого элемента. На примере Capture the Orb выше, если бы вы захотели создать spawnpoint на (30, 14, 3), редактор бы отобразил объект модели 3092 на координатах (30, 14, 4), потому что posZ объекта, равная 1, была бы сложена с координатой spawnpoint по оси z, равной 3.

===Настройки===

Настройки специфического элемента описаны в <data>. Имена некоторых настроек, такие как ''position'' и ''rotation'', особенные: они могут быть изменены при перемещении и вращении элемента прямо в редакторе. Другие настройки могут быть изменены в окне Properties.

===Визуальное представление, зависимое от настроек===

Специфический элемент можно сделать зависимым от одной или более настроек другого элемента. Например, элемент <checkpoint> race мода, содержащий <marker>: checkpoint имеет несколько атрибутов, таких как color и size, которые должны быть отражены и в marker. Чтобы это сделать, укажите какой-либо из-них в виде ''!propertyname!'' в качестве как одного или более атрибутов зависимого элемента. Например:

<syntaxhighlight lang="xml">
<def name="Race">
<element name="checkpoint" friendlyname="Race checkpoint">
<data name="position" type="coord3d" required="true" default="0,0,0" />

<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" />
<data name="size" type="number" required="true" default="2.25"/>
<data name="color" type="color" required="false" default="#ff0000ff" />
...

<marker type="!type!" size="!size!" color="!color!" />
</element>
</def>
</syntaxhighlight>

Теперь, когда бы настройки checkpoint "type", "size" или "color" не менялись, новое значение будет также скопировано в его marker, в связи с чем их внешний вид будет меняться вместе.

===Интеграция в ресурсы===

Когда вы написали свой EDF, сохраните его как .edf-файл в папке своего ресурса и добавьте атрибут "edf:definition" в тег <info> meta.xml, как здесь:

<syntaxhighlight lang="xml">
<meta>
<info author="erorr404" type="gamemode" ... edf:definition="cto.edf" />
...
</meta>
</syntaxhighlight>

==EDF ссылки==

===Вшитые элементы===
Эти элементы могут использоваться для ваших специфических элементов, вкупе с их настройками.

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <blip>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|icon
| style="background-color: #EEE"|blipID
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <marker>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|markerType
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <object>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|objectID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <ped>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|skinID
|-
| style="background-color: #EEE"|rotZ
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <pickup>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|pickupType
|-
| style="background-color: #EEE"|amount
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|respawn
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <vehicle>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|vehicleID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|vehiclecolors
|-
| style="background-color: #EEE"|upgrades
| style="background-color: #EEE"|vehicleupgrades
|-
| style="background-color: #EEE"|plate
| style="background-color: #EEE"|plate
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <radararea>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|posX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|posY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

===Вшитые названия настроек===
Настройки с данными именами особенно воспринимаются редактором и могут быть изменены не только через окно Properties.
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Тип
|-
! style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
! style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|}

===Типы настроек===
Это - типы, которые могут быть выбранными в (<data>) ваших специфических элементов.

====Типы====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|boolean
| style="background-color: #EEE"|Простое двоичное (булевое) значение.
| style="background-color: #EEE"|"true" или "false"
|-
! style="background-color: #EEE"|natural
| style="background-color: #EEE"|Натуральное число (целое и неотрицательное).
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|integer
| style="background-color: #EEE"|Целое число.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|number
| style="background-color: #EEE"|Рациональное число.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|string
| style="background-color: #EEE"|Простая текстовая строка.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|color
| style="background-color: #EEE"|цвет, с или без указания прозрачности (alpha).
| style="background-color: #EEE"|#RRGGBB или #RRGGBBAA
|}

====Координаты====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|camera
| style="background-color: #EEE"|Позиция и угол обзора камеры.
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ
|-
! style="background-color: #EEE"|coord3d
| style="background-color: #EEE"|3-компонентный вектор, зачастую используемый для позиции и вращения.
| style="background-color: #EEE"|x,y,z
|}

====Транспорт====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|plate
| style="background-color: #EEE"|Текст номерного знака для транспортного средства.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehiclecolors
| style="background-color: #EEE"|цвета транспортного средства
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4
|-
! style="background-color: #EEE"|vehicleupgrades
| style="background-color: #EEE"|апгрейды (тюнинг) транспортного средства
| style="background-color: #EEE"|upgradeID1,upgradeID2,...
|}

====ID моделей====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|blipID
| style="background-color: #EEE"|ID картинки для метки
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|objectID
| style="background-color: #EEE"|ID модели для объекта
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|pickupType
| style="background-color: #EEE"|Броня, хп или оружие
| style="background-color: #EEE"|"armor", "health" или ID-номер оружия
|-
! style="background-color: #EEE"|skinID
| style="background-color: #EEE"|ID скина для педа
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehicleID
| style="background-color: #EEE"|ID модели для транспортного средства
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|weaponID
| style="background-color: #EEE"|Оружие, напр. M4
| style="background-color: #EEE"|ID-номер оружия, напр. 31
|}

====Колшейпы и маркеры====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|colshapeType
| style="background-color: #EEE"|коллизионные круг, куб, прямоугольник, сфера или труба
| style="background-color: #EEE"|Один из: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"
|-
! style="background-color: #EEE"|markerType
| style="background-color: #EEE"|Стрелка, чекпоинт, кольцо, цилиндр или круглый маркер.
| style="background-color: #EEE"|Один из: "arrow", "checkpoint", "corona", "cylinder", "ring"
|-
|}

====Специальные====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|element:type
| style="background-color: #EEE"|Элемент определенного типа, например: element:flag
| style="background-color: #EEE"|ID элемента
|-
! style="background-color: #EEE"|selection:val1,val2,...
| style="background-color: #EEE"|Показывает выпадающий список, из которого можно выбрать одно из значений.
| style="background-color: #EEE"|Выборное значение
|}

[[en:Resource:Editor/EDF]]

RU/Resource:Editor/EDF

2012-07-04T13:36:39Z

Vincent: /* EDF ссылки */

{{RU/Resource page}}
__NOTOC__
EDF означает ''Editor Definition File'' (файл-описание редактора; формат объявлений редактора). EDF'ы являются XML-файлами с расширением .edf, которые описывают специфические элементы, используемые ресурсом: новые типы элементов, которых самих по себе в MTA нет. Образцами служат <spawnpoint> (спавн), <flag> (флаг), <checkpoint> (чекпоинт) и т.д. Они также используются для того, чтобы устанавливать настройки, используемые модами (gamemode), эти настройки находятся под тегом <settings> внутри ''meta.xml'' ресурса.

==Вступление==
Некоторые ресурсы используют специфические элементы карты. Например, мод захвата флага (CTF) скорее всего будет использовать элементы <flag>, которые будут содержать позиции флагов и их принадлежность командам. Когда загружается карта, мод ищет любые элементы <flag> и соответствующе расставляет флаги - например, через создание объекта флага и его коллизии.

Проблема с этими специфическими элементами в том, что в отличие от встроенных в MTA элементов, редактор карт не понимает, что они из себя представляют. Как должен быть визуально представлен собой элемент <flag>? Какие у него есть характеристики? Без передачи редактору этой информации, вы не сможете использовать его для создания таких специфических элементов, и вам придется прибегнуть к ручному редактированию .map-файла через текстовый редактор. К счастью, это необязательно: любой ресурс может содержать editor definition file, который опишет специфические элементы карты, используемые ресурсом.

==Использование definition files в редакторе==
Как и описано в [[RU/Resource:Editor|главной инструкции по редактору]], чтобы иметь возможность создавать специфические элементы ресурса на вашей карте, вам придется его добавить в окне ''Definitions''. Нажмите кнопку ''Definitions'' в главном меню и дважды щелкните по ресурсу из левого списка. Затем закройте окно и крутаните колесиком мыши в панели элементов, пока не появится желаемый ресурс. С этого момента вы можете создавать и управлять специфическими элементами этого ресурса, как и любым другим элементом.

==Построение EDF-файлов==
EDF-файлы - просто XML-файлы с расширением .edf. Начнем с образца: EDF'а мода Capture the Orb.

<syntaxhighlight lang="xml">
<def name="Capture the Orb">
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="0.5" type="corona" color="#ffff00ff" />
</element>
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached.">
<data name="position" type="coord3d" default="0,0,0" />
<marker size="3" type="cylinder" color="#9370dbaa" />
</element>
<element name="spawnpoint" friendlyname="Spawnpoint">
<object editorOnly="true" model="3092" posZ="1" />
<data name="position" type="coord3d" default="0,0,0" />
<data name="rotation" type="coord3d" default="0,0,0" />
<data name="skin" type="skinID" default="0" />
</element>
</def>
</syntaxhighlight>

Как вы уже убедились, синтаксис очень легок для понимания. Root element (корневой элемент), <def>, содержит несколько <element>. Каждый из этих <element> описывает специфический элемент и задает его имя, визуальное представление и доступные ему настройки.

===Визуальное представление===

Каждый child node (дочерний узел) <element>, не являющийся <data>, отвечает за визуальное представление. Объектов, маркеров, пикапов и т.д. могут быть один или несколько. Для каждого элемента вы можете опционально задать позицию (posX, posY, posZ) и угол вращения (rotX, rotY, rotZ): они ''родственны'' с позицией и вращенем каждого отдельно взятого элемента. На примере Capture the Orb выше, если бы вы захотели создать spawnpoint на (30, 14, 3), редактор бы отобразил объект модели 3092 на координатах (30, 14, 4), потому что posZ объекта, равная 1, была бы сложена с координатой spawnpoint по оси z, равной 3.

===Настройки===

Настройки специфического элемента описаны в <data>. Имена некоторых настроек, такие как ''position'' и ''rotation'', особенные: они могут быть изменены при перемещении и вращении элемента прямо в редакторе. Другие настройки могут быть изменены в окне Properties.

===Визуальное представление, зависимое от настроек===

Специфический элемент можно сделать зависимым от одной или более настроек другого элемента. Например, элемент <checkpoint> race мода, содержащий <marker>: checkpoint имеет несколько атрибутов, таких как color и size, которые должны быть отражены и в marker. Чтобы это сделать, укажите какой-либо из-них в виде ''!propertyname!'' в качестве как одного или более атрибутов зависимого элемента. Например:

<syntaxhighlight lang="xml">
<def name="Race">
<element name="checkpoint" friendlyname="Race checkpoint">
<data name="position" type="coord3d" required="true" default="0,0,0" />

<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" />
<data name="size" type="number" required="true" default="2.25"/>
<data name="color" type="color" required="false" default="#ff0000ff" />
...

<marker type="!type!" size="!size!" color="!color!" />
</element>
</def>
</syntaxhighlight>

Теперь, когда бы настройки checkpoint "type", "size" или "color" не менялись, новое значение будет также скопировано в его marker, в связи с чем их внешний вид будет меняться вместе.

===Интеграция в ресурсы===

Когда вы написали свой EDF, сохраните его как .edf-файл в папке своего ресурса и добавьте атрибут "edf:definition" в тег <info> meta.xml, как здесь:

<syntaxhighlight lang="xml">
<meta>
<info author="erorr404" type="gamemode" ... edf:definition="cto.edf" />
...
</meta>
</syntaxhighlight>

==EDF ссылки==

===Вшитые элементы===
Эти элементы могут использоваться для ваших специфических элементов, вкупе с их настройками.

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <blip>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|icon
| style="background-color: #EEE"|blipID
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <marker>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|markerType
|-
| style="background-color: #EEE"|size
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <object>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|objectID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <ped>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|skinID
|-
| style="background-color: #EEE"|rotZ
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <pickup>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|type
| style="background-color: #EEE"|pickupType
|-
| style="background-color: #EEE"|amount
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|respawn
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <vehicle>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|model
| style="background-color: #EEE"|vehicleID
|-
| style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|vehiclecolors
|-
| style="background-color: #EEE"|upgrades
| style="background-color: #EEE"|vehicleupgrades
|-
| style="background-color: #EEE"|plate
| style="background-color: #EEE"|plate
|-
| style="background-color: #EEE"|interior
| style="background-color: #EEE"|integer
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

{| cellspacing="1"
! style="background-color: #EEE" colspan="2" | <radararea>
|-
! style="background-color: #EEE"|Атрибут
! style="background-color: #EEE"|Тип
|-
| style="background-color: #EEE"|posX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|posY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeX
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|sizeY
| style="background-color: #EEE"|number
|-
| style="background-color: #EEE"|color
| style="background-color: #EEE"|color
|-
| style="background-color: #EEE"|dimension
| style="background-color: #EEE"|integer
|}

===Вшитые названия настроек===
Настройки с данными именами особенно воспринимаются редактором и могут быть изменены не только через окно Properties.
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Тип
|-
! style="background-color: #EEE"|position
| style="background-color: #EEE"|coord3d
|-
! style="background-color: #EEE"|rotation
| style="background-color: #EEE"|coord3d
|}

===Типы настроек===
Это - типы, которые могут быть выбранными в (<data>) ваших специфических элементов.

====Типы====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|boolean
| style="background-color: #EEE"|Простое двоичное (булевое) значение.
| style="background-color: #EEE"|"true" или "false"
|-
! style="background-color: #EEE"|natural
| style="background-color: #EEE"|Натуральное число (целое и неотрицательное).
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|integer
| style="background-color: #EEE"|Целое число.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|number
| style="background-color: #EEE"|Рациональное число.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|string
| style="background-color: #EEE"|Простая текстовая строка.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|color
| style="background-color: #EEE"|цвет, с или без указания прозрачности (alpha).
| style="background-color: #EEE"|#RRGGBB или #RRGGBBAA
|}

====Координаты====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|camera
| style="background-color: #EEE"|Позиция и угол обзора камеры.
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ
|-
! style="background-color: #EEE"|coord3d
| style="background-color: #EEE"|3-компонентный вектор, зачастую используемый для позиции и вращения.
| style="background-color: #EEE"|x,y,z
|}

====Транспорт====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|plate
| style="background-color: #EEE"|Текст номерного знака для транспортного средства.
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehiclecolors
| style="background-color: #EEE"|цвета транспортного средства
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4
|-
! style="background-color: #EEE"|vehicleupgrades
| style="background-color: #EEE"|апгрейды (тюнинг) транспортного средства
| style="background-color: #EEE"|upgradeID1,upgradeID2,...
|}

====ID моделей====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|blipID
| style="background-color: #EEE"|ID картинки для метки
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|objectID
| style="background-color: #EEE"|ID модели для объекта
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|pickupType
| style="background-color: #EEE"|Броня, хп или оружие
| style="background-color: #EEE"|"armor", "health" или ID-номер оружия
|-
! style="background-color: #EEE"|skinID
| style="background-color: #EEE"|ID скина для педа
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|vehicleID
| style="background-color: #EEE"|ID модели для транспортного средства
| style="background-color: #EEE"| 
|-
! style="background-color: #EEE"|weaponID
| style="background-color: #EEE"|Оружие, напр. M4
| style="background-color: #EEE"|ID-номер оружия, напр. 31
|}

====Колшейпы и маркеры====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|colshapeType
| style="background-color: #EEE"|коллизионные круг, куб, прямоугольник, сфера или труба
| style="background-color: #EEE"|Один из: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"
|-
! style="background-color: #EEE"|markerType
| style="background-color: #EEE"|Стрелка, чекпоинт, кольцо, цилиндр или круглый маркер.
| style="background-color: #EEE"|Один из: "arrow", "checkpoint", "corona", "cylinder", "ring"
|-
|}

====Специальные====
{| cellspacing="1"
! style="background-color: #EEE"|Название
! style="background-color: #EEE"|Описание
! style="background-color: #EEE"|Значение
|-
! style="background-color: #EEE"|element:type
| style="background-color: #EEE"|Элемент определенного типа, например: element:flag
| style="background-color: #EEE"|The element's ID
|-
! style="background-color: #EEE"|selection:val1,val2,...
| style="background-color: #EEE"|Показывает выпадающий список, из которого можно выбрать одно из значений.
| style="background-color: #EEE"|Выбранное значение
|}

[[en:Resource:Editor/EDF]]

Anti-cheat guide

2012-07-03T17:28:45Z

Vincent:

=AC (anti cheat) guide=

==Server setup==

3 settings in [[Server_mtaserver.conf|'''mtaserver.conf''']] control AC behaviour for a server:

===<disableac></disableac>===
----
Comma separated list of disabled anti-cheats. This setting disables specific AC codes. AC codes are shown to the player when that detection has been triggered. Available codes are:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Code for <disableac>
! scope="col" style="background:#dfdfdf;"|Displayed on detect
! scope="col" style="background:#dfdfdf;"|Notes
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Classic health/armour hack detector
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Detects presence of trainer. Capital letters in the message are for tagging particular trainers
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Detects use of trainer.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Detects use of trainer incl.: player movement, health/damage, weapons, money, gamespeed, game cheats, aimbot
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Detects unauthorized mods. Capital letters in the message are for tagging particular items e.g. CLEO - Cleo detected, RENDER - Wall hack detected
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| More trainers
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Trainer
|}
<br/>
===<enablesd></enablesd>===
----
Comma separated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications. Competitive servers may wish to enable special detections, but most servers should leave this setting blank. Available codes are:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Code for <enablesd>
! scope="col" style="background:#dfdfdf;"|Displayed on detect
! scope="col" style="background:#dfdfdf;"|Notes
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Disallow custom D3D9.DLL
|}
<br/>
===<client_file name="data/carmods.dat" verify="0"/>===
----
By default, clients may not join a server if they have customized GTA:SA data files. Adding one or more of the above lines excludes files from validation. The file names that can be used are:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Note 1:''''' ''"data/maps" represents all the files and directories within "data/maps"''<br/>

'''''Note 2:''''' ''"data/handling.cfg" is not included as it is always ignored by MTA because of the internal vehicle handling functions. If you want to load custom handling.cfg files, you can achieve the same effect by using some resource I would imagine.''<br/>

==Client==
When joining a server, the server AC info is displayed in the client console (F8)<br/>
Example:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC contains the contents of the server setting from <disableac></disableac><br/>
Enabled SD contains the contents of the server setting from <enablesd></enablesd><br/>
Allowed client files contains numbers to indicate which client files the server allows to be modified. The numbers represent these files:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Using modified files====
If you want to use modified data files from your GTA:SA install directory, check this check box:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(check box only appears if your GTA:SA data files are customized)<br/>

Note that this will restrict your access to public servers as most do not allow customized data files.

[[Category: Support]]
[[ru:Anti-cheat guide]]

RU/Anti-cheat guide

2012-07-03T17:28:10Z

Vincent: Created page with "=Руководство по АЧ (АнтиЧиту)= ==Серверное устройство== Поведение античита на сервере контролирую..."

=Руководство по АЧ (АнтиЧиту)=

==Серверное устройство==

Поведение античита на сервере контролируют 3 настройки [[Server_mtaserver.conf|'''mtaserver.conf''']]:

===<disableac></disableac>===
----
Список отключенных античитов, разделенный запятыми. Данная настройка античита отключит АЧ определенных кодов. Коды АЧ показываются игроку при срабатывании соответствующих проверок. Доступные коды:

{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <disableac>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''1'''
| style="background:#f8f8f8;" align="center"|AC #1
| style="background:#f8f8f8;"|Обнаружитель классических хаков на хп/броню
|-
| scope="row" style="background:#efefef;" align="center"|'''4'''
| style="background:#f8f8f8;" align="center"|AC #4
| style="background:#f8f8f8;"|Обнаруживает присутствие трейнеров. Заглавные буквы в сообщении служат для отметки конкретных трейнеров
|-
| scope="row" style="background:#efefef;" align="center"|'''5'''
| style="background:#f8f8f8;" align="center"|AC #5
| style="background:#f8f8f8;"|Обнаруживает использование трейнера.
|-
| scope="row" style="background:#efefef;" align="center"|'''6'''
| style="background:#f8f8f8;" align="center"|VF #6
| style="background:#f8f8f8;"|Обнаруживает использование трейнера, влияющего на: передвижение игрока, хп/урон, оружие, деньги, скорость игры; также игровые читы, аимбот
|-
| scope="row" style="background:#efefef;" align="center"|'''8'''
| style="background:#f8f8f8;" align="center"|VF #8
| style="background:#f8f8f8;"|Обнаруживает посторонние моды. Заглавные буквы в сообщении служат для отметки конкретных модов, например, CLEO - обнаружен Cleo, RENDER - обнаружен воллхак
|-
| scope="row" style="background:#efefef;" align="center" rowspan="2"|'''11'''
| style="background:#f8f8f8;" align="center"|AC #11
| style="background:#f8f8f8;"| Еще трейнеры
|-
| style="background:#f8f8f8;" align="center"|VF #11
| style="background:#f8f8f8;"|Dll injector / Трейнер
|}
<br/>
===<enablesd></enablesd>===
----
Список включенных спецпроверок, разделенный запятыми. Специальная проверка - тип проверки античита на наличие (как правило) безвредных модификаций игры. Возможно, соревновательные сервера будут заинтересованы в использовании спецпроверок, но большинству серверов все же следует оставить это поле настроек пустым. Доступные коды:
{| border="0" cellpadding="1" cellspacing="2"
|-
! scope="col" style="background:#dfdfdf;"|Код <enablesd>
! scope="col" style="background:#dfdfdf;"|Отображается при обнаружении
! scope="col" style="background:#dfdfdf;"|Заметки
|-
| scope="row" style="background:#efefef;" align="center"|'''12'''
| style="background:#f8f8f8;" align="center"|SD #12
| style="background:#f8f8f8;"|Запрет на собственный D3D9.DLL
|}
<br/>
===<client_file name="data/carmods.dat" verify="0"/>===
----
По умолчанию клиенты могут не смочь присоединиться к серверу, если data-файлы их GTA:SA изменены. Добавление одной или более строк по образцу выше исключит файлы из списка проверяемых. Названия файлов, пригодных к использованию:<br/>
*"data/carmods.dat"
*"data/animgrp.dat"
*"data/ar_stats.dat"
*"data/melee.dat"
*"data/clothes.dat"
*"data/object.dat"
*"data/default.dat"
*"data/surface.dat"
*"data/default.ide"
*"data/gta.dat"
*"data/surfinfo.dat"
*"data/peds.ide"
*"data/vehicles.ide"
*"data/pedstats.dat"
*"data/water.dat"
*"data/txdcut.ide"
*"data/water1.dat"
*"models/coll/weapons.col"
*"data/weapon.dat"
*"data/plants.dat"
*"anim/ped.ifp"
*"data/furnitur.dat"
*"data/procobj.dat"
*"data/maps"
<br/>
'''''Заметка 1:''''' ''"data/maps" представляет все файлы и папки внутри "data/maps"''<br/>

'''''Заметка 2:''''' ''"data/handling.cfg" не учитывается, так как он игнорируется MTA в любом случае в связи со встроенным функционалом управления транспортом. Если вы хотите подгрузить собственные файлы handling.cfg, то аналогичный эффект можно достичь благодаря использованию соответствующего ресурса.''<br/>

==Клиент==
При подсоединению к серверу информация по АЧ сервера отображается в клиентской консоли (F8)<br/>
Пример:<br/>
Server AC Info: [Allowed client files: None] [Disabled AC: None] [Enabled SD: None]

Disabled AC содержит данные серверной настройки, указанные в <disableac></disableac><br/>
Enabled SD содержит данные серверной настройки, указанные в <enablesd></enablesd><br/>
Allowed client files содержит номера, указывающие на файлы, разрешенные клиенту сервером для модификации. Номера отвечают за следующие файлы:
*1 - "data/carmods.dat"
*2 - "data/animgrp.dat"
*4 - "data/ar_stats.dat"
*5 - "data/melee.dat"
*6 - "data/clothes.dat"
*7 - "data/object.dat"
*8 - "data/default.dat"
*9 - "data/surface.dat"
*10 - "data/default.ide"
*12 - "data/gta.dat"
*13 - "data/surfinfo.dat"
*14 - "data/peds.ide"
*15 - "data/vehicles.ide"
*16 - "data/pedstats.dat"
*17 - "data/water.dat"
*18 - "data/txdcut.ide"
*19 - "data/water1.dat"
*20 - "models/coll/weapons.col"
*21 - "data/weapon.dat"
*22 - "data/plants.dat"
*23 - "anim/ped.ifp"
*24 - "data/furnitur.dat"
*25 - "data/procobj.dat"
*26 - "data/maps"

====Использование модифицированных файлов====
Если вы хотите использовать модифицированные data-файлы из вашей папки с установенной GTA:SA, поставьте маркер маркер в:<br/>
Settings->Multiplayer->Use customized GTA:SA files
(маркер появляется только когда у вас изменены data-файлы GTA:SA)<br/>

Заметьте, что это ограничит ваш доступ к публичным серверам, так как большиснтво из них не приемлет измененные файлы данных.

[[Category: Support]]
[[en:Anti-cheat guide]]

RU/Radar blips

2012-07-02T14:47:40Z

Vincent:

Здесь указаны [[RU/Id|Id]] меток на радаре, которые можно использовать с [[createBlip]], [[createBlipAttachedTo]], [[getBlipIcon]] и [[setBlipIcon]].
{{Blip Icons}}

==Также смотрите==
[[RU/Id|Списки идентификаторов]]

[[Category:ID Lists]]

[[de:Radarsymbole]]
[[en:Radar Blips]]

RU/Element tree

2012-07-02T14:44:31Z

Vincent:

[[File:Tre.png|frame|Дерево элементов]]
MTA использует так называемое ''дерево элементов'' для хранения всех элементов, которые существуют на сервере и клиенте. Это напрямую связано с набором запущенных [[RU/Resources|ресурсов]] и XML-устройством их map-файлов, хотя все можно изменить скриптово прямо во время их работы.

Если вы знакомы с понятием ''деревьев'' в информатике, понять это не составит труда. Если же нет, представьте себе это в качестве генеалогического древа, за тем лишь исключением, что все имеют только по одному родителю. Каждый [[RU/Element|элемент]] имеет ''родительский'' элемент.

Все элементы, создаваемые внутри скриптов или через .map-файлы, являются дочерними элементами ресурса, которому они принадлежат. Таким образом, большинство элементов (за исключением [[client]]'ов) существуют только внутри ресурсов и уничтожаются сразу по остановке ресурса-родителя.

==Элементы дерева==
* '''root''': (корень) Он располагается в самом начале дерева - все элементы являются по отношении к этому элементу дочерними (или потомками).
* '''resource''': Это различные дочерние элементы root элемента - по одному на каждый ''запущенный'' ресурс. Этот элемент называется ''resource root'' (корень ресурса). Его ID содержит имя ресурса.
* '''map''': Каждый элемент ресурса содержит как минимум один map-элемент (карту), представляющий либо ".map"-файл ресурса, либо содержащий элементы, созданные скриптами (это называется ''динамической'' картой). Их ID содержат названия файлов-карт или ''dynamic'' в случае, если карта динамическая.
** Файлы карт могут содержать некоторые другие [[RU/Element|элементы]] с таким же успехом как и неограниченное количество своих собственных.

==Пример==
Это пример серверного дерева, выведенного в XML от запущенного сервера.
''Пожалуйста, заметьте, что в некоторых местах для целей обзора оно укорочено.''
<syntaxhighlight lang="xml">
<root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root>
</syntaxhighlight>
===Пояснение===
Это дерево состоит из некоторого количество элементов resource root, [[Element/Console|консоли сервера]] и двух элементов [[player]], которые являются непосредственными "детьми" элемета '''root'''. Все эти ресурсы в качестве дочернего элемента имеют ''динамическую карту'' (для большинства их она просто не показана). Она содержит элементы, динамически создаваемые ее ресурсом посредством скриптов, например, [[vehicle]] (транспорт). Если у ресурса еще есть и map-файл, то он тоже будет являться дочерним элементом и будет содержать в себе все элементы из .map-файла.

Давайте присмотримся к ресурсу '''assault''': Он содержит одну единственную ''динамеческую'' карту, которая в качестве дочерних элементов имеет 2 команды, 3 радарных метки, 1 маркер и 1 колшейп (colshape). Они и являются элементами, создаваемыми скриптово, например, маркер, колшейп и одна из меток возможно используются для обозначения цели.

Функция ресурса ''as-farm'', напротив, быть картой мода '''assault'''. Динамическая карта пуста (хотя она тоже могла бы содержать элементы при условии существования скрипта), но имеется map-файл, названный 'as-farm.map', содержащий некоторое количество элементов. Среди них большинство - собственные (такие как spawngroup, spawnarea, objective), но есть также немного элементов, создаваемых MTA автоматически после загрузки карты (pickup). В скобках после типа элемента вы можете видеть данные, которые он содержит. Они идентичны атрибутам внутри этих самых элементов в .map-файле, а в то же время вы можете устанавливать и получать данные любых других элементов (напр. типа "player", т.е. игроков) через [[setElementData]] и [[getElementData]].

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

===Присвоение элементам данных===
При вызове функции set... по отношении к узлу дерева элементов, она затронет каждый элемент внутри него (на котором она сработает).

Таким образом, следующий код установит размер всех маркеров (единственный тип элементов, с которым функция setMarkerSize может работать), находящихся ниже root элемента на ''2.5''.
<syntaxhighlight lang="lua">
setMarkerSize ( getRootElement(), 2.5 )
</syntaxhighlight>

То же самое можно сделать с любым элементом, это не ограничено root элементом.

===Map manager===
[[#Пример|Пример выше]] демонстрирует, как [[RU/Map manager|Map manager]] использует различные ресурсы. Ресурс 'assault' - мод, который управляет происходящим на сервере используя скрипты и, следовательно, посредством динамического создания элементов в дереве. При старте ресурса-карты мод получает [[RU:Resource|указатель ресурса]], ссылающийся на запустившийся ресурс - в данном случае это ''as-farm'' - из него вы можете запросить и сохранить элемент resource root. Используя данный элемент вкупе с такими функциями, как [[getElementsByType]], [[getElementData]] и различными другими, вы можете получить доступ к любой информации, загруженной в дерево через скрипты ресура-мода из файла 'as-farm.map'.

Другая вещь, связанная с деревом элементов, которой следует уделить внимание - тот факт, что при смене карты вам не нужно удалять какие-либо созданные вами внутри ресурса-карты элементы, но вам '''нужно''' удалять элементы, созданные внутри ресурса-мода, '''если''' они специфичны карте (что возможно и будет применимо к таким, которые вы создали, базируясь на информации, прочитанной из .map-файлов ресурса-карты).

==Element browser==
Вы можете запустить ресурс ''elementbrowser'', чтобы увидеть, как дерево элементов вашего сервера выглядит в данный момент. Просто запустите ресурс, в браузере зайдите на веб-страницу вашего сервера и выберите опцию ''Element browser'' в боковой панели (на данный момент только в firefox).

[[Category:Scripting Concepts]]
[[en:Element tree]]
[[es:Árbol de elementos]]

Category:Элемент

2012-07-02T14:40:15Z

Vincent:

'''Element''' (элемент) - общий класс, представляющий почти все внутриигровые [[entity|субъекты]]. Встроенные типы элементов:

''Примечание: у многих статей из списка ниже также имеется русская версия''

{{Elements}}

Любой другой тип элементов может быть создаван как абстрактный элемент, без ссылки на различные игровые [[entity|субъекты]]. Например, элементы '''resource''' и '''map''' создаются при загрузке ресурсов и карт соответственно, их цель - группировка создаваемых ими же субъектов, которые являются по отношении к ним дочерними.

Доступны такие обыденные функции, как запрос типа элемента и списка элементов определенного типа, операция уничтожения для удаления элемента и игровых субъектов, с которыми он связан (за исключением некоторых неуничтожаемых, например, элементов client), хранение и запрос [[element data|данных элементов]], и многие другие характерные операции.

Все элементы хранятся внутри [[RU/Element tree|древовидной структуры]], и в сущности каждый элемент, отличный от '''root''', имеет родительский элемент, который может являться элементами '''root''' (корень), '''resource''', '''map''' или другими. Это сделано сугубо для возможности определения сферы действия вызываемой функции.

==Связанные функции скриптинга==
===Клиентские===
{{Client element functions}}
===Серверные===
{{Element functions}}
[[Category:Scripting Concepts]]

[[en:Element]]
[[es:Elemento]]
[[it:Elemento]]