Документация / Справочник

Термины и компоненты

FXServer, txAdmin, портал, каталог, admission, publisher, endpoint и игровой ресурс.

Движок и управление

Термин Значение в этой документации
OpenM Независимый проект клиента, серверной интеграции и сервисов доступа/каталога
FXServer Исполняемый серверный движок; FXServer.exe также является точкой запуска комплекта
txAdmin Веб-панель и монитор серверного процесса: администраторы, консоль, запуск и остановка
Монитор Управляющий процесс, который поддерживает работу игрового процесса и служебного издателя
Игровой процесс Процесс, загружающий server.cfg, ресурсы и обслуживающий игроков
Профиль txAdmin Сохранённые настройки конкретного экземпляра, включая путь server-data
server-data / dataPath Каталог с конфигом и ресурсами игры; может располагаться вне комплекта
txData Каталог состояния управления, профилей и приватной конфигурации
Runtime Движок и связанные исполняемые библиотеки; отличается от пользовательских игровых данных

Остановка ресурса, игрового процесса и всего монитора — разные действия. Сначала определите уровень, на котором возникла ошибка, затем выбирайте команду или кнопку управления.

Каталог и идентичность

Термин Значение
Портал владельца Интерфейс управления своими карточками, адресами, ключами и модерацией
Карточка сервера Запись с владельцем, ID, описанием, endpoint и состоянием публикации
Server ID Постоянный идентификатор вида srv_ и 32 шестнадцатеричных символа
Каталог Публичное представление доступных серверов для сайта и клиента
Модерация Проверка карточки перед публичным использованием; изменение данных может потребовать повторения
Join code Отдельный короткий код карточки; не равен ID и не выдаётся автоматически всем серверам
Endpoint Сетевой адрес игрового сервера в формате хост:порт
Gateway / шлюз Проверяемый HTTP-маршрут OpenM к опубликованному игровому серверу

Имя сервера — отображаемый текст. Его совпадение с названием карточки не доказывает, что процесс принадлежит этой карточке. Для этого сравнивают ID и проверяют предусмотренную авторизацию.

Ключи и публикация

Термин Значение
Admission Механизм проверки допуска игрока в OpenM и взаимодействия сервера с этой проверкой
Ключ доступа сервера Отдельный секрет длиной 43 символа, используемый серверной частью admission
Ключ публикации / seed Приватный материал для подписи heartbeat; не заменяет admission
publisher.json Экспорт конфигурации публикации с ID, keyId и endpoint
.seed Файл приватного ключа публикации; хранится закрыто
keyId Идентификатор пары ключей публикации; помогает сопоставить конфигурацию и seed
Издатель / publisher Автоматический процесс локальных проверок и отправки подписанных обновлений
Heartbeat Периодическое сообщение о состоянии сервера, проверяемое каталогом
Ротация Замена ключа новым значением с применением на сервере
Отзыв Прекращение действия ключа в центральном сервисе

Base64 и base64url — разные варианты текстового представления байтов. Внешне похожие строки не взаимозаменяемы. Длина и завершающий символ помогают определить формат, но не подтверждают право использования ключа.

Сеть и хост

Термин Значение
Loopback Обращение к своему компьютеру, обычно 127.0.0.1
Bind / адрес привязки Интерфейс, на котором процесс слушает порт; 0.0.0.0 означает все IPv4-интерфейсы
TCP Транспорт, используемый в том числе игровым HTTP и панелью
UDP Транспорт игрового обмена; проверяется отдельно от TCP
NAT Преобразование адресов маршрутизатором; входящий порт должен вести на правильный игровой хост
CGNAT Общий NAT провайдера; домашнего проброса порта может быть недостаточно
DNS Преобразование имени хоста в адрес; запись AAAA относится к IPv6, A — к IPv4
ACL Правила доступа к файлам или объектам; NTFS ACL управляет доступом Windows к состоянию сервера
SID Идентификатор учётной записи Windows, используемый в правах доступа

Публичный IP сайта OpenM и IP вашего игрового компьютера могут отличаться. Проброс игрового порта на веб-сервер вместо игрового хоста не создаёт рабочее подключение.

Ресурсы и данные

Термин Значение
Resource / ресурс Пакет скриптов, данных или интерфейса с манифестом
fxmanifest.lua Описание файлов, зависимостей и контекста выполнения ресурса
ensure Команда запуска/обеспечения работы ресурса; может перезапустить уже запущенный ресурс
NUI Встроенный веб-интерфейс игрового ресурса
Native Функция движка/игры, доступная скриптам; поддержка зависит от версии
Export Функция, которую один ресурс предоставляет другому
Framework Набор основных ресурсов игрового режима, например QBCore
SQL-коннектор Ресурс/библиотека, связывающая игровые скрипты с СУБД
Миграция БД Управляемое изменение схемы или данных между версиями
Согласованная копия Файлы и БД, отражающие совместимый момент состояния
Откат Возврат согласованного набора версии, конфигов и данных после неудачного изменения

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

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

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