https://wiki.multitheftauto.com/api.php?action=feedcontributions&feedformat=atom&user=DivineMulti Theft Auto: Wiki - User contributions [en]2026-05-04T23:07:07ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=Element/Marker&diff=22459Element/Marker2010-02-22T12:59:48Z<p>Divine: </p>
<hr />
<div>__NOTOC__<br />
The marker class represents colored, 3D shapes in the GTA world. There are serveral types of markers, including cylinders and checkpoints. In scripts, markers are often used to mark spots and trigger some sort of action when a player goes into them.<br />
<br />
The element type of this class is '''"marker"'''.<br />
<br />
The size of the marker cannot be specified from XML and defaults to 4.0.<br />
<br />
==XML syntax==<br />
<syntaxhighlight lang="xml"><br />
<marker posX="" posY="" posZ="" type="" .../><br />
</syntaxhighlight><br />
<br />
===Required Attributes===<br />
* '''posX''': A float representing the X position of the pickup.<br />
* '''posY''': A float representing the Y position of the pickup.<br />
* '''posZ''': A float representing the Z position of the pickup.<br />
<br />
===Optional Attributes===<br />
* '''type:''' The visual type of the marker to be created. Possible values:<br />
{{Marker types}}<br />
* '''color:''' The color of the marker in HTML style format #RRGGBB, defaults to red if not specified.<br />
<br />
==Related scripting functions==<br />
{{Marker functions}}<br />
[[Category:Element Types]]<br />
<br />
[[it:Elemento/Marker]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:RU/Elements&diff=21923Template:RU/Elements2009-11-12T19:28:54Z<p>Divine: </p>
<hr />
<div>* [[Element/Player|Игрок]]<br />
* [[Element/Ped|Бот]]<br />
* [[Element/Vehicle|Транспорт]]<br />
* [[Element/Object|Объект]]<br />
* [[Element/Pickup|Пикап]]<br />
* [[Element/Marker|Маркер]]<br />
* [[Element/Collision shape|Форма]]<br />
* [[Element/Blip|Метка]]<br />
* [[Element/Radar area|Radar area]]<br />
* [[Element/Projectile|Projectile]]<br />
* [[Element/Team|Команда]]<br />
* [[Element/Console|Консоль сервера]]<br />
* [[Element/Admin|Удаленный админ]]<br />
* [[GUI widgets]]:<br />
<ul>{{GUI_widgets}}</ul><br />
* [[Element/TXD|TXD]]<br />
* [[Element/DFF|DFF]]<br />
* [[Element/COL|COL]]<br />
* [[Element/Sound|Sound]]<br />
<noinclude><br />
[[en:Template:Elements]]<br />
</noinclude></div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Deathmatch_Client_Manual&diff=21653RU/Deathmatch Client Manual2009-10-03T11:48:53Z<p>Divine: moved RU/Deathmatch Client Manual to RU/Client Manual</p>
<hr />
<div>#REDIRECT [[RU/Client Manual]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Client_Manual&diff=21652RU/Client Manual2009-10-03T11:48:53Z<p>Divine: moved RU/Deathmatch Client Manual to RU/Client Manual</p>
<hr />
<div>__TOC__<br />
<br />
==Введение==<br />
Multi Theft Auto: San Andreas является самым последним мультиплеером из всех мультиплееров, созданных поклонниками игр Grand Theft Auto (только PC версий). Для получения информации о мультиплеерах для игр GTA3 и Vice City, посетите [http://www.multitheftauto.com/ http://www.multitheftauto.com]. Эта модификация не является официально поддерживаемой Rockstar Games и Take 2 Interactive.<br />
<br />
Обратите внимание на то, что клиентское приложение MTA:SA Deathmatch находится на стадии бета-тестирования, что означает приложение может аварийно завершать работу или являться причиной возникновения неожиданных результатов.<br />
<br />
==Перед началом установки==<br />
<br />
Перед тем, как установить Multi Theft Auto: San Andreas, сначала убедитесь в том, что для игры GTA:SA не установлены какие-либо модификации. Они могут явиться причиной неправильной работе MTA. Если вы желаете оставить в игре режим одного игрока, вы можете повторно установить San Andreas в другую директорию на жестком диске.<br />
<br />
Также убедитесь, в том что у вас установлена одна из следующих операционных систем '''Windows XP''', '''Windows 2000''', '''Windows Vista''' или '''Windows Server 2003''' и что системные требования вашего компьютера соответствуют требованиям работы игры в одиночном режиме. обратите внимание на то, что если запускаете одиночный режим игры на компьютере обладающем минимальными системными требованиями, вы будете испытывать некоторые замедления в работе MTA, вызванные высокой загрузкой процессора.<br />
<br />
'''Обратите внимание: MTA:SA работает только с GTA:SA EXE v1.0.''' Если вы приобрели игру недавно, то возможно у вас более поздняя версия игры.<br />
<br />
Если у вас возникли ошибки в работе мультиплеера, убедитесь в том, что они описаны на странице [[Known_Issues_-_FAQ|Известные ошибки]], или свяжитесь с нами по IRC каналу по адресу irc://irc.multitheftauto.com/mta<br />
<br />
===Системные требования===<br />
Минимальные системные требования компьютера для Multi Theft Auto: San Andreas незначительно отличаются от системных требований игры Grand Theft Auto: San Andreas.<br />
* процессор класса Intel Pentium 4 или AMD Athlon XP<br />
* 512МБ ОЗУ<br />
* Установленная без модификаций игра Grand Theft Auto: San Andreas версии 1.0 или 1.1 (американская или европейская)<br />
* 3.7ГБ свободного места на жестком диске (3.6ГБ для установки Grand Theft Auto)<br />
* видеокарта семейства nVidia GeForce 4 или ATI Radeon 8xxx с 64MB ОЗУ и поддержкой DirectX 9.0<br />
* звуковая карта или кодек с поддержкой DirectX 9.0<br />
* клавиатура и мышь<br />
* широкополосный доступ в интернет для стабильной игры через сеть<br />
<br />
Для дополнительных возможностей игры рекомендуется использовать видеокарту, имеющую поддержку пиксельных шейдеров версии 2.0 (видеокарта семейства nVidia GeForce FX или выше, ATI Radeon 9xxx или выше).<br />
<br />
Для быстрой загрузки игры рекомендуется использовать больший объем оперативной памяти.<br />
<br />
==Установка игры==<br />
<br />
'''Этот раздел имеет смысл читать после того, как у вас будет установочный файл мультиплеера'''<br />
<br />
# Если у вас его нет, то перейдите на сайт http://www.mtabeta.com, зарегистрируйтесь и скачайте установщик клиентского приложения MTA:SA.<br />
# Запустите установочный файл. Вы увидите диалоговое окно приветствия, затем прочитайте Лицензионное соглашение с конечным пользователем (EULA). Вы должны быть согласны с условиями лицензионного соглашения для продолжения установки.<br />
# Далее вам будет необходимо выбрать один из трех вариантов: создать учетную запись, использовать уже имеющуюся учетную запись или не использовать учетную запись. После этого возможны два варианта продолжения установки.<br />
<br><br />
'''Выбран первый вариант: создать учетную запись'''<br><br />
Выполните создание новой учетной записи на MTABeta.com, после чего введите ваш логин и пароль в окно программы установки<br><br />
'''Выбран второй вариант: использовать уже имеющуюся учетную запись'''<br><br />
Введите данные учетной записи в программу установки<br />
<br><br><br />
# Затем вам будет необходимо выбрать компоненты для установки.<br />
#* '''Client''' интерфейсы игры, является обязательным компонентом.<br />
#* '''MTA Server''' позволяет вам использовать ваш собственный компьютер в качестве сервера.<br />
#* '''MTA Server > Editor''' используется для создания новых карт, является необязательным компонентом.<br />
# Затем вам необходимо выбрать директорию, в которую будет произведена установка. Вы качестве этой директории вы должны указать директорию, в которой установлена San Andreas. По умолчанию это: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Нажмите кнопку '''Install''' для выполнения установки.<br />
# После завершения установки, вам будет предложено запустить MTA: San Andreas. Выберите эту опцию по своему усмотрению и нажмите кнопку '''Finish'''.<br />
# Вы можете также запускать MTA:DM из меню Пуск, когда пожелаете.<br />
<br />
==Запуск игры==<br />
# Запустите Multi Theft Auto щелкнув левой кнопкой мыши по иконке расположенной на вашем рабочем столе или выбрав в меню Пуск пункт '''MTA:San Andreas'''.<br />
# Запуститься GTA: San Andreas и после загрузки игры вы увидите главное меню MTA:SA. Ниже показаны варианты меню:<br />
<br />
{| border="0" align="center"<br />
| width="188" |<br />
[[Image:MENU_QuickConnect.jpg]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – этот пункт позволяет вам соединиться с сервером, IP или URL адрес и порт которого вам уже известен. Этот вариант полезен, когда вы точно знаете, на каком сервере вы хотите играть и поэтому вам не нужно искать его в списке всех серверов.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_ServerBrowser.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – при выборе этого пункта отображается список доступных для игры серверов. </font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:Settings.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– это пункт позволяет вам сменить ваш nickname в игре, настроить управление и свойства дисплея.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_About.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– этот пункт позволяет вам посмотреть список участников проекта.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– этот пункт позволяет вам создавать собственные карты, контрольные точки, рампы, препятствия и другие объекты. Эти карты вы можете затем загрузить на сервер, чтобы вы могли играть на них с другими игроками.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– этот пункт позволяет вам выйти из игры на рабочий стол Windows.</font><br />
<br />
<br /><br /><br />
|}<br />
<br />
Простейшим способом начать игру - выбрать в меню пункт '''Browse Servers'''. Появится новое окно:<br />
<br />
<center>[[Image:MENU_ServerBrowser.jpg]]<br />'''Server Browser'''</center><br />
<br />
Если сервера не отображаются, нажмите кнопку '''Refresh''' и MTA просканирует сервера и отобразит их список.<br />
<br />
* В столбце '''Name''' отображается название каждого сервера.<br />
* В столбце '''Players''' отображается число игроков и максимально возможное число игроков на сервере, в формате [Имеющееся число игроков] / [Максимальное число игроков].<br />
* В столбце '''Ping''' отображается время задержки в миллисекундах между вашим компьютером и сервером. Время задержки - это время между моментом отправки вашим компьютером пакетов данных серверу и моментом получения ответного сообщения от сервера, поэтому чем больше время задержки, тем больше вы будете испытывать задержек в работе клиентского приложения с конкретным сервером. Обычно, сервера расположенные недалеко от вас по географическому местоположению должны иметь более низкое время задержки.<br />
* В столбце '''Host''' отображается IP адрес сервера. Вы можете использовать этот адрес для будущих соединений с этим же сервером посредством выбора пункта меню Quick Connect в главном меню.<br />
<br />
По каждому столбцу можно щелкать указателем мыши для упорядочивания значений столбца по возрастанию или убыванию.<br />
<br />
Для оптимальной работы приложения и процесса игры, выбирайте сервера с наилучшим балансом между числом игроков и временем задержки.<br />
<br />
После того как вы выбрали нужный вам сервер, выберите его строку списка и щелкните левой кнопкой мыши кнопку '''Connect''' в верхнем правом углу диалогового окна. Если процесс соединения будет выполнен успешно, вы соединиться с сервером и автоматически включиться в процесс игры.<br />
<br />
<!--===Запуск игры из ASE (The All-Seeing Eye)===<br />
<br />
Если вам не нравится встроенный в игру просмотр серверов MTA:San Andreas, вы можете захотеть использовать '''The All-Seeing Eye''', который позволит вам просмотреть список игровых серверов, и применить настраиваемые фильтры поиска. Этот учебник поможет вам установить ASE, и покажет как легко с ним работать.<br />
# Скачайте ASE по адресу http://videogames.yahoo.com/multiplayer и установите.<br />
# '''Следующее применимо к MTA:SA вплоть до версии 1.0 dp2, и будет скорее всего зафиксировано в дальнейшей версии''' <br /> Скачайте [http://www.xup.in/dl,19686489/ASELauncher.zip/ ASELauncher] и извлеките ASELauncher.exe в директорию, где установлен MTA (по умолчанию, это C:\Program Files\MTA San Andreas). Эта небольшая программа конвертирует командную строку ASE в формат понятный MTA. <br />
# Теперь добавьте MTA:SA в ваш список игр в ASE:<br />
#* В ASE щелкните левой кнопкой мыши ''Tools'' -> ''Options'', и выберите вкладку ''Games''<br />
#* Откройте категорию ''Not installed'' и выберите в списке ''Multi Theft Auto'' <br />
#* Выберите ''Visible in filter list'', щелкните ''Browse'' и выберите в '''ASELauncher.exe''' вашу директорию MTA San Andreas<br />
#* Оставьте поле ''Player name'' пустым, и нажмите кнопку ''OK''<br />
# Запуститься '''Multi Theft Auto'''. После того, как вы нажмете кнопку ''Refresh'' на панели инструментов, вы увидите список сервером для всех версий MTA. Теперь добавьте модификатор для того, чтобы отображалась текущая версия '''1.0 dp2'''<br />
#* Щелкните правой кнопкой мыши по ''Multi Theft Auto'' и выберите пункт ''New...''<br />
#* В нижнем левом углу выберите ''Modifier'' и замените MYMOD на '''MTADP2'''<br />
#* Введите название модификатора в поле ''Name'', например '''MTA:SA 1.0 dp2'''<br />
#* Вставьте следующий код фильтра (со строкой номера):<br /><tt>1 if version != "1.0dp2" remove</tt><br />
#* Щелкните ''OK''<br />
#* Ваш новый модификатор отображается в ''My filters''<br />
# Все готово! Теперь активируйте ваш модификатор для того, чтобы отображать только вашу версию игры, выберите игру ''Multi Theft Auto'', и дважды щелкните по строке, содержащей сервер, чтобы начать игру.<br />
--><br />
==Как играть==<br />
<br />
MTA:SA предоставляет полную систему написания сценариев, которая позволяет создателем игровых карт настраивать многие элементы игры различным образом, вплоть до создания своих собственных новых игровых режимов. Игра объединяет множество игроков, с некоторыми исключениями, отличающими многопользовательский режим от однопользовательского.<br />
<br />
В многопользовательской игре нет пешеходов и на дорогах нет машин, "искусственно" управляемых алгоритмами самой игры. Вашими оппонентами на игровой карте являются только другие игроки, или союзники если это карта командной игры. Вы можете общаться с ними используя окно чата, расположенное в левом верхнем углу экрана, нажав клавишу '''T'''. Чтобы переписываться только с игроками вашей команды, нажмите клавишу '''Y'''.<br />
<br />
Редактор карт MTA позволяет создателям карт добавлять различные объекты GTA в свои карты включая дороги, взрывающиеся баки, рампы, строения, возвышенности и так далее. Не только для этих, но и для других объектов могут быть написаны сценарии движения, модели изменения и исчезновения. Это позволит сделать игровой процесс более интересным и разнообразным. <br />
<br />
Окно просмотра игроков будет отображать очки, заработанные игроком. По умолчанию, отображаются только имена и время задержки, но сценарии могут добавить дополнительные столбцы, которые являются специфичными определенному режиму игры. Например, режим игры "deathmatch" может иметь столбец перечисляющий общее число убийств, но создатель карт может выбирать сам и добавить дополнительные колонки для числа смертей вашего персонажа, длительности вашей игры, а также поместить очки, заработанные вами.<br />
<br />
==Управление==<br />
<br />
===Клавиши управления в игре===<br />
<br />
* F8 (или клавиша "тильда") - Консоль<br />
* F9 - Помощь игрового сервера<br />
* F11 - Показать карту SA ''(следующий список клавиш используется при отображении карты)''<br />
**numpad +/- - Увеличить/уменьшить масштаб карты<br />
**numpad 4, 8, 6, 2 - переместиться влево, вверх, вправо, вниз по карте<br />
**numpad 0 - переключиться между режимами карты: закрепить карту за локальным игроком (карта следует за меткой игрока) и свободное передвижение (карта остается неподвижной) <br />
* F12 - Сделать снимок изображения экрана<br />
* T - Чат<br />
* Y - Командный чат<br />
* TAB - Список игроков (если ресурс [[Scoreboard]] запущен на сервере)<br />
<br />
==Команды консоли==<br />
<br />
'''bind defaults''' Сбросить настроийки управления на настройки по умолчанию<br />
<br />
Нажатие '''~ (тильда)''' или '''F8''' доступ к консоли, затем вводится команда, за которой при необходимости следуют параметры (если нужно) затем нажимается Enter.<br />
<br />
;'''maps''' :Отобразить список всех карт доступных на сервере. <br />
<br />
;'''nick [nickname]''' :Изменить nickname, отображаемый в игре на тот, который служит параметром в данной команде.<br />
<br />
;'''msg [nickname] [message]''' или '''pm [nickname] [message]''' :Отправить личное сообщение игроку, который определяется параметром [nickname]. Только игрок, определенный вами может увидеть это сообщение. И '''msg''' и '''pm''' выполняют одну и ту же функцию.<br />
<br />
;'''quit''' или '''exit''' :Выполнить разрыв связи с сервером и выйти из игры на рабочий стол Windows. Выполняет ту же функцию, что и кнопка Quit в главном меню.<br />
<br />
;'''ver''' :Отобразить номер версии и информацию об авторских правах программного обеспечения.<br />
<br />
;'''time''' :Отобразить текущее время.<br />
<br />
;'''disconnect''' :Разорвать соединение с игровым сервером и вернуться в главное меню.<br />
<br />
;'''say [text]''' :Позволяет вам продолжить общение с игроками через окно чата из консоли.<br />
<br />
;'''ignore [nickname]''' :Не отображать любой текст, введенный игроком, которого вы игнорируете. Чтобы отменить игнорирование сообщений игрока введите команду '''ignore [nickname]''' снова.<br />
<br />
'''Совет:''' Вы можете использовать эти команды непосредственно в окне чата, поместив перед ними / (слеш).<br />
<br />
Список команд консоли можно увидеть, введя в консоли команду '''help''' и нажав клавишу Enter. Любая карта может также иметь дополнительные команды, к которым вы можете получить доступ введя в консоли команду '''commands'''.<br />
<br />
==Коды ошибок и их описание==<br />
'''Ошибки загрузки'''<br><br />
0: UNKNOWN_ERROR<br><br />
1: INVALID_FILE_DESCRIPTORS<br><br />
2: INVALID_MAX_FILE_DESCRIPTOR<br><br />
3: INVALID_SELECT_RETURN<br><br />
4: INVALID_INITIAL_MULTI_PERFORM<br><br />
5: INVALID_MULTI_PERFORM_CODE<br><br />
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br><br />
7: UNEXPECTED_CURL_MESSAGE<br><br />
8: UNABLE_TO_CONNECT<br><br />
9: UNABLE_TO_DOWNLOAD_FILE<br><br />
10: FAILED_TO_INITIALIZE_DOWNLOAD<br><br />
<br />
'''Неустранимые ошибки'''<br><br />
1: no local player model on ingame event<br><br />
2: no local player on ingame event<br><br />
3: server downloads disabled<br><br />
4: no local player model on player-list packet<br><br />
5: no local player on player-list packet<br><br />
6: invalid custom data length on entity-add packet<br><br />
7: invalid bitstream data on entity-add packet<br><br />
8: system entity on entity-add packet<br><br />
9: failed to create object on entity-add packet<br><br />
10: failed to create pickup on entity-add packet<br><br />
11: failed to create vehicle on entity-add packet<br><br />
12: invalid team-name length on entity-add packet<br><br />
13: invalid lua-event name length in lua-event packet<br><br />
14: invalid resource name length in resource-start packet<br><br />
<br />
'''Ошибки типа 'Unable to enter vehicle''''<br><br />
1: script cancelled<br><br />
2: script cancelled (jack)<br><br />
3: current occupier is entering/exiting<br><br />
4: invalid seat<br><br />
5: not close enough<br><br />
6: already in a vehicle<br><br />
7: already entering/exiting<br><br />
8: invalid vehicle (trailer)<br><br />
<br />
[[de:MTA DM Client Anleitung]]<br />
[[es:Manual Cliente Deathmatch]]<br />
[[en:Deathmatch Client Manual]]<br />
[[it:Manuale del Client]]<br />
[[nl:Deathmatch Client Manual]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21651Главная страница2009-10-03T10:51:01Z<p>Divine: /* Скриптинг */</p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Введение====<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиенту]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверу]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]<br />
* [[Resource:mapmanager|Менеджер карт]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Скриптинг====<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
* [[Useful Functions|Полезные функции]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Разработка MTA====<br />
*[[Roadmap]]<br />
*[[Git Coding Guidelines]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21650Главная страница2009-10-03T10:48:30Z<p>Divine: /* Введение */</p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Введение====<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиенту]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверу]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]<br />
* [[Resource:mapmanager|Менеджер карт]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Скриптинг====<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Разработка MTA====<br />
*[[Roadmap]]<br />
*[[Git Coding Guidelines]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21649Главная страница2009-10-03T10:47:55Z<p>Divine: </p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Введение====<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиенту]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверу]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]<br />
* [[Resource:Editor|Редактор карт]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Скриптинг====<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Разработка MTA====<br />
*[[Roadmap]]<br />
*[[Git Coding Guidelines]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Deathmatch_Server_Manual&diff=21648RU/Deathmatch Server Manual2009-10-03T10:44:46Z<p>Divine: moved RU/Deathmatch Server Manual to RU/Server Manual</p>
<hr />
<div>#REDIRECT [[RU/Server Manual]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Server_Manual&diff=21647RU/Server Manual2009-10-03T10:44:46Z<p>Divine: moved RU/Deathmatch Server Manual to RU/Server Manual</p>
<hr />
<div>__TOC__<br />
<br />
==Начало==<br />
Установить и запустить ваш собственный сервер для сети интернет или локальной сети намного проще, чем вам могло показаться на первый взгляд. Следуйте указаниям, описанным в этой статье чтоб создать свой собственный MTA:SA DM сервер.<br />
<br />
==Установка сервера==<br />
В зависимости от платформы сервера имеется несколько вариантов серверного приложения MTA:SA DM.<br />
<br />
===Установка серверного приложения в операционной системе Linux===<br />
====Ubuntu====<br />
Ниже описывается установка серверного приложения в операционной системе(далее ОС) Ubuntu 6.05 LTS. Позже будут добавлены инструкции по установке серверного приложения на другие версии ОС Linux.<br />
Описываемая установка выполнялась в недавно установленной ОС, поэтому некоторые вещи будут устанавливаться впервые.<br />
Первоначально все ssh на вашем сервере используют любой клиент, который вы пожелаете.<br />
Некоторые предпочитают изменить это.<br />
Начните с ввода '''sudo apt-get upgrade'''. Вам потребуется ваш пароль снова. После выполнения обновления выполните<br />
'''sudo apt-get install pico'''. Это позволит вам легко выполнить установку, используя pico text editor, который вы будете использовать для редактирования файлов настройки.<br />
После выполнения установки, вам необходимо получить копию libcurl3 для сервера. Чтобы запустить установку введите '''sudo apt-get install libcurl3'''.<br />
Вам снова придется ввести ваш пароль. После этого необходимо получить серверное приложение для вашего сервера Linux. Имеется несколько способов сделать это. Вы можете получить установочный дистрибутив с ftp сервера. Вы можете использовать передачу файлов. Если вы знаете какой-либо веб-сайт, вы можете скачать файл с этого веб-сайта, используя команду '''wget http://wwww.websitename.com/file.tar''' Где в качестве адреса веб-сайта используйте адрес известного вам сайта. После получения необходимого tar файла, вам необходимо распаковать его, используя команду '''tar -zxvf filename.tar'''<br />
<br />
====Gentoo====<br />
Далее предполагается, что вы используете Gentoo и знаете как получить файлы с веб-сайтов для своего сервера... (в противном случае, читайте предыдущий пункт, посвященный Ubuntu)<br />
<br />
Ниже описаны действия для DP2:<br />
<br />
Обновите вашу версию gcc до 4.2.2:<br />
* уберите маску gcc в /etc/portage/package.unmask)<br />
* выйдите из gcc<br />
* перейдите к gcc 4.2.2: gcc-config i686-pc-linux-gnu-4.2.2<br />
Обновите вашу версию libstdc++ до 3.3 (если у вас еще не установлено это обновление)<br />
* выйдите из libstdc++<br />
Установите libcurl:<br />
* выйдите из libcurl<br />
Распакуйте mtasa, и запустите его...<br />
<br />
===Установка серверного приложения в операционной системе Windows===<br />
Установку серверного приложения MTA:SA DM в операционной системе Windows выполнить гораздо легче.<br />
*Перейдите на [http://mtasa.com/dp.html страницу загрузки] и найдите на странице раздел "Dedicated servers".<br />
*Нажмите на ссылку, предназначенную для ОС Windows.<br />
*После загрузки программы установки запустите её.<br />
*Выберете директорию, в которую вы хотите установить серверное приложение.<br />
*Нажмите кнопку Install.<br />
*На этом установка завершена!<br />
<br />
==Настройка сервера==<br />
Откройте в текстовом редакторе(например, Windows Notepad) файл ''''mtaserver.conf'''', расположенный в директории <SERVER>/mods/deathmatch.<br />
<br />
Этот файл удобно редактировать: каждая переменная имеет описание того, что с помощью нее можно изменить и какие значения она может принимать.<br />
<br />
===Добавление администраторов===<br />
''Для получения подробной информации об acl.xml (access control list) читайте: [[Access_Control_List|Access Control List]]''<br/><br/><br />
Чтобы добавить администраторов ваших игровых серверов выполните следующие шаги:<br><br />
<ol><br />
<li>Посмотрите ваши игровые сервера в директории 'deathmatch', открыв файл Accounts.xml</li><br />
<li>Добавьте новую учетную запись в файл, используя синтаксис описанный ниже<br />
<div style="padding: 10px"><br />
''''Синтаксис, используемый в файле Accounts.xml''''<br />
<syntaxhighlight lang="xml"><br />
<account name="Username" password="UserPassword" /><br />
</syntaxhighlight><br />
</div><br />
<li>Сохраните и закройте файл</li><br />
<li>Откройте файл acl.xml</li><br />
<li>Выберите один из следующих наборов прав администратора: Moderator, SuperModerator или Admin</li><br />
<li>В выбранную группу добавьте учетную запись, которую вы создали ранее, используя синтаксис описанный ниже<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<object name="user.Username" /><br />
</syntaxhighlight><br />
</div><br />
<br />
У вас должно получиться, что-то похожее на:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<group name="Admin"><br />
...<br />
<object name="user.Username" /><br />
</group><br />
</syntaxhighlight><br />
</div><br />
<br />
</li><br />
<li><br />
Добавление администратора завершено! Этим способом вы можете добавить необходимое вам количество администраторов, только остерегайтесь создания одинаковых учетных записей и одинаковых ACL прав.<br><br />
</li><br />
</ol><br />
'''Обратите внимание: 1)''' Изменение этих файлов вступят в силу только после перезапуска игрового сервера<br /><br />
'''2)''' Существует также другой способ добавления учетных записей и редактирования прав во время работы игрового сервера. Команда '''addaccount <user> <password>''' является встроенной командой для добавления учетных записей, позволяющей вам посредством веб интерфейса управлять ACL правами во время работы игрового сервера. (Этот способ может быть наилучшим для вас, если первый способ не работает)<br />
<br />
=== Настройка внешнего веб-сервера ===<br />
Из соображений производительности и стабильности работы лучше использовать внешний веб-сервер, вместо встроенного веб-сервера. Внешний веб-сервер должен быть доступен всем, чтобы любой пользователь мог скачать необходимые файлы ресурсов для клиентского приложения, а затем подключиться и играть на вашем игровом сервере.<br />
<br />
Чтобы разрешить скачивание ресурсов с внешнего веб-сервера, вы должны настроить теги ''httpdownload'' и ''httpdownloadurl'' в настройках вашего сервера:<br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload> <br />
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl><br />
</syntaxhighlight></div><br />
<br />
После того, как все сжатые файлы ресурсов будут загружены со специализированного сервера, они обычно автоматически распаковываются встроенным веб-сервером, теперь вы можете обеспечить способ для закачки клиентскими приложениями на компьютер несжатых файлов. Несжатые файлы обычно доступны в директории '''<SERVER>/mods/deathmatch/resourcecache'''.<br />
<br />
<ol><br />
<li>Запустите специализированный сервер и выйдите. После этого сжатые zip файлы распакуются в директорию '''<SERVER>/mods/deathmatch/resourcecache'''.</li><br />
<li>Перейдите в эту директорию и скопируйте ресурсы в доступную для других пользователей директорию вашего внешнего веб сервера. Это можно сделать следующими способами:<br />
<ul><br />
<li>Если вы не позаботитесь о том, чтобы '''файлы, размещенные на вашем сервере были доступны''': создайте символьную ссылку(Linux), соединение(Windows) или явную копию содержимого директории '''resourcecache''' в общедоступной директории вашего веб-сервера.</li><br />
<li>Если вы не хотите, чтобы файлы сервера были доступны остальным пользователям с вашего веб-сервера: перейдите в директорию '''resourcecache''' и вручную скопируйте директорию в директорию вашего сервера, доступную для других пользователей, удалите все файлы, предназначенные для сервера (они '''не''' нужны для скачивания клиентским приложениям) которые вы не хотите, чтобы были доступны с вашего веб-сервера.<br /><br />
<br /><br />
Более быстрый способ защиты ваших файлов, предназначенных для сервера в настоящее время недоступен. Инструментальное средство, автоматически копирующее только необходимые для клиентского приложения файлы всех ресурсов с вашего сервера, находится в разработке.<br />
</ul><br />
</li><br />
</ol><br />
<br />
'''Обратите внимание: 1)''' Пожалуйста избегайте использования любых специальных символов (например ~, !) в ваших адресах URL для скачивания файлов.<br/><br />
'''2)''' Пожалуйста не используйте слеш в конце ваших URL для скачивания(например, используйте ''hxxp://www.myserver.tld/directory'' вместо ''hxxp://www.myserver.tld/directory/'')<br />
<br />
==Запуск сервера==<br />
Перед запуском сервера убедитесь в том, что вы завершили все настройки сервера!<br />
<br />
Чтоб запустить серверное приложение MTA:SA DM, дважды щелкните указателем мыши по MTA Server.exe. Убедитесь в том, что брандмауэр или антивирус не ограничивают нормальный доступ MTA:SA DM к сети. Если все прошло удачно, то сервер нормально запущен и функционирует!<br />
<br />
==Установка/обновление файлов ресурсов на вашем сервере==<br />
Файлы ресурсов могут быть в двух форматах, либо в формате ZIP или в обычной директории, содержащей файлы сценариев. Серверное приложение MTA:SA DM поддерживает оба формата.<br />
<br />
# Переместите или скопируйте новые ресурсы в директорию <SERVER>\mods\deathmatch\resources.<br />
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.<br />
<br />
==Удаление ресурсов==<br />
Ресурсы могут быть легко удалены с вашего сервера, если они вам больше не нужны.<br />
<br />
# Удалите ZIP файл или директорию с ресурсами, которые вы хотите удалить<br />
# В окне серверного приложения введите команду "refresh" (без выхода из приложения). Это позволит приложению повторно просмотреть директорию с ресурсами и обновить их список при необходимости.<br />
<br />
==Администрирование сервера==<br />
Вы можете запустить ресурсы, введя команду "start resourcename" в консоли серверного приложения, или остановить их выполнение введя "stop resourcename".<br />
<br />
Также возможно выполнять эти и другие команды администратора в игровой консоле (которую вы можете открыть нажав клавишу ` или F8). Чтобы все это работало, вам сначала необходимо выполнить вход с помощью команды "login username password". Кроме того, вы можете нажать клавишу p для отображения панели администратора - это графический интерфейс, позволяющий вам легко наказать провинившихся игроков.<br />
<br />
Для получения информации о других командах, введите команду "help" в окне консоли.<br />
<br />
==Запуск игровой карты/режима игры==<br />
Смотрите раздел документации [[Resource:Map manager|mapmanager]] для получения более подробной информации.<br />
<br />
==Удаленное администрирование сервера==<br />
В этом разделе предполагается, что вы настроили работу учетной записи с правами пользователя 'Admin', и у вас имеются следующие ресурсы:<br />
# ResourceBrowser<br />
# ResourceManager<br />
# WebAdmin<br />
# WebMap<br />
<br />
Вы можете получить доступ к этим инструментам удаленного администрирования, посетив веб-ресурс <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> в вашем Firefox. <br />
'''Обратите внимание: Internet Explorer не работает, он не отображает браузер ресурсов, другие веб-браузеры (а именно Opera) будут смешивать результаты'''. Если вы хотите работать в Internet Explorer, то почуствуете неудобство при перекодировании ресурсов:)<br />
<br />
==Полезные заметки==<br />
<br />
# Вы также можете обновить ресурсы во время игры, введя команду "refresh" в окне консоли клиентского приложения или команду "/refresh" в окне чата. Это может привести к временным неудобствам, если имеется большое число ресурсов.<br />
# Во всех указаниях, описанных выше под <SERVER> понимался путь к главной директории вашего серверного приложения. В большинстве случаев это C:\Program Files\MTA San Andreas\server<br />
<br />
====Нужна дополнительная помощь?====<br />
Вы можете связаться с командой разработчиков на их [http://forum.mtasa.com/ форумах] или на [irc://irc.multitheftauto.com/mta IRC] каналах (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])<br />
<br />
[[de:MTA DM Server Anleitung]]<br />
[[en:Deathmatch Server Manual]]<br />
[[it:Manuale del Server]]<br />
[[nl:Deathmatch Server Manual]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21646Главная страница2009-10-03T10:41:49Z<p>Divine: </p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Введение====<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиенту]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверу]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы]]<br />
* [[Resource:Editor|Редактор карт]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Скриптинг====<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21645Главная страница2009-10-03T10:39:12Z<p>Divine: </p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Начало====<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиентской части MTA]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверной части MTA]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы MTA:SA DM]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
==Скриптинг==<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Client_Scripting_Events&diff=21643RU/Client Scripting Events2009-10-03T10:32:24Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
<pageclass class="client"></pageclass><br />
Здесь приведены все [[event|события]], выполняемые на '''клиентской стороне''', уже втроенные в мод. Для запроса функций или событий смотри [[Requested Functions and Events]].<br />
<br />
'''События серверной стороны можно найти здесь: [[RU/Server Scripting Events|События генерируемые на стороне сервера]]<br />
<br />
==Colshape events==<br />
{{Client_colshape_events}}<br />
<br />
==Element events==<br />
{{Client_element_events}}<br />
<br />
==GUI events==<br />
{{GUI_events}}<br />
<br />
==Marker events==<br />
{{Client_marker_events}}<br />
<br />
==Ped events==<br />
{{Client_ped_events}}<br />
<br />
==Player events==<br />
{{Client_player_events}}<br />
<br />
==Projectile events==<br />
{{Client_projectile_events}}<br />
<br />
==Resource events==<br />
{{Client_resource_events}}<br />
<br />
==Vehicle events==<br />
{{Client_vehicle_events}}<br />
<br />
==Other events==<br />
{{Client_other_events}}<br />
<br />
[[en:Client Scripting Events]]<br />
[[pl:Zdarzenia_po_stronie_klienta]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Client_Scripting_Events&diff=21642Client Scripting Events2009-10-03T10:30:37Z<p>Divine: We've no need "new feature" template anymore</p>
<hr />
<div><pageclass class="client"></pageclass><br />
This page lists all '''client-side''' scripting [[event]]s that have been implemented and are available in the Deathmatch mod. To request a function or event, use [[Requested Functions and Events]].<br />
<br />
'''Server-side scripting events can be found here: [[Server Scripting Events]]<br />
<br />
==Colshape events==<br />
{{Client_colshape_events}}<br />
<br />
==Element events==<br />
{{Client_element_events}}<br />
<br />
==GUI events==<br />
{{GUI_events}}<br />
<br />
==Marker events==<br />
{{Client_marker_events}}<br />
<br />
==Ped events==<br />
{{Client_ped_events}}<br />
<br />
==Player events==<br />
{{Client_player_events}}<br />
<br />
==Projectile events==<br />
{{Client_projectile_events}}<br />
<br />
==Resource events==<br />
{{Client_resource_events}}<br />
<br />
==Vehicle events==<br />
{{Client_vehicle_events}}<br />
<br />
==Other events==<br />
{{Client_other_events}}<br />
<br />
[[pl:Zdarzenia_po_stronie_klienta]]<br />
[[ru:Client Scripting Events]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Client_Scripting_Events&diff=21641RU/Client Scripting Events2009-10-03T10:26:23Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
<pageclass class="client"></pageclass><br />
Здесь приведены все [[event|события]], выполняемые на '''клиентской стороне''', уже втроенные в мод. Для запроса функций или событий смотри [[Requested Functions and Events]].<br />
<br />
'''События серверной стороны можно найти здесь: [[RU/Server Scripting Events|События генерируемые на стороне сервера]]<br />
<br />
==Colshape events==<br />
{{Client_colshape_events}}<br />
<br />
==Element events==<br />
{{Client_element_events}}<br />
<br />
==GUI events==<br />
{{GUI_events}}<br />
<br />
==Marker events==<br />
{{New feature|3|1.0|<br />
{{Client_marker_events}}<br />
}}<br />
<br />
==Ped events==<br />
{{Client_ped_events}}<br />
<br />
==Player events==<br />
{{Client_player_events}}<br />
<br />
==Projectile events==<br />
{{Client_projectile_events}}<br />
<br />
==Resource events==<br />
{{Client_resource_events}}<br />
<br />
==Vehicle events==<br />
{{Client_vehicle_events}}<br />
<br />
==Other events==<br />
{{Client_other_events}}<br />
<br />
[[en:Client Scripting Events]]<br />
[[pl:Zdarzenia_po_stronie_klienta]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Client_Scripting_Events&diff=21640RU/Client Scripting Events2009-10-03T10:25:35Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
<pageclass class="client"></pageclass><br />
Здесь приведены все [[event|события]], выполняемые на '''клиентской стороне''', уже втроенные в мод. Для запроса функций или событий смотри [[Requested Functions and Events]].<br />
<br />
'''События серверной стороны можно найти здесь: [[RU/Server Scripting Events|События генерируемые на стороне сервера]]<br />
<br />
==Colshape events==<br />
{{Client_colshape_events}}<br />
<br />
==Element events==<br />
{{Client_element_events}}<br />
<br />
==GUI events==<br />
{{GUI_events}}<br />
<br />
==Marker events==<br />
{{New feature|3|1.0|<br />
{{Client_marker_events}}<br />
}}<br />
<br />
==Ped events==<br />
{{Client_ped_events}}<br />
<br />
==Player events==<br />
{{Client_player_events}}<br />
<br />
==Projectile events==<br />
{{Client_projectile_events}}<br />
<br />
==Resource events==<br />
{{Client_resource_events}}<br />
<br />
==Vehicle events==<br />
{{Client_vehicle_events}}<br />
<br />
==Other events==<br />
{{Client_other_events}}<br />
<br />
[[pl:Zdarzenia_po_stronie_klienta]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=User_talk:EAi&diff=21639User talk:EAi2009-10-03T10:16:36Z<p>Divine: /* New version */ new section</p>
<hr />
<div>I just should remember you to add this green border for the useful functions pages.<br />
It's a class for the pageclass-tag. (CSS)<br />
Hope you don't forget reading this. :P<br />
[[User:NeonBlack|NeonBlack]] 23:12, 13 May 2009 (CEST)<br />
<br />
== New version ==<br />
<br />
Hey, add the new version record to [[Template:Current_Version]] [[User:Divine|Divine]] 10:16, 3 October 2009 (UTC)</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21638Главная страница2009-10-03T10:14:28Z<p>Divine: </p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
====Начало====<br />
<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиентской части MTA]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверной части MTA]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы MTA:SA DM]]<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Template:Elements&diff=21527RU/Template:Elements2009-09-13T10:51:27Z<p>Divine: moved RU/Template:Elements to Template:RU/Elements</p>
<hr />
<div>#REDIRECT [[Template:RU/Elements]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:RU/Elements&diff=21526Template:RU/Elements2009-09-13T10:51:27Z<p>Divine: moved RU/Template:Elements to Template:RU/Elements</p>
<hr />
<div>* [[Element/Player|Игрок]]<br />
* [[Element/Ped|Бот]]<br />
* [[Element/Vehicle|Транспорт]]<br />
* [[Element/Object|Объект]]<br />
* [[Element/Pickup|Пикап]]<br />
* [[Element/Marker|Маркер]]<br />
* [[Element/Collision shape|Collision shape]]<br />
* [[Element/Blip|Blip]]<br />
* [[Element/Radar area|Radar area]]<br />
* [[Element/Projectile|Projectile]]<br />
* [[Element/Team|Team]]<br />
* [[Element/Console|Server console]]<br />
* [[Element/Admin|Remote admin]]<br />
* [[GUI widgets]]:<br />
<ul>{{GUI_widgets}}</ul><br />
* [[Element/TXD|TXD]]<br />
* [[Element/DFF|DFF]]<br />
* [[Element/COL|COL]]<br />
* [[Element/Sound|Sound]]<br />
<noinclude><br />
[[en:Template:Elements]]<br />
</noinclude></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:RU/Elements&diff=21525Template:RU/Elements2009-09-13T10:50:12Z<p>Divine: </p>
<hr />
<div>* [[Element/Player|Игрок]]<br />
* [[Element/Ped|Бот]]<br />
* [[Element/Vehicle|Транспорт]]<br />
* [[Element/Object|Объект]]<br />
* [[Element/Pickup|Пикап]]<br />
* [[Element/Marker|Маркер]]<br />
* [[Element/Collision shape|Collision shape]]<br />
* [[Element/Blip|Blip]]<br />
* [[Element/Radar area|Radar area]]<br />
* [[Element/Projectile|Projectile]]<br />
* [[Element/Team|Team]]<br />
* [[Element/Console|Server console]]<br />
* [[Element/Admin|Remote admin]]<br />
* [[GUI widgets]]:<br />
<ul>{{GUI_widgets}}</ul><br />
* [[Element/TXD|TXD]]<br />
* [[Element/DFF|DFF]]<br />
* [[Element/COL|COL]]<br />
* [[Element/Sound|Sound]]<br />
<noinclude><br />
[[en:Template:Elements]]<br />
</noinclude></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:RU/Elements&diff=21524Template:RU/Elements2009-09-13T10:49:12Z<p>Divine: Created page with '* Player * Ped * Vehicle * Object * Pickup * Marker * [[Element/Co…'</p>
<hr />
<div>* [[Element/Player|Player]]<br />
* [[Element/Ped|Ped]]<br />
* [[Element/Vehicle|Vehicle]]<br />
* [[Element/Object|Object]]<br />
* [[Element/Pickup|Pickup]]<br />
* [[Element/Marker|Marker]]<br />
* [[Element/Collision shape|Collision shape]]<br />
* [[Element/Blip|Blip]]<br />
* [[Element/Radar area|Radar area]]<br />
* [[Element/Projectile|Projectile]]<br />
* [[Element/Team|Team]]<br />
* [[Element/Console|Server console]]<br />
* [[Element/Admin|Remote admin]]<br />
* [[GUI widgets]]:<br />
<ul>{{GUI_widgets}}</ul><br />
* [[Element/TXD|TXD]]<br />
* [[Element/DFF|DFF]]<br />
* [[Element/COL|COL]]<br />
* [[Element/Sound|Sound]]<br />
<noinclude><br />
[[ru:Template:Elements]]<br />
</noinclude></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:Elements&diff=21523Template:Elements2009-09-13T10:45:29Z<p>Divine: </p>
<hr />
<div>* [[Element/Player|Player]]<br />
* [[Element/Ped|Ped]]<br />
* [[Element/Vehicle|Vehicle]]<br />
* [[Element/Object|Object]]<br />
* [[Element/Pickup|Pickup]]<br />
* [[Element/Marker|Marker]]<br />
* [[Element/Collision shape|Collision shape]]<br />
* [[Element/Blip|Blip]]<br />
* [[Element/Radar area|Radar area]]<br />
* [[Element/Projectile|Projectile]]<br />
* [[Element/Team|Team]]<br />
* [[Element/Console|Server console]]<br />
* [[Element/Admin|Remote admin]]<br />
* [[GUI widgets]]:<br />
<ul>{{GUI_widgets}}</ul><br />
* [[Element/TXD|TXD]]<br />
* [[Element/DFF|DFF]]<br />
* [[Element/COL|COL]]<br />
* [[Element/Sound|Sound]]<br />
<noinclude><br />
[[ru:Template:Elements]]<br />
</noinclude></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Category:%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82&diff=21522Category:Элемент2009-09-13T10:43:49Z<p>Divine: </p>
<hr />
<div>[[Element|Элемент]] - общий класс, отражающий почти все внитриигровые [[entity|объекты]]. Встроенными типами элементов являются:<br />
<br />
{{RU/Elements}}<br />
<br />
Можно создавать любые другие элементы, которые будут абстрактны и не будут относиться к каким-либо конкретным игровым [[entity|объектам]]. Например, элементы '''ресурс''' и '''карта''' создаются когда ресурсы и карты загружают группу объектов, создаваемых ими как дочерние элементы.<br />
<br />
Элементы объединяют общие функции, такие как тип и список параметров, операция уничтожения убирает как элемент, так и его игровое представление, с которым он связан (за исключение некоторых элементов, которые не могут быть уничтожены, например, элементы клиентов), хранение и представление [[element data|данных элемента]], и другие общие операции.<br />
<br />
Все элементы хранятся в [[Element tree|древовидной структуре]], поэтому все элементы, кроме '''root''' имеют родительский элемент, которым может быть '''root''', '''resource''', '''map''' или другой элемент. Он определяет сферу действия вызываемой функции.<br />
<br />
==Связанные функции скриптинга==<br />
===Клиент===<br />
{{Client element functions}}<br />
===Сервер===<br />
{{Element functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
[[it:Elemento]]<br />
[[en:Element]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Element&diff=21521Element2009-09-13T10:24:27Z<p>Divine: </p>
<hr />
<div>An '''element''' is a generic class that can represent almost all in-game [[entity|entities]]. The built-in element types are:<br />
<br />
{{Elements}}<br />
<br />
Any other element type can be created as an abstract element, not referring to any game [[entity]]. For example, '''resource''' and '''map''' elements are created when resources and maps are loaded to group entities they create as their children.<br />
<br />
Elements share common functions such as type and list retrieval, a destroy operation to remove both the element and the game entity it is linked to (except for some elements which can't be destroyed, for example client elements), [[element data]] storing and retrieval, and many more common operations.<br />
<br />
All elements are stored internally in a [[Element tree|tree structure]], and as such every element except the '''root''' element has a parent element, that can be the '''root''' element, a '''resource''', '''map''' or another element. This is purely for declaring the scope of function calls.<br />
<br />
==Related scripting functions==<br />
===Client===<br />
{{Client element functions}}<br />
===Server===<br />
{{Element functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
[[it:Elemento]]<br />
[[ru:Element]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Category:%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82&diff=21520Category:Элемент2009-09-13T10:23:33Z<p>Divine: </p>
<hr />
<div>[[Element|Элемент]] - общий класс, отражающий почти все внитриигровые [[entity|объекты]]. Встроенными типами элементов являются:<br />
<br />
{{Elements}}<br />
<br />
{{translate}}<br />
Any other element type can be created as an abstract element, not referring to any game [[entity]]. For example, '''resource''' and '''map''' elements are created when resources and maps are loaded to group entities they create as their children.<br />
<br />
Elements share common functions such as type and list retrieval, a destroy operation to remove both the element and the game entity it is linked to (except for some elements which can't be destroyed, for example client elements), [[element data]] storing and retrieval, and many more common operations.<br />
<br />
All elements are stored internally in a [[Element tree|tree structure]], and as such every element except the '''root''' element has a parent element, that can be the '''root''' element, a '''resource''', '''map''' or another element. This is purely for declaring the scope of function calls.<br />
<br />
==Related scripting functions==<br />
===Client===<br />
{{Client element functions}}<br />
===Server===<br />
{{Element functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
[[it:Elemento]]<br />
[[en:Element]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Resource:Editor/EDF&diff=21420RU/Resource:Editor/EDF2009-09-05T18:06:55Z<p>Divine: </p>
<hr />
<div>{{RU/Resource page}}<br />
{{translate}}<br />
EDF stands for ''Editor Definition File''. EDF's are XML files with an .edf extension that describe the custom elements used by a resource: new element types that have no meaning to MTA itself. Examples are &lt;spawnpoint&gt;, &lt;flag&gt;, &lt;checkpoint&gt; etc. They also are used to define settings that are used by gamemodes, which are placed under the &lt;settings&gt; tag within a resource's ''meta.xml''.<br />
<br />
==Введение==<br />
Some resources use custom map elements. A capture the flag gamemode, for example, will likely use &lt;flag&gt; elements that contain flag positions and teams. When a map is loaded, the gamemode looks for any &lt;flag&gt; elements and installs flags accordingly - for example by creating a flag object and a collision shape.<br />
<br />
The problem with these custom elements is that, unlike built-in MTA elements, the map editor has no idea of their meaning. How should a &lt;flag&gt; element be visually represented? What properties does it have? Without telling the editor this information, you could not use it to create these custom elements and would instead have to resort to manually editing the .map file with a text editor. Fortunately this isn't necessary: any resource can contain an editor definition file that describes the custom map elements used by that resource.<br />
<br />
==Использование определенных файлов в редакторе==<br />
As described in the [[Resource:Editor|main editor manual]], to be able to create the custom elements of a resource in your map you need to add it in the ''Definitions'' window. Click the ''Definitions'' button in the main menu and double click the resource in the left list. Then close the window and roll the mousewheel in the element panel until the resource comes up. At that point you can create and manipulate custom elements of that resource like any other element.<br />
<br />
==EDF файлы==<br />
EDF files are simply XML files with an .edf extension. We'll start with an example: the EDF of the Capture the Orb gamemode.<br />
<br />
<syntaxhighlight lang="xml"><br />
<def name="Capture the Orb"><br />
<element name="orb" friendlyname="Orb spawnpoint" instructions="Place your orb in a position that can be collected."><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<marker size="0.5" type="corona" color="#ffff00ff" /><br />
</element><br />
<element name="objective" friendlyname="Objective point" instructions="Place your objective point in a position that can be reached."><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<marker size="3" type="cylinder" color="#9370dbaa" /><br />
</element><br />
<element name="spawnpoint" friendlyname="Spawnpoint"><br />
<object editorOnly="true" model="3092" posZ="1" /><br />
<data name="position" type="coord3d" default="0,0,0" /><br />
<data name="rotation" type="coord3d" default="0,0,0" /><br />
<data name="skin" type="skinID" default="0" /><br />
</element><br />
</def><br />
</syntaxhighlight><br />
<br />
As you can see, the syntax is fairly straightforward. The root element, &lt;def&gt;, contains a number of &lt;element&gt;s. Each of these &lt;element&gt;s describes a custom element and specifies its name, visual representation and available properties.<br />
<br />
===Визуальное представление===<br />
<br />
Any child node of an &lt;element&gt; that is not a &lt;data&gt; node is part of the visual representation. There can be one or more objects, markers, pickups etc. For each representation element you can optionally specify a position (posX, posY, posZ) and rotation (rotX, rotY, rotZ): these are ''relative'' to the position and rotation of the represented custom element. Using the above Capture the Orb example, if you were to create a spawnpoint at (30, 14, 3), the editor would display an object of model 3092 at (30, 14, 4) to represent it, because the object's posZ of 1 is added to the spawnpoint's z position of 3.<br />
<br />
===Настройки===<br />
<br />
Properties of a custom element are described by &lt;data&gt; nodes. Some property names have a special meaning, like ''position'' and ''rotation'': these can be changed by moving and rotating the element in the editor. The other properties can be changed in the Properties window.<br />
<br />
===Настройки визуального редактора===<br />
<br />
It is possible to make the representation of a custom element depend on one or more of the element's properties. Take as example a &lt;checkpoint&gt; element of a race gamemode that contains a &lt;marker&gt; for representation: the checkpoint has several attributes like color and size that should be reflected in the marker. To accomplish this, specify something of the form ''!propertyname!'' in one or more of the representing element's attributes. For example:<br />
<br />
<syntaxhighlight lang="xml"><br />
<def name="Race"><br />
<element name="checkpoint" friendlyname="Race checkpoint"><br />
<data name="position" type="coord3d" required="true" default="0,0,0" /><br />
<br />
<data name="type" type="selection:checkpoint,ring" required="true" default="checkpoint" /><br />
<data name="size" type="number" required="true" default="2.25"/><br />
<data name="color" type="color" required="false" default="#ff0000ff" /><br />
...<br />
<br />
<marker type="!type!" size="!size!" color="!color!" /><br />
</element><br />
</def><br />
</syntaxhighlight><br />
<br />
Now whenever the "type", "size" or "color" property of a checkpoint is changed, the new value will be copied to its marker, and the marker's visual appearance changes accordingly.<br />
<br />
===Интеграция в ресурсах===<br />
<br />
Once you've written your EDF, save it as an .edf file in your resource's folder and add an "edf:definition" attribute to your meta.xml's &lt;info&gt; tag, like so:<br />
<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="erorr404" type="gamemode" ... edf:definition="cto.edf" /><br />
...<br />
</meta><br />
</syntaxhighlight><br />
<br />
==EDF reference==<br />
<br />
===Built-in elements===<br />
These are the elements you can use for representing your custom elements, along with their properties.<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;blip&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|icon<br />
| style="background-color: #EEE"|blipID<br />
|-<br />
| style="background-color: #EEE"|size<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;marker&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|type<br />
| style="background-color: #EEE"|markerType<br />
|-<br />
| style="background-color: #EEE"|size<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;object&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|objectID<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;ped&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|skinID<br />
|-<br />
| style="background-color: #EEE"|rotZ<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;pickup&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|type<br />
| style="background-color: #EEE"|pickupType<br />
|-<br />
| style="background-color: #EEE"|amount<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|respawn<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;vehicle&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|model<br />
| style="background-color: #EEE"|vehicleID<br />
|-<br />
| style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|vehiclecolors<br />
|-<br />
| style="background-color: #EEE"|upgrades<br />
| style="background-color: #EEE"|vehicleupgrades<br />
|-<br />
| style="background-color: #EEE"|plate<br />
| style="background-color: #EEE"|plate<br />
|-<br />
| style="background-color: #EEE"|interior<br />
| style="background-color: #EEE"|integer<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
<br />
{| cellspacing="1"<br />
! style="background-color: #EEE" colspan="2" | &lt;radararea&gt;<br />
|-<br />
! style="background-color: #EEE"|Property<br />
! style="background-color: #EEE"|Type<br />
|-<br />
| style="background-color: #EEE"|posX<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|posY<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|sizeX<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|sizeY<br />
| style="background-color: #EEE"|number<br />
|-<br />
| style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color<br />
|-<br />
| style="background-color: #EEE"|dimension<br />
| style="background-color: #EEE"|integer<br />
|}<br />
<br />
===Built-in property names===<br />
Properties with these names have a special meaning to the editor and can be modified by other means than the Properties window.<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Type<br />
|-<br />
! style="background-color: #EEE"|position<br />
| style="background-color: #EEE"|coord3d<br />
|-<br />
! style="background-color: #EEE"|rotation<br />
| style="background-color: #EEE"|coord3d<br />
|}<br />
<br />
===Property types===<br />
These are the types you can choose from for the properties (&lt;data&gt;) of your custom elements.<br />
<br />
====Primitives====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|boolean<br />
| style="background-color: #EEE"|Simple boolean value.<br />
| style="background-color: #EEE"|"true" or "false"<br />
|-<br />
! style="background-color: #EEE"|natural<br />
| style="background-color: #EEE"|Natural number (whole and positive).<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|integer<br />
| style="background-color: #EEE"|Whole number.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|number<br />
| style="background-color: #EEE"|Rational number.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|string<br />
| style="background-color: #EEE"|Simple string of text.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|color<br />
| style="background-color: #EEE"|color, with or without alpha.<br />
| style="background-color: #EEE"|#RRGGBB or #RRGGBBAA<br />
|}<br />
<br />
====Coordinates====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|camera<br />
| style="background-color: #EEE"|Position and lookat coordinates for the camera.<br />
| style="background-color: #EEE"|posX,posY,posZ,lookatX,lookatY,lookatZ<br />
|-<br />
! style="background-color: #EEE"|coord3d<br />
| style="background-color: #EEE"|3-component vector, typically used for positions and rotations.<br />
| style="background-color: #EEE"|x,y,z<br />
|}<br />
<br />
====Vehicles====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|plate<br />
| style="background-color: #EEE"|Number plate text for a vehicle.<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|vehiclecolors<br />
| style="background-color: #EEE"|colors of a vehicle<br />
| style="background-color: #EEE"|colorID1,colorID2,colorID3,colorID4<br />
|-<br />
! style="background-color: #EEE"|vehicleupgrades<br />
| style="background-color: #EEE"|Upgrades of a vehicle<br />
| style="background-color: #EEE"|upgradeID1,upgradeID2,...<br />
|}<br />
<br />
====Model ID's====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|blipID<br />
| style="background-color: #EEE"|Picture ID for blips<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|objectID<br />
| style="background-color: #EEE"|Model ID for objects<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|pickupType<br />
| style="background-color: #EEE"|Armor, health or weapon<br />
| style="background-color: #EEE"|"armor", "health" or numeric weapon ID<br />
|-<br />
! style="background-color: #EEE"|skinID<br />
| style="background-color: #EEE"|Skin ID for peds<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|vehicleID<br />
| style="background-color: #EEE"|Model ID for vehicles<br />
| style="background-color: #EEE"|&nbsp;<br />
|-<br />
! style="background-color: #EEE"|weaponID<br />
| style="background-color: #EEE"|Weapon, e.g. M4<br />
| style="background-color: #EEE"|Numeric weapon ID, e.g. 31<br />
|}<br />
<br />
====Colshapes and markers====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|colshapeType<br />
| style="background-color: #EEE"|collision circle, cube, rectangle, sphere or tube<br />
| style="background-color: #EEE"|One of: "colcircle", "colcube", "colrectangle", "colsphere", "coltube"<br />
|-<br />
! style="background-color: #EEE"|markerType<br />
| style="background-color: #EEE"|Arrow, checkpoint, corona, cylinder or ring marker.<br />
| style="background-color: #EEE"|One of: "arrow", "checkpoint", "corona", "cylinder", "ring"<br />
|-<br />
|}<br />
<br />
====Specials====<br />
{| cellspacing="1"<br />
! style="background-color: #EEE"|Name<br />
! style="background-color: #EEE"|Description<br />
! style="background-color: #EEE"|Value<br />
|-<br />
! style="background-color: #EEE"|element:type<br />
| style="background-color: #EEE"|Element of a certain type, for example: element:flag<br />
| style="background-color: #EEE"|The element's ID<br />
|-<br />
! style="background-color: #EEE"|selection:val1,val2,...<br />
| style="background-color: #EEE"|Shows a dropdown box from which to pick one value.<br />
| style="background-color: #EEE"|The selected value<br />
|}<br />
[[en:Resource:Editor/EDF]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:Translate&diff=21398Template:Translate2009-09-01T22:43:23Z<p>Divine: </p>
<hr />
<div>{| cellspacing="0" style="margin-left: auto; margin-right: auto; border:solid green 1px; margin: 1px; width: 560px; background: #e0e0e0;"<br />
| style="width: 45px; height: 45px; background: white;"| [[Image:Warning.png]]<br />
| style="font-size: 10pt; padding: 4pt; line-height: 1.25em; color: black;"|<br />
{{#if: {{{1|}}}|<br />
{{#ifeq:{{{1|}}}|ru|Статью необходимо [http://wiki.multitheftauto.com/index.php?title={{urlencode:{{FULLPAGENAME}}}}&action=edit перевести] на русский язык. На странице обсуждения могут быть подробности.<br />
}}<br />
{{#ifeq:{{{1|}}}|en|This page require english translation. Discuss page can contain more information.}}<br />
<!-- Add more langs here. --><br />
|Статью необходимо [http://wiki.multitheftauto.com/index.php?title={{urlencode:{{FULLPAGENAME}}}}&action=edit перевести] на русский язык. На странице обсуждения могут быть подробности.<br />
}}<br />
<br />
|}<br />
<includeonly><br />
[[Category:Pages to translate]]<br />
</includeonly></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:Translate&diff=21397Template:Translate2009-09-01T22:40:05Z<p>Divine: </p>
<hr />
<div>{| cellspacing="0" style="margin-left: auto; margin-right: auto; border:solid green 1px; margin: 1px; width: 560px; background: #e0e0e0;"<br />
| style="width: 45px; height: 45px; background: white;"| [[Image:Warning.png]]<br />
| style="font-size: 10pt; padding: 4pt; line-height: 1.25em; color: black;"|<br />
{{#if: {{{1|}}}|<br />
{{#ifeq:{{{1|}}}|ru|Статью необходимо [http://wiki.multitheftauto.com/index.php?title={{urlencode:{{FULLPAGENAME}}}}&action=edit перевести] на русский язык. На странице обсуждения могут быть подробности.<br />
}}<br />
{{#ifeq:{{{1|}}}|en|This page require english translation. Discuss page can contain more information.}}<br />
|Статью необходимо [http://wiki.multitheftauto.com/index.php?title={{urlencode:{{FULLPAGENAME}}}}&action=edit перевести] на русский язык. На странице обсуждения могут быть подробности.<br />
}}<br />
<br />
|}<br />
<includeonly><br />
[[Category:Pages to translate]]<br />
</includeonly></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:Translate&diff=21393Template:Translate2009-09-01T20:46:00Z<p>Divine: </p>
<hr />
<div>{| cellspacing="0" style="margin-left: auto; margin-right: auto; border:solid green 1px; margin: 1px; width: 560px; background: #e0e0e0;"<br />
| style="width: 45px; height: 45px; background: white;"| [[Image:Warning.png]]<br />
| style="font-size: 10pt; padding: 4pt; line-height: 1.25em; color: black;"| Статью необходимо [http://wiki.multitheftauto.com/index.php?title={{urlencode:{{FULLPAGENAME}}}}&action=edit перевести] на русский язык. На странице обсуждения могут быть подробности.<br />
|}<br />
<includeonly><br />
[[Category:Pages to translate]]<br />
</includeonly></div>Divinehttps://wiki.multitheftauto.com/index.php?title=Resource:Interiors&diff=21387Resource:Interiors2009-08-31T14:23:11Z<p>Divine: </p>
<hr />
<div>__NOTOC__<br />
{{Resource page}}<br />
The interiors resource provides a generic system for use of the single player's interiors system, which is included in the MTASA 1.0 server package onwards. This means placing warp points where when players hit the marker, they are set into the appropriate interior.<br />
<br />
=Loading interiors from the resource=<br />
By default, the interiors resource offers over 200 of single player's own interior locations. Coupled with [[dimension|dimensions]], each and every warp point offers a unique location - with a total of over 450 locations.<br />
<br />
Loading these interiors is easy. Starting the ''interiors'' resource will auto load all these preset warp points and will be ready to use out of the box.<br />
<br />
=Adding your own interiors=<br />
The interiors resource supports a flexible .map based element system to add your own interiors. The syntax follows an ''entry'' and ''return'' system. An ''interiorEntry'' element must have a unique id, and the ''interiorReturn'' element uses the "refid" attribute to link them together.<br />
<syntaxhighlight lang="xml"><br />
<interiorEntry id="" posX="" posY="" posZ="" rotation="" dimension="" interior="" oneway="" /><br />
<interiorReturn refid="" posX="" posY="" posZ="" rotation="" dimension="" interior="" /><br />
</syntaxhighlight><br />
==Required Arguments==<br />
* '''posX''': A float representing the X position of the interior warp.<br />
* '''posY''': A float representing the Y position of the interior warp.<br />
* '''posZ''': A float representing the Z position of the interior warp.<br />
* '''rotation''': A float representing the rotation of the player when he '''reaches''' the marker in the specified element.<br />
* '''dimension''': An integer representing the dimension of the player when he '''reaches''' the interior warp in the specified element. In other words, which dimension the warp point exists.<br />
* '''interior''': An integer representing the interior world of the player when he '''reaches''' the interior warp in the specified element. In other words, which interior the warp point exists.<br />
<br />
==Optional Arguments==<br />
* '''oneway''': If set to ''true'', a interiorReturn marker will not be created, and the warp point will be one-way - from the interiorEntry to the interiorReturn with no way back.<br />
<br />
==Example==<br />
<syntaxhighlight lang="xml"><br />
<interiorEntry id="AMMUN1" posX="1368.35" posY="-1279.06" posZ="12.55" rotation="-0.100006" dimension="0" interior="0" /><br />
<interiorReturn refid="AMMUN1" posX="286.15" posY="-41.54" posZ="1000.57" rotation="90" interior="1" dimension="0" /><br />
</syntaxhighlight><br />
The interiorEntry element here is located at 1368.35,-1279.06,12.55. When the player reaches this location, he will be warped to the attributes specified in the linked interiorReturn element - 286.15,-41.54,1000.57 with a rotation of 90 degrees, into the new interior world 1. When the player hits this marker again, the transverse will happen.<br />
<br />
=Interfacing your script with the interiors resource=<br />
The interiors resource offers a few events and functions which should allow customisability of<br />
interiors.<br />
<br />
==Exported functions==<br />
Please remember that [[call]] must be used to call functions of another resource.<br />
----<br />
===getInteriorName===<br />
This function retrieves the overall name of an interior. This means it is the id or the overall refid.<br />
====Syntax====<br />
<syntaxhighlight lang="lua"><br />
string getInteriorName ( element interiorEntry/InteriorReturn )<br />
</syntaxhighlight><br />
<br />
====Required Arguments====<br />
*'''interior:''' The interior you wish to get the name of. Can be of type ''interiorEntry'' or ''interiorReturn''.<br />
<br />
====Returns====<br />
Returns a string of the interior name, or false if it could not be retrieved.<br />
----<br />
<br />
<br />
===getInteriorMarker===<br />
This function retrieves the [[marker]] element associated to the interior. This will allow you to modify the visibility of interior markers using the [[setElementVisibleTo]] function.<br />
====Syntax====<br />
<syntaxhighlight lang="lua"><br />
marker getInteriorName ( element interiorEntry/InteriorReturn )<br />
</syntaxhighlight><br />
<br />
====Required Arguments====<br />
*'''interior:''' The interior you wish to retrieve the associated marker of. Can be of type ''interiorEntry'' or ''interiorReturn''.<br />
<br />
====Returns====<br />
Returns a marker element associated to the specified interior, or false if it could not be retrieved.<br />
<br />
==Events==<br />
===onInteriorHit===<br />
This event is triggered when an interior warp point is hit, prior to when a player is warped to his/her destination.<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player hitPlayer<br />
</syntaxhighlight> <br />
<br />
*'''hitPlayer''': The player that hit the interior warp point.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the interior element which was hit.<br />
<br />
====Cancel effect====<br />
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.<br />
----<br />
<br />
<br />
===onInteriorWarped===<br />
This event is triggered when an interior destination has successfully been warped to.<br />
<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player warpedPlayer<br />
</syntaxhighlight> <br />
<br />
*'''warpedPlayer''': The player that has warped to the destination interior.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the interior element which was warped '''to'''.<br />
----<br />
<br />
<br />
===onPlayerInteriorHit===<br />
This event is triggered when a player hits an interior warp point, prior to him reaching his destination<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player hitInterior<br />
</syntaxhighlight> <br />
<br />
*'''hitInterior''': The interior element that was hit.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the player who hit the interior element.<br />
<br />
====Cancel effect====<br />
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.<br />
----<br />
<br />
<br />
===onPlayerInteriorWarped===<br />
This event is triggered when a player successfully warps to his destination interior.<br />
<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player warpedInterior<br />
</syntaxhighlight> <br />
<br />
*'''warpedInterior''': The interior that has been warped '''to'''.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the player who was warped to his destination point.<br />
<br />
<br />
----<br />
===Examples===<br />
'''Coming soon'''<br />
[[ru:Resource:Interiors]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Resource:Interiors&diff=21386RU/Resource:Interiors2009-08-31T14:22:14Z<p>Divine: </p>
<hr />
<div>__NOTOC__<br />
{{RU/Resource page}}<br />
{{translate}}<br />
The interiors resource provides a generic system for use of the single player's interiors system, which is included in the MTASA:DM DP2 server package onwards. This means placing warp points where when players hit the marker, they are set into the appropriate interior.<br />
<br />
=Loading interiors from the resource=<br />
By default, the interiors resource offers over 200 of single player's own interior locations. Coupled with [[dimension|dimensions]], each and every warp point offers a unique location - with a total of over 450 locations.<br />
<br />
Loading these interiors is easy. Starting the ''interiors'' resource will auto load all these preset warp points and will be ready to use out of the box.<br />
<br />
=Adding your own interiors=<br />
The interiors resource supports a flexible .map based element system to add your own interiors. The syntax follows an ''entry'' and ''return'' system. An ''interiorEntry'' element must have a unique id, and the ''interiorReturn'' element uses the "refid" attribute to link them together.<br />
<syntaxhighlight lang="xml"><br />
<interiorEntry id="" posX="" posY="" posZ="" rotation="" dimension="" interior="" oneway="" /><br />
<interiorReturn refid="" posX="" posY="" posZ="" rotation="" dimension="" interior="" /><br />
</syntaxhighlight><br />
==Required Arguments==<br />
* '''posX''': A float representing the X position of the interior warp.<br />
* '''posY''': A float representing the Y position of the interior warp.<br />
* '''posZ''': A float representing the Z position of the interior warp.<br />
* '''rotation''': A float representing the rotation of the player when he '''reaches''' the marker in the specified element.<br />
* '''dimension''': An integer representing the dimension of the player when he '''reaches''' the interior warp in the specified element. In other words, which dimension the warp point exists.<br />
* '''interior''': An integer representing the interior world of the player when he '''reaches''' the interior warp in the specified element. In other words, which interior the warp point exists.<br />
<br />
==Optional Arguments==<br />
* '''oneway''': If set to ''true'', a interiorReturn marker will not be created, and the warp point will be one-way - from the interiorEntry to the interiorReturn with no way back.<br />
<br />
==Example==<br />
<syntaxhighlight lang="xml"><br />
<interiorEntry id="AMMUN1" posX="1368.35" posY="-1279.06" posZ="12.55" rotation="-0.100006" dimension="0" interior="0" /><br />
<interiorReturn refid="AMMUN1" posX="286.15" posY="-41.54" posZ="1000.57" rotation="90" interior="1" dimension="0" /><br />
</syntaxhighlight><br />
The interiorEntry element here is located at 1368.35,-1279.06,12.55. When the player reaches this location, he will be warped to the attributes specified in the linked interiorReturn element - 286.15,-41.54,1000.57 with a rotation of 90 degrees, into the new interior world 1. When the player hits this marker again, the transverse will happen.<br />
<br />
=Interfacing your script with the interiors resource=<br />
The interiors resource offers a few events and functions which should allow customisability of<br />
interiors.<br />
<br />
==Exported functions==<br />
Please remember that [[call]] must be used to call functions of another resource.<br />
----<br />
===getInteriorName===<br />
This function retrieves the overall name of an interior. This means it is the id or the overall refid.<br />
====Syntax====<br />
<syntaxhighlight lang="lua"><br />
string getInteriorName ( element interiorEntry/InteriorReturn )<br />
</syntaxhighlight><br />
<br />
====Required Arguments====<br />
*'''interior:''' The interior you wish to get the name of. Can be of type ''interiorEntry'' or ''interiorReturn''.<br />
<br />
====Returns====<br />
Returns a string of the interior name, or false if it could not be retrieved.<br />
----<br />
<br />
<br />
===getInteriorMarker===<br />
This function retrieves the [[marker]] element associated to the interior. This will allow you to modify the visibility of interior markers using the [[setElementVisibleTo]] function.<br />
====Syntax====<br />
<syntaxhighlight lang="lua"><br />
marker getInteriorName ( element interiorEntry/InteriorReturn )<br />
</syntaxhighlight><br />
<br />
====Required Arguments====<br />
*'''interior:''' The interior you wish to retrieve the associated marker of. Can be of type ''interiorEntry'' or ''interiorReturn''.<br />
<br />
====Returns====<br />
Returns a marker element associated to the specified interior, or false if it could not be retrieved.<br />
<br />
==Events==<br />
===onInteriorHit===<br />
This event is triggered when an interior warp point is hit, prior to when a player is warped to his/her destination.<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player hitPlayer<br />
</syntaxhighlight> <br />
<br />
*'''hitPlayer''': The player that hit the interior warp point.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the interior element which was hit.<br />
<br />
====Cancel effect====<br />
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.<br />
----<br />
<br />
<br />
===onInteriorWarped===<br />
This event is triggered when an interior destination has successfully been warped to.<br />
<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player warpedPlayer<br />
</syntaxhighlight> <br />
<br />
*'''warpedPlayer''': The player that has warped to the destination interior.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the interior element which was warped '''to'''.<br />
----<br />
<br />
<br />
===onPlayerInteriorHit===<br />
This event is triggered when a player hits an interior warp point, prior to him reaching his destination<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player hitInterior<br />
</syntaxhighlight> <br />
<br />
*'''hitInterior''': The interior element that was hit.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the player who hit the interior element.<br />
<br />
====Cancel effect====<br />
If this event is [[Event system#Canceling|canceled]], the player will not be warped to his destination point.<br />
----<br />
<br />
<br />
===onPlayerInteriorWarped===<br />
This event is triggered when a player successfully warps to his destination interior.<br />
<br />
====Parameters====<br />
<syntaxhighlight lang="lua"><br />
player warpedInterior<br />
</syntaxhighlight> <br />
<br />
*'''warpedInterior''': The interior that has been warped '''to'''.<br />
<br />
====Source====<br />
The [[event system#Event source|source]] of this event is the player who was warped to his destination point.<br />
<br />
<br />
----<br />
===Examples===<br />
'''Coming soon'''<br />
[[en:Resource:Interiors]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=EDF&diff=21366EDF2009-08-29T20:44:57Z<p>Divine: Redirected page to Resource:Editor/EDF</p>
<hr />
<div>#REDIRECT [[Resource:Editor/EDF]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=EDF&diff=21365EDF2009-08-29T20:44:23Z<p>Divine: Redirected page to Editor/EDF</p>
<hr />
<div>#REDIRECT [[editor/EDF]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Meta.xml&diff=21349RU/Meta.xml2009-08-28T10:47:04Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.<br />
<br />
Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247<br />
<br />
== Возможные тэги ==<br />
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых и опциональных. У них есть свои атрибуты.<br />
Язык XML не умеет формировать тэги, он служит как простой способ хранения данных. Интерпретацией тэгов занимаются скрипты, то есть '''вы можете определять новые тэги в XML'''. Однако, MTA определяет несколько тэгов самостоятельно, они приведены ниже:<br />
<br />
*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):<br />
** '''author:''' The author of this resource<br />
** '''version:''' The version of this resource<br />
** '''name:''' The name of this resource<br />
** '''description:''' A brief description of this resource<br />
** '''type:''' The type of this resource, that can be "gamemode", "script", "map" or "misc".<br />
*'''<script />''' Source code for this resource, possible parameters are:<br />
** '''src:''' The file name of the source code<br />
** '''type:''' The type of source code: "client" or "server"<br />
*'''<map />''' The map for a gamemode, possible parameters are:<br />
**'''src:''' .map file name (can be path too eg. "maps/filename.map")<br />
**'''dimension:''' Dimension in which the map will be loaded (optional)<br />
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)<br />
**'''src:''' client-side file name (can be path too eg. "images/image.png")<br />
*'''<include />''' Include resources that this resource will use<br />
**'''resource:''' Resource name that you want to start with this resource<br />
**'''minversion:''' Minimum version that '''resource''' needs to be (optional)<br />
**'''maxversion:''' Maximum version that '''resource''' needs to be (optional)<br />
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:<br />
**'''src:''' The file name of the config file<br />
**'''type:''' The type of the config file: "client" or "server"<br />
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]<br />
**'''function:''' The function name<br />
**'''type''' Whether function is exported server-side or client-side (valid values are: "server" and "client")<br />
**'''http:''' Can the function be called via HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' The filename for the HTTP file (can be a path)<br />
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)<br />
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)<br />
*'''<settings> <setting name="" value=""/> </settings>:''' Most gamemodes use [[settings system]] to let server admins to configure it how they like. For instance you could set round time and then use [[get]] and [[set]] to get the value or change it, respectively.<br />
<br />
== Example ==<br />
Heres an example of a meta file using some of the tags mentioned:<br />
<syntaxhighlight lang="lua" lang="xml"><meta><br />
<info author="Slothman" type="gamemode" name="Stealth" /><br />
<config src="help.xml" type="client"/><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="client"/><br />
<script src="stealthmain_client.lua" type="client"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" /><br />
<file src="camera.png" /><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- round length in minutes --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on --><br />
<setting name="teambalance" value="[1]" /> <!-- difference limit of amount of players between teams --><br />
<setting name="spazammo" value="[25]" /> <!-- ammo amounts --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
</settings><br />
</meta></syntaxhighlight><br />
[[Category:Scripting Concepts]]<br />
[[Category:Incomplete]]<br />
[[en:Meta.xml]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Meta.xml&diff=21348RU/Meta.xml2009-08-28T10:40:54Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хотите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.<br />
<br />
Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247<br />
<br />
== Возможные тэги ==<br />
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых ит опциональных. У них есть свои атрибуты.<br />
<br />
Possible tags:<br />
*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):<br />
** '''author:''' The author of this resource<br />
** '''version:''' The version of this resource<br />
** '''name:''' The name of this resource<br />
** '''description:''' A brief description of this resource<br />
** '''type:''' The type of this resource, that can be "gamemode", "script" or "map".<br />
*'''<script />''' Source code for this resource, possible parameters are:<br />
** '''src:''' The file name of the source code<br />
** '''type:''' The type of source code: "client" or "server"<br />
*'''<map />''' The map for a gamemode, possible parameters are:<br />
**'''src:''' .map file name (can be path too eg. "maps/filename.map")<br />
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)<br />
**'''src:''' client-side file name (can be path too eg. "images/image.png")<br />
*'''<include />''' Include resources that this resource will use<br />
**'''resource:''' Resource name that you want to start with this resource<br />
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:<br />
**'''src:''' The file name of the config file<br />
**'''type:''' The type of the config file: "client" or "server"<br />
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]<br />
**'''function:''' The function name<br />
**'''http:''' Can the function be called via HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' The filename for the HTTP file (can be a path)<br />
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)<br />
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)<br />
*'''<settings> </settings>'''<br />
<br />
== Example ==<br />
Heres an example of a meta file using some of the tags mentioned:<br />
<syntaxhighlight lang="xml"><meta><br />
<info author="Slothman" type="gamemode" name="Stealth" /><br />
<config src="help.xml" type="client"/><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="client"/><br />
<script src="stealthmain_client.lua" type="client"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" /><br />
<file src="camera.png" /><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- round length in minutes --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on --><br />
<setting name="teambalance" value="[1]" /> <!-- difference limit of amount of players between teams --><br />
<setting name="spazammo" value="[25]" /> <!-- ammo amounts --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
</settings><br />
</meta></syntaxhighlight><br />
[[Category:Scripting Concepts]]<br />
[[Category:Incomplete]]<br />
[[en:Meta.xml]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Meta.xml&diff=21347RU/Meta.xml2009-08-28T10:40:40Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''. Если вы хотите отображать изображение на экране клиента, клиент должен сначала загрузить его. Чтобы сервер знал, что вы хоттите использовать изображение, нужно прописать имя файла в meta.xml. Если вам нужно использовать какие-то настройки для скрипта в качестве переменных, вы можете прописать их в тэге <settings>.<br />
<br />
Примечание: Вы можете опробывать простой генератор meta.xml, созданный 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247<br />
<br />
== Возможные тэги ==<br />
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых ит опциональных. У них есть свои атрибуты.<br />
<br />
Possible tags:<br />
*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):<br />
** '''author:''' The author of this resource<br />
** '''version:''' The version of this resource<br />
** '''name:''' The name of this resource<br />
** '''description:''' A brief description of this resource<br />
** '''type:''' The type of this resource, that can be "gamemode", "script" or "map".<br />
*'''<script />''' Source code for this resource, possible parameters are:<br />
** '''src:''' The file name of the source code<br />
** '''type:''' The type of source code: "client" or "server"<br />
*'''<map />''' The map for a gamemode, possible parameters are:<br />
**'''src:''' .map file name (can be path too eg. "maps/filename.map")<br />
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)<br />
**'''src:''' client-side file name (can be path too eg. "images/image.png")<br />
*'''<include />''' Include resources that this resource will use<br />
**'''resource:''' Resource name that you want to start with this resource<br />
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:<br />
**'''src:''' The file name of the config file<br />
**'''type:''' The type of the config file: "client" or "server"<br />
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]<br />
**'''function:''' The function name<br />
**'''http:''' Can the function be called via HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' The filename for the HTTP file (can be a path)<br />
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)<br />
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)<br />
*'''<settings> </settings>'''<br />
<br />
== Example ==<br />
Heres an example of a meta file using some of the tags mentioned:<br />
<syntaxhighlight lang="xml"><meta><br />
<info author="Slothman" type="gamemode" name="Stealth" /><br />
<config src="help.xml" type="client"/><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="client"/><br />
<script src="stealthmain_client.lua" type="client"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" /><br />
<file src="camera.png" /><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- round length in minutes --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on --><br />
<setting name="teambalance" value="[1]" /> <!-- difference limit of amount of players between teams --><br />
<setting name="spazammo" value="[25]" /> <!-- ammo amounts --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
</settings><br />
</meta></syntaxhighlight><br />
[[Category:Scripting Concepts]]<br />
[[Category:Incomplete]]<br />
[[en:Meta.xml]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Meta.xml&diff=21346RU/Meta.xml2009-08-28T10:33:45Z<p>Divine: </p>
<hr />
<div>{{translate}}<br />
Этот файл имеет очень важное содержание, которое позволяет загрузить ресурс/режим/карту. Вам нужно указать имена файлов, которые ваш скрипт/режим e (resource) будет использовать в файле '''meta.xml'''.<br />
Eg. If you want to display an image on the client's screen, the client needs to download the image first. To tell the server that you want to use an image in the script you'll need to include the file's name in the meta.xml file.<br /><br />
If you want to use some settings for the script as a variable you can set them in <settings> tag.<br />
<br />
Note: You can try simple Meta.xml generator made by 50p: http://forum.mtasa.com/viewtopic.php?f=91&t=22247<br />
<br />
== Possible tags ==<br />
Тэги в .xml такие же, как в . html. Файл meta.xml имеет множество тэгов, необходимых ит опциональных. У них есть свои атрибуты.<br />
<br />
Possible tags:<br />
*'''<info />''' Information about this resource, possible parameters include (any arbitrary parameters can be used and read using [[getResourceInfo]]):<br />
** '''author:''' The author of this resource<br />
** '''version:''' The version of this resource<br />
** '''name:''' The name of this resource<br />
** '''description:''' A brief description of this resource<br />
** '''type:''' The type of this resource, that can be "gamemode", "script" or "map".<br />
*'''<script />''' Source code for this resource, possible parameters are:<br />
** '''src:''' The file name of the source code<br />
** '''type:''' The type of source code: "client" or "server"<br />
*'''<map />''' The map for a gamemode, possible parameters are:<br />
**'''src:''' .map file name (can be path too eg. "maps/filename.map")<br />
*'''<file />''' A client-side file. Generally these are images, .txd, .col, .dff or .xml files. They'll be downloaded by clients when the resources is started (or on join)<br />
**'''src:''' client-side file name (can be path too eg. "images/image.png")<br />
*'''<include />''' Include resources that this resource will use<br />
**'''resource:''' Resource name that you want to start with this resource<br />
*'''<config />''' Config file (.xml) can be accessed by resource, possible parameters are:<br />
**'''src:''' The file name of the config file<br />
**'''type:''' The type of the config file: "client" or "server"<br />
*'''<export />''' This exports functions from this resource, so other resources can use them with [[call]]<br />
**'''function:''' The function name<br />
**'''http:''' Can the function be called via HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' The filename for the HTTP file (can be a path)<br />
**'''default:''' The html file is one that is shown by default when visiting /resourceName/ on the server. Only one html can be default, the rest are ignored. (true/false)<br />
**'''raw:''' The html file is not parsed by the LUA interpreter and is treated as binary data. Must be used for binary files (images mainly) (true/false)<br />
*'''<settings> </settings>'''<br />
<br />
== Example ==<br />
Heres an example of a meta file using some of the tags mentioned:<br />
<syntaxhighlight lang="xml"><meta><br />
<info author="Slothman" type="gamemode" name="Stealth" /><br />
<config src="help.xml" type="client"/><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="client"/><br />
<script src="stealthmain_client.lua" type="client"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" /><br />
<file src="camera.png" /><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- round length in minutes --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 for team protection off, 1 for team protection on --><br />
<setting name="teambalance" value="[1]" /> <!-- difference limit of amount of players between teams --><br />
<setting name="spazammo" value="[25]" /> <!-- ammo amounts --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
</settings><br />
</meta></syntaxhighlight><br />
[[Category:Scripting Concepts]]<br />
[[Category:Incomplete]]<br />
[[en:Meta.xml]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Getting_MTA:SA_to_work_with_wine&diff=21250RU/Getting MTA:SA to work with wine2009-08-26T17:43:47Z<p>Divine: </p>
<hr />
<div>Вам понадобится последняя версия Wine.<br />
<br />
Установите MTA:SA, абсолютно не важно, какой у Вас путь к MTA и к GTA:SA.<br />
<br />
Вам нужен Wine версии 0.9.49 или более поздней для запуска MTA:SA.<br />
<br />
Как только установите его, скачайте [http://ijs.bastage.net/mta/mta_unix.zip Загрузчик для *nix], и извлеките его в папку MTA San Andreas.<br />
<br />
Скачайте шрифты [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] и [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] нужные для CEGUI, и скопируйте их в $HOME/.wine/drive_c/windows/fonts/<br />
<br />
Откройте <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, перейдите на вкладку "Графика", и снимите флажок "Разрешить Пиксельные Шейдеры".<br />
<br />
Удалите из вашей папки MTA San Andreas файл MTA/data/menu.mkv.<br />
<br />
Вставьте [http://pastebin.com/f4c91e22b это] в MTA/coreconfig.xml (menu_options всегда должен быть равен 7).<br />
<br />
Запустите MTA_SA_unix.exe.</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Getting_MTASADM_to_work_with_wine&diff=21249RU/Getting MTASADM to work with wine2009-08-26T17:41:57Z<p>Divine: moved RU/Getting MTASADM to work with wine to RU/Getting MTA:SA to work with wine</p>
<hr />
<div>#REDIRECT [[RU/Getting MTA:SA to work with wine]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Getting_MTA:SA_to_work_with_wine&diff=21248RU/Getting MTA:SA to work with wine2009-08-26T17:41:57Z<p>Divine: moved RU/Getting MTASADM to work with wine to RU/Getting MTA:SA to work with wine</p>
<hr />
<div>Вам понадобится последняя версия Wine.<br />
<br />
Установите MTA:SA:DM, абсолютно не важно, какой у Вас путь к MTA и к GTA:SA.<br />
<br />
Вам нужен Wine версии 0.9.49 или более поздней для запуска MTA:SA:DM.<br />
<br />
Как только установите его, скачайте [http://ijs.bastage.net/mta/mta_unix.zip Загрузчик для *nix ], и извлеките его в папку с GTA:SA.<br />
<br />
Скачайте шрифты [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] и [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] нужные для CEGUI, и скопируйте их в $HOME/.wine/drive_c/windows/fonts/<br />
<br />
Откройте <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, перейдите на вкладку "Графика", и снимите флажок "Разрешить Пиксельные Шейдеры".<br />
<br />
Удалите из вашей папки с GTA:SA файл MTA/data/menu.mkv<br />
<br />
Вставьте [http://pastebin.com/f4c91e22b это] в MTA/coreconfig.xml (menu_options всегда должен быть равен 7).<br />
<br />
Запустите MTA_SA_unix.exe</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Getting_MTASADM_to_work_with_wine&diff=21247Getting MTASADM to work with wine2009-08-26T17:40:54Z<p>Divine: moved Getting MTASADM to work with wine to Getting MTA:SA to work with wine</p>
<hr />
<div>#REDIRECT [[Getting MTA:SA to work with wine]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Getting_MTA:SA_to_work_with_wine&diff=21246Getting MTA:SA to work with wine2009-08-26T17:40:54Z<p>Divine: moved Getting MTASADM to work with wine to Getting MTA:SA to work with wine</p>
<hr />
<div>You will need the latest version of Wine to get the installer working.<br />
<br />
Install MTA:SA:DM, it does not matter wherever you install MTA, and the GTA:SA path.<br />
<br />
You will need the version of ''Wine'' greater than 0.9.49 to run MTA:SA.<br />
<br />
Once you installed it, download the [http://ijs.bastage.net/mta/mta_unix.zip *nix loader], and extract it to your GTA:SA directory.<br />
<br />
Download the fonts [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] and [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] needed by CEGUI, and place them in ''$HOME/.wine/drive_c/windows/fonts/''<br />
<br />
Open <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, go to the graphics tab, and uncheck "Allow Pixel Shader".<br />
<br />
Remove in your ''MTA San Andreas'' directory ''MTA/data/menu.mkv''.<br />
<br />
Paste [http://pastebin.com/f4c91e22b this] in ''MTA/coreconfig.xml'' (menu_options must be always 7).<br />
<br />
Run ''MTA_SA_unix.exe''.<br />
<br />
[[ru:Getting MTASADM to work with wine]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Getting_MTA:SA_to_work_with_wine&diff=21245Getting MTA:SA to work with wine2009-08-26T17:39:06Z<p>Divine: </p>
<hr />
<div>You will need the latest version of Wine to get the installer working.<br />
<br />
Install MTA:SA:DM, it does not matter wherever you install MTA, and the GTA:SA path.<br />
<br />
You will need the version of ''Wine'' greater than 0.9.49 to run MTA:SA.<br />
<br />
Once you installed it, download the [http://ijs.bastage.net/mta/mta_unix.zip *nix loader], and extract it to your GTA:SA directory.<br />
<br />
Download the fonts [http://www.afosteo.org/Download/Fonts/verdana.ttf verdana], [http://www.bikeparadise.cz/jpgraph/ttf/tahoma.ttf tahoma] and [http://www.bikeparadise.cz/jpgraph/ttf/tahomabd.ttf tahomabd] needed by CEGUI, and place them in ''$HOME/.wine/drive_c/windows/fonts/''<br />
<br />
Open <syntaxhighlight lang="lua">winecfg</syntaxhighlight>, go to the graphics tab, and uncheck "Allow Pixel Shader".<br />
<br />
Remove in your ''MTA San Andreas'' directory ''MTA/data/menu.mkv''.<br />
<br />
Paste [http://pastebin.com/f4c91e22b this] in ''MTA/coreconfig.xml'' (menu_options must be always 7).<br />
<br />
Run ''MTA_SA_unix.exe''.<br />
<br />
[[ru:Getting MTASADM to work with wine]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Template:Translate&diff=21220Template:Translate2009-08-24T11:22:30Z<p>Divine: </p>
<hr />
<div>{| cellspacing="0" style="margin-left: auto; margin-right: auto; border:solid green 1px; margin: 1px; width: 560px; background: #e0e0e0;"<br />
| style="width: 45px; height: 45px; background: white;"| [[Image:Warning.png]]<br />
| style="font-size: 10pt; padding: 4pt; line-height: 1.25em; color: black;"| Статью необходимо перевести на русский язык. На странице обсуждения могут быть подробности.<br />
|}<br />
<includeonly><br />
[[Category:Pages to translate]]<br />
</includeonly></div>Divinehttps://wiki.multitheftauto.com/index.php?title=IT/Guida_al_Debug&diff=21219IT/Guida al Debug2009-08-24T11:19:11Z<p>Divine: </p>
<hr />
<div>{{IT/MainP}}<br />
[[Category:100%]]<br />
[[Category:IT/Concetti di scripting]]<br />
[[Category:IT/Guide e tutorial]]<br />
Scriptando ti capiteranno presto problemi che non si notano subito. Questa pagina ha lo scopo di elencare qualche strategia di base per trovare l'errore.<br />
<br />
==Console di debug==<br />
MTA possiede una console ingame per il debug. Puoi aprirla digitando ''debugscript x'' nella console, dove ''x'' è il livello di debug:<br />
* '''1:''' solo gli errori<br />
* '''2:''' gli errori e i ''warning''<br />
* '''3:''' gli errori, i ''warning'' e le info<br />
Perciò, digitando ''debugscript 3'' tutti i messaggi saranno visibili, anche se il livello 2 è raccomandato per la maggior parte dei casi. Dovresti avere il ''debugscript'' attivato la maggior parte del tempo che scripti, ti aiuterà a trovare errori di digitazione, insieme ad altri piccoli problemi e a risolverli facilmente.<br />
<br />
===Esempio===<br />
Questo frammento di esempio ha due errori:<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor")<br />
outputChatbox("DISGRACE")<br />
end<br />
</syntaxhighlight><br />
Quando lo script tenterà di caricare questa parte di codice, nella console di debug dovrebbe apparire qualcosa del genere:<br />
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near 'outputChatbox'}}<br />
Significa che c'è un errore di sintassi. Il ''debugscript'' mostra il percorso dello script che genera l'errore, in modo da conoscere la ''resource'' ('myResource' in questo caso) e ovviamente il nome dello script. Dopo il nome del file mostra la linea dell'errore e poi il tipo di errore. A questo punto è facile, abbiamo dimenticato il 'then':<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatbox("DISGRACE")<br />
end<br />
</syntaxhighlight><br />
Ora lo script caricherà senza errori e sembrerà funzionare bene, ma quando un player di nome 'Fedor' raggiungerà questa parte dello script, il ''debugscript'' darà questo errore:<br />
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}<br />
Significa che la funzione chiamata non esiste: è facilmente spiegabile, visto che il nome esatto della funzione è ''outputChatBox'' (con la ''B'' maiuscola):<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatBox("DISGRACE")<br />
end<br />
</syntaxhighlight><br />
<br />
Ovviamente è solo un esempio, potrebbe esserci un'infinità di altre situazioni, ma dovreste esservi fatti un'idea.<br />
<br />
==Log del debug==<br />
Puoi anche attivare la creazione di un file log del debug modificando il file ''coreconfig.xml'' nella tua cartella MTA all'interno di quella di GTA. Devi cercare la riga seguente:<br />
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight><br />
<br />
E rimpiazzarla con questa, scegliendo la path che preferisci, relativa alla cartella di GTA:<br />
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight><br />
Tutti i messaggi di debug da ora in poi verranno aggiunti al file log. Per bloccare questo processo, ripristina la riga precedente.<br />
<br />
==Strategie di debug==<br />
Esistono svariate strategie per trovare gli errori, la maggior parte delle quali prevede l'uso dei messaggi di debug, con informazioni differenti a seconda della situazione.<br />
<br />
===Funzioni utili===<br />
Prima di tutto ecco alcune funzioni comode per il debug.<br />
* [[IT/outputDebugString|outputDebugString]] o [[IT/outputChatBox|outputChatBox]] per l'''output'' di informazioni nella console di debug o in chatbox<br />
* (in inglese) [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] su una variabile per trasformarla in una stringa (per esempio se è una ''float'')<br />
* [[IT/getElementType|getElementType]] per verificare il tipo di un elemento di MTA<br />
<br />
===Creare messaggi di debug per verificare ''se'', ''quando'' o ''quante volte'' è eseguita una parte di codice===<br />
Un esempio tipico potrebbe essere verificare se la sezione di codice dentro un ''if'' sia eseguita o meno. Per far questo, aggiungi un messaggio qualsiasi (che in seguito riconoscerai) nella sezione dentro l'''if''.<br />
<syntaxhighlight lang="lua"><br />
if (variabile1 == variabile2) then<br />
outputDebugString("if eseguito")<br />
-- fai qualsiasi cosa<br />
end<br />
</syntaxhighlight><br />
<br />
Un altro uso potrebbe essere verificare se il valore di una variabile è modficato. Prima cerca tutti i punti in cui questo valore è modificato e aggiungi un messaggio di debug proprio sotto di essi.<br />
<br />
=== Creare messaggi di debug per verificare il ''valore'' di una variabile===<br />
Diciamo che vuoi creare un ''marker'', ma non sembra essere nella posizione dove dovrebbe trovarsi. La prima cosa che potresti voler fare è controllare se la funzione [[IT/createMarker|createMarker]] è eseguita. Ma nel fare ciò, puoi anche verificare le variabili usate nel [[IT/createMarker|createMarker]] in un colpo solo.<br />
<syntaxhighlight lang="lua"><br />
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))<br />
createMarker(x,y,z)<br />
</syntaxhighlight><br />
Questo mostrerà le 3 variabili usate come coordinate per creare il ''marker''. Assumendo che tu le 'legga' da un file map, puoi controllare in questo modo il loro valore. La funzione [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] permette di unire con certezza i valori delle variabili in una stringa, anche se per esempio sono dei ''booleani''.<br />
<br />
==Esempio==<br />
Immagina di creare una [[IT/Elemento/Collision shape|colshape]] da qualche parte e di volere che un'azione accada dopo che un [[IT/Elemento/Player|player]] rimanga 10 secondi dentro di essa.<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Il player è rimasto 10 secondi nella colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- elimina il timer quando un player esce dalla colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
Quando un player entra nella colshape, il debugscript mostra il questo messaggio:<br />
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}<br />
Significa che hai tentato di settare un ''index'' (indice) di una tabella che non esiste. Nell'esempio di sopra, accade quando viene settato l'id del timer nell'''index'' della tabella. Dobbiamo verificare se la tabella esiste e, se non esiste, crearla.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- elimina il timer quando un player esce dalla colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Ora riceviamo un errore quando un player entra nella colshape, aspetta dieci secondi e poi la lascia:<br />
<br />
{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}<br />
<br />
A parte questo (ne riparleremo più tardi) tutto sembra funzionare bene. Se un player entra nella colshape, il timer è avviato, se resta dentro 10 secondi il messaggio viene mostrato e se esce il timer viene eliminato.<br />
<br />
===Un errore ancora meno visibile===<br />
Ma per qualche ragione il messaggio viene mostrato due volte se entri nella [[IT/Elemento/Collision shape|colshape]] mentre sei in un [[IT/Elemento/Veicolo|veicolo]]. Siccome sembra che una parte del codice sia eseguita due volte, aggiungiamo dei messaggi di debug per controllarlo.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- messaggio di debug<br />
outputDebugString("colShapeHit")<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- messaggio di debug<br />
outputDebugString("colShapeLeave")<br />
-- elimina il timer quando un player esce dalla colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Ora ci rendiamo conto che entrambe le funzioni vengono eseguite due volte se siamo in un veicolo, ma solo una volta se siamo a piedi. Sembrerebbe che anche il veicolo chiami gli eventi legati alla colshape. Per confermare questa teoria, controlliamo la variabile ''player'' che '''dovrebbe''' contenere un [[IT/Elemento/Player|elemento player]].<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- messaggio di debug<br />
outputDebugString("colShapeHit "..getElementType(player) )<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- messaggio di debug<br />
outputDebugString("colShapeLeave "..getElementType(player) )<br />
-- elimina il timer quando un player esce dalla colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
I messaggi di debug ci mostrano che un sola delle variabili ''player'' è davvero un elemento player, l'altra è un elemento veicolo. Visto che vogliamo che lo script reagisca solo quando un player entra nella colshape, aggiungiamo un ''if'' che bloccherà l'esecuzione della funzione se ''player'' '''non''' è un elemento player.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- controllo del ''type'' dell'elemento<br />
if (getElementType(player) ~= "player") then return end<br />
-- messaggio di debug<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- controllo del ''type'' dell'elemento<br />
if (getElementType(player) ~= "player") then return end<br />
-- messaggio di debug<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- elimina il timer quando un player esce dalla colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Ora lo script dovrebbe funzionare come si desidera, ma continuiamo a ricevere il ''warning'' di cui abbiamo parlato prima. Ciò accade perchè il timer che cerchiamo di eliminare dopo che un player è rimasto 10 secondi nella [[IT/Elemento/Collision shape|colshape]] è già stato eseguito in precedenza e non esiste più. Ci sono diversi modi per risolvere questo ''warning'' (sapendo che il timer non esiste più e che dobbiamo eliminarlo solo se esiste ancora). Un modo sarebbe controllare se il timer riferito a quell'''index'' della tabella esista realmente. Per farlo, abbiamo bisogno di una piccola funzione 'ausiliaria':<br />
<syntaxhighlight lang="lua"><br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
Che useremo quando eliminiamo il timer:<br />
<syntaxhighlight lang="lua"><br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
</syntaxhighlight><br />
<br />
Perciò il codice completamente funzionante sarebbe:<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- controllo del ''type'' dell'elemento<br />
if (getElementType(player) ~= "player") then return end<br />
-- messaggio di debug<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- setta un timer per mostrare un messaggio (potrebbe ugualmente eseguire un'altra funzione)<br />
-- settare l'id del timer in una tabella, con il player come ''index''<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- controllo del ''type'' dell'elemento<br />
if (getElementType(player) ~= "player") then return end<br />
-- messaggio di debug<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- elimina il timer quando un player esce dalla colshape<br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
<br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
<br />
[[en:Debugging]]<br />
[[ru:Debugging]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Debugging&diff=21218RU/Debugging2009-08-24T11:18:45Z<p>Divine: </p>
<hr />
<div>При написании скриптов вы обязательно столкнетесь с проблемами, которые не сможете решить немедленно. Цель этой страницы - показать вам основные способыы нахождения ошибок.<br />
<br />
==Консоль отладки==<br />
MTA включает консоль, которая показывает отладочные сообщения, выводимые функциями MTA и скриптами. Вы можете открыть ее введя ''debugscript x'' в консоли, где ''x'' уровень отладки:<br />
* '''1:''' только ошибки<br />
* '''2:''' ошибки и предупреждения<br />
* '''3:''' ошибки, предупреждения и информационные сообщения<br />
Так, введя ''debugscript 3'', вы будете видеть все сообщения, этот или 2 уровень рекомендуется в большинстве случаев. Рекомендуем держать debugscript включенным всё время, пока вы тестируете свой скрипт, это поможет вам обнаружить мелкие ошибки и исправить их.<br />
<br />
===Пример===<br />
Этот участок кода содержит две ошибки:<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor")<br />
outputChatbox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
При попытке запуска скрипта, содержащего этот участо кода, debugscript выведет что-то похожее на:<br />
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}<br />
Это означает, что скрипт не может быть обработан из-за синтаксической ошибки. Показывается путь к скрипту, поэтому вы можете увидеть, какому ресурсу он принадлежит, ('myResource' в данном случае) и, конечно же, имя скрипта. После имени файла показан номер строки и информация об ошибке. Теперь проблема легко решается, мы просто забыли написать ключевое слово 'then':<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatbox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
Теперь скрипт загрузится нормально и не будет выводить ошибок пока не выполнится для игрока с ником 'Fedor'. Тогда debugscript выведет:<br />
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}<br />
Это значит, вызванная вами функция не существует, оно и понятно, ведь правильное название этой функции ''outputChatBox'' (с заглавной буквы ''B''):<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatBox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
<br />
Конечно, это просто пример, есть множество других сообщений и сценариев.<br />
<br />
==Debug logging==<br />
{{translate}}<br />
You can also turn debug message logging on by editing ''coreconfig.xml'' in your GTA\MTA folder. You should find the following tag:<br />
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight><br />
<br />
Replace that with a tag specifying the file you want to log messages to (file path is relative from the GTA folder):<br />
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight><br />
<br />
All debug messages will be appended to the specified file from now on. To turn logging off, replace that line with an empty tag again.<br />
<br />
==Debug strategies==<br />
There are several strategies that support finding errors, apart from going through the code of course. Most of them include outputting debug messages, with differing information depending on the situtation.<br />
<br />
===Useful functions===<br />
First of all some functions that may come in handy for debugging.<br />
* [[outputDebugString]] or [[outputChatBox]] for outputting any information<br />
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] on a variable to turn it into a string, for example when it contains a boolean value<br />
* [[getElementType]] to check an MTA Element for its type<br />
<br />
===Add debugmessages to check ''if'', ''when'' or ''how often'' a section of code is executed===<br />
A typical example would be verify whether an ''if''-section is executed or not. To do that, just add any message you will recognize later within the ''if''-section.<br />
<syntaxhighlight lang="lua"><br />
if (variable1 == variable2) then<br />
outputDebugString("entered if")<br />
-- do anything<br />
end<br />
</syntaxhighlight><br />
<br />
Another application would be to check when variable values are modified. First search for all occurences of the variable being edited and add a message just beside it.<br />
<br />
===Add debugmessages to check the ''value'' of a variable===<br />
Let's say you want to create a marker, but it doesn't appear at the position you expect it to be. The first thing you might want to do is check if the [[createMarker]] function is executed. But while doing this, you can also check the values being used in the [[createMarker]] function in one run.<br />
<syntaxhighlight lang="lua"><br />
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))<br />
createMarker(x,y,z)<br />
</syntaxhighlight><br />
This would output all three variables that are used as coordinates for the marker. Assuming you read those from a map file, you can now compare the debug output to the desired values. The [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] will ensure that the variables' value can be put together as a string, even if it's a boolean value for example.<br />
<br />
==Example==<br />
Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
When a player enters the colshape, debugscript outputs the following message:<br />
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}<br />
This means you tried to index a table that does not exist. In the example above, this is done when storing the timer id in the table. We need to add a check if the table exists and if not create it.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now we still get a warning when a player enters the colshape, waits for the message and leaves it again:<br />
<br />
{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}<br />
<br />
Except for that (we will talk about that later) everything seems to work fine. A player enters the colshape, the timer is started, if he stays the message occurs, if he leaves the timer is killed.<br />
<br />
===A more inconspicuous error===<br />
But for some reason the message gets outputted twice when you stay in the colcircle while in a vehicle. Since it would appear some code is executed twice, we add debug messages to check this.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a debug message<br />
outputDebugString("colShapeHit")<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a debug message<br />
outputDebugString("colShapeLeave")<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now we notice that both handler functions get executed twice when we are in a vehicle, but only once when we are on-foot. It would appear the vehicle triggers the colshape as well. To confirm this theory, we check the ''player'' variable that '''should''' contain a player element.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
The debug messages tell us that one of the ''player'' variables is a player, the other one a vehicle element. Since we only want to react when a player enters the colshape, we add an ''if'' that will end the execution of the function if it's '''not''' an player element.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now the script should work as desired, but will still output the warning mentioned above. This happens because the timer we try to kill when a player leaves the colshape will not exist anymore when it reached the 10 seconds and is executed. There are different ways to get rid of that warning (since you know that the timer might not exist anymore and you only want to kill it if it is there). One way would be to check if the timer referenced in the table really exists. To do this, we need a little help function:<br />
<syntaxhighlight lang="lua"><br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
Which we will use when we kill the timer:<br />
<syntaxhighlight lang="lua"><br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
</syntaxhighlight><br />
<br />
So the complete working code would be:<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
<br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
<br />
[[Category:Scripting Concepts]]<br />
[[en:Debugging]]<br />
[[it:Guida al Debug]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=RU/Debugging&diff=21217RU/Debugging2009-08-24T11:17:48Z<p>Divine: </p>
<hr />
<div>При написании скриптов вы обязательно столкнетесь с проблемами, которые не сможете решить немедленно. Цель этой страницы - показать вам основные способыы нахождения ошибок.<br />
<br />
==Консоль отладки==<br />
MTA включает консоль, которая показывает отладочные сообщения, выводимые функциями MTA и скриптами. Вы можете открыть ее введя ''debugscript x'' в консоли, где ''x'' уровень отладки:<br />
* '''1:''' только ошибки<br />
* '''2:''' ошибки и предупреждения<br />
* '''3:''' ошибки, предупреждения и информационные сообщения<br />
Так, введя ''debugscript 3'', вы будете видеть все сообщения, этот или 2 уровень рекомендуется в большинстве случаев. Рекомендуем держать debugscript включенным всё время, пока вы тестируете свой скрипт, это поможет вам обнаружить мелкие ошибки и исправить их.<br />
<br />
===Пример===<br />
Этот участок кода содержит две ошибки:<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor")<br />
outputChatbox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
При попытке запуска скрипта, содержащего этот участо кода, debugscript выведет что-то похожее на:<br />
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}<br />
Это означает, что скрипт не может быть обработан из-за синтаксической ошибки. Показывается путь к скрипту, поэтому вы можете увидеть, какому ресурсу он принадлежит, ('myResource' в данном случае) и, конечно же, имя скрипта. После имени файла показан номер строки и информация об ошибке. Теперь проблема легко решается, мы просто забыли написать ключевое слово 'then':<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatbox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
Теперь скрипт загрузится нормально и не будет выводить ошибок пока не выполнится для игрока с ником 'Fedor'. Тогда debugscript выведет:<br />
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}<br />
Это значит, вызванная вами функция не существует, оно и понятно, ведь правильное название этой функции ''outputChatBox'' (с заглавной буквы ''B''):<br />
<syntaxhighlight lang="lua"><br />
if (getClientName(player) == "Fedor") then<br />
outputChatBox("Hello Fedor")<br />
end<br />
</syntaxhighlight><br />
<br />
Конечно, это просто пример, есть множество других сообщений и сценариев.<br />
<br />
==Debug logging==<br />
{{translate}}<br />
You can also turn debug message logging on by editing ''coreconfig.xml'' in your GTA\MTA folder. You should find the following tag:<br />
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight><br />
<br />
Replace that with a tag specifying the file you want to log messages to (file path is relative from the GTA folder):<br />
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight><br />
<br />
All debug messages will be appended to the specified file from now on. To turn logging off, replace that line with an empty tag again.<br />
<br />
==Debug strategies==<br />
There are several strategies that support finding errors, apart from going through the code of course. Most of them include outputting debug messages, with differing information depending on the situtation.<br />
<br />
===Useful functions===<br />
First of all some functions that may come in handy for debugging.<br />
* [[outputDebugString]] or [[outputChatBox]] for outputting any information<br />
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] on a variable to turn it into a string, for example when it contains a boolean value<br />
* [[getElementType]] to check an MTA Element for its type<br />
<br />
===Add debugmessages to check ''if'', ''when'' or ''how often'' a section of code is executed===<br />
A typical example would be verify whether an ''if''-section is executed or not. To do that, just add any message you will recognize later within the ''if''-section.<br />
<syntaxhighlight lang="lua"><br />
if (variable1 == variable2) then<br />
outputDebugString("entered if")<br />
-- do anything<br />
end<br />
</syntaxhighlight><br />
<br />
Another application would be to check when variable values are modified. First search for all occurences of the variable being edited and add a message just beside it.<br />
<br />
===Add debugmessages to check the ''value'' of a variable===<br />
Let's say you want to create a marker, but it doesn't appear at the position you expect it to be. The first thing you might want to do is check if the [[createMarker]] function is executed. But while doing this, you can also check the values being used in the [[createMarker]] function in one run.<br />
<syntaxhighlight lang="lua"><br />
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))<br />
createMarker(x,y,z)<br />
</syntaxhighlight><br />
This would output all three variables that are used as coordinates for the marker. Assuming you read those from a map file, you can now compare the debug output to the desired values. The [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] will ensure that the variables' value can be put together as a string, even if it's a boolean value for example.<br />
<br />
==Example==<br />
Imagine you created a colshape (collision shape) somewhere and you want a player to stay 10 seconds in it, then perform some action.<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
When a player enters the colshape, debugscript outputs the following message:<br />
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}<br />
This means you tried to index a table that does not exist. In the example above, this is done when storing the timer id in the table. We need to add a check if the table exists and if not create it.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now we still get a warning when a player enters the colshape, waits for the message and leaves it again:<br />
<br />
{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}<br />
<br />
Except for that (we will talk about that later) everything seems to work fine. A player enters the colshape, the timer is started, if he stays the message occurs, if he leaves the timer is killed.<br />
<br />
===A more inconspicuous error===<br />
But for some reason the message gets outputted twice when you stay in the colcircle while in a vehicle. Since it would appear some code is executed twice, we add debug messages to check this.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a debug message<br />
outputDebugString("colShapeHit")<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a debug message<br />
outputDebugString("colShapeLeave")<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now we notice that both handler functions get executed twice when we are in a vehicle, but only once when we are on-foot. It would appear the vehicle triggers the colshape as well. To confirm this theory, we check the ''player'' variable that '''should''' contain a player element.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
The debug messages tell us that one of the ''player'' variables is a player, the other one a vehicle element. Since we only want to react when a player enters the colshape, we add an ''if'' that will end the execution of the function if it's '''not''' an player element.<br />
<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
killTimer(colshapeTimer[player])<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
</syntaxhighlight><br />
<br />
Now the script should work as desired, but will still output the warning mentioned above. This happens because the timer we try to kill when a player leaves the colshape will not exist anymore when it reached the 10 seconds and is executed. There are different ways to get rid of that warning (since you know that the timer might not exist anymore and you only want to kill it if it is there). One way would be to check if the timer referenced in the table really exists. To do this, we need a little help function:<br />
<syntaxhighlight lang="lua"><br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
Which we will use when we kill the timer:<br />
<syntaxhighlight lang="lua"><br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
</syntaxhighlight><br />
<br />
So the complete working code would be:<br />
<syntaxhighlight lang="lua"><br />
function colShapeHit(player)<br />
if (colshapeTimer == nil) then<br />
colshapeTimer = {}<br />
end<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeHit "..getElementType(player))<br />
-- set a timer to output a message (could as well execute another function)<br />
-- store the timer id in a table, using the player as index<br />
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")<br />
end<br />
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)<br />
<br />
function colShapeLeave(player)<br />
-- add a check for the element type<br />
if (getElementType(player) ~= "player") then return end<br />
-- add a debug message, with the element type<br />
outputDebugString("colShapeLeave "..getElementType(player))<br />
-- kill the timer when the player leaves the colshape<br />
if (isTimer(colshapeTimer[player])) then<br />
killTimer(colshapeTimer[player])<br />
end<br />
end<br />
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)<br />
<br />
function isTimer(timer)<br />
local timers = getTimers()<br />
for k,v in ipairs(timers) do<br />
if (v == timer) then<br />
return true<br />
end<br />
end<br />
return false<br />
end<br />
</syntaxhighlight><br />
<br />
[[it:Guida al Debug]]<br />
[[Category:Scripting Concepts]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=Resources&diff=21216Resources2009-08-24T11:13:27Z<p>Divine: </p>
<hr />
<div>Resources are a key part of MTA. A resource is essentially a folder or zip file that contains a collection of files - including essential script files, plus a ''meta'' file that describes how the resource should be loaded. A resource can be seen as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once. Its worth remember though, that unlike programs on an operating system, there is no multi-tasking between resources.<br />
<br />
==Terminology==<br />
* '''Resource''' - A zip file or folder containing a meta.xml file and a number of resource items. These are placed in the ''mods/deathmatch/resources'' folder in the server directory.<br />
* '''Resource item''' - A file contained within a resource, currently this can be a map, script, images etc.<br />
<br />
==The Meta File==<br />
''See main article [[Meta.xml]] for details''<br />
<br />
The Meta file is the core of each the resource. It describes exactly what files in the resource should be used, and how. The following is an example that covers every option there is, your meta files can have as many or as few of these tags as you require:<br />
<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="eAi" description="This is a basic CTF script" version="4"/><br />
<br />
<include resource="radarblips"/><br />
<include resource="markermanagement" /><br />
<br />
<script src="ctf.lua" /><br />
<script src="flag.lua" /><br />
<script src="ctf_client.lua" type="client" /><br />
<br />
<file src="model.dff" /><br />
<file src="quitbutton.png" /><br />
<file src="killed.png" /><br />
<br />
<html src="test.htm" default="true"/><br />
<html src="logo.png" raw="true" /><br />
<br />
<export function="multiply" http="true" /><br />
<export function="getPlayerList" /><br />
<export function="getElementOwner" type="client"/><br />
<br />
<config src="vehicle-list.xml" type="client" /><br />
<config src="markerconfig.xml" type="server" /><br />
<br />
<map src="somestuff.map" dimension="99" /><br />
</meta><br />
</syntaxhighlight><br />
While a CTF map may have a meta.xml that looks like:<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<include resource="ctf" /><br />
<map src="myuberl33tctfmap.map" /><br />
<br />
<info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
<br />
Script/type, Config/type and File/type attributes specify if the script/resource should be sent to clients or not, and defaults to "server".<br />
<br />
The include tag specifies other resources that should be started before this resoucre is started. In other words, if your resource is dependent on another, you can include it so that the other resource is started first,<br />
<br />
<br />
Each resource has its own virtual machine (VM). This contains every script in the resource. This means that variables are not shared with other resources. The best way to communictate with other resources is by using the ''export'' tag and exporting a function. This will enable other resources to fire this function using the [[call]] scripting function.<br />
<br />
<br />
Scripts sent to clients are started as soon as all the scripts have been downloaded.<br />
<br />
<br />
Scripts are able to read and write to their own resource folder with functions such as [[xmlCreateFile]] and [[fileCreate]]. They can also read and write to other resources, but must have [[Access_Control_List|ACL]] access. <br />
<br />
<br />
Each resource can only be loaded once, the server will ensure this. If a resource is included more than once, the same instance will be used by each resource that includes it.<br />
<br />
==File storage==<br />
Resource files can either be stored in a zip or a directory. This is located in:<br />
<br />
server/mods/deathmatch/resources/ (for MTASA clients)<br />
<br />
or<br />
<br />
mods/deathmatch/resources/ (for dedicated server installations)<br />
<br />
Each resource can have a zip file, a directory or both. In the case of both existing, the directory has precedence over the zip file, as such files can be placed in the directory to over-ride the files in the zip file. This allows directories to be used for testing and developing of maps/scripts while zip files used by end-users.<br />
<br />
==Script functions==<br />
The resource system can be manipulated by script. As such, the following Serverside scripting functions are provided:<br />
{{Resource functions}}<br />
<br />
The following events are also provided:<br />
{{Resource_events}}<br />
<br />
[[it:Introduzione alle Risorse]]<br />
[[ru:Resources]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=IT/Introduzione_alle_Risorse&diff=21215IT/Introduzione alle Risorse2009-08-24T11:12:18Z<p>Divine: </p>
<hr />
<div>{{IT/MainP}}<br />
[[Category:100%]]<br />
[[Category:IT/Concetti di scripting]]<br />
Le '''risorse''' sono una parte chiave di MTA. Essenzialmente una riosra è una cartella o un archivio zip contenente dei file - tra cui gli script essenziali ed un file ''meta'' che descrive al [[IT/Server|server]] come la risorsa dev'essere caricata. Una risorsa può essere vista come un programma in un sistema operativo - può essere avviata e fermata, e più risorse possono essere avviate in contemporanea.<br />
<br />
==Terminologia==<br />
* '''Resource''': Un archivio zip o una cartella contenente un file [[IT/Meta.xml|meta.xml]] e un certo numero di altri file (''resource items''). Questa va posizionata nella cartella <syntaxhighlight lang="lua"><SERVER>/mods/deathmatch/resources</syntaxhighlight> di MTA.<br />
* '''Resource item''': Un file contenuto in una risorsa, possono essere script LUA, mappe, immagini eccetera.<br />
==Il File Meta==<br />
''Guarda l'articolo principale [[Meta.xml]] per dettagli''<br />
<br />
Il file Meta è il nucleo di ogni risorsa. Descrive esattamente quali files verranno usati nella risorsa, e come. Il seguente è un esempio che comprende ogni opzione che il tuo meta file può contenere e che ti potrebbero servire:<br />
<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info author="eAi" description="This is a basic CTF script" version="4"/><br />
<br />
<include resource="radarblips"/><br />
<include resource="markermanagement" /><br />
<br />
<script src="ctf.lua" /><br />
<script src="flag.lua" /><br />
<script src="ctf_client.lua" type="client" /><br />
<br />
<file src="model.dff" /><br />
<file src="quitbutton.png" /><br />
<file src="killed.png" /><br />
<br />
<html src="test.htm" default="true"/><br />
<html src="logo.png" raw="true" /><br />
<br />
<export function="multiply" http="true" /><br />
<export function="getPlayerList" /><br />
<export function="getElementOwner" type="client"/><br />
<br />
<config src="vehicle-list.xml" type="client" /><br />
<config src="markerconfig.xml" type="server" /><br />
<br />
<map src="somestuff.map" dimension="99" /><br />
</meta><br />
</syntaxhighlight><br />
While a CTF map may have a meta.xml that looks like:<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<include resource="ctf" /><br />
<map src="myuberl33tctfmap.map" /><br />
<br />
<info author="Tom" instructions="this is uber l33t !!!!!1111111" type="map" /><br />
</meta><br />
</syntaxhighlight><br />
<br />
Gli attributi Script/type, Config/type e File/type specificato se lo script/la risorsa deve essere inviato al client o no, e il default è "server".<br />
<br />
Il tag include specifica le altre risorse che devono essere eseguite prima che questa risorsa sia avviata. In altre parole, se la tua risorsa depende da un'altra, puoi includere quest'ultima cosicchè l'altra risorse sia avviata prima.<br />
<br />
Ogni riosrsa ha la propria macchina virtuale [ (VM ) Virtual Machine in inglese ]. Questa contiene ogni script nella risorsa. Questo significa che le variabili non sono condivise con altre risorse. Il miglior modo per comunicare con le altre risorse è usando il tag ''export'' ed esportando una funzione. Questo abiliterà le altre risorse a far partire questa funzione usando la funzione [[call]].<br />
<br />
Gli script inviati ai client sono avviati non appena tutti gli script sono stati scaricati.<br />
<br />
Gli script possono leggere e scrivere alle prorie cartelle delle risorse con funzioni come [[xmlCreateFile]] e [[fileCreate]].<br />
Possono anche leggere e scrivere alle altre risorse, ma deve avere l'accesso da [[Access_Control_List[ACL]]].<br />
<br />
Ogni risorsa può essere solo caricata una volta, il server se ne accerterà. Se una risorsa è inclusa più di una volta, la stessa istanza sarà usata da ogni risorsa che la include.<br />
<br />
==Memorizzazione dei File==<br />
Le risorse possono sia essere memorizzati in un archivio zip sia in una cartella. Queste si trovano qui:<br />
<br />
mods/deathmatch/resources/<br />
<br />
Ogni risorsa può avere un file zip, una cartella o entrambi. Nel caso che esistino entrambi, la cartella ha precedenza sul file zip, in quanto tale i file possono essere messi nella cartella per "annullare" i file nell'archivio zip. Questo permette alle cartelle di essere usato per testare e sviluppare mappe/script mentre i file zip quando sono pronti per essere usati.<br />
<br />
==Funzioni Script==<br />
Il sistema delle risorce può essre amministrato da script. In quanto tale, sono disponibili le seguenti funzioni Serverside:<br />
{{Resource functions}}<br />
<br />
Anche i seguenti eventi sono disponibili:<br />
{{Resource_events}}<br />
[[en:Resources]]<br />
[[ru:Resources]]</div>Divinehttps://wiki.multitheftauto.com/index.php?title=%D0%93%D0%BB%D0%B0%D0%B2%D0%BD%D0%B0%D1%8F_%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0&diff=21214Главная страница2009-08-24T11:10:29Z<p>Divine: /* Начало */</p>
<hr />
<div><div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Последняя стабильная версия '''Multi Theft Auto: San Andreas Deathmatch''' - '''{{Current Version|full}}'''. Посетите [http://mtasa.com/dp.html download page] для скачивания.<br />
<p><br />
Также вы можете получить актуальную [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 версию для разработчиков], чтобы воспользоваться последними разработками.<br />
</p><br />
</div><br />
__NOTOC__<br />
Добро пожаловать в Wiki разработчиков Multi Theft Auto: San Andreas Deathmatch. <br />
Здесь вы найдёте информацию по разработке игровых модов и карт для Multi Theft Auto.<br />
<br />
Есть много [[RU/How you can help|способов помочь нам]] сделать MTA лучше - создать карту, игровой режим, добавить описание функции скриптинга, написать пример кода, руководство, или просто играть в MTA и сообщать о найденых багах на форум.<br />
<br />
Пожалуйста, отнеситесь с пониманием к неизбежному появлению ошибок и помните, что многие вещи еще не сделаны до конца!<br />
<br />
Если у вас есть какие-либо вопросы по скриптингу, вы можете задать их в нашем [[IRC Channel |IRC канале]].<br />
<br />
'''Для редактирования статей вам понадобится [http://community.mtasa.com/ MTA Community] аккаунт.'''<br />
Пожалуйста зарегистрируйтесь на сайте [http://community.mtasa.com MTA Community] и используйте полученные логин/пароль для авторизации здесь. Акты вандализма будут караться баном вашего аккаунта.<br />
<br />
<div style="clear:both;"></div><br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
|-<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
====Начало====<br />
<br />
* [[RU/Deathmatch_Client_Manual|Руководство по клиентской части MTA]]<br />
* [[RU/Deathmatch_Server_Manual|Руководство по серверной части MTA]]<br />
* [[RU/Known_Issues_-_FAQ|Известные проблемы MTA:SA DM]]<br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI | Введение в скриптинг GUI (графический пользовательский интерфейс)]]<br />
* [[RU/Debugging| Руководство по отладке]] - Как найти ошибки в ваших скриптах.<br />
* [[RU/MTA Classes | Классы MTA]] - Детальные описания всех специфических типов MTA<br />
** [[RU/Element|MTA Элементы]] / [[RU/Element tree | Дерево элементов]]<br />
* [[RU/Resources| Введение в ресурсы]]<br />
** [[RU/Resource Web Access | Ресурс веб-доступа]]<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml | Meta.xml]]<br />
* [[RU/Map_manager|Менеджер карт]]<br />
* [[:Category:Modules|Модули]]<br />
* [[RU/Introduction_to_Scripting_the_GUI|Введение в скриптинг пользовательских интерфейсов]]<br />
* [[RU/Writing_Gamemodes| Создание игровых режимов]]<br />
<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Базы данных====<br />
В этой секции описаны все возможности LUA, предоставляемые MTA и ресурсами.<br />
* [[:Category:RU/Resource|Каталог ресурсов]] - Изучите это, чтобы писать хорошие скрипты<br />
* [[RU/Client side scripts | Клиентские скрипты]]<br />
</div><br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Основная помощь по Lua====<br />
Страницы, которые могут вам помочь в изучении LUA<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на LUA (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[http://gtascript.ru Портал по скриптингу. Строгая модерация.]<br />
</div><br />
<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Редактор карт====<br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат объявлений редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;"><br />
<br />
====Описание====<br />
* [[RU/Client Scripting Functions|Функции, выполняемые на стороне клиента]]<br />
* [[RU/Client Scripting Events|События, генерируемые на стороне клиента]]<br />
* [[RU/Server Scripting Functions|Функции, выполняемые на стороне сервера]]<br />
* [[RU/Server Scripting Events|События, генерируемые на стороне сервера]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
</div><br />
<br />
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;"><br />
<br />
====Список идентификаторов====<br />
*[[Animations|Анимации]]<br />
*[[RU/Character Skins | Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда]]<br />
*[[RU/Garage|Идентификаторы гаражей]]<br />
*[[Interior IDs | Интерьеры]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar_blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle_colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Апгрейды транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<br />
|-<br />
| colspan="2" |<br />
|}<br />
[[pl:Main Page]]<br />
[[en:Main Page]]<br />
[[es:Pagina Principal]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[de:Hauptseite]]</div>Divine