Документация / Начало работы

Требования и ограничения

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

Поддерживаемая платформа

Публичный серверный комплект этой документации предназначен для Windows x64 и игрового направления GTA V Legacy. Не используйте инструкции как подтверждение поддержки GTA V Enhanced, RDR2 или Linux-сервера. Публичный Linux-комплект этим руководством не предоставляется.

Игровой сервер и компьютер игрока — разные роли. Серверной машине нужны runtime-файлы из архива и ресурсы режима. Для подключения игроку нужны клиент OpenM, установленная поддерживаемая GTA V Legacy и рабочая проверка владения игрой. Аккаунт OpenM не заменяет лицензию GTA.

Программные компоненты

Базовый архив уже содержит FXServer, модифицированный txAdmin 8.0.1, необходимую серверную среду Node и библиотеки Visual C++ из комплекта. Для обычного запуска базовой сборки не нужны отдельно установленные Node.js, npm, Docker или SQL-сервер.

Windows PowerShell требуется встроенным процедурам подготовки защищённой папки и помощникам .cmd. Если PowerShell заблокирован корпоративной политикой, решите это с администратором системы; не отключайте защиту всей ОС ради запуска. Совместимые файлы должны оставаться из одного проверенного архива. Случайная DLL из интернета не является корректным исправлением.

Путь установки и права

Используйте полный ASCII-путь, например C:\OpenM-Server или D:\Servers\OpenM-01. Кириллица и другие не-ASCII-символы недопустимы во всём пути, в том числе в имени профиля Windows. Пробелы допустимы, но в командной строке путь с пробелами нужно заключать в кавычки.

Учётная запись Windows должна иметь право читать runtime и записывать данные в папки сервера. Мастер ограничивает ACL txData текущим пользователем, SYSTEM и локальными администраторами. Обычный запуск выполняйте от одного выбранного пользователя. Запуск другим пользователем и перенос ACL разбираются в миграции.

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

Процессор, память и диск

У OpenM пока нет опубликованной таблицы подтверждённой ёмкости «число игроков → RAM/CPU». Лимит поля мастера 128 игроков — это ограничение ввода, а не гарантия, что конкретный компьютер и набор ресурсов выдержат такую нагрузку.

Планируйте память и процессор по измерениям своего режима: отдельно учитывайте FXServer, txAdmin, SQL-базу, голосовые компоненты и сторонние процессы. Проверяйте свободную память, загрузку ядер, задержки серверных кадров, скорость диска, объём логов и баз данных. Начинайте с малого числа игроков и увеличивайте нагрузку ступенчато.

На диске должны помещаться новая распаковка, текущий сервер, ресурсы, SQL-данные, логи и резервная копия. Для безопасного обновления нужно место одновременно под старую и новую версии. Не рассчитывайте необходимое место только по размеру server.zip.

Сеть

Для публикации и проверок доступа нужен исходящий HTTPS к службам OpenM. Для игрового подключения сервер должен принимать входящие TCP и UDP на выбранном игровом порту. Панель txAdmin привязана к loopback и не должна становиться публичным портом.

Серый адрес провайдера, CGNAT, двойной NAT или закрытый UDP не исправляются выпуском нового ключа. DNS-имя должно разрешаться в действительный адрес игрового узла. Подробная проверка приведена в сети и портах.

Совместимость ресурсов

Форматы fxmanifest.lua, ensure и привычные CitizenFX-пространства имён сохраняются там, где это необходимо для ресурсов. Однако бинарные зависимости, новые native-функции, asset escrow, внешняя авторизация, лицензирование и современные закрытые компоненты могут отличаться или отсутствовать.

Для каждого ресурса фиксируйте источник, версию, зависимости, необходимые native-функции, game build, OneSync и доступ к SQL. Проверяйте его в отдельном тестовом экземпляре. Не отключайте проверку OpenM или Rockstar ради ресурса, который требует несовместимый механизм авторизации.

Что не включено и не обещано

  • Готовый RP-сервер, SQL-схема персонажей, QBCore или ESX в базовом ZIP отсутствуют.
  • Автоматическая установка из произвольного FiveM recipe не является проверенным способом переноса.
  • Скрытие адреса в каталоге не скрывает игровой адрес от подключающегося клиента.
  • Автоматический шлюз не заменяет игровой UDP и не открывает NAT.
  • Для первого запуска не требуется ключ Cfx.re; ключи OpenM выдаются отдельно в портале.
  • Полностью автономный игровой вход без центральных проверок не описан и не предоставлен как поддерживаемый режим.

Введите название, параметр или текст ошибки.

Esc — закрыть · Tab — выбрать результат