Почему server.cfg короткий
Стандартный файл содержит подключение управляемых настроек и запуск базовых ресурсов:
# The setup wizard creates this file with your name, ports and server identity.
exec openm-server.cfg
ensure chat
ensure openm-local
Это рабочая структура, а не пустая заготовка. Команда exec выполняет строки другого файла. Параметры мастера находятся в openm-server.cfg рядом с входным конфигом. Для внешнего server-data используйте папку, указанную в профиле txAdmin.
Управляемые параметры
Пример состава openm-server.cfg. Адрес и ID ниже условные, секретов в примере нет:
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "My OpenM Server"
sets sv_projectName "My OpenM Server"
sv_maxclients 8
set sv_lan false
set sv_openmAdmission true
set sv_openmCompatIdentifiers true
set sv_openmServerId "srv_0123456789abcdef0123456789abcdef"
set sv_enableCfxNucleus false
set steam_webApiKey "none"
sv_master1 ""
sv_endpointprivacy true
set sv_endpoints "play.example.org:30120"
Эти строки сохраняет мастер. Повторная настройка перезаписывает управляемый файл. Не храните в нём единственную копию собственных настроек режима. Ключ admission не должен появляться в этом файле: монитор передаёт процессу путь к защищённому файлу ключа.
sv_endpoints указывает публичный игровой endpoint для клиента. Он отличается от адреса привязки 0.0.0.0, который обозначает локальное прослушивание всех IPv4-интерфейсов. Когда публикация отключена, мастер записывает пустое значение sv_endpoints.
Где добавлять свои настройки
Создайте отдельный пользовательский конфиг, например custom.cfg, в server-data. Подключите его из server.cfg после exec openm-server.cfg, но до запуска ресурсов, которым нужны его параметры:
exec openm-server.cfg
exec custom.cfg
ensure chat
ensure openm-local
Пример несекретного custom.cfg:
sets sv_projectDesc "Сервер сообщества: правила и описание"
sets tags "freeroam,ru"
sets locale "ru-RU"
sets публикует значение в серверных сведениях. Не используйте его для паролей, ключей, SQL-строк подключения и приватных URL. Клиентские/реплицируемые настройки также не являются хранилищем секретов.
Порядок выполнения и конфликтующие строки
Конфиги выполняются последовательно, а часть параметров применяется при запуске соответствующего компонента. Повторное определение может изменить результат; не рассчитывайте, что «последняя строка исправит всё» после уже запущенных ресурсов.
Проверьте все подключаемые файлы на повторные endpoint_add_tcp, endpoint_add_udp, sv_openmServerId, отключение admission, старые Cfx-настройки и противоречащий OneSync. Для поиска без вывода значений секретов:
Get-ChildItem -LiteralPath 'C:\OpenM-Server\game' -Filter *.cfg -File -Recurse |
Select-String -Pattern 'endpoint_add_tcp|endpoint_add_udp|sv_openmServerId|sv_openmAdmission|onesync' |
Select-Object Path, LineNumber, Line
Перед отправкой результата кому-либо проверьте строки вручную. Если в ваших конфигах нарушено разделение секретов, даже такой узкий поиск может показать лишние данные.
Имя в портале и имя игрового процесса
В каталоге приоритет может иметь одобренное название карточки. sv_hostname и sv_projectName относятся к игровому процессу. Поэтому изменение одного имени не обязательно меняет другое. Аналогично описание карточки и sv_projectDesc — разные поля.
Не исправляйте такое различие заменой ID. Определите, какое представление хотите изменить: карточку портала, короткое имя процесса или серверные сведения.
OneSync, слоты и game build
OneSync базовой установки задаётся профилем txAdmin через мастер. Число слотов сохраняется как sv_maxclients. Изменение числа слотов не добавляет памяти и не проверяет нагрузку режима.
Принудительный game build меняйте только при наличии совместимых игровых файлов клиента и требований выбранных ресурсов. Не переносите значение из чужой современной FiveM-сборки без проверки. Для базового старта используйте поставляемые значения, затем фиксируйте изменения в журнале эксплуатации.
Применение изменений
- Создайте резервную копию затрагиваемых конфигов.
- Убедитесь, что редактируете активный server-data.
- Измените пользовательский файл либо выполните повторный мастер для управляемых полей.
- Штатно перезапустите игровой процесс; для изменения ключей через мастер остановите также монитор.
- Проверьте консоль и
/info.json, затем вход игрока.
При откате восстановите именно изменённые пользовательские настройки. Не возвращайте старый уже отозванный ключ вместе с конфигом. Справочник основных параметров находится здесь.