RU/Compiling MTASA

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

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

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

Компиляция клиента Multi Theft Auto поддерживается только в Windows 10.

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

Visual Studio 2022

1. Скачайте Microsoft Visual Studio 2022 - убедитесь, что вы получаете "Community Edition", который является бесплатным.
2. В контрольном списке установки, убедитесь, что вы отметили эти два пункта:
   1. Разработка классических приложений на C++
   2. MFC-библиотека C++ для новейшей версии Build Tools v143 (x86 и x64)

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

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

Microsoft DirectX SDK

Скачайте Microsoft DirectX SDK (August 2009) (DXSDK_Aug09.exe):

• Зеркало 1
• Зеркало 2

Проверка файлов

Алгоритм и вариант		Хэш	Хэш-файл
SHA-3	SHA3-224	8bfcdc03518d7edd34689534fd4d21291469ff2f2eb10437ad648c58	DXSDK_Aug09.exe.sha3-224
	SHA3-256	45bf3e08da3b3636ddb4f4a74243430f8d65759c074c0d79756ef810c4701c5a	DXSDK_Aug09.exe.sha3-256
	SHA3-384	b358e529963d6f5fd7f8bd4b530fb18f6a2e6a442009a54e981b2f9967589ed48150af310f283640d56f9b60d41100c9	DXSDK_Aug09.exe.sha3-384
	SHA3-512	43522187053af744250059ef69c0f3083cecd1157fe56daac16b9497ebc6fb5b525875144e42898367c55f757cffd3526f37074d544470578602a5a944a45a75	DXSDK_Aug09.exe.sha3-512
	SHAKE128	2a7c81bde9e867cbb5ef00b72ad8de66a3ee64c1d59f16465fa712479b6a84d28a02cc5ed08afa1d51e72011657453dbd4656cc9340d32e18179c39d03982dfc35c8f0c2a5c99e11dc74d0e23ed21b1e55f19c809a5a152bde39a2d46fcd12421f373f2d691ade1b57faf6c2ab7aded5a7d174f1f1c77127c0d6a1523b4775c569c5e1b4efa2da4bf2f708a96707a709e245a7f507382e69a81777919c90e95a091c0b699ce7f517	DXSDK_Aug09.exe.sha3-128000
	SHAKE256	9c100dac5245a61774f3a2752bf9e941bdcd5654b18035155161c63b20936dfc9bd7334feb9a6fe9a99a65491161083b39ac3bd578e2cf4f90cba3c786e9924fa0611f65a725331b77b63e7c8b552e1637bc77531ba0f2c9cac72115b28e523929ede4e5b246a0755e8d5c4089d94bf16627fb08672cfffa523bba3d976489a0eec60d3c6a96ca2b	DXSDK_Aug09.exe.sha3-256000
SHA-2	SHA-224	a3a74b89cccfe314b79418d5598aac5e94800221e5d945c74f15c004	DXSDK_Aug09.exe.sha2-224
	SHA-256	4ab1de69312f10f6b41310a5218d80c478bbd823bc0f86627318d690b128fb9f	DXSDK_Aug09.exe.sha2-256
	SHA-384	254ed29c6ad2cadc6f013d2d51c0ac78a6bbe236a2c94ca99610eba8b2c1200d1a62c445ca9ee51bb09354875d5eca8a	DXSDK_Aug09.exe.sha2-384
	SHA-512	736393c0dfa32221e229890f87eb330174d70dd2a02fa0cace303816d3e7a10a332a44129748de39665d1b339e627d6028c2080268f7afdd5240c447fec8ff0b	DXSDK_Aug09.exe.sha2-512
	SHA-512/224	7e23d9ba916000782a17e23abf48e25237f45590cfe767aed9d79f10	DXSDK_Aug09.exe.sha2-512224
	SHA-512/256	0c833a56046fe7e4213fcb1862c730acf313d1b8f60b51eebf64dc3e79730c1c	DXSDK_Aug09.exe.sha2-512256
MD5		66e5379ecf46b014688779621bcc677c	DXSDK_Aug09.exe.md5
SHA-1		5b9b969ed7b6cf5534bb7350e44c09b3573b0e71	DXSDK_Aug09.exe.sha1

CRC32 e9f5c61d (DXSDK_Aug09.exe.sfv)

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

Git Клиент

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

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

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

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

• Репозиторий: multitheftauto/mtasa-blue
• .zip: master.zip
• .tar.gz: master.tar.gz

Компиляция кода

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

Запуск ПО

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

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

Запуск выделенного сервера

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

Установка последних ресурсов

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

Наш официальный репозиторий, откуда вы можете скачать все ресурсы находится на GitHub. Вы также можете скачать все последние ресурсы в ZIP формате. Убедитесь, что у вас есть все необходимые ресурсы для продолжения.

Запуск сервера

• Продолжение перевода скоро, а пока вы можете ознакомиться с версией статьи на английском языке