Файл server.properties лежит в корневой папке сервера и создаётся при первом запуске. Формат простой: одна строка — один ключ, ключ=значение, строки с # — комментарии. Сервер читает файл только при запуске, поэтому после правки нужен перезапуск. Если ключа нет или значение неверное, сервер подставит значение по умолчанию и перезапишет файл.
Доступ и безопасность
Эти ключи решают, кто может зайти и что видно снаружи. Ошибка здесь стоит дороже всего: открытый RCON или выключенная проверка аккаунтов без плагина авторизации — это сервер, отданный первому встречному.
| Ключ | По умолчанию | Что делает и что ставить |
|---|---|---|
online-mode | true | Пускать только игроков, чей аккаунт подтвердили серверы Mojang. false — только за прокси или на сервере без лицензии с плагином авторизации: см. оффлайн-режим. |
white-list | false, с 26.3 — true | Пускать только игроков из whitelist.json (команды /whitelist add <ник>, /whitelist on). Операторы проходят автоматически. Для закрытых серверов и тестов. |
enforce-whitelist | false | При перечитывании белого списка выкидывать тех, кого в нём больше нет. Включайте вместе с white-list, иначе удалённый игрок доиграет сессию. |
enforce-secure-profile | true | Пускать только игроков с ключом, подписанным Mojang. Если выключить, сообщения чата не подписываются и на них нельзя пожаловаться, а клиенты увидят предупреждение. |
prevent-proxy-connections | false | Выкидывать игрока, если его провайдер (ISP/AS) не совпадает с тем, через который он прошёл авторизацию Mojang. Игрока, у которого вход и игра идут через разные сети, тоже выкинет. |
hide-online-players | false | Не отдавать список ников в ответе на пинг из списка серверов. Число игроков онлайн при этом видно. |
enable-status | true | Отвечать на пинг списка серверов. false — сервер выглядит выключенным для сканеров, но зайти по адресу можно. |
server-port | 25565 | TCP-порт, на котором сервер принимает игроков. Подробно — в статье про IP и порт. |
server-ip | пусто | Адрес, на котором слушать. Пусто — все адреса машины. 127.0.0.1 — только локально: так закрывают игровые серверы за прокси на той же машине. |
enable-rcon, rcon.port, rcon.password | false, 25575, пусто | Удалённая консоль. Соединение не шифруется, пароль идёт открытым текстом — подключайтесь только с самой машины и не открывайте порт наружу. С пустым паролем RCON не запустится. |
enable-query, query.port | false, 25565 | Протокол query (UDP) с информацией о сервере. На Paper он по умолчанию отдаёт и список плагинов (query-plugins в bukkit.yml). Не нужен — не включайте. |
spawn-protection | 16 | Радиус защиты спавна: сторона квадрата 2×N+1, то есть 33×33 блока. Работает, только если на сервере есть хотя бы один оператор. 0 — выключить, если спавн защищает плагин. |
chat-spam-threshold-seconds, command-spam-threshold-seconds | 10, 10 (с 26.2) | Встроенный автокик за флуд сообщениями и командами; 0 — не кикать. |
log-ips | true | Писать IP игроков в консоль и лог. Пригодится модераторам для поиска мультиаккаунтов — но лог тогда тоже данные, которые надо беречь. |
enable-command-block | false | До 1.21.9 — работают ли командные блоки. С 1.21.9 ключа нет, это правило игры; с 1.21.11 оно называется command_blocks_work, текущее значение покажет /gamerule command_blocks_work без аргумента. |
allow-flight: почему оставить false
allow-flight не даёт игрокам летать. Он только решает, выкидывать ли того, кто висит в воздухе в режиме выживания. При false (по умолчанию) сервер через несколько секунд такого полёта кикает игрока с сообщением «Flying is not enabled on this server». При true этот кик выключен для всех.
Это встроенная и очень грубая проверка: справочник Paper прямо пишет, что такой полёт чаще всего означает чит, но бывают и ложные срабатывания. Minecraft Wiki предупреждает, что с allow-flight=true гриферам работать проще. Поэтому оставляйте false, если у вас нет причины.
Если всё же включаете (например, из-за ложных киков на карте с батутами и лаунчпадами), понимайте последствие: полёт в выживании теперь ловит только античит. Ванильный кик ловит только зависание в воздухе: Speed, Timer или NoFall он не видит, а Fly-читы умеют его обходить. Проверьте, что ваш античит закрывает полёт целиком:
| Чит | DGuard | GrimAC | Vulcan | Polar | Intave | Matrix |
|---|---|---|---|---|---|---|
| Flyлетает без элитр и креатива | ||||||
| ElytraFlyуправляемый полёт на элитрах | частично: не названа — симуляция воспроизводит «большинство» движений | |||||
| BoatFly / EntitySpeedлетает и разгоняется на транспорте |
Производительность
Здесь — ключи, от которых зависят процессор, память и сеть. Если сервер лагает, начинайте с дальностей: они дают больше всего и ничего не ломают. Подробнее о поиске причин — в статье про лаги сервера.
| Ключ | По умолчанию | Что делает |
|---|---|---|
view-distance | 10 | Сколько чанков вокруг игрока сервер отправляет клиенту (радиус, 3–32). Это память, сеть и генерация новых чанков. Заранее сгенерированный мир снимает последнее: см. прегенерацию. |
simulation-distance | 10 | В каком радиусе чанков от игрока мир «живёт»: двигаются мобы, растут фермы, работает редстоун (3–32). Это нагрузка на процессор. Дальше этого радиуса сущности не обновляются. |
entity-broadcast-range-percentage | 100 | На каком расстоянии сущности отправляются клиенту, в процентах от стандартного (10–1000). Больше — видно дальше, но выше нагрузка. На Paper этот процент масштабирует дальности entity-tracking-range из spigot.yml. |
network-compression-threshold | 256 | Пакеты от этого размера в байтах сжимаются. -1 — не сжимать, 0 — сжимать всё. Ниже 64 пользы может не быть, выше MTU (обычно 1500) не рекомендуется. |
rate-limit | 0 | Сколько пакетов игрок может прислать до кика; 0 — выключено. На Paper есть свой ограничитель packet-limiter в config/paper-global.yml: по умолчанию 500 пакетов за 7 секунд, затем кик. |
sync-chunk-writes | true | Синхронная запись чанков на диск: защищает от порчи мира при сбое, но может тормозить. На Paper по умолчанию ни на что не влияет, пока не задано соответствующее системное свойство Java. |
max-players | 20 | Сколько игроков может быть онлайн одновременно. Это лимит слотов, а не производительности: сколько игроков потянет машина, зависит от железа и плагинов. |
Игра
| Ключ | По умолчанию | Что делает |
|---|---|---|
gamemode | survival | Режим игры по умолчанию: survival, creative, adventure, spectator. |
force-gamemode | false | true — при каждом входе ставить режим по умолчанию. false — игрок заходит в том режиме, в котором вышел. |
difficulty | easy | Сложность: peaceful, easy, normal, hard. |
hardcore | false | Хардкор для новых миров: после смерти игрок становится наблюдателем. |
pvp | true | До 1.21.9 — разрешён ли урон между игроками. С 1.21.9 ключа нет: используйте правило игры pvp. |
motd | A Minecraft Server | Описание сервера в списке серверов. Поддерживает коды форматирования §; \n переносит на вторую строку. |
level-name | world | Имя папки мира. Поменяете — сервер создаст новый мир, старый останется на диске. |
level-seed | пусто | Сид для генерации нового мира; пусто — случайный. |
player-idle-timeout | 0 | Через сколько минут бездействия кикать игрока; 0 — не кикать. Учтите, что этот кик обходят читы AntiAFK. |
С 1.21.9 PvP и командные блоки переключают правилами игры; ниже — имена правил для 1.21.11 и новее. На Paper правила игры у каждого мира свои, поэтому выполните команду в каждом мире, где это нужно:
/gamerule pvp false
/gamerule command_blocks_work falseКонфиги Paper: что настраивается не здесь
server.properties — ванильный файл. Paper добавляет свои конфиги, и многие важные настройки живут там:
config/paper-global.yml— общие настройки сервера: ограничитель пакетовpacket-limiter, приём игроков от прокси Velocity (proxies.velocity, см. настройку Velocity), скорость загрузки чанков.config/paper-world-defaults.yml— значения для всех миров: например, анти-X-Ray (anticheat.anti-xray, по умолчанию выключен — как включить, читайте в статье про защиту от X-Ray).paper-world.ymlв папке мира — переопределения для одного мира. С 26.1 эти файлы лежат вworld/dimensions/minecraft/<измерение>/. Копируйте туда только то, что меняете, остальное мир возьмёт изpaper-world-defaults.yml.bukkit.ymlиspigot.yml— наследство Bukkit и Spigot: задержка между подключениями с одного IP,query-plugins, дальности отслеживания сущностей.
Античит в этих файлах не настраивается — это отдельный плагин со своим конфигом. DGuard ставится в plugins/ на Paper или Leaf, ключ лицензии вписывается в plugins/DGuard/config.yml, строгость наказаний — там же. Пошагово — в инструкции по установке.
Частые вопросы
Где находится server.properties?
В корневой папке сервера, рядом с jar-файлом ядра. Файл создаётся при первом запуске; на хостинге его обычно открывают в файловом менеджере панели.
Почему изменения в server.properties не применились?
Сервер читает файл только при запуске, поэтому после правки нужен полный перезапуск. Если ключ написан с ошибкой или значение недопустимое, сервер подставит значение по умолчанию.
Как выключить PvP на сервере Minecraft?
До 1.21.9 — строкой pvp=false в server.properties. С 1.21.9 ключа нет: выполните /gamerule pvp false в каждом мире, где PvP не нужен.
Почему на новом сервере пишет «You are not white-listed»?
С версии 26.3 белый список включён по умолчанию (white-list=true). Добавьте игроков командой /whitelist add <ник> или поставьте white-list=false и перезапустите сервер.
Включать ли allow-flight?
Обычно нет: при false сервер сам кикает за долгий полёт в выживании, а при true вся защита от полёта ложится на античит. Включайте, только если ванильный кик мешает честным игрокам, и проверьте, что античит ловит Fly.
Какое значение view-distance поставить?
По умолчанию 10, допустимо от 3 до 32. Если сервер не справляется, сначала уменьшайте simulation-distance (нагрузка на процессор), потом view-distance (память и сеть).
Источники
- Minecraft Wiki: server.properties
- Paper: справочник server.properties
- Paper: файлы конфигурации
- Paper: paper-global.yml
- Paper: paper-world-defaults.yml
- Paper: spigot.yml (entity-tracking-range)
- Paper: bukkit.yml
- Minecraft Wiki: правила игры
- DGuard — лучший античит для современного сервера Minecraft: сравнение проверок с GrimAC, Vulcan, Polar, Intave и Matrix
- DGuard: установка, требования и решение проблем
- DGuard: поддерживаемые версии Paper и Leaf