Настройки сервера

Редактирование конфигурации сервера осуществляется посредством файла server.json, расположенного в корневом каталоге сервера. Файл server_example.json является шаблонным и предназначен исключительно для ознакомления — внесение изменений в него не влияет на поведение сервера.

Аналогичные файлы могут присутствовать в каталоге KontraServer, однако их редактирование также не оказывает влияния на работу сервера в игре.

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

При работе с конфигурацией используются два основных файла: server_example.json и server.json. Первый служит примером и ориентиром при настройке, тогда как все изменения необходимо вносить непосредственно в файл server.json.

Рекомендуется скопировать содержимое файла примера (исключая комментарии) в server.json и далее выполнять настройку, опираясь на пояснения, приведённые в конфигурации.

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

• Region — регион сервера:
  • 255 — автоматический выбор (предпочтительный);
  • 0–7 — фиксированные регионы (США, Европа, Азия и др.).
• MaxPlayers — максимальное количество игроков на сервере.
• VoteKickCount — количество голосов, необходимое для исключения игрока.
• Title — название сервера, отображаемое в списке.
• Password — пароль для подключения к серверу (при необходимости).
• AllowVoteKick — возможность голосования за исключение игрока (true — разрешено, false — запрещено).
• VoiceChatType — тип голосового чата:
  • 0 — отключён;
  • 1 — стандартный;
  • 2 — по расстоянию;
  • 3 — по расстоянию с 2D-звуком после смерти;
  • 4 — полностью 2D.
• MasterServers — список мастер-серверов (не более двух).

События сервера

Блок Events используется для настройки автоматических сообщений на сервере:

• eventTag — тег события (например, SERVER);
• eventMessage — текст сообщения;
• startTime — время до первого появления сообщения (в секундах);
• repeatRate — интервал повторения сообщения (в секундах);
• duration — длительность отображения сообщения (в секундах);
• eventColor32 — цвет тега события;
• messageColor32 — цвет текста сообщения.

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

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

• физика и взаимодействие игроков (EnemyCollision, TeamCollision);
• игровые механики (FallDamage, BunnyHopAllowed);
• множители скорости и прыжка (SpeedMultiplier, JumpVelocityMultiplier);
• длительность игровых режимов (MatchDurationSec, WarmUpDurationSec);
• таймауты неактивности игроков (PlayerInactivityTimeout и др.).

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