Multi Theft Auto: Wiki - User contributions [en]

Category:RU/Needs Checking

2026-01-29T01:57:35Z

Rasliv: Created page with "Страницы, которые нуждаются в проверке"

Страницы, которые нуждаются в проверке

RU/Main Page

2026-01-29T01:44:39Z

Rasliv: Исправил перевод

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;">
[[File:Mtalogo.png|left|100px|link=https://wiki.multitheftauto.com/wiki/RU/Main_Page]]'''Добро пожаловать в вики о модификации [[RU/Multi Theft Auto|Multi Theft Auto]] для игры Grand Theft Auto: San Andreas.''' Здесь вы найдёте множество информации об использовании этой модификации.

Есть много [[Как ты можешь помочь|вещей]], которые вы можете сделать, чтобы помочь нам улучшить Multi Theft Auto - создать карту, игровой режим, добавить описание функций скриптинга, написать пример кода, руководство, или просто поиграть в Multi Theft Auto и сообщить о найденных недоработках.

Если у вас есть какие-либо вопросы или проблемы, связанные со скриптингом, вы можете [[RU/Places_To_Chat|связаться с нами]].
<br/><br/>[ Перестань играть с самим собой ]
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎|link=]]</div>
<h3>Играть</h3>
<div style="background: #FFEEAA; border: 1px solid #FFCD19;">
[[File:Go-down.png|link=https://mtasa.com/]] ''' [https://mtasa.com/ Скачать Multi Theft Auto {{Current Version|full}}]'''</div>
* [[RU/Where to buy GTASA|Где купить Grand Theft Auto: San Andreas]]
* [[RU/Client Manual|Руководство о клиенте]]

* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}| Изменения в версии {{padleft:|5|{{Current Version|full}}}}]]
* [[RU/Known Issues_-_FAQ|Известные проблемы]]
* [[RU/Upgrading_from_MTA:Race|Переход из MTA:Race в MTA:SA {{padleft:|3|{{Current Version|full}}}}]]
* [[RU/Server Manual|Руководство о сервере]]
* [[RU/Map manager|Менеджер карт]]

<h3>Редактор карт</h3>
*[[RU/Resource:Editor|Руководство]]
*[[RU/Resource:Editor/EDF|Формат определения редактора]]
*[[RU/Resource:Editor/Plugins|Плагины]]
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎|link=]]</div>
<h3>Базы данных</h3>
В этом разделе описаны все возможности Lua, предоставляемые Multi Theft Auto и ресурсами.
* [[:RU/Category:Resource|Каталог ресурсов]] - изучите их, чтобы создавать правильные скрипты
* [[RU/Client side scripts|Клиентские скрипты]]
* [[Modules|Модули]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎|link=]]</div>
<h3>Разработка Multi Theft Auto</h3>
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Ночные сборки]
* [[RU/Compiling_MTASA|Компилирование MTA:SA на Windows]]

* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTA:SA на GNU/Linux]]
* [[RU/Coding guidelines|Рекомендации по написанию кода]]
* [https://github.com/multitheftauto/mtasa-blue Главный репозиторий GitHub]
* [[RU/Roadmap|План разработки]]
* [https://bugs.mtasa.com/ Багтрекер]
* [[RU/Branches|Ответвления]]
* [[RU/Forks|Forks and anti cheat]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div>
<h3>Вики - как вы можете помочь</h3>
* Заполните документацию для [[:Category:RU/Incomplete|незавершённых функций]].
* Добавьте [[:Category:RU/Needs_Example|примеры использования функций и событий]].
* Просмотрите и проверьте [[:Category:RU/Needs Checking|страницы, требующие проверки]].
* Напишите руководства для помощи новичкам.
* Переводите страницы вики.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎|link=]]</div>
<h3>Сообщество</h3>
* [https://forum.multitheftauto.com/ Англоязычный форум]
* [https://forum.multitheftauto.com/forum/100-russian-русский/ Русскоязычный форум]
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Официальный MTA Discord сервер]
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [https://community.mtasa.com/ Сообщество MTA] - обмен и закачка ресурсов
* [https://twitter.com/#!/MTAQA/ Twitter] - [https://www.youtube.com/user/MTAQA YouTube] - [https://plus.google.com/102014133442331779727/ Google+] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas Mod DB]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div>
<h3>Скриптинг</h3>
* [[RU/Scripting Introduction|Введение в скриптинг]]
* [[RU/Introduction to Scripting the GUI|Введение в GUI-скриптинг]]
* [[RU/Debugging|Руководство по отладке]] - как найти ошибки в ваших скриптах
* [[RU/Resources|Введение в ресурсы]]
** [[RU/Resource Web Access|Веб-доступ к ресурсам]] - как можно связать сайт и ресурсы
** [[:Category:RU/Resource|Каталог ресурсов]]
** [[RU/Meta.xml|Meta.xml]] - имеющийся у каждого ресурса файл-описание
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов
* [[RU/Writing_Gamemodes|Создание игровых ресурсов]]
* [[RU/Script_security|Как писать безопасные скрипты и не бояться читеров]]
* [[RU/Useful_Functions|Полезные функции]]
Форумные ссылки
* [https://forum.mtasa.com/forum/71-scripting/ Скриптинг]
* [https://forum.mtasa.com/forum/123-tutorials/ Руководства по скриптингу]
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Вики-копии офлайн]
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div>
<h3>Общая информация о Lua</h3>
Страницы, которые могут вам помочь в изучении Lua
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)]
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]
*[http://lua-users.org/wiki/TutorialDirectory Lua-вики (англ.)]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]
*[https://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;">
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div>
<h3>Справка</h3>
* [[RU/Client Scripting Functions|Клиентские функции]]
* [[RU/Client Scripting Events|Клиентские события]]
* [[RU/Server Scripting Functions|Серверные функции]]
* [[RU/Server Scripting Events|Серверные события]]

* [[RU/MTA Classes|Классы MTA]] - подробное описание всех настраиваемых типов MTA
** [[RU/Element|Элементы MTA]]/[[RU/Element tree|Дерево элементов]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div>
<h3>[[RU/Id|Списки идентификаторов]]</h3>
*[[RU/Animations|Анимации]]
*[[RU/Character Skins|Скины персонажей]]
*[[RU/CJ_Clothes|Одежда CJ]]
*[[RU/Garage|Гаражи]]
*[[RU/Interior IDs|Интерьеры]]
*[[RU/Material IDs|Материалы]]
*[[RU/Projectiles|Снаряды]]
*[[RU/Radar Blips|Метки радара]]
*[[RU/Sounds|Звуки]]
*[[RU/Vehicle IDs|Транспорт]]
*[[RU/Vehicle Colors|Цвета транспорта]]
*[[RU/Vehicle Upgrades|Модернизация транспорта]]
*[[RU/Vehicle variants|Варианты транспорта]]
*[[RU/Vehicle component manipulation|Манипуляция компонентов транспорта]]
*[[RU/Weapons|Оружие]]
*[[RU/Weather|Погода]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]
'''Multi Theft Auto''' имеет '''открытый исходный код'''.
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!
</div>
|-
| colspan="2" |
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks">
[[File:MTALogo_8ball.png|left|85px|link=Archive]]
<ul style="list-style: none; width: 200px; float: left;">
<li>'''О [[Multi Theft Auto]]'''</li>
<li>[[RU/Archive|Архив]]</li>
<li>[[RU/Press Coverage|В прессе]]</li>
<li>[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Разработчики]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Multi Theft Auto 0.5'''</li>
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li>
<li>[[MTA 0.5r2 Known Issues|Известные проблемы]]</li>
</ul>
<ul style="list-style: none; width: 200px; float: left;">
<li>'''Статистика вики'''</li>
<li>Статей: {{NUMBEROFARTICLES}}</li>
<li>Страниц: {{NUMBEROFPAGES}}</li>
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li>
</ul>
</div>
|}

__NOTOC__
__NOEDITSECTION__
[[ar:Main Page‎]]
[[cs:hlavni‎]]
[[sk:Main Page‎]]
[[de:Hauptseite]]
[[en:Main Page]]
[[es:Página Principal]]
[[fr:Main Page]]
[[hu:Main Page‎]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Strona_Główna]]
[[pt-br:Página Inicial‎]]
[[tr:Anasayfa]]
[[zh-cn:Main Page]]

RU/Building MTASA Server on GNU Linux

2026-01-29T01:36:43Z

Rasliv:

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

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

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

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

'''Debian Linux'''

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

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

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

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

'''Gentoo Linux'''

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

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

Образец:

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

'''Fedora'''

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если вы получили какие-либо неожиданные ошибки в процессе компиляции, пожалуйста, посетите наш [https://github.com/multitheftauto/mtasa-blue/issues багтрекер] или [https://discord.com/invite/mtasa Discord]

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

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

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

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

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

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

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

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

[[en:Building MTASA Server on GNU Linux]]
[[Category:Translated/Development]]

RU/Compiling MTASA

2026-01-29T01:25:31Z

Rasliv: /* 32px Additional information */

Для того чтобы успешно собрать Multi Theft Auto из исходного кода, необходимо выполнить ряд шагов, которые мы объясним ниже.

Пожалуйста, внимательно прочитайте инструкцию и не пропускайте ее части, если у вас нет опыта.

== Начало работы ==

Компиляция клиента и сервера Multi Theft Auto поддерживается в Windows 10 и 11. В Linux вы можете скомпилировать сервер Multi Theft Auto ([[Building MTASA Server on GNU Linux|Ознакомьтесь с этой статьей]]).

Убедитесь что у вас установлено следующее программное обеспечение и SDK:

=== Visual Studio 2026 ===
[[File:Visual_Studio_Community.PNG|right|150px|link=https://visualstudio.microsoft.com/ru/vs/]]
#Скачайте и установите '''[https://visualstudio.microsoft.com/vs/ Microsoft Visual Studio 2026]''' - убедитесь, что вы получаете "Community Edition", который является бесплатным.
# В контрольном списке установки, [[:File:VsFoundationClasses.png|убедитесь, что вы отметили эти два пункта]]:
## ''Разработка классических приложений на C++''
## ''MFC-библиотека C++ для новейшей версии Build Tools v145 (x86 и x64)''

Если вы не включите MFC библиотеку, то получите следующую ошибку: <code>cannot open include file 'afxres.h'</code>.

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

=== Microsoft DirectX SDK ===
[[File:DirectX_SDK.jpg|right|150px|link=http://web.archive.org/web/20200804044856/https://www.microsoft.com/en-us/download/details.aspx?id=23549]]
'''Скачайте Microsoft DirectX SDK (August 2009) (DXSDK_Aug09.exe):'''
* [https://archive.org/download/dxsdk_aug09/DXSDK_Aug09.exe Зеркало 1]
* [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe Зеркало 2]

{| class="wikitable" style="margin-top: 0px; width: 70%; word-break: break-all;"
|+ Проверка файлов
|- style="vertical-align:bottom;"
! colspan="2" | Алгоритм и вариант
! Хэш
! Хэш-файл
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-3}}''' || ''SHA3-224'' || 8bfcdc03518d7edd34689534fd4d21291469ff2f2eb10437ad648c58 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-224 DXSDK_Aug09.exe.sha3-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-256'' || 45bf3e08da3b3636ddb4f4a74243430f8d65759c074c0d79756ef810c4701c5a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256 DXSDK_Aug09.exe.sha3-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-384'' || b358e529963d6f5fd7f8bd4b530fb18f6a2e6a442009a54e981b2f9967589ed48150af310f283640d56f9b60d41100c9 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-384 DXSDK_Aug09.exe.sha3-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-512'' || 43522187053af744250059ef69c0f3083cecd1157fe56daac16b9497ebc6fb5b525875144e42898367c55f757cffd3526f37074d544470578602a5a944a45a75 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-512 DXSDK_Aug09.exe.sha3-512]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE128'' || 2a7c81bde9e867cbb5ef00b72ad8de66a3ee64c1d59f16465fa712479b6a84d28a02cc5ed08afa1d51e72011657453dbd4656cc9340d32e18179c39d03982dfc35c8f0c2a5c99e11dc74d0e23ed21b1e55f19c809a5a152bde39a2d46fcd12421f373f2d691ade1b57faf6c2ab7aded5a7d174f1f1c77127c0d6a1523b4775c569c5e1b4efa2da4bf2f708a96707a709e245a7f507382e69a81777919c90e95a091c0b699ce7f517 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-128000 DXSDK_Aug09.exe.sha3-128000]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE256'' || 9c100dac5245a61774f3a2752bf9e941bdcd5654b18035155161c63b20936dfc9bd7334feb9a6fe9a99a65491161083b39ac3bd578e2cf4f90cba3c786e9924fa0611f65a725331b77b63e7c8b552e1637bc77531ba0f2c9cac72115b28e523929ede4e5b246a0755e8d5c4089d94bf16627fb08672cfffa523bba3d976489a0eec60d3c6a96ca2b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256000 DXSDK_Aug09.exe.sha3-256000]
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-2}}''' || ''SHA-224'' || a3a74b89cccfe314b79418d5598aac5e94800221e5d945c74f15c004 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-224 DXSDK_Aug09.exe.sha2-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-256'' || 4ab1de69312f10f6b41310a5218d80c478bbd823bc0f86627318d690b128fb9f || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-256 DXSDK_Aug09.exe.sha2-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA-384'' || 254ed29c6ad2cadc6f013d2d51c0ac78a6bbe236a2c94ca99610eba8b2c1200d1a62c445ca9ee51bb09354875d5eca8a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-384 DXSDK_Aug09.exe.sha2-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512'' || style="width: 60%;" | 736393c0dfa32221e229890f87eb330174d70dd2a02fa0cace303816d3e7a10a332a44129748de39665d1b339e627d6028c2080268f7afdd5240c447fec8ff0b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512 DXSDK_Aug09.exe.sha2-512]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/224'' || 7e23d9ba916000782a17e23abf48e25237f45590cfe767aed9d79f10 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512224 DXSDK_Aug09.exe.sha2-512224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/256'' || 0c833a56046fe7e4213fcb1862c730acf313d1b8f60b51eebf64dc3e79730c1c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512256 DXSDK_Aug09.exe.sha2-512256]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''MD5''' || 66e5379ecf46b014688779621bcc677c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.md5 DXSDK_Aug09.exe.md5]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''{{nowrap|SHA-1}}''' || 5b9b969ed7b6cf5534bb7350e44c09b3573b0e71 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha1 DXSDK_Aug09.exe.sha1]
|}
CRC32 e9f5c61d ([https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sfv DXSDK_Aug09.exe.sfv])<br>

'''Примечание:''' перезагрузите компьютер после установки ''Microsoft DirectX SDK'', так как в противном случае переменная окружения '''DXSDK_DIR''' еще не будет доступна. После его перезапуска повторно запустите '''create-projects.bat'''

=== Git Клиент ===
[[File:Git_logo.png|left|32px|link=https://git-scm.com/]]

Если вы хотите внести свой вклад в MTA, вам следует установить Git Клиент. Это позволит вам сотрудничать с нами, создавая собственные ветвления, которые вы сможете использовать в своей работе. Если вам не нравится командная строка, мы рекомендуем вам скачать и установить это: [https://desktop.github.com/ GitHub Desktop].

Если вы хотите только скомпилировать исходный код и не заинтересованы в участии в MTA, вы можете загрузить исходный код напрямую (см. ниже).

== Получение последнего исходного кода ==

Чтобы получить последний код, вам нужно будет загрузить последнюю копию нашего Git репозитория.<br>
Мы рекомендуем клонировать репозиторий в вашем Git клиенте, потому что вы можете легко извлекать оттуда любые обновления.

* '''Репозиторий:''' [https://github.com/multitheftauto/mtasa-blue multitheftauto/mtasa-blue]
* '''.zip:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.zip master.zip]
* '''.tar.gz:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz master.tar.gz]

== Компиляция кода ==
# Выполните скрипт '''win-create-projects.bat'''
# Откройте файл '''MTASA.sln''' в '''Build''' директории
# Если вам предложат обновить клиент, нажмите '''Cancel'''
# Выполните компиляцию в Visual Studio с помощью '''Debug''' конфигурации (это может заняться несколько минут)
# Выполните скрипт '''win-install-data.bat'''

= Запуск ПО =

== Запуск клиента ==

Вы можете запустить свой клиент в '''Bin''' каталоге. Вы можете найти там ''Multi Theft Auto.exe'' и/или ''Multi Theft Auto_d.exe''. Суффикс ''_d'' указывает на отладочную сборку программного обеспечения.<br>
Кроме того, вы также можете запустить свой клиент внутри отладчика Visual Studio, если хотите исследовать трассировку стека или установить точки остановки в интересных областях кода (Подробнее читайте в разделе "Отладка" ниже).

== Запуск выделенного сервера ==
Если вы уже выполнили шаг 5 (Установка ресурсов) в пункте '''Компиляция кода''', то вы можете перейти к пункту '''Запуск сервера'''

=== Установка последних ресурсов ===
Если вы хотите запустить выделенный сервер Multi Theft Auto, то вам придется установить все необходимые ресурсы. Они нужны, потому что они реализуют самые основные функции (спавн игроков, например).

Наш официальный репозиторий, откуда вы можете скачать все ресурсы [https://github.com/multitheftauto/mtasa-resources находится на GitHub]. Вы также можете скачать все последние ресурсы в [http://mirror.mtasa.com/mtasa/resources/ ZIP формате]. Убедитесь, что у вас есть все необходимые ресурсы для продолжения.

=== Запуск выделенного сервера ===
Если вы уже запустили "win-install-data.bat" и выбрали "Установить ресурсы", то вы можете перейти к [[#Starting the server]].

===Установка самых последних ресурсов===
Если вы хотите запустить выделенный сервер Multi Theft Auto, вам необходимо установить официальные ресурсы. Этот пакет по умолчанию включает ресурсы, которые обеспечивают самую базовую функциональность (например, создание новых игроков) для игры.

=== Запуск сервера ===
Чтобы запустить сервер, откройте исполняемый файл "MTA Server.exe" в каталоге "Bin/server". Суффикс "_d" указывает на отладочную сборку программного обеспечения.<br>
Вы также можете запустить отладочную сборку "MTA Server_d.exe " с помощью отладчика Visual Studio (на момент написания статьи вы можете сделать это, щелкнув правой кнопкой мыши на проекте запуска сервера и выбрав "Запустить локальный экземпляр" в меню "Отладчик"), но вы также можете подключиться к запущенной отладке создайте сервер MTA (подробнее смотрите в разделе "Отладка" ниже).

= [[File:Preferences-system.svg|32px]] Отладка =
Если вы уже скомпилировали код в конфигурации "Отладка", продолжайте чтение, если нет, перейдите к разделу "Компиляция кода" и следуйте инструкциям по сборке "Отладка".<br>
Чтобы выполнить компиляцию в режиме "Release", щелкните по списку "Debug" и переключитесь на "Release".<br>
Вы можете либо запустить MTA самостоятельно и подключить любой отладчик, который хотите использовать (это также относится к отладчику Visual Studio), либо запустить локальный сеанс отладки в Visual Studio.<br>
[[File:Local_Windows_Debugger.PNG]]

== Как включить точки останова ==
Если вы решите запустить MTA с помощью Visual Studio, вам также следует подключить отладчик к исполняемому файлу "'gta_sa.exe" (нажмите "CTRL + ALT + P" в Visual Studio) - в противном случае ваши
точки останова не будут работать ни для чего, кроме проекта запуска MTA.<br>
[[File:Attach_to_Process.png|600px]]

== Увеличение продолжительности тайм-аута ==
Когда вы используете точки останова во время отладки, сервер может заблокировать вас из-за тайм-аута, поскольку клиент заморожен. Чтобы предотвратить это, создайте тайм-аут "'.файл "longtime" в вашем каталоге "Bin/server/".
Содержимое файла - это новая продолжительность тайм-аута в секундах, поэтому убедитесь, что вы ввели там большое количество символов. Если вы оставите файл пустым, тайм-аут будет установлен на 120 секунд.

== Повторное подключение для Visual Studio ==
Вы можете использовать [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach Повторное подключение] для повторного подключения отладчика к исполняемому файлу "'gta_sa.exe" всякий раз, когда вы запускаете локальный отладчик в Visual Studio.<br>
[[File:ReAttach_to_GTASA.PNG]]

= [[File:System-users.svg|32px]] Как принять участие =
Пожалуйста, ознакомьтесь с нашими [[Coding guidelines]] для получения информации о практике кодирования.

= [[File:Mail-reply-all.svg|32px]] Дополнительная информация =
Если вам нужно больше информации, можете посмотреть здесь: [https://github.com/multitheftauto/mtasa-blue/issues bug tracker] или [https://discord.com/invite/mtasa Discord].

= Error Troubleshooting =

==Не удается открыть включаемый файл "afxres.h"==
Эта ошибка вызвана неполной настройкой Visual Studio. Используйте установщик Visual Studio, чтобы включить дополнительный компонент "C++ MFC для новейших средств сборки версии 145 (x86 и x64)".

==Не удается найти d3dx9.h==
Добавьте "'$(DXSDK_DIR)Include;"' в каталоги VC++ в проектах DirectX9GuiRenderer, GUI и Client Core.
Вы можете найти список каталогов VC++, выбрав проект, затем нажав сочетание клавиш ALT + ENTER (без +), затем в разделе "Свойства конфигурации" вы можете найти "Каталоги VC++", и там вы можете найти поле "Включить каталоги", нажмите на него и добавьте "';$(DXSDK_DIR)включает в себя;"' в конце.
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Не могу найти файл d3dx9.lib==
Сделайте то же самое, что и в приведенной выше ошибке, но вместо "';$(DXSDK_DIR)Include;"' вы должны добавить "';$(DXSDK_DIR)Lib/x86;"' в поле "Каталоги библиотек".
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Ошибка S1023==
[https://support.microsoft.com/en-us/kb/2728613 Ошибка "S1023" при установке DirectX SDK (June 2010)]<br style="clear:both">

==Не удается открыть исходный файл "xxx.h" после обновления до Visual Studio 2026==
Если вы только что обновились до Visual Studio 2026 и работали над MTA, используя предыдущую версию, при сборке проекта могут появляться ошибки о том, что заголовочные файлы не найдены (stdio.h, stddef.h и т.д.).

Убедитесь, что у вас установлена последняя версия Windows 10/11 SDK (через установщик Visual Studio) и перезагрузите компьютер.

Если это не сработает - закройте Visual Studio, перейдите в папку "Build" (где находится ваш mtasa-blue) и удалите папку `.vs`. Запустите Visual Studio, и все должно быть исправлено.

== Ошибка CL38. [netc_d.dll not found] ==
Решение: удалите "'Multi Theft Auto_d.exe" и снова нажмите "скомпилировать".

== После клонирования репозитория проект не компилируется ==
Решение: Запустите "'win-create-projects.bat"' в главном каталоге.

== CL17 Load field. Пожалуйста, убедитесь, что файлы данных установлены правильно ==
Решение: Запустите "'win-install-data.bat"' в главном каталоге.

== ОШИБКА: Не удалось загрузить сетевую библиотеку (net_d.dll)! ==
Решение: Запустите "'win-install-data.bat"' в главном каталоге.

[[pt-br:Compilando o MTASA]]
[[en:Compiling MTASA]]
[[pl:Kompilowanie MTASA]]

[[Category:Translated/Development]]

RU/Compiling MTASA

2026-01-29T01:23:28Z

Rasliv: Полный перевод

Для того чтобы успешно собрать Multi Theft Auto из исходного кода, необходимо выполнить ряд шагов, которые мы объясним ниже.

Пожалуйста, внимательно прочитайте инструкцию и не пропускайте ее части, если у вас нет опыта.

== Начало работы ==

Компиляция клиента и сервера Multi Theft Auto поддерживается в Windows 10 и 11. В Linux вы можете скомпилировать сервер Multi Theft Auto ([[Building MTASA Server on GNU Linux|Ознакомьтесь с этой статьей]]).

Убедитесь что у вас установлено следующее программное обеспечение и SDK:

=== Visual Studio 2026 ===
[[File:Visual_Studio_Community.PNG|right|150px|link=https://visualstudio.microsoft.com/ru/vs/]]
#Скачайте и установите '''[https://visualstudio.microsoft.com/vs/ Microsoft Visual Studio 2026]''' - убедитесь, что вы получаете "Community Edition", который является бесплатным.
# В контрольном списке установки, [[:File:VsFoundationClasses.png|убедитесь, что вы отметили эти два пункта]]:
## ''Разработка классических приложений на C++''
## ''MFC-библиотека C++ для новейшей версии Build Tools v145 (x86 и x64)''

Если вы не включите MFC библиотеку, то получите следующую ошибку: <code>cannot open include file 'afxres.h'</code>.

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

=== Microsoft DirectX SDK ===
[[File:DirectX_SDK.jpg|right|150px|link=http://web.archive.org/web/20200804044856/https://www.microsoft.com/en-us/download/details.aspx?id=23549]]
'''Скачайте Microsoft DirectX SDK (August 2009) (DXSDK_Aug09.exe):'''
* [https://archive.org/download/dxsdk_aug09/DXSDK_Aug09.exe Зеркало 1]
* [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe Зеркало 2]

{| class="wikitable" style="margin-top: 0px; width: 70%; word-break: break-all;"
|+ Проверка файлов
|- style="vertical-align:bottom;"
! colspan="2" | Алгоритм и вариант
! Хэш
! Хэш-файл
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-3}}''' || ''SHA3-224'' || 8bfcdc03518d7edd34689534fd4d21291469ff2f2eb10437ad648c58 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-224 DXSDK_Aug09.exe.sha3-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-256'' || 45bf3e08da3b3636ddb4f4a74243430f8d65759c074c0d79756ef810c4701c5a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256 DXSDK_Aug09.exe.sha3-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-384'' || b358e529963d6f5fd7f8bd4b530fb18f6a2e6a442009a54e981b2f9967589ed48150af310f283640d56f9b60d41100c9 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-384 DXSDK_Aug09.exe.sha3-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-512'' || 43522187053af744250059ef69c0f3083cecd1157fe56daac16b9497ebc6fb5b525875144e42898367c55f757cffd3526f37074d544470578602a5a944a45a75 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-512 DXSDK_Aug09.exe.sha3-512]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE128'' || 2a7c81bde9e867cbb5ef00b72ad8de66a3ee64c1d59f16465fa712479b6a84d28a02cc5ed08afa1d51e72011657453dbd4656cc9340d32e18179c39d03982dfc35c8f0c2a5c99e11dc74d0e23ed21b1e55f19c809a5a152bde39a2d46fcd12421f373f2d691ade1b57faf6c2ab7aded5a7d174f1f1c77127c0d6a1523b4775c569c5e1b4efa2da4bf2f708a96707a709e245a7f507382e69a81777919c90e95a091c0b699ce7f517 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-128000 DXSDK_Aug09.exe.sha3-128000]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE256'' || 9c100dac5245a61774f3a2752bf9e941bdcd5654b18035155161c63b20936dfc9bd7334feb9a6fe9a99a65491161083b39ac3bd578e2cf4f90cba3c786e9924fa0611f65a725331b77b63e7c8b552e1637bc77531ba0f2c9cac72115b28e523929ede4e5b246a0755e8d5c4089d94bf16627fb08672cfffa523bba3d976489a0eec60d3c6a96ca2b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256000 DXSDK_Aug09.exe.sha3-256000]
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-2}}''' || ''SHA-224'' || a3a74b89cccfe314b79418d5598aac5e94800221e5d945c74f15c004 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-224 DXSDK_Aug09.exe.sha2-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-256'' || 4ab1de69312f10f6b41310a5218d80c478bbd823bc0f86627318d690b128fb9f || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-256 DXSDK_Aug09.exe.sha2-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA-384'' || 254ed29c6ad2cadc6f013d2d51c0ac78a6bbe236a2c94ca99610eba8b2c1200d1a62c445ca9ee51bb09354875d5eca8a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-384 DXSDK_Aug09.exe.sha2-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512'' || style="width: 60%;" | 736393c0dfa32221e229890f87eb330174d70dd2a02fa0cace303816d3e7a10a332a44129748de39665d1b339e627d6028c2080268f7afdd5240c447fec8ff0b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512 DXSDK_Aug09.exe.sha2-512]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/224'' || 7e23d9ba916000782a17e23abf48e25237f45590cfe767aed9d79f10 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512224 DXSDK_Aug09.exe.sha2-512224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/256'' || 0c833a56046fe7e4213fcb1862c730acf313d1b8f60b51eebf64dc3e79730c1c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512256 DXSDK_Aug09.exe.sha2-512256]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''MD5''' || 66e5379ecf46b014688779621bcc677c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.md5 DXSDK_Aug09.exe.md5]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''{{nowrap|SHA-1}}''' || 5b9b969ed7b6cf5534bb7350e44c09b3573b0e71 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha1 DXSDK_Aug09.exe.sha1]
|}
CRC32 e9f5c61d ([https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sfv DXSDK_Aug09.exe.sfv])<br>

'''Примечание:''' перезагрузите компьютер после установки ''Microsoft DirectX SDK'', так как в противном случае переменная окружения '''DXSDK_DIR''' еще не будет доступна. После его перезапуска повторно запустите '''create-projects.bat'''

=== Git Клиент ===
[[File:Git_logo.png|left|32px|link=https://git-scm.com/]]

Если вы хотите внести свой вклад в MTA, вам следует установить Git Клиент. Это позволит вам сотрудничать с нами, создавая собственные ветвления, которые вы сможете использовать в своей работе. Если вам не нравится командная строка, мы рекомендуем вам скачать и установить это: [https://desktop.github.com/ GitHub Desktop].

Если вы хотите только скомпилировать исходный код и не заинтересованы в участии в MTA, вы можете загрузить исходный код напрямую (см. ниже).

== Получение последнего исходного кода ==

Чтобы получить последний код, вам нужно будет загрузить последнюю копию нашего Git репозитория.<br>
Мы рекомендуем клонировать репозиторий в вашем Git клиенте, потому что вы можете легко извлекать оттуда любые обновления.

* '''Репозиторий:''' [https://github.com/multitheftauto/mtasa-blue multitheftauto/mtasa-blue]
* '''.zip:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.zip master.zip]
* '''.tar.gz:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz master.tar.gz]

== Компиляция кода ==
# Выполните скрипт '''win-create-projects.bat'''
# Откройте файл '''MTASA.sln''' в '''Build''' директории
# Если вам предложат обновить клиент, нажмите '''Cancel'''
# Выполните компиляцию в Visual Studio с помощью '''Debug''' конфигурации (это может заняться несколько минут)
# Выполните скрипт '''win-install-data.bat'''

= Запуск ПО =

== Запуск клиента ==

Вы можете запустить свой клиент в '''Bin''' каталоге. Вы можете найти там ''Multi Theft Auto.exe'' и/или ''Multi Theft Auto_d.exe''. Суффикс ''_d'' указывает на отладочную сборку программного обеспечения.<br>
Кроме того, вы также можете запустить свой клиент внутри отладчика Visual Studio, если хотите исследовать трассировку стека или установить точки остановки в интересных областях кода (Подробнее читайте в разделе "Отладка" ниже).

== Запуск выделенного сервера ==
Если вы уже выполнили шаг 5 (Установка ресурсов) в пункте '''Компиляция кода''', то вы можете перейти к пункту '''Запуск сервера'''

=== Установка последних ресурсов ===
Если вы хотите запустить выделенный сервер Multi Theft Auto, то вам придется установить все необходимые ресурсы. Они нужны, потому что они реализуют самые основные функции (спавн игроков, например).

Наш официальный репозиторий, откуда вы можете скачать все ресурсы [https://github.com/multitheftauto/mtasa-resources находится на GitHub]. Вы также можете скачать все последние ресурсы в [http://mirror.mtasa.com/mtasa/resources/ ZIP формате]. Убедитесь, что у вас есть все необходимые ресурсы для продолжения.

=== Запуск выделенного сервера ===
Если вы уже запустили "win-install-data.bat" и выбрали "Установить ресурсы", то вы можете перейти к [[#Starting the server]].

===Установка самых последних ресурсов===
Если вы хотите запустить выделенный сервер Multi Theft Auto, вам необходимо установить официальные ресурсы. Этот пакет по умолчанию включает ресурсы, которые обеспечивают самую базовую функциональность (например, создание новых игроков) для игры.

=== Запуск сервера ===
Чтобы запустить сервер, откройте исполняемый файл "MTA Server.exe" в каталоге "Bin/server". Суффикс "_d" указывает на отладочную сборку программного обеспечения.<br>
Вы также можете запустить отладочную сборку "MTA Server_d.exe " с помощью отладчика Visual Studio (на момент написания статьи вы можете сделать это, щелкнув правой кнопкой мыши на проекте запуска сервера и выбрав "Запустить локальный экземпляр" в меню "Отладчик"), но вы также можете подключиться к запущенной отладке создайте сервер MTA (подробнее смотрите в разделе "Отладка" ниже).

= [[File:Preferences-system.svg|32px]] Отладка =
Если вы уже скомпилировали код в конфигурации "Отладка", продолжайте чтение, если нет, перейдите к разделу "Компиляция кода" и следуйте инструкциям по сборке "Отладка".<br>
Чтобы выполнить компиляцию в режиме "Release", щелкните по списку "Debug" и переключитесь на "Release".<br>
Вы можете либо запустить MTA самостоятельно и подключить любой отладчик, который хотите использовать (это также относится к отладчику Visual Studio), либо запустить локальный сеанс отладки в Visual Studio.<br>
[[File:Local_Windows_Debugger.PNG]]

== Как включить точки останова ==
Если вы решите запустить MTA с помощью Visual Studio, вам также следует подключить отладчик к исполняемому файлу "'gta_sa.exe" (нажмите "CTRL + ALT + P" в Visual Studio) - в противном случае ваши
точки останова не будут работать ни для чего, кроме проекта запуска MTA.<br>
[[File:Attach_to_Process.png|600px]]

== Увеличение продолжительности тайм-аута ==
Когда вы используете точки останова во время отладки, сервер может заблокировать вас из-за тайм-аута, поскольку клиент заморожен. Чтобы предотвратить это, создайте тайм-аут "'.файл "longtime" в вашем каталоге "Bin/server/".
Содержимое файла - это новая продолжительность тайм-аута в секундах, поэтому убедитесь, что вы ввели там большое количество символов. Если вы оставите файл пустым, тайм-аут будет установлен на 120 секунд.

== Повторное подключение для Visual Studio ==
Вы можете использовать [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach Повторное подключение] для повторного подключения отладчика к исполняемому файлу "'gta_sa.exe" всякий раз, когда вы запускаете локальный отладчик в Visual Studio.<br>
[[File:ReAttach_to_GTASA.PNG]]

= [[File:System-users.svg|32px]] Как принять участие =
Пожалуйста, ознакомьтесь с нашими [[Coding guidelines]] для получения информации о практике кодирования.

= [[File:Mail-reply-all.svg|32px]] Additional information =
Если вам нужно больше информации, попробуйте посмотреть здесь [https://github.com/multitheftauto/mtasa-blue/issues bug tracker] или [https://discord.com/invite/mtasa Discord].

= Error Troubleshooting =

==Не удается открыть включаемый файл "afxres.h"==
Эта ошибка вызвана неполной настройкой Visual Studio. Используйте установщик Visual Studio, чтобы включить дополнительный компонент "C++ MFC для новейших средств сборки версии 145 (x86 и x64)".

==Не удается найти d3dx9.h==
Добавьте "'$(DXSDK_DIR)Include;"' в каталоги VC++ в проектах DirectX9GuiRenderer, GUI и Client Core.
Вы можете найти список каталогов VC++, выбрав проект, затем нажав сочетание клавиш ALT + ENTER (без +), затем в разделе "Свойства конфигурации" вы можете найти "Каталоги VC++", и там вы можете найти поле "Включить каталоги", нажмите на него и добавьте "';$(DXSDK_DIR)включает в себя;"' в конце.
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Не могу найти файл d3dx9.lib==
Сделайте то же самое, что и в приведенной выше ошибке, но вместо "';$(DXSDK_DIR)Include;"' вы должны добавить "';$(DXSDK_DIR)Lib/x86;"' в поле "Каталоги библиотек".
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Ошибка S1023==
[https://support.microsoft.com/en-us/kb/2728613 Ошибка "S1023" при установке DirectX SDK (June 2010)]<br style="clear:both">

==Не удается открыть исходный файл "xxx.h" после обновления до Visual Studio 2026==
Если вы только что обновились до Visual Studio 2026 и работали над MTA, используя предыдущую версию, при сборке проекта могут появляться ошибки о том, что заголовочные файлы не найдены (stdio.h, stddef.h и т.д.).

Убедитесь, что у вас установлена последняя версия Windows 10/11 SDK (через установщик Visual Studio) и перезагрузите компьютер.

Если это не сработает - закройте Visual Studio, перейдите в папку "Build" (где находится ваш mtasa-blue) и удалите папку `.vs`. Запустите Visual Studio, и все должно быть исправлено.

== Ошибка CL38. [netc_d.dll not found] ==
Решение: удалите "'Multi Theft Auto_d.exe" и снова нажмите "скомпилировать".

== После клонирования репозитория проект не компилируется ==
Решение: Запустите "'win-create-projects.bat"' в главном каталоге.

== CL17 Load field. Пожалуйста, убедитесь, что файлы данных установлены правильно ==
Решение: Запустите "'win-install-data.bat"' в главном каталоге.

== ОШИБКА: Не удалось загрузить сетевую библиотеку (net_d.dll)! ==
Решение: Запустите "'win-install-data.bat"' в главном каталоге.

[[pt-br:Compilando o MTASA]]
[[en:Compiling MTASA]]
[[pl:Kompilowanie MTASA]]

[[Category:Translated/Development]]

RU/Compiling MTASA

2026-01-28T16:31:00Z

Rasliv:

Для того чтобы успешно построить Multi Theft Auto из исходного кода, необходимо выполнить ряд шагов, которые мы объясним ниже.

Пожалуйста, внимательно прочитайте инструкцию и не пропускайте ее части, если у вас нет опыта.

== Начало работы ==

Компиляция клиента и сервера Multi Theft Auto поддерживается в Windows 10 и 11. В Linux вы также можете скомпилировать сервер Multi Theft Auto ([[Building MTASA Server on GNU Linux|Ознакомьтесь с этой статьей]]).

Убедитесь что у вас установлено следующее программное обеспечение и SDK:

=== Visual Studio 2026 ===
[[File:Visual_Studio_Community.PNG|right|150px|link=https://visualstudio.microsoft.com/ru/vs/]]
#Скачайте и установите '''[https://visualstudio.microsoft.com/vs/ Microsoft Visual Studio 2026]''' - убедитесь, что вы получаете "Community Edition", который является бесплатным.
# В контрольном списке установки, [[:File:VsFoundationClasses.png|убедитесь, что вы отметили эти два пункта]]:
## ''Разработка классических приложений на C++''
## ''MFC-библиотека C++ для новейшей версии Build Tools v145 (x86 и x64)''

Если вы не включите MFC библиотеку, то получите следующую ошибку: <code>cannot open include file 'afxres.h'</code>.

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

=== Microsoft DirectX SDK ===
[[File:DirectX_SDK.jpg|right|150px|link=http://web.archive.org/web/20200804044856/https://www.microsoft.com/en-us/download/details.aspx?id=23549]]
'''Скачайте Microsoft DirectX SDK (August 2009) (DXSDK_Aug09.exe):'''
* [https://archive.org/download/dxsdk_aug09/DXSDK_Aug09.exe Зеркало 1]
* [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe Зеркало 2]

{| class="wikitable" style="margin-top: 0px; width: 70%; word-break: break-all;"
|+ Проверка файлов
|- style="vertical-align:bottom;"
! colspan="2" | Алгоритм и вариант
! Хэш
! Хэш-файл
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-3}}''' || ''SHA3-224'' || 8bfcdc03518d7edd34689534fd4d21291469ff2f2eb10437ad648c58 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-224 DXSDK_Aug09.exe.sha3-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-256'' || 45bf3e08da3b3636ddb4f4a74243430f8d65759c074c0d79756ef810c4701c5a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256 DXSDK_Aug09.exe.sha3-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-384'' || b358e529963d6f5fd7f8bd4b530fb18f6a2e6a442009a54e981b2f9967589ed48150af310f283640d56f9b60d41100c9 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-384 DXSDK_Aug09.exe.sha3-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA3-512'' || 43522187053af744250059ef69c0f3083cecd1157fe56daac16b9497ebc6fb5b525875144e42898367c55f757cffd3526f37074d544470578602a5a944a45a75 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-512 DXSDK_Aug09.exe.sha3-512]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE128'' || 2a7c81bde9e867cbb5ef00b72ad8de66a3ee64c1d59f16465fa712479b6a84d28a02cc5ed08afa1d51e72011657453dbd4656cc9340d32e18179c39d03982dfc35c8f0c2a5c99e11dc74d0e23ed21b1e55f19c809a5a152bde39a2d46fcd12421f373f2d691ade1b57faf6c2ab7aded5a7d174f1f1c77127c0d6a1523b4775c569c5e1b4efa2da4bf2f708a96707a709e245a7f507382e69a81777919c90e95a091c0b699ce7f517 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-128000 DXSDK_Aug09.exe.sha3-128000]
|- style="text-align:center;vertical-align:center;"
| ''SHAKE256'' || 9c100dac5245a61774f3a2752bf9e941bdcd5654b18035155161c63b20936dfc9bd7334feb9a6fe9a99a65491161083b39ac3bd578e2cf4f90cba3c786e9924fa0611f65a725331b77b63e7c8b552e1637bc77531ba0f2c9cac72115b28e523929ede4e5b246a0755e8d5c4089d94bf16627fb08672cfffa523bba3d976489a0eec60d3c6a96ca2b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha3-256000 DXSDK_Aug09.exe.sha3-256000]
|- style="text-align:center;vertical-align:center;"
| rowspan="6" | '''{{nowrap|SHA-2}}''' || ''SHA-224'' || a3a74b89cccfe314b79418d5598aac5e94800221e5d945c74f15c004 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-224 DXSDK_Aug09.exe.sha2-224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-256'' || 4ab1de69312f10f6b41310a5218d80c478bbd823bc0f86627318d690b128fb9f || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-256 DXSDK_Aug09.exe.sha2-256]
|- style="text-align:center;vertical-align:center;"
| ''SHA-384'' || 254ed29c6ad2cadc6f013d2d51c0ac78a6bbe236a2c94ca99610eba8b2c1200d1a62c445ca9ee51bb09354875d5eca8a || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-384 DXSDK_Aug09.exe.sha2-384]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512'' || style="width: 60%;" | 736393c0dfa32221e229890f87eb330174d70dd2a02fa0cace303816d3e7a10a332a44129748de39665d1b339e627d6028c2080268f7afdd5240c447fec8ff0b || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512 DXSDK_Aug09.exe.sha2-512]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/224'' || 7e23d9ba916000782a17e23abf48e25237f45590cfe767aed9d79f10 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512224 DXSDK_Aug09.exe.sha2-512224]
|- style="text-align:center;vertical-align:center;"
| ''SHA-512/256'' || 0c833a56046fe7e4213fcb1862c730acf313d1b8f60b51eebf64dc3e79730c1c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha2-512256 DXSDK_Aug09.exe.sha2-512256]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''MD5''' || 66e5379ecf46b014688779621bcc677c || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.md5 DXSDK_Aug09.exe.md5]
|- style="text-align:center;vertical-align:center;"
| colspan="2" | '''{{nowrap|SHA-1}}''' || 5b9b969ed7b6cf5534bb7350e44c09b3573b0e71 || [https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sha1 DXSDK_Aug09.exe.sha1]
|}
CRC32 e9f5c61d ([https://assets.mtasa.com/DXSDK/DXSDK_Aug09.exe.sfv DXSDK_Aug09.exe.sfv])<br>

'''Примечание:''' перезагрузите компьютер после установки ''Microsoft DirectX SDK'', так как в противном случае переменная окружения '''DXSDK_DIR''' еще не будет доступна. После его перезапуска повторно запустите '''create-projects.bat'''

=== Git Клиент ===
[[File:Git_logo.png|left|32px|link=https://git-scm.com/]]

Если вы хотите внести свой вклад в MTA, вам следует установить Git Клиент. Это позволит вам сотрудничать с нами, создавая собственные ветвления, которые вы сможете использовать в своей работе. Если вам не нравится командная строка, мы рекомендуем вам скачать и установить это: [https://desktop.github.com/ GitHub Desktop].

Если вы хотите только скомпилировать исходный код и не заинтересованы в участии в MTA, вы можете загрузить исходный код напрямую (см. ниже).

== Получение последнего исходного кода ==

Чтобы получить последний код, вам нужно будет загрузить последнюю копию нашего Git репозитория.<br>
Мы рекомендуем клонировать репозиторий в вашем Git клиенте, потому что вы можете легко извлекать оттуда любые обновления.

* '''Репозиторий:''' [https://github.com/multitheftauto/mtasa-blue multitheftauto/mtasa-blue]
* '''.zip:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.zip master.zip]
* '''.tar.gz:''' [https://github.com/multitheftauto/mtasa-blue/archive/master.tar.gz master.tar.gz]

== Компиляция кода ==
# Выполните скрипт '''win-create-projects.bat'''
# Откройте файл '''MTASA.sln''' в '''Build''' директории
# Если вам предложат обновить клиент, нажмите '''Cancel'''
# Выполните компиляцию в Visual Studio с помощью '''Debug''' конфигурации (это может заняться несколько минут)
# Выполните скрипт '''win-install-data.bat'''

= Запуск ПО =

== Запуск клиента ==

Вы можете запустить свой клиент в '''Bin''' каталоге. Вы можете найти там ''Multi Theft Auto.exe'' и/или ''Multi Theft Auto_d.exe''. Суффикс ''_d'' указывает на отладочную сборку программного обеспечения.<br>
Кроме того, вы также можете запустить свой клиент внутри отладчика Visual Studio, если хотите исследовать трассировку стека или установить точки остановки в интересных областях кода (Подробнее читайте в разделе "Отладка" ниже).

== Запуск выделенного сервера ==
Если вы уже выполнили шаг 5 (Установка ресурсов) в пункте '''Компиляция кода''', то вы можете перейти к пункту '''Запуск сервера'''

=== Установка последних ресурсов ===
Если вы хотите запустить выделенный сервер Multi Theft Auto, то вам придется установить все необходимые ресурсы. Они нужны, потому что они реализуют самые основные функции (спавн игроков, например).

Наш официальный репозиторий, откуда вы можете скачать все ресурсы [https://github.com/multitheftauto/mtasa-resources находится на GitHub]. Вы также можете скачать все последние ресурсы в [http://mirror.mtasa.com/mtasa/resources/ ZIP формате]. Убедитесь, что у вас есть все необходимые ресурсы для продолжения.

=== Запуск выделенного сервера ===
Если вы уже запустили "win-install-data.bat" и выбрали "Установить ресурсы", то вы можете перейти к [[#Starting the server]].

===Установка самых последних ресурсов===
Если вы хотите запустить выделенный сервер Multi Theft Auto, вам необходимо установить официальные ресурсы. Этот пакет по умолчанию включает ресурсы, которые обеспечивают самую базовую функциональность (например, создание новых игроков) для игры.

=== Запуск сервера ===
Чтобы запустить сервер, откройте исполняемый файл "MTA Server.exe" в каталоге "Bin/server". Суффикс "_d" указывает на отладочную сборку программного обеспечения.<br>
Вы также можете запустить отладочную сборку "MTA Server_d.exe " с помощью отладчика Visual Studio (на момент написания статьи вы можете сделать это, щелкнув правой кнопкой мыши на проекте запуска сервера и выбрав "Запустить локальный экземпляр" в меню "Отладчик"), но вы также можете подключиться к запущенной отладке создайте сервер MTA (подробнее смотрите в разделе "Отладка" ниже).

= [[File:Preferences-system.svg|32px]] Debugging =
Если вы уже скомпилировали код в конфигурации "Отладка", продолжайте чтение, если нет, перейдите к разделу "Компиляция кода" и следуйте инструкциям по сборке "Отладка".<br>
Чтобы выполнить компиляцию в режиме "Release", щелкните по списку "Debug" и переключитесь на "Release".<br>
Вы можете либо запустить MTA самостоятельно и подключить любой отладчик, который хотите использовать (это также относится к отладчику Visual Studio), либо запустить локальный сеанс отладки в Visual Studio.<br>
[[File:Local_Windows_Debugger.PNG]]

== Как включить точки останова ==
Если вы решите запустить MTA с помощью Visual Studio, вам также следует подключить отладчик к исполняемому файлу "'gta_sa.exe" (нажмите "CTRL + ALT + P" в Visual Studio) - в противном случае ваши
точки останова не будут работать ни для чего, кроме проекта запуска MTA.<br>
[[File:Attach_to_Process.png|600px]]

== Увеличение продолжительности тайм-аута ==
Когда вы используете точки останова во время отладки, сервер может заблокировать вас из-за тайм-аута, поскольку клиент заморожен. Чтобы предотвратить это, создайте тайм-аут "'.файл "longtime" в вашем каталоге "Bin/server/".
Содержимое файла - это новая продолжительность тайм-аута в секундах, поэтому убедитесь, что вы ввели там большое количество символов. Если вы оставите файл пустым, тайм-аут будет установлен на 120 секунд.

== Повторное подключение для Visual Studio ==
Вы можете использовать [https://marketplace.visualstudio.com/items?itemName=ErlandR.ReAttach Повторное подключение] для повторного подключения отладчика к исполняемому файлу "'gta_sa.exe" всякий раз, когда вы запускаете локальный отладчик в Visual Studio.<br>
[[File:ReAttach_to_GTASA.PNG]]

= [[File:System-users.svg|32px]] Как принять участие =
Пожалуйста, ознакомьтесь с нашими [[Coding guidelines]] для получения информации о практике кодирования.

= [[File:Mail-reply-all.svg|32px]] Additional information =
Если вам нужно больше информации, попробуйте посмотреть здесь [https://github.com/multitheftauto/mtasa-blue/issues bug tracker] или [https://discord.com/invite/mtasa Discord].

= Error Troubleshooting =

==Не удается открыть включаемый файл "afxres.h"==
Эта ошибка вызвана неполной настройкой Visual Studio. Используйте установщик Visual Studio, чтобы включить дополнительный компонент "C++ MFC для новейших средств сборки версии 145 (x86 и x64)".

==Не удается найти d3dx9.h==
Добавьте "'$(DXSDK_DIR)Include;"' в каталоги VC++ в проектах DirectX9GuiRenderer, GUI и Client Core.
Вы можете найти список каталогов VC++, выбрав проект, затем нажав сочетание клавиш ALT + ENTER (без +), затем в разделе "Свойства конфигурации" вы можете найти "Каталоги VC++", и там вы можете найти поле "Включить каталоги", нажмите на него и добавьте "';$(DXSDK_DIR)включает в себя;"' в конце.
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Не могу найти файл d3dx9.lib==
Сделайте то же самое, что и в приведенной выше ошибке, но вместо "';$(DXSDK_DIR)Include;"' вы должны добавить "';$(DXSDK_DIR)Lib/x86;"' в поле "Каталоги библиотек".
""Примечание: вам нужно сделать то же самое и в режиме выпуска"".

==Ошибка S1023==
[https://support.microsoft.com/en-us/kb/2728613 Ошибка "S1023" при установке DirectX SDK (June 2010)]<br style="clear:both">

==Не удается открыть исходный файл "xxx.h" после обновления до Visual Studio 2026==
Если вы только что обновились до Visual Studio 2026 и работали над MTA, используя предыдущую версию, при сборке проекта могут появляться ошибки о том, что заголовочные файлы не найдены (stdio.h, stddef.h и т.д.).

Убедитесь, что у вас установлена последняя версия Windows 11 SDK (через установщик Visual Studio) и перезагрузите компьютер.

Если это не сработает - закройте Visual Studio, перейдите в папку "Build" (где находится ваш mtasa-blue) и удалите папку `.vs`. Запустите Visual Studio, и все должно быть исправлено.

* Продолжение перевода скоро, а пока вы можете ознакомиться с [https://wiki.multitheftauto.com/wiki/Compiling_MTASA версией статьи на английском языке]

[[pt-br:Compilando o MTASA]]
[[en:Compiling MTASA]]
[[pl:Kompilowanie MTASA]]

[[Category:Translated/Development]]

RU/Compiling MTASA

2026-01-28T16:08:50Z

Rasliv:

RU/Compiling MTASA

2026-01-28T16:06:45Z

Rasliv: Обновил раздел Visual Studio 2022 ---> 2026