Файл server.properties в Minecraft: разбор

server.properties – главный файл настроек сервера Java Edition. Он лежит в папке сервера, создаётся при первом запуске и управляет портом, миром, сложностью, безопасностью и производительностью. В этом гайде разобраны важные параметры, разумные значения и что ломается, если их поменять.

Как устроен файл

• Каждая строка – это key=value, без пробелов вокруг знака равенства.
• Останови сервер перед редактированием. Большинство изменений применяются только после перезапуска, а при выключении сервер может перезаписать файл.
• Строки, начинающиеся с #, – комментарии.
• Если удалить файл, при следующем запуске сервер создаст новый со значениями по умолчанию.
• Paper, Spigot и Purpur тоже читают этот файл и добавляют свои настройки в других файлах, например в spigot.yml и в папке конфигурации Paper.

Значения ниже указаны для Java 1.20 и 1.21. Начиная с 1.21.9 pvp, allow-nether, spawn-monsters и enable-command-block больше не параметры сервера: они стали игровыми правилами, которые меняются в игре через /gamerule. В старых версиях они всё ещё в этом файле.

Настройки подключения

server-port: если его поменять, игрокам придётся дописывать порт к адресу (play.example.com:25570), если только ты не настроишь SRV-запись. Новый порт также нужно пробросить. Смотри IP и порт сервера Minecraft.

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

motd: поддерживает цветовые коды, записанные как \u00A7 и код после него, например \u00A7a для зелёного, и \n для второй строки. Писать это вручную неудобно; наш генератор MOTD соберёт строку за тебя.

enable-status: если поставить false, сервер будет показан офлайн в списке «Сетевая игра» и в списках серверов, хотя игроки смогут заходить. На публичном сервере оставь включённым.

network-compression-threshold: для большинства серверов оставь 256. -1 отключает сжатие, что имеет смысл только когда сервер и игроки (или прокси) находятся в одной быстрой локальной сети. Очень низкие значения тратят больше процессора без реальной пользы.

Настройки мира

• level-name (по умолчанию world): имя папки мира. Измени его, чтобы загрузить другую папку мира.
• level-seed: сид для нового мира. На уже существующий мир не влияет.
• level-type (по умолчанию minecraft:normal): другие значения – minecraft:flat, minecraft:large_biomes, minecraft:amplified и minecraft:single_biome_surface. Как и сид, применяется только при первом создании мира. Расширенные (amplified) миры гораздо сильнее нагружают процессор.
• generator-settings: JSON для настраиваемых плоских миров. Оставь пустым, если точно не знаешь, что тебе это нужно.
• generate-structures (по умолчанию true): деревни, храмы и другие структуры.
• max-world-size: радиус границы мира в блоках. На публичных серверах граница поменьше вместе с заранее сгенерированным миром держит под контролем место на диске и лаги.
• allow-nether (1.21.8 и ниже): при false отключает Нижний мир. На серверах на основе Bukkit Край управляется параметром allow-end в bukkit.yml.

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

Игровые настройки

difficulty: большинство серверов выживания используют normal или hard. Peaceful убирает враждебных мобов и урон от голода, что ломает фермы мобов и многие цели выживания.

allow-flight: поставь true, если используешь плагины полёта, много летаешь на элитрах при лагах или используешь определённых ездовых существ. Иначе игроков может кикать за «полёт», когда сервер просто лагает. Плагины античита ловят настоящие флай-читы лучше, чем этот параметр.

spawn-protection: защищённая зона – это квадрат вокруг точки спавна мира, и на операторов она не действует. Работает, только если хотя бы один игрок – оператор. Многие серверы ставят 0 и защищают спавн через WorldGuard, который даёт более точный контроль над тем, что игроки могут там делать.

Настройки производительности

view-distance и simulation-distance: дальность прорисовки – это сколько чанков вокруг каждого игрока отправляется его клиенту, чтобы он их видел. Дальность симуляции – сколько чанков вокруг каждого игрока действительно работают: мобы двигаются, урожай растёт, работают редстоун и печи. Симуляция – дорогая часть, поэтому частая схема – умеренная дальность прорисовки и более низкая дальность симуляции. Игроки по-прежнему видят далеко, а сервер работает только рядом с ними. Очень низкая дальность симуляции ломает фермы, которым нужен игрок поблизости, так что на сервере выживания не опускайся ниже 4.

entity-broadcast-range-percentage: на каком расстоянии игроки видят сущности, в процентах от стандартной дальности (от 10 до 1000). Снижение уменьшает сетевой трафик на загруженных серверах, но мобы и другие игроки появляются позже, что важно для PvP.

sync-chunk-writes: при true чанки сохраняются синхронно, что надёжнее при падении сервера. Значение false может ускорить сохранение, но при падении есть риск потерять последние изменения. Оставь включённым, если не знаешь, зачем это меняешь.

max-tick-time: если один тик длится дольше этого числа миллисекунд, watchdog останавливает сервер, потому что тот, скорее всего, завис. -1 отключает watchdog. Не отключай его, чтобы спрятать падения; лучше найди причину профилировщиком. Как это сделать, объясняется в статье Как уменьшить лаги на сервере Minecraft.

В 1.21.2 и новее pause-when-empty-seconds ставит сервер на паузу, когда он пустует столько секунд. На приватном сервере это экономит ресурсы, но на публичном некоторые плагины и таймеры рассчитывают, что мир продолжает работать.

Настройки безопасности

online-mode

online-mode=true (по умолчанию) заставляет сервер проверять аккаунт каждого игрока через Mojang. Оставь включённым.

При online-mode=false (офлайн-режим) сервер доверяет любому нику, который присылает клиент. Кто угодно может зайти под любым игроком, включая тебя или твоих модераторов, и получить его инвентарь, приваты и права. Плагины, использующие UUID, видят другие UUID, чем в онлайн-режиме, поэтому переключение позже перемешает данные игроков.

Единственное нормальное исключение – сервер за прокси, например Velocity: там прокси работает в онлайн-режиме, а бэкенд-серверы – в офлайн-режиме с пересылкой данных игроков, и бэкенды должны принимать подключения только от прокси. Смотри как настроить сеть на Velocity.

enforce-secure-profile

По умолчанию true. Чтобы зайти, у игроков должен быть ключ профиля, подписанный Mojang; он используется для подписанного чата. Если некоторые игроки не могут зайти с сообщением об отсутствующем публичном ключе или ты используешь определённые настройки чата или прокси, владельцы иногда ставят false. Оставь true, если у тебя нет конкретной причины.

Белый список

• white-list (по умолчанию false): заходить могут только игроки из белого списка.
• enforce-whitelist (по умолчанию false): при true игроки онлайн, которых нет в списке, кикаются сразу после перезагрузки белого списка.

Его также можно включить в игре командой /whitelist on. Все шаги – в статье как включить белый список на сервере Minecraft.

Query и RCON

enable-query (по умолчанию false) включает протокол запросов GameSpy4 на query.port (UDP, по умолчанию 25565). Некоторые инструменты и списки используют его, чтобы читать плагины и ники игроков. Он необязателен; пинг статуса работает и без него.

enable-rcon (по умолчанию false) разрешает удалённый доступ к консоли на rcon.port (TCP, по умолчанию 25575) с паролем rcon.password. RCON отправляет команды с полными правами консоли, а пароль не шифруется. Если ты его используешь:

• Используй длинный случайный пароль.
• Никогда не пробрасывай и не открывай порт RCON в интернет. Разрешай его только с той же машины или из частной сети.
• Если он не нужен, оставь выключенным.

Другие параметры безопасности

• op-permission-level (по умолчанию 4): что могут операторы. 4 разрешает всё, включая остановку сервера.
• prevent-proxy-connections (по умолчанию false): кикает игроков, чьё подключение похоже на VPN или прокси, сравнивая адреса с Mojang. Может блокировать обычных игроков.
• rate-limit (по умолчанию 0): кикает клиентов, отправляющих слишком много пакетов в секунду. 0 отключает.
• log-ips (по умолчанию true, 1.20.2+): записываются ли IP-адреса игроков в лог.
• accepts-transfers (по умолчанию false, 1.20.5+): принимает ли сервер игроков, отправленных с другого сервера пакетом переноса.

Настройки ресурспака

• resource-pack: прямая ссылка на скачивание zip-файла. Ссылки на страницы скачивания не работают; URL должен отдавать сам файл.
• resource-pack-sha1: хеш SHA-1 этого zip. Он позволяет клиентам кешировать пак и замечать, что он изменился. Обновляй его каждый раз, когда меняешь файл.
• require-resource-pack: если true, игроки, отказавшиеся от пака, отключаются.
• resource-pack-prompt: своё сообщение в окне запроса на скачивание.

Делай пак обязательным, только если он действительно нужен серверу, и держи его маленьким. Большой обязательный пак – ещё одна причина для новичка сдаться. Игрокам Bedrock, заходящим через Geyser, нужен сконвертированный пак.

Разумная отправная точка

Для небольшого публичного сервера выживания на Paper:

server-port=25565
online-mode=true
enforce-secure-profile=true
max-players=50
difficulty=normal
view-distance=8
simulation-distance=6
spawn-protection=0
white-list=false
enable-status=true
enable-query=false
enable-rcon=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=true

Подстрой max-players, view-distance и simulation-distance под своё железо и следи, как сервер ведёт себя с игроками онлайн. После изменения настроек перезапусти сервер и убедись через проверку статуса сервера, что он по-прежнему отображается правильно.