Область справочника
Значения ниже относятся к комплекту сервера 1.1.3 и интеграции OpenM на дату проверки. Они не заменяют ограничения конкретного игрового ресурса. Параметры центрального каталога изменяются оператором инфраструктуры и не управляются вашим server.cfg.
Основные адреса
| Назначение | Адрес |
|---|---|
| Основной сайт | https://open-multiplayer.online/ |
| Документация | https://docs.open-multiplayer.online/ |
| Портал через основной сайт | https://open-multiplayer.online/portal |
| Отдельный портал | https://portal.open-multiplayer.ru/portal |
| Единый серверный ZIP | https://open-multiplayer.online/cdn/server.zip |
| Локальная панель по умолчанию | http://127.0.0.1:40120 |
| Локальные сведения игры | http://127.0.0.1:30120/info.json |
| Шлюз конкретного сервера | https://open-multiplayer.online/game/<SERVER_ID>/ |
Локальные порты заменяются фактически настроенными. Внешний адрес игры — адрес игрового хоста, а не обязательно адрес сайта OpenM.
Ограничения мастера
| Поле | Ограничение |
|---|---|
| Имя локального администратора | 3–20 ASCII-символов; буквы, цифры, _; . и - допускаются внутри |
| Новый пароль | Не менее 12 символов, не более 72 байт UTF-8; учитывайте обработку пробелов по краям |
| Имя сервера в мастере | 1–18 символов; без кавычек, обратного слеша, ; и управляющих символов |
| Игровой порт | 1024–65535; не равен порту панели и не входит в 40120–40150 |
| Слоты | 1–128; это предел поля, не гарантия производительности |
| Привязка игры | 127.0.0.1 либо 0.0.0.0 по выбранному режиму |
| OneSync | Включён или выключен |
| Путь существующего server-data | Абсолютный ASCII-путь с server.cfg и resources |
| Ключ доступа | 43 символа base64url |
| Seed публикации | 32 байта в канонической base64, обычно 44 символа |
| Импорт конфигурации публикации | JSON не более 8192 байт |
| Импорт seed-файла | Не более 128 байт входного файла |
Не сокращайте ключ для соответствия длине: длина помогает распознать тип, но не подтверждает действительность и принадлежность серверу.
Параметры конфигурации
| Параметр | Назначение и правило |
|---|---|
endpoint_add_tcp, endpoint_add_udp |
Адрес привязки и игровой порт; оба протокола настраиваются согласованно |
sv_hostname |
Имя, сообщаемое игровым сервером |
sets sv_projectName |
Публичное имя проекта |
sv_maxclients |
Максимум подключённых клиентов |
sv_lan |
Для публичного режима мастером устанавливается false |
sv_openmAdmission |
Проверка допуска OpenM; для управляемого публичного входа включена |
sv_openmCompatIdentifiers |
Совместимые представления идентификаторов для ресурсов |
sv_openmServerId |
ID именно этой карточки сервера |
sv_enableCfxNucleus |
В стартовом профиле отключён |
steam_webApiKey |
В стартовом профиле none; это не поле ключа OpenM |
sv_master1 |
Стартовый профиль использует пустое значение |
sv_endpointprivacy |
Настройка приватности endpoint; не обещает скрыть IP от игрока |
sv_endpoints |
Публичный endpoint, применяемый мастером при публикации |
Управляемые параметры находятся в openm-server.cfg; пользовательские ресурсы и дополнительные настройки размещайте отдельно. OneSync также отражается в конфигурации запуска профиля txAdmin. Ключ доступа передаётся через приватный файл и окружение процесса, а не через публичные convars.
Помощники запуска
| Файл/параметр | Действие |
|---|---|
FXServer.exe |
Основной запуск монитора и сохранённого профиля |
Start-Server.cmd |
Помощник запуска и диагностики |
Check-Server.cmd |
Проверка состава runtime без запуска игры |
Configure-Server.cmd |
Повторное открытие настройки |
Start-Server.ps1 -CheckOnly |
Только проверка комплекта |
Start-Server.ps1 -Configure |
Режим настройки |
Start-Server.ps1 -NoBrowser |
Не открывать браузер автоматически |
Start-Server.ps1 -PanelPort 40121 |
Выбрать другой порт панели для этого запуска |
Start-Server.ps1 -GamePort 30121 |
Передать игровой порт помощнику; перепроверьте итоговый профиль мастера |
Используйте расположение Start-Server.ps1 из вашего комплекта и запускайте из его корня. Изменение аргумента одного запуска не обязательно меняет ярлык или задачу автозапуска. Полную установку см. здесь.
Команды игровой консоли
| Команда | Где выполнять и что проверять |
|---|---|
refresh |
Серверная консоль; обновить обнаруженные ресурсы |
ensure resource-name |
Серверная консоль/конфиг; запустить или перезапустить ресурс |
stop resource-name |
Серверная консоль; остановить ресурс с учётом зависимостей |
restart resource-name |
Серверная консоль; перезапуск может сбросить состояние ресурса |
exec custom.cfg |
Серверная консоль/конфиг; выполнить указанный конфиг относительно server-data |
connect https://open-multiplayer.online/game/<SERVER_ID>/ |
F8 клиента; начать подключение к выбранному серверу |
Штатную остановку всего сервера выполняйте через txAdmin с предварительным сохранением режима. Не вводите SQL в Live Console или игровые команды в PowerShell.
Диагностические HTTP-интерфейсы
| Маршрут | Назначение |
|---|---|
Локальный /info.json |
Идентичность и параметры игрового сервера |
Локальный /dynamic.json |
Динамические данные, используемые издателем |
Основной сайт /api/servers |
Представление каталога для веб-интерфейса |
Основной сайт /api/servers/<SERVER_ID> |
Карточка и доступные данные подключения |
Основной сайт /api/v1/servers |
Публичное представление реестра |
Шлюз /game/<SERVER_ID>/info.json |
GET/HEAD до проверенного игрового сервера |
Шлюз /game/<SERVER_ID>/client |
Протокольный POST клиента |
Шлюз /game/<SERVER_ID>/files/... |
GET/HEAD файлов ресурсов |
Это диагностический перечень текущего поведения, а не обещание неизменности всех полей внутренних интерфейсов. Административные API и браузерные сессии не следует автоматизировать копированием cookie. Не обращайтесь к служебным приватным портам инфраструктуры.
Поля портала и публикация
Название карточки допускает до 128 символов, описание — до 1000, ссылки — до 8; ограничения имени в мастере уже. Короткий код — отдельное административное поле длиной 3–64 символа и не выдаётся автоматически. Изменение данных может вернуть карточку на модерацию.
Издатель отправляет heartbeat примерно каждые 30 секунд. Текущие пороги каталога — 60 секунд для подозрения на недоступность и 120 секунд для устаревшего состояния. Детальный порядок проверки и причины отказов описаны в статье об издателе.