Настройка mtaserver.conf MTA:SA — порты, слоты и ресурсы

Где находится файл mtaserver.conf

Файл располагается внутри каталога игрового модуля deathmatch:

mods/deathmatch/mtaserver.conf

Пример пути на Windows

C:\MTA-Server\mods\deathmatch\mtaserver.conf

При установке через официальный установщик путь может выглядеть так:

C:\Program Files (x86)\MTA San Andreas 1.6\server\mods\deathmatch\mtaserver.conf

Пример пути на Linux

/home/mtasa/mta-server/mods/deathmatch/mtaserver.conf

Если сервер установлен в другом каталоге, найдите папку mods/deathmatch относительно исполняемого файла MTA Server.

Как открыть файл на Windows

Подойдут следующие редакторы:

• Notepad++;
• Visual Studio Code;
• Sublime Text;
• обычный Блокнот Windows.

Как открыть файл на Linux

nano /home/mtasa/mta-server/mods/deathmatch/mtaserver.conf

Сохранение в Nano:

Ctrl + O
Enter
Ctrl + X

Структура файла mtaserver.conf

Конфигурация записывается в формате XML. Все активные параметры должны находиться внутри общего элемента config:

<config>

 <servername>My MTA Server</servername>
 <serverip>auto</serverip>
 <serverport>22003</serverport>
 <maxplayers>32</maxplayers>

</config>

Каждая настройка состоит из открывающего тега, значения и закрывающего тега:

<название_параметра>значение</название_параметра>

XML-комментарии

Закомментированная строка не применяется сервером:

<!-- <module src="sample_win32.dll" /> -->

Чтобы активировать параметр, необходимо убрать символы комментария:

<module src="sample_win32.dll" />

Самозакрывающиеся строки

Некоторые элементы используют атрибуты и закрываются символами />:

<resource src="admin" startup="1" protected="0" />

Правила редактирования mtaserver.conf

• остановите MTA Server перед редактированием;
• создайте копию исходного файла;
• не удаляйте корневые теги <config> и </config>;
• не оставляйте незакрытые элементы;
• не создавайте несколько активных строк одного обязательного параметра;
• не вставляйте настройки после </config>;
• сохраняйте файл в кодировке UTF-8;
• не используйте текстовый редактор Microsoft Word;
• после изменения полностью перезапускайте сервер;
• проверяйте сообщения консоли и журнал server.log.

Правильная строка

<maxplayers>50</maxplayers>

Неправильные варианты

<maxplayers>50

<maxplayers 50>

<maxplayers>50<maxplayers>

Специальные символы в значениях

Амперсанд внутри XML необходимо записывать как &:

<servername>Drift &amp; Race Server</servername>

Иначе XML-парсер может воспринять символ как начало специальной последовательности.

Название сервера — servername

Параметр servername задаёт название, под которым сервер отображается в браузере MTA и сервисах мониторинга.

<servername>Default MTA Server</servername>

Пример для Role Play

<servername>Miami RP | Role Play | MTA 1.6</servername>

Пример для гоночного сервера

<servername>My Race Server | New Maps</servername>

Пример для Freeroam

<servername>San Andreas Freeroam | Cars and Tuning</servername>

Рекомендации

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

Описание, язык, теги и сайт сервера

Параметры rule добавляют дополнительную информацию в браузер серверов MTA.

Описание проекта

<rule
 name="description"
 value="Русский Role Play сервер с работами, бизнесами и транспортом"
/>

Поддерживаемые языки

<rule name="languages" value="ru" />

Для нескольких языков значения перечисляются через запятую:

<rule name="languages" value="ru,en" />

Тематические теги

<rule name="tags" value="roleplay,russian,cars" />

Официальный сайт

<rule
 name="website_url"
 value="https://example.com"
/>

Социальные сети

<rule
 name="social_url_1"
 value="https://example.com/community"
/>

<rule
 name="social_url_2"
 value="https://example.com/video"
/>

<rule
 name="social_url_3"
 value="https://example.com/news"
/>

Замените демонстрационные адреса собственными официальными страницами. Не указывайте сторонние сайты, которые не относятся к проекту.

Пример блока для русского RP-сервера

<rule
 name="description"
 value="Role Play сервер MTA:SA с собственной экономикой"
/>

<rule name="languages" value="ru" />
<rule name="tags" value="roleplay,russian,economy" />
<rule name="website_url" value="https://example.com" />

Контакт владельца — owner_email_address

В параметре указывается адрес электронной почты владельца или нескольких владельцев:

<owner_email_address>admin@example.com</owner_email_address>

Для нескольких адресов используется запятая:

<owner_email_address>owner@example.com,admin@example.com</owner_email_address>

Адрес не предназначен для публичного отображения. Он может использоваться администрацией MTA для связи с владельцем проекта.

Рекомендации

• используйте действующий служебный адрес;
• регулярно проверяйте входящие сообщения;
• не указывайте временную почту;
• не публикуйте пароль от этого ящика;
• не используйте адрес, к которому потерян доступ.

IP-адрес сервера — serverip

Стандартное и рекомендуемое значение:

<serverip>auto</serverip>

В режиме auto сервер самостоятельно определяет адрес, который используется для связи с инфраструктурой MTA и публикации проекта.

Когда IP указывается вручную

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

Пример ручного значения

<serverip>203.0.113.10</serverip>

Адрес выше является примером. Не копируйте его в рабочую конфигурацию.

Игровой порт — serverport

Основной UDP-порт для подключения игроков:

<serverport>22003</serverport>

Игрок подключается по адресу:

IP_СЕРВЕРА:22003

Подключение через консоль MTA

connect IP_СЕРВЕРА:22003

Можно ли изменить порт

Да. Например:

<serverport>22101</serverport>

После изменения необходимо:

• открыть новый UDP-порт в брандмауэре;
• настроить его в панели VPS;
• обновить правила роутера;
• изменить адрес подключения на сайте;
• пересчитать ASE-порт;
• проверить, что порт не занят другой программой.

Расчёт ASE-порта

ASE-порт = игровой порт + 123

Для порта 22003:

22003 + 123 = 22126

Для порта 22101:

22101 + 123 = 22224

Количество слотов — maxplayers

Стандартная конфигурация содержит 32 игровых места:

<maxplayers>32</maxplayers>

Сервер на 50 игроков

<maxplayers>50</maxplayers>

Сервер на 100 игроков

<maxplayers>100</maxplayers>

Количество слотов задаёт верхний предел одновременных подключений. Оно не гарантирует, что серверная сборка и оборудование выдержат указанное число игроков.

Что влияет на реальную нагрузку

• количество активных пользователей;
• число серверных Lua-скриптов;
• частота запросов к базе данных;
• количество автомобилей и объектов;
• объём синхронизируемых данных;
• качество оптимизации ресурсов;
• производительность одного ядра процессора;
• скорость накопителя и сети.

Для нового проекта разумно начать с 32–50 мест и увеличивать лимит после нагрузочного тестирования.

Встроенный HTTP-сервер MTA

Встроенный HTTP-сервер используется для скачивания клиентских файлов ресурсов и работы совместимых веб-интерфейсов.

Включение HTTP-сервера

<httpserver>1</httpserver>

Отключение

<httpserver>0</httpserver>

Для большинства обычных серверов рекомендуется оставить значение 1.

HTTP-порт

<httpport>22005</httpport>

Это TCP-порт. Он должен быть открыт отдельно от игрового UDP-порта.

Можно ли использовать одинаковый номер

Игровой и HTTP-порты используют разные протоколы, поэтому технически номер может совпадать. Однако стандартные значения 22003 и 22005 проще обслуживать и диагностировать.

Пример блока HTTP-настроек

<httpserver>1</httpserver>
<httpport>22005</httpport>
<httpdownloadurl></httpdownloadurl>

Внешняя загрузка ресурсов — httpdownloadurl

По умолчанию клиент получает файлы непосредственно от встроенного HTTP-сервера MTA:

<httpdownloadurl></httpdownloadurl>

Для крупного проекта ресурсы можно раздавать через отдельный Nginx, CDN или другой веб-сервер.

Пример внешнего адреса

<httpdownloadurl>https://files.example.com/mta/</httpdownloadurl>

Когда внешний веб-сервер полезен

• игроки скачивают большой объём моделей;
• используется множество карт и текстур;
• одновременно подключается много новых пользователей;
• требуется снизить нагрузку на игровой процесс;
• нужна более быстрая раздача через CDN;
• ресурсы размещаются на отдельном сервере.

Что необходимо проверить

• адрес заканчивается правильным каталогом;
• файлы доступны по HTTPS или HTTP;
• структура каталогов совпадает с подготовленной MTA;
• сервер возвращает файлы без авторизации;
• не включена блокировка по User-Agent;
• нет бесконечной переадресации;
• сертификат HTTPS действителен;
• внешний сервер поддерживает нужную нагрузку.

Дополнительные настройки HTTP-сервера

Число соединений от одного клиента

<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>

Допустимый диапазон — от 1 до 8. Параметр особенно важен при использовании внешнего веб-сервера.

Количество рабочих потоков

<httpthreadcount>8</httpthreadcount>

Не увеличивайте значение без необходимости. Большее количество потоков не всегда ускоряет скачивание и может увеличить нагрузку.

Порог защиты от частых HTTP-подключений

<httpdosthreshold>20</httpdosthreshold>

Параметр ограничивает количество соединений, которые один IP может инициировать за короткий период.

Исключения из ограничения

<http_dos_exclude>127.0.0.1</http_dos_exclude>

Несколько IP перечисляются через запятую:

<http_dos_exclude>127.0.0.1,192.168.1.10</http_dos_exclude>

Публикация сервера — ase

Параметр управляет отправкой информации в общий браузер серверов MTA:

<ase>1</ase>

• 1 — публикация включена;
• 0 — публикация отключена.

Для публичного проекта

<ase>1</ase>

Для локального теста

<ase>0</ase>

Для корректной публикации требуется дополнительный UDP-порт:

serverport + 123

При игровом порте 22003 откройте:

22126 UDP

Почему сервер не появляется в списке

• закрыт игровой UDP-порт;
• закрыт ASE-порт;
• установлено <ase>0</ase>;
• неверно указан serverip;
• сервер работает за CG-NAT;
• указан неправильный адрес владельца;
• проект запущен недавно и список ещё не обновился;
• сервер блокирует сетевой экран хостинга.

Обнаружение сервера в локальной сети

Параметр donotbroadcastlan управляет трансляцией информации внутри локальной сети.

Разрешить обнаружение

<donotbroadcastlan>0</donotbroadcastlan>

Отключить обнаружение

<donotbroadcastlan>1</donotbroadcastlan>

Для домашнего тестирования удобно оставить значение 0. Оно позволяет другим устройствам той же сети обнаруживать работающий сервер.

Пароль подключения — password

Открытый сервер без пароля:

<password></password>

Закрытый тестовый сервер:

<password>MyTestPassword2026</password>

Пароль потребуется всем игрокам при подключении.

Когда использовать пароль

• во время первоначальной настройки;
• при закрытом альфа-тестировании;
• перед публичным открытием;
• во время проверки нового обновления;
• при переносе базы данных;
• во время технических работ.

Требования к паролю

• не используйте название проекта;
• не устанавливайте пароль 123456;
• не применяйте пароль администратора;
• не используйте пароль базы данных;
• передавайте его только участникам теста;
• удаляйте пароль перед публичным открытием.

Минимальная и рекомендуемая версия клиента

Минимальная версия

<minclientversion></minclientversion>

Пустое значение не устанавливает собственное жёсткое ограничение.

Автоматическое обновление минимальной версии

<minclientversion_auto_update>1</minclientversion_auto_update>

• 0 — отключено;
• 1 — обновление с задержкой;
• 2 — быстрое применение новой версии.

Для обычного проекта рекомендуется оставить значение 1.

Рекомендуемая версия

<recommendedclientversion></recommendedclientversion>

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

Сетевой трафик и синхронизация

Снижение потребления трафика

<bandwidth_reduction>medium</bandwidth_reduction>

Основные значения:

• none — минимальное сокращение трафика;
• medium — сбалансированный вариант;
• maximum — максимальная экономия трафика.

Для большинства серверов рекомендуется оставить medium.

Интервалы синхронизации

В конфигурации могут присутствовать параметры:

<player_sync_interval>100</player_sync_interval>
<lightweight_sync_interval>1500</lightweight_sync_interval>
<camera_sync_interval>500</camera_sync_interval>
<ped_sync_interval>400</ped_sync_interval>
<unoccupied_vehicle_sync_interval>400</unoccupied_vehicle_sync_interval>
<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
<keysync_analog_sync_interval>100</keysync_analog_sync_interval>

Эти значения определяют частоту отправки разных типов сетевых данных.

Почему их не стоит менять новичку

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

Сначала оптимизируйте Lua-скрипты и запросы базы данных, а сетевые интервалы оставьте стандартными.

Синхронизация выстрелов

<bullet_sync>1</bullet_sync>

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

Ограничение FPS — fpslimit

Параметр устанавливает лимит кадров для подключающихся клиентов:

<fpslimit>74</fpslimit>

Пример ограничения на 60 FPS

<fpslimit>60</fpslimit>

Без ограничения

<fpslimit>0</fpslimit>

Не устанавливайте чрезмерно высокое значение без проверки игрового режима. Некоторые старые системы, управление транспортом и расчёты скриптов могут вести себя по-разному при очень высоком FPS.

Практический выбор

• 60 FPS — универсальный вариант;
• 74 FPS — стандартное значение современных конфигураций;
• более высокий лимит — только после тестирования;
• 0 — отсутствие ограничения, подходит не каждому проекту.

Настройка голосового чата

Отключённый голосовой чат

<voice>0</voice>

Включённый голосовой чат

<voice>1</voice>

Частота дискретизации

<voice_samplerate>1</voice_samplerate>

• 0 — 8 кГц;
• 1 — 16 кГц;
• 2 — 32 кГц.

Качество

<voice_quality>4</voice_quality>

Допустимы значения от 0 до 10. Чем выше качество, тем больше сетевой трафик.

Интервал голосовых пакетов

<voice_packets_interval>100</voice_packets_interval>

Лимиты пакетов

<max_voice_packets_per_interval>32</max_voice_packets_per_interval>
<max_voice_buffer_size>512</max_voice_buffer_size>

Отдельный ресурс voice

В некоторых сборках для полноценной работы также запускается стандартный ресурс:

<resource src="voice" startup="1" protected="0" />

Настройка журналов MTA Server

Главный серверный журнал

<logfile>logs/server.log</logfile>

Журнал авторизации

<authfile>logs/server_auth.log</authfile>

В нём сохраняются успешные и неуспешные попытки входа в серверные аккаунты.

Журнал запросов базы данных

<dbfile>logs/db.log</dbfile>

Уровень журналирования запросов изменяется серверной командой debugdb.

Журнал Lua-ошибок

<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>

Уровень Lua-отладки

<scriptdebugloglevel>0</scriptdebugloglevel>

Доступны уровни от 0 до 3. Для постоянной работы не рекомендуется без необходимости включать максимальную детализацию: журнал может быстро увеличиваться.

HTML-отладка

<htmldebuglevel>0</htmldebuglevel>

Фильтрация одинаковых строк

<filter_duplicate_log_lines>1</filter_duplicate_log_lines>

Значение 1 сокращает повторение полностью одинаковых сообщений.

Файл уникального ключа сервера

<idfile>server-id.keys</idfile>

Автоматические резервные копии

Папка хранения

<backup_path>backups</backup_path>

Интервал

<backup_interval>3</backup_interval>

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

Количество сохраняемых копий

<backup_copies>5</backup_copies>

Можно установить другое количество в пределах поддерживаемого диапазона:

<backup_copies>10</backup_copies>

Отключение встроенных копий

<backup_interval>0</backup_interval>

Либо:

<backup_copies>0</backup_copies>

Обслуживание внутренних SQLite-баз

<compact_internal_databases>1</compact_internal_databases>

• 0 — не выполнять;
• 1 — после базовой резервной копии при запуске;
• 2 — при каждом запуске.

Параметры безопасности mtaserver.conf

Файл ACL

<acl>acl.xml</acl>

Файл определяет права аккаунтов, административных групп и серверных ресурсов.

Защита административных групп по serial

<auth_serial_groups>Admin</auth_serial_groups>

Попытка входа в защищённый аккаунт с нового serial может быть заблокирована до ручного подтверждения.

Несколько групп перечисляются через запятую:

<auth_serial_groups>Admin,Console</auth_serial_groups>

Защита входа через HTTP-интерфейс

<auth_serial_http>1</auth_serial_http>

Для защищённых аккаунтов проверяется связь IP веб-входа с адресом, недавно использованным аккаунтом в игре.

Исключения для HTTP-проверки

<auth_serial_http_ip_exceptions>127.0.0.1</auth_serial_http_ip_exceptions>

Не добавляйте внешние IP без необходимости.

Защита учётных данных MySQL

<database_credentials_protection>1</database_credentials_protection>

Параметр добавляет ограничения для ресурсов, использующих подключение MySQL через dbConnect. Рекомендуется оставить его включённым.

Защита синхронизируемых element data

<elementdata_whitelisted>0</elementdata_whitelisted>

При включении сервер игнорирует изменения синхронизируемых данных, которые клиент не получил разрешение изменять.

Проверка одинаковых serial

<check_duplicate_serials>1</check_duplicate_serials>

Сервер проверяет одновременное подключение игроков с одинаковым serial. Настройка может создавать сложности при использовании некоторых виртуальных машин.

Лимит клиентских событий

<player_triggered_event_interval>1000</player_triggered_event_interval>
<max_player_triggered_events_per_interval>100</max_player_triggered_events_per_interval>

Первая строка задаёт интервал в миллисекундах, вторая — максимальное число событий triggerServerEvent за этот интервал.

Не уменьшайте лимиты без тестирования: активный интерфейс, инвентарь или система транспорта может законно отправлять много событий.

Проверка клиентских файлов ресурсов

<resource_client_file_checks>1</resource_client_file_checks>

Сервер проверяет клиентские файлы PNG, DFF и TXD на повреждения и выводит предупреждения в консоль.

Античит и модификации GTA San Andreas

Разрешение изменённых моделей пешеходов

<allow_gta3_img_mods>none</allow_gta3_img_mods>

• none — изменённые модели блокируются;
• peds — разрешаются локальные модификации персонажей.

Для соревновательных серверов рекомендуется оставить none.

Разрешение отдельных файлов GTA

<client_file name="data/carmods.dat" verify="0" />

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

Отключение отдельных проверок античита

<disableac></disableac>

Пустое значение не отключает проверки.

Пример синтаксиса:

<disableac>2,3</disableac>

Специальные обнаружения

<enablesd></enablesd>

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

Дублирующиеся обработчики команд

<allow_multi_command_handlers>1</allow_multi_command_handlers>

• 0 — запретить дублирование;
• 1 — разрешить с предупреждением;
• 2 — разрешить без предупреждения.

Стандартное значение 1 помогает заметить возможный конфликт ресурсов.

Автоматический запуск ресурсов

В нижней части mtaserver.conf перечисляются постоянные ресурсы:

<resource src="admin" startup="1" protected="0" />
<resource src="scoreboard" startup="1" protected="0" />
<resource src="webadmin" startup="1" protected="0" />

Параметр src

Точное название папки или ZIP-архива ресурса:

src="admin"

Файл должен находиться здесь:

mods/deathmatch/resources/admin/

Параметр startup

startup="1"

• 1, true или yes — запускать вместе с сервером;
• 0 — не запускать автоматически.

Параметр protected

protected="1"

Защищённый ресурс нельзя остановить обычным способом, пока он работает.

Параметр default

default="true"

Ресурс становится главной страницей встроенного HTTP-сервера. Одновременно может быть назначен только один основной веб-ресурс.

Пример системных ресурсов

<resource src="admin" startup="1" protected="0" />
<resource src="mapmanager" startup="1" protected="0" />
<resource src="resourcebrowser" startup="1" protected="1" default="true" />
<resource src="resourcemanager" startup="1" protected="1" />
<resource src="scoreboard" startup="1" protected="0" />
<resource src="spawnmanager" startup="1" protected="0" />
<resource src="webadmin" startup="1" protected="0" />

Пример собственной RP-сборки

<resource src="database" startup="1" protected="1" />
<resource src="accounts" startup="1" protected="0" />
<resource src="characters" startup="1" protected="0" />
<resource src="inventory" startup="1" protected="0" />
<resource src="vehicles" startup="1" protected="0" />
<resource src="roleplay" startup="1" protected="0" />

Порядок запуска

Зависимые ресурсы рекомендуется размещать после базовых:

1. библиотеки и общие экспорты;
2. подключение к базе данных;
3. система аккаунтов;
4. персонажи;
5. экономика и инвентарь;
6. транспорт и имущество;
7. работы и организации;
8. дополнительные интерфейсы.

Стандартный ресурс play

<resource src="play" startup="1" protected="0" />

play является стандартным Freeroam-режимом. При установке собственной RP-, Race- или другой сборки его обычно удаляют из автозапуска, чтобы режимы не конфликтовали.

Подключение серверных модулей

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

Модуль Windows

<module src="module_name.dll" />

Модуль Linux

<module src="module_name.so" />

Несколько модулей

<module src="first_module.dll" />
<module src="second_module.dll" />

Почему модуль не загружается

• выбрана неправильная операционная система;
• не совпадает архитектура x86 и x64;
• файл находится не в нужной папке;
• отсутствуют системные библиотеки;
• модуль создан для другой версии MTA;
• имя файла указано с ошибкой;
• на Linux не учтён регистр букв.

Дополнительные параметры mtaserver.conf

Отправка аварийных дампов

<crash_dump_upload>1</crash_dump_upload>

• 1 — разрешить отправку;
• 0 — отключить.

Лимит логики сервера

<server_logic_fps_limit>0</server_logic_fps_limit>

Этот параметр предназначен для опытных администраторов. Оставьте стандартное значение, пока не появится конкретная причина его менять.

Сон процесса при нагрузке

<busy_sleep_time>-1</busy_sleep_time>

Сон процесса в простое

<idle_sleep_time>-1</idle_sleep_time>

Значение -1 позволяет серверу автоматически выбирать режим. Ручная настройка влияет на потребление процессора и отзывчивость.

Радиус передачи синхронизации автомобиля

<vehicle_contact_sync_radius>30</vehicle_contact_sync_radius>

Предупреждение о неожиданном перемещении

<player_teleport_alert>100</player_teleport_alert>

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

Пример готовой базовой конфигурации

Не заменяйте этим фрагментом весь официальный файл. Перенесите необходимые значения в существующий mtaserver.conf, сохранив остальные строки своей версии MTA.

<config>

 <servername>My Role Play Server | MTA 1.6</servername>

 <rule
 name="description"
 value="Русский Role Play сервер MTA:SA"
 />

 <rule name="languages" value="ru" />
 <rule name="tags" value="roleplay,russian" />
 <rule name="website_url" value="https://example.com" />

 <owner_email_address>admin@example.com</owner_email_address>

 <serverip>auto</serverip>
 <serverport>22003</serverport>
 <maxplayers>50</maxplayers>

 <httpserver>1</httpserver>
 <httpport>22005</httpport>
 <httpdownloadurl></httpdownloadurl>
 <httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
 <httpdosthreshold>20</httpdosthreshold>
 <http_dos_exclude>127.0.0.1</http_dos_exclude>

 <ase>1</ase>
 <donotbroadcastlan>0</donotbroadcastlan>

 <password></password>

 <minclientversion></minclientversion>
 <minclientversion_auto_update>1</minclientversion_auto_update>
 <recommendedclientversion></recommendedclientversion>

 <bandwidth_reduction>medium</bandwidth_reduction>
 <fpslimit>74</fpslimit>

 <voice>0</voice>
 <voice_samplerate>1</voice_samplerate>
 <voice_quality>4</voice_quality>

 <idfile>server-id.keys</idfile>
 <logfile>logs/server.log</logfile>
 <authfile>logs/server_auth.log</authfile>
 <dbfile>logs/db.log</dbfile>
 <acl>acl.xml</acl>
 <scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
 <scriptdebugloglevel>0</scriptdebugloglevel>

 <backup_path>backups</backup_path>
 <backup_interval>3</backup_interval>
 <backup_copies>5</backup_copies>
 <compact_internal_databases>1</compact_internal_databases>

 <auth_serial_groups>Admin</auth_serial_groups>
 <auth_serial_http>1</auth_serial_http>
 <auth_serial_http_ip_exceptions>127.0.0.1</auth_serial_http_ip_exceptions>

 <database_credentials_protection>1</database_credentials_protection>
 <elementdata_whitelisted>0</elementdata_whitelisted>
 <check_duplicate_serials>1</check_duplicate_serials>

 <player_triggered_event_interval>1000</player_triggered_event_interval>
 <max_player_triggered_events_per_interval>100</max_player_triggered_events_per_interval>

 <resource_client_file_checks>1</resource_client_file_checks>

 <resource src="admin" startup="1" protected="0" />
 <resource src="mapmanager" startup="1" protected="0" />
 <resource src="resourcebrowser" startup="1" protected="1" default="true" />
 <resource src="resourcemanager" startup="1" protected="1" />
 <resource src="scoreboard" startup="1" protected="0" />
 <resource src="spawnmanager" startup="1" protected="0" />
 <resource src="webadmin" startup="1" protected="0" />

 <resource src="roleplay" startup="1" protected="0" />

</config>

Что необходимо заменить

• My Role Play Server — название проекта;
• описание, язык и теги;
• https://example.com — официальный сайт;
• admin@example.com — адрес владельца;
• 50 — нужное количество мест;
• roleplay — точное название основного ресурса.

Если ресурса roleplay в папке нет, удалите эту демонстрационную строку.

Как проверить mtaserver.conf после изменения

1. Запустите сервер

На Windows:

MTA Server.exe

На Linux:

./mta-server64

2. Проверьте консоль

При ошибке XML сервер обычно указывает строку или параметр, который не удалось обработать.

3. Проверьте версию

version

4. Проверьте порты

openports

5. Просмотрите ресурсы

list

6. Обновите их список

refresh

7. Подключитесь локально

connect 127.0.0.1:22003

8. Проверьте внешний адрес

connect ВНЕШНИЙ_IP:22003

9. Проверьте журналы

mods/deathmatch/logs/server.log
mods/deathmatch/logs/scripts.log
mods/deathmatch/logs/server_auth.log

Распространённые ошибки mtaserver.conf

Сервер перестал запускаться

• не закрыт один из тегов;
• параметр находится после </config>;
• удалён корневой элемент;
• использован недопустимый символ;
• добавлена неправильная строка ресурса;
• порт уже занят;
• файл сохранён в неподходящей кодировке.

Название не изменилось

• редактировался файл другого экземпляра сервера;
• MTA Server не был перезапущен;
• осталась вторая строка servername;
• браузер серверов показывает сохранённые данные;
• запущена другая папка MTA Server.

Игроки подключаются, но файлы не скачиваются

• закрыт порт 22005 TCP;
• HTTP-сервер отключён;
• неверно указан httpdownloadurl;
• файлы отсутствуют на внешнем сервере;
• HTTPS-сертификат содержит ошибку;
• веб-сервер блокирует часть запросов.

Ресурс не запускается автоматически

• неверно указано имя в src;
• установлено startup="0";
• ресурс имеет двойную вложенность;
• отсутствует meta.xml;
• не установлены зависимости;
• на Linux не совпадает регистр букв;
• ошибка появилась в Lua-коде.

Сервер не виден в общем списке

• ASE отключён;
• не открыт порт serverport + 123;
• неверно изменён serverip;
• используется CG-NAT;
• сервер работает только локально;
• сетевой экран VPS блокирует UDP;
• не указан корректный контакт владельца.

После включения защиты перестала работать сборка

Верните изменённый параметр к прежнему значению и проверьте совместимость ресурсов. Особенно внимательно тестируйте:

• elementdata_whitelisted;
• лимиты клиентских событий;
• настройки античита;
• минимальную версию клиента;
• параметры синхронизации.

Частые вопросы

Где находится mtaserver.conf?

В папке mods/deathmatch установленного MTA Server.

Нужно ли останавливать сервер перед изменением?

Да. Это снижает риск перезаписи файла и позволяет применить параметры при следующем запуске.

Как изменить название?

Отредактируйте значение servername.

Как изменить количество слотов?

Измените число между тегами maxplayers.

Как поставить пароль?

Укажите его внутри элемента password.

Как удалить пароль?

Оставьте строку пустой: <password></password>.

Какой стандартный игровой порт?

22003 UDP.

Какой стандартный HTTP-порт?

22005 TCP.

Как рассчитать ASE-порт?

Прибавьте 123 к игровому порту. Для 22003 получится 22126 UDP.

Нужно ли менять serverip?

Обычно нет. Для большинства серверов подходит значение auto.

Как включить сервер в общий список?

Установите <ase>1</ase> и откройте игровой и ASE-порты.

Как отключить публикацию?

Установите <ase>0</ase>.

Как включить голосовой чат?

Установите <voice>1</voice> и проверьте запуск необходимого ресурса.

Как автоматически запускать ресурс?

Добавьте его в конфигурацию с параметром startup="1".

Что означает protected?

При значении 1 запущенный ресурс защищён от обычной остановки.

Что означает default у ресурса?

Он назначается главной страницей встроенного HTTP-сервера.

Можно ли указать внешний сервер загрузки?

Да. Для этого используется httpdownloadurl.

Где настраиваются права администратора?

В файле acl.xml, а не непосредственно в mtaserver.conf.

Где задаётся игровой режим?

Игровой режим определяется запущенными ресурсами. Отдельного стандартного элемента gamemode в mtaserver.conf нет.

Можно ли менять сетевые интервалы?

Технически да, но без нагрузочного тестирования их лучше оставить стандартными.

Почему нельзя отключать античит без причины?

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

Нужно ли сохранять server-id.keys?

Да. Храните его резервную копию отдельно и не распространяйте вместе с публичной сборкой.