MTA:World - игровой режим для Multi Theft Auto, который планировалось запустить на серверах сети Prineside, и о котором шла речь в группе VK. Разработка приостановлена, подробности можно прочитать в группе.

Разработка мода производилась на ОС Windows 7, поэтому вспомогательные скрипты и исполняемые файлы, скорее всего, будут работать только на этой ОС. Для разработки на других ОС необходимо поправить пути и зависимости в скриптах, это не должно занять много времени.

Готовые к релизу скрипты и ресурсы можно использовать на любой ОС, которую поддерживает сервер MTA.

Необходимые ресурсы

• OS Windows 7 или более новая
• Установщик клиента и сервера MTA (https://mtasa.com/download)
• Сервер MySQL (https://dev.mysql.com/downloads/installer/)
• Интерпретатор PHP 5.6 для Windows (https://windows.php.net/download/) (для прекомпилятора и вспомогательных скриптов)
• Node.js (https://nodejs.org/en/download/) (для минификации и обфускации скриптов js и стилей css графического интерфейса, используется прекомпилятором)
• (опционально) Git для Windows (https://git-scm.com/download/win) (используется прекомпилятором для создания "резервных копий")

Подготовка и запуск

• Установите клиент и сервер MTA
• Установите сервер MySQL, создайте базу данных с названием mtaw и импортируйте (выполните) mtaw.sql. Для удобства можно использовать клиент MySQL, например HeidiSQL
• Распакуйте интерпретатор PHP в любой каталог (например, C:\php), пропишите путь к интерпретатору в PATH инструкция
• Установите Node.js, откройте консоль и выполните следующие команды:
  • set NODE_PATH=%USERPROFILE%\node_modules
  • npm install clean-css
  • npm install uglify-js
• Скачайте компилятор для своей ОС из сайта MTA и поместите в каталог compiler (должен быть файл compiler/luac.exe или compiler/luac)
• (опционально) Установите Git
• Скопируйте содержимое каталога resources в [Путь установки сервера MTA]/mods/deathmatch/resources
• Замените файлы [Путь установки сервера MTA]/mods/deathmatch/acl.xml и [Путь установки сервера MTA]/mods/deathmatch/mtaserver.conf файлами из корня репозитория
• Отредактируйте resources/MTAW/compiler/db-handles-debug.xml и resources/MTAW/compiler/db-handles-release.xml, смените login, password на данные, указанные при установке MySQL. (разные конфигурации будут использованы в зависимости от того, установлен ли RELEASE в compiler.php - debug для локальной машины, где происходит разработка, release для реального сервера, где, скорее всего, установлены другие логин и пароль)
• Ознакомьтесь с комментариями в файле MTAW/compile.php, при необходимости отредактируйте его. Запустите compile.bat двойным кликом (либо командой php compile.php в каталоге MTAW). Будет произведена подготовка файлов к запуску на сервере, скомпилированы клиентские скрипты, сгенерирован мета-файл ресурса и установлены данные для подключения к базе. Если появится ошибка вида "php не является исполняемым файлом...", убедитесь, что вы установили интерпретатор PHP и прописали PATH к php.exe (см. выше)
• Запустите MTA Server.exe и подождите, пока сервер полностью загрузится. При необходимости, исправьте ошибки, которые возникнут

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

Для того, чтобы разобраться с модом было легче, весь код написан с учетом определенных правил оформления и прокомментирован. Кроме того, был написан небольшой генератор документации (типа javadoc), который способен сгенерировать интерактивный HTML-файл для более удобного изучения структуры мода (при условии, что разработчик придерживается всех правил оформления кода). Для генерации документации, запустите файл inspect.bat, через несколько секунд рядом появится файл inspector.html с документацией, который можно открыть любым браузером. Рекомендуется прочитать комментарии в файле inspect.php перед началом разработки, если вы хотите генерировать документацию в будущем.

В репозитории размещены другие ресурсы, не только MTAW, что они здесь делают?

Другие ресурсы (возможно, не все), используются ресурсом MTAW. Они были разработаны другими людьми, и получены из сайта ресурсов для MTA. Ресурсы размещены в этом репозитории для (чуть) более простого решения проблем с зависимостями у тех, кто будет пытаться запустить мод MTAW. Ресурсы могут быть немного изменены или вовсе устарели. Все права на ресурсы принадлежат их авторам.

Я могу использовать исходный код / ресурсы MTA:W как захочу?

MTA:W распространяется по лицензии MIT (файл LICENSE в корне репозитория). Это значит, что код и ресурсы можно бесплатно использовать в любых целях - модифицировать, распространять, использовать на своих серверах в коммерческих целях и даже продавать, но никто не дает гарантии их правильной работы и не отвечает за любые последствия их использования.

Не получается запустить мод / выдает ошибку / работает неправильно, к кому обратиться за помощью?

По вопросам, которые относятся к серверу и исходному коду мода (написанному на Lua), лучше всего обратиться на официальный форум MTA. Если возникают проблемы при использовании вспомогательных скриптов или программ, внимательно изучите инструкции в данном README и почитайте комментарии в скриптах - возможно, у вас не установлены какие-то зависимости.

Что здесь делают PHP-скрипты?

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

Не могу войти / зарегистрироваться на своем сервере

Регистрация не была реализована. Мод изначально разрабатывался под сеть Prineside, где аутентификация пользователей реализована с помощью других технологий (игровые моды не работают напрямую с базой данных). Сейчас мод может только читать таблицу базы данных accounts, для добавления новых игроков нужно добавить записи в эту таблицу (id - уникальный идентификатор игрока, автоинкрементное поле, login - логин игрока, tester - установить в 1 для доступа к серверу во время тестирования, blowfish - случайная строка ('соль'), которая используется для шифрования пароля (16 рандомных символов, для каждого игрока свои), hash - хэш-строка из 32 символов, которая содержит зашифрованный пароль по алгоритму md5( md5( password ) + blowfish ). Для примера, в таблицу уже добавлен один игрок с логином admin и паролем password. Никогда не храните пароли в открытом виде!