Конфиг server.properties

Свой сервер

Что делает каждая строка конфига сервераПодробнее

Файл, который сервер создаёт сам и который правят вслепую. Тут у каждой строки написано, что случится, если её поменять, — а значения по умолчанию взяты из документации, а не из чужих гайдов.

Моя игра выбрать версию

Запомним в этом браузере и подставим там, где доступна ваша версия. Настройки открытой ссылки важнее этого выбора; отметки версии в вики не меняются.

Уже есть свой server.properties? Вставьте его — форма заполнится сама

Основное

Первое, что меняют после установки.

Подробнее о ключе

Две строки под названием сервера. Цвет ставится кодами §, а сами коды в файле пишутся как \u00A7 — собрать строку целиком проще в генераторе MOTD.

Подробнее о ключе

Больше игроков — больше памяти и больше нагрузка на процессор. Ставить с запасом бессмысленно: слоты не резервируются.

Подробнее о ключе

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

Подробнее о ключе

Пусто — слушать все адреса машины. Заполняют только на нескольких сетевых картах; ошибка тут делает сервер недоступным снаружи.

Подробнее о ключе

true — пускать только лицензионные аккаунты; false — пиратский сервер, и тогда ник ничем не подтверждён: любой может зайти под чужим. Под прокси (BungeeCord, Velocity) ставят false, но закрывают порт снаружи.

Подробнее о ключе

Пускать только тех, кто в whitelist.json. С 26.3 включён по умолчанию: новый сервер пускает только тех, кого добавили командой /whitelist add. Единственная защита от случайных гостей на пиратском сервере.

Подробнее о ключе

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

Подробнее о ключе

Показывать игроку правила сервера перед входом. Тексты лежат в папке codeofconduct рядом с сервером, по файлу на язык (ru_ru.txt, en_us.txt). Кто не принял правила, на сервер не войдёт.

Игровой процесс

Каким сервер будет для игрока.

Подробнее о ключе

Режим, в котором появляется новый игрок.

Подробнее о ключе

На мирной враждебные мобы не появляются вовсе, а голод не убивает.

Подробнее о ключе

Смерть переводит игрока в наблюдатели навсегда. Сложность при этом принудительно сложная.

Подробнее о ключе

Каждый вход переводит игрока в режим по умолчанию. Полезно на выживании, где кто-то остался в творческом.

Подробнее о ключе

Про полёт в выживании: с false сервер выкидывает за «читы на полёт», и это ломает элитры на плагинах. На сервере с плагинами ставят true.

Подробнее о ключе

Сколько блоков вокруг точки появления нельзя ломать никому, кроме операторов. 0 — защиты нет; на сервере с плагинами обычно так и делают, а защиту вешают на регион.

Подробнее о ключе

Минуты без действий, после которых игрока отключает. 0 — не выгонять; ставят на людных серверах, где слоты кончаются.

Подробнее о ключе

4 — полный доступ, включая /stop и /op. Ниже ставят, чтобы помощники не могли выключить сервер.

Подробнее о ключе

С каким уровнем прав выполняются функции датапаков. Ниже четвёртого часть команд в них просто не сработает.

Мир

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

Подробнее о ключе

Имя папки с миром. Смена имени = новый мир: старый останется на диске нетронутым, и это самый простой способ начать заново.

Подробнее о ключе

Пусто — случайное. Действует только при создании мира; на готовый мир не влияет никак.

Подробнее о ключе

Тоже только при создании. Плоский мир задаётся вместе с generator-settings.

Подробнее о ключе

JSON для плоского мира и одиночного биома. У обычного мира не используется.

Подробнее о ключе

Деревни, крепости, храмы. Выключают редко и только на новых мирах.

Подробнее о ключе

Граница мира в блоках от центра. Уменьшают, чтобы карта не росла бесконечно вместе с местом на диске.

Подробнее о ключе

Через сколько секунд пустой сервер перестаёт считать мир. Экономит процессор на маленьких серверах; 0 — не останавливаться.

Сеть и производительность

Тут живут причины лагов и разрывов соединения.

Подробнее о ключе

Главная настройка нагрузки: чанки грузятся квадратом со стороной 2×N+1 на каждого игрока. Снижение с 10 до 6 обычно спасает слабый сервер сильнее всего остального вместе.

Подробнее о ключе

На каком расстоянии мир живёт: растут посевы, работают фермы, движутся мобы. Дальше этого игрок видит застывшую картинку.

Подробнее о ключе

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

Подробнее о ключе

Насколько далеко клиент видит мобов и предметы, в процентах от обычного. Снижение до 50 заметно разгружает сеть на людном сервере.

Подробнее о ключе

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

Подробнее о ключе

Сколько пакетов в секунду позволено игроку до отключения. 0 — без лимита.

Подробнее о ключе

false ускоряет сохранение мира на медленном диске, но при падении машины теряется больше. На VPS с NVMe разницы почти нет.

Подробнее о ключе

Ускоренная работа с сетью на Linux. На Windows значение игнорируется.

Подробнее о ключе

Сервер спрашивает у Mojang, совпадает ли страна игрока. Ломает вход тем, кто заходит через VPN, — а таких много.

Подробнее о ключе

lz4 быстрее, но файлы крупнее; none — вообще без сжатия. Менять стоит только на слабом процессоре с быстрым диском.

Подробнее о ключе

Каждое сообщение в чат прибавляет игроку секунду «долга», и долг тает в реальном времени. Набралось больше указанного числа секунд — игрока выкидывает с «Вы исключены за спам». При 10 подряд можно отправить около десяти сообщений, дальше — не чаще раза в секунду. 0 — без ограничения; операторов порог не трогает.

Подробнее о ключе

То же, что порог чата, но для команд: каждая команда — секунда «долга», и при переполнении игрока выкидывает за спам. 0 — без ограничения; операторов порог не трогает.

Ресурспак

Пак, который сервер раздаёт при входе.

Подробнее о ключе

Прямая ссылка на zip. Сервер раздаёт ровно один пак — если своих паков несколько, их сначала сливают в один.

Подробнее о ключе

Хеш файла. Без него клиент качает пак заново при каждом входе, и это первая причина «долгий вход на сервер».

Подробнее о ключе

Что написано в окне «сервер предлагает ресурспак». Поддерживает JSON-текст.

Подробнее о ключе

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

Подробнее о ключе

UUID пака. Пусто — сервер выводит его из ссылки на пак, и одна ссылка всегда даёт один id. По id клиент узнаёт пак, который уже скачивал.

Удалённое управление

RCON и запросы состояния.

Подробнее о ключе

Удалённая консоль. Пароль ходит по сети почти открытым, поэтому порт наружу не открывают никогда.

Подробнее о ключе
Подробнее о ключе

Без пароля RCON не включится. Впишите его в скачанный файл сами: в адрес страницы пароль мы не кладём — ссылку на конфиг пересылают, а адрес оседает в истории браузера.

Подробнее о ключе

Операторы видят в чате, что кто-то делает через удалённую консоль.

Подробнее о ключе

Отдаёт список игроков и версию по UDP. Нужен старым мониторингам; современные (в том числе наш) обходятся обычным пингом.

Подробнее о ключе
Подробнее о ключе

Сайты, которым можно подключаться к протоколу управления из браузера, через запятую. Пусто — никаким.

Подробнее о ключе

Включает протокол управления сервером — JSON-RPC через WebSocket. Через него панели и боты видят игроков, меняют часть настроек без перезапуска и получают уведомления о событиях.

Подробнее о ключе

На каком адресе слушает протокол управления. localhost — подключиться можно только с этой же машины.

Подробнее о ключе

Порт протокола управления. 0 — система выдаст свободный порт, и сервер напишет его в лог при запуске.

Подробнее о ключе

Ключ доступа к протоколу управления. Сервер сам придумывает случайный, когда создаёт файл, — поэтому у каждого сервера он свой. Никому его не показывайте.

Подробнее о ключе

Шифровать подключения к протоколу управления (TLS). Включено по умолчанию; для работы нужен keystore.

Подробнее о ключе

Путь к файлу keystore с сертификатом для протокола управления.

Подробнее о ключе

Пароль от keystore для протокола управления.

Подробнее о ключе

Как часто, в секундах, сервер присылает клиентам протокола управления сводку о своём состоянии. 0 — не присылать.

Служебное

Редко трогают, но знать полезно.

Подробнее о ключе

false прячет сервер из списков: он останется рабочим, но мониторинги и клиент покажут его недоступным.

Подробнее о ключе

В пинге не будет ников. Онлайн числом при этом виден.

Подробнее о ключе

Требует от клиента подписи чата. На пиратском сервере это ставят в false, иначе часть клиентов не зайдёт вовсе.

Подробнее о ключе

false убирает адреса из логов — иногда нужно, чтобы не хранить лишние персональные данные.

Подробнее о ключе

Разрешает другим серверам передавать сюда игроков командой /transfer.

Подробнее о ключе

Команды из консоли видны операторам в чате.

Подробнее о ключе

Метрики JVM наружу. Нужно единицам и только вместе с настроенным сборщиком.

Подробнее о ключе

Защита от бесконечных редстоун-цепочек: длиннее — обновления обрываются, а сервер остаётся жив.

Подробнее о ключе

Куда клиент отправит игрока по кнопке «сообщить о проблеме».

Подробнее о ключе

Список через запятую. Сюда добавляют встроенные эксперименты: trade_rebalance, minecart_improvements, redstone_experiments.

Подробнее о ключе
Подробнее о ключе

Ссылка на внешний сервис фильтрации чата. Пусто — фильтра нет.

Подробнее о ключе

Версия протокола внешнего фильтра чата. Нужна только вместе с text-filtering-config.

Сбросить всё

Как применить

  1. Остановите сервер

    Файл читается только при запуске: правка на ходу ничего не изменит до перезапуска.

  2. Положите файл рядом с jar

    Именно server.properties, в папку сервера — на место старого.

  3. Запустите и проверьте

    Загляните в лог сервера: про то, что в конфиге не так, он пишет туда, а не на экран.

Что нужно знать про конфиг

  • Файл читается только при запуске. Правки на живом сервере ничего не меняют до перезапуска — кроме тех, что дублируются командами вроде /difficulty.
  • Половина настроек мира действует только при создании. Зерно, тип мира и настройки генератора на готовый мир не влияют вовсе: чтобы они сработали, нужен новый мир — то есть новое имя папки.
  • Дальность прорисовки — главная настройка нагрузки. Каждый игрок держит в памяти квадрат чанков со стороной 2×N+1: при 10 это 441 чанк на человека, при 6 — 169.
  • Коды § в файле пишутся как §. Сам символ в properties-файле превращается в мусор — escape-запись мы подставляем сами. Собрать описание с цветом целиком проще в генераторе MOTD.
  • Пустое значение — это законное значение. server-ip= означает «слушать все адреса», а не «не задано»; стирать такую строку из файла не нужно.
  • Порядок строк не важен, а вот пробелы вокруг знака равенства — важны: max-players = 20 сервер прочтёт как значение « 20» и не примет.
  • После правок сервер перепишет файл сам. Он добавит недостающие ключи со значениями по умолчанию и уберёт незнакомые — свои комментарии в нём не выживают.

Значения по умолчанию сверены с minecraft.wiki (Server.properties) и относятся к Java Edition. Скрипт запуска для этого же сервера собирает генератор файла запуска.

Частые вопросы

Почему настройки server.properties не применились?

Файл читается только при запуске: правку надо сохранить и перезапустить сервер. Половина настроек мира (сид, генератор, тип мира) вдобавок действует только при создании мира.

Как включить сервер без лицензии?

online-mode=false — тогда сервер не проверяет аккаунты у Mojang. Вместе с ним обязателен белый список: без проверки под чужим ником зайдёт кто угодно.

Какая настройка сильнее всего влияет на нагрузку?

Дальность прорисовки (view-distance). Она задаёт, сколько чанков сервер держит и рассылает на каждого игрока, и растёт квадратом от числа.

Где поиграть

Сервера из топа мониторинга, где прямо сейчас играют люди.