server.properties Minecraft: полный разбор всех параметров

Полный гайд по server.properties Minecraft: все параметры по группам - сеть, геймплей, производительность, мир, RCON, Query. Таблицы и примеры значений.

Файл server.properties - главный конфиг Minecraft-сервера. От его параметров зависит всё: от номера порта до того, как сервер ведёт себя при перегрузках. Разберём каждый параметр по группам, с примерами и влиянием на производительность.

Где найти и как редактировать

Файл лежит в корне папки сервера, рядом с server.jar. Создаётся автоматически при первом запуске. Формат - простой ключ=значение, по одному параметру на строку.

После любого изменения требуется перезапуск сервера. Команда /reload файл не перечитает.

На хостингах с панелью Pterodactyl большая часть параметров вынесена в раздел Startup или Settings - удобный UI вместо ручного редактирования.

Сетевые параметры

server-port

server-port=25565

TCP-порт, на котором слушает сервер. По умолчанию 25565. Менять имеет смысл, если на одном IP несколько серверов или хотите усложнить жизнь сканерам. Для смены порта учтите, что клиенту нужно будет указать порт явно: play.example.com:25566.

server-ip

server-ip=

Привязка к конкретному IP-адресу сервера. Пустое значение - слушает на всех интерфейсах. Заполняется редко, в основном на multi-homed серверах.

online-mode

online-mode=true

Главный параметр безопасности. При true сервер проверяет лицензию каждого подключающегося игрока через Mojang API. Никто не может зайти под чужим ником.

При false - сервер пускает любого с любым ником. Это нужно только если:

• играют с пиратского клиента (что в России распространено);
• используется BungeeCord/Velocity как прокси (там online-mode на прокси, а бэкенды в offline).

При offline-mode ОБЯЗАТЕЛЬНО ставьте мод/плагин авторизации: AuthMe Reloaded (Bukkit), EasyAuth (Fabric), FTBAuth (Forge). Без них первый же тролль зайдёт под ником админа и снесёт мир.

prevent-proxy-connections

prevent-proxy-connections=false

При true сервер отклоняет подключения с IP, которые Mojang считает прокси/VPN. Защита от обхода банов. Минус - страдают легитимные игроки с VPN и Tor. Используется редко.

network-compression-threshold

network-compression-threshold=256

Минимальный размер пакета (в байтах) для сжатия zlib. По умолчанию 256:

• -1 - сжатие выключено (для серверов в одной LAN, где сеть быстрее CPU);
• 0 - сжимать всё (нагрузка на CPU);
• 256 - разумный дефолт;
• 512 - меньше нагрузка на CPU, чуть больше трафика.

На BungeeCord/Velocity ставят -1 на бэкендах, потому что сжатие делает прокси.

enforce-secure-profile

enforce-secure-profile=true

Требует у клиента подписанные ключи чата (с 1.19+). Если выключить, разрешает заходить с клиентов без ключей. Для серверов с offline-mode часто ставят false.

Игровые параметры

gamemode

gamemode=survival

Игровой режим по умолчанию для новых игроков:

• survival - выживание;
• creative - творческий;
• adventure - приключение (нельзя ломать блоки без нужного инструмента);
• spectator - наблюдатель.

force-gamemode

force-gamemode=false

При true каждый раз при входе игроку принудительно ставится gamemode из файла. При false (стандарт) - режим запоминается из сессии.

difficulty

difficulty=easy

Сложность мира:

• peaceful - моба не появляются;
• easy - меньше урон от мобов;
• normal - стандарт;
• hard - мобы наносят больше урона, голод убивает.

hardcore

hardcore=false

При true смерть переводит игрока в режим зрителя навсегда (или до удаления данных). Используется на хардкор-проектах.

pvp

pvp=true

Разрешает игрокам наносить урон друг другу. На приватных серверах с друзьями часто false, на публичных - true. Внимание: плагины регионов (WorldGuard) могут переопределять PvP в зонах.

spawn-protection

spawn-protection=16

Радиус защищённой зоны вокруг точки спавна (в блоках). Внутри обычные игроки не могут ломать/ставить блоки. Только операторы. По умолчанию 16. Ставьте 0 для приватных, 32-64 для публичных.

allow-flight

allow-flight=false

При false сервер кикает игрока за полёт без креатива (анти-чит). При наличии модов на полёт (Mekanism Jetpack, Botania Tiara) или плагинов вроде EssentialsX /fly - ставьте true, иначе будут кики.

allow-nether

allow-nether=true

Разрешает посещение Нижнего мира.

spawn-monsters

spawn-monsters=true

Спавн враждебных мобов. При false мобов нет даже в Нижнем мире (но из спавнеров будут).

spawn-animals / spawn-npcs

spawn-animals=true
spawn-npcs=true

Спавн дружелюбных мобов и NPC (жителей).

white-list / enforce-whitelist

white-list=false
enforce-whitelist=false

Включает белый список игроков (управляется /whitelist и файлом whitelist.json). Когда enforce-whitelist=true - при удалении игрока из белого списка он немедленно кикается.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Параметры производительности

Это самая важная группа для владельца сервера.

view-distance

view-distance=10

Радиус рендеринга чанков в чанках. Влияет на CPU и сеть. Каждый игрок видит мир в этом радиусе.

Рекомендации:

Снижение с 10 до 8 сокращает количество загружаемых чанков на ~36%.

simulation-distance

simulation-distance=10

Радиус тикования чанков. В этих чанках идёт симуляция: мобы ходят, машины работают, растения растут. Появился в 1.18.

Обычно ставится на 1-2 меньше view-distance:

• view-distance=10, simulation-distance=8 - типично.

Влияет на CPU больше, чем view-distance.

max-tick-time

max-tick-time=60000

Максимальное время тика (мс) до того, как watchdog убьёт сервер. Дефолт 60000 (60 секунд). При зависании сервера он сам себя убьёт, и autorestart поднимет заново.

Для модовых серверов с тяжёлой генерацией иногда ставят max-tick-time=-1 (отключить watchdog), но это плохая идея - лучше разобраться с причиной зависаний. Смотрите гайд по решению лагов.

entity-broadcast-range-percentage

entity-broadcast-range-percentage=100

На каком расстоянии в процентах от view-distance игрок видит сущностей. 100 - стандарт. Снижение до 50-70 уменьшает трафик на серверах с большим количеством мобов.

max-players

max-players=20

Максимум одновременно играющих. Если зашло столько - новые получают “Server full”. Не путать с реальной нагрузкой - 20 в списке не значит, что сервер тянет 20 на тяжёлом модпаке.

player-idle-timeout

player-idle-timeout=0

Через сколько минут AFK-игрока кикнуть. 0 - не кикать. На загруженных серверах ставят 15-30, чтобы AFK-фермеры не занимали слоты.

sync-chunk-writes

sync-chunk-writes=true

Синхронная запись чанков на диск. true безопаснее (нет потери данных при краше), false быстрее на медленных дисках. На NVMe разница незаметна - оставляйте true.

use-native-transport

use-native-transport=true

Использовать epoll на Linux вместо стандартного NIO. Снижает нагрузку CPU на сетевом тике. Всегда true на Linux-хостинге.

Параметры мира

level-name

level-name=world

Имя папки с миром. Для смены мира - меняете значение и перезапускаете. Старый мир остаётся на диске нетронутым.

level-seed

level-seed=

Зерно генерации. Пустое - случайное. Можно указать конкретное число для воспроизводимого мира.

level-type

level-type=minecraft\:normal

Тип мира:

• minecraft:normal - стандартный;
• minecraft:flat - плоский (Superflat);
• minecraft:large_biomes - увеличенные биомы;
• minecraft:amplified - амплитудный (экстремальный рельеф, не для слабых машин);
• minecraft:single_biome_surface - один биом.

Двоеточие в файле экранируется бэкслэшем.

generator-settings

generator-settings={}

JSON-конфиг для кастомного генератора. Для Superflat - описание слоёв и структур.

generate-structures

generate-structures=true

Генерировать ли структуры: деревни, цитадели, храмы. При false - чистый мир без квестов и сокровищ.

max-world-size

max-world-size=29999984

Максимальный размер мира в блоках от центра. По умолчанию максимум Minecraft. Снижение до, например, 10000 - простой способ ограничить рост мира. После достижения границы игроки получат The world border is here.

initial-enabled-packs / initial-disabled-packs

initial-enabled-packs=vanilla
initial-disabled-packs=

Список включённых/отключённых datapack’ов при первой генерации.

RCON

RCON - текстовый протокол для удалённого управления сервером Minecraft. Полезен для скриптов автоматизации.

enable-rcon

enable-rcon=false

Включает RCON. По умолчанию выключен.

rcon.port

rcon.port=25575

Порт RCON. По умолчанию 25575.

rcon.password

rcon.password=

Пароль для подключения. Если пустой - RCON не запустится. ОБЯЗАТЕЛЬНО ставьте сильный пароль из 20+ символов.

broadcast-rcon-to-ops

broadcast-rcon-to-ops=true

Показывать ли операторам в чате команды, отправленные через RCON.

Безопасность RCON

RCON-протокол не шифрован. Никогда не открывайте RCON-порт в интернет без VPN или SSH-туннеля. Типичная конфигурация:

enable-rcon=true
rcon.port=25575
rcon.password=Tg7v2Pq9LkN4xMr8YbW3
broadcast-rcon-to-ops=false

Подключение через mcrcon:

mcrcon -H 127.0.0.1 -P 25575 -p "Tg7v2Pq9LkN4xMr8YbW3" "list"

На хостинге с панелью Pterodactyl консоль сервера и так доступна через веб-интерфейс, RCON обычно не нужен.

Query

Старый UDP-протокол для запроса информации о сервере (онлайн, MOTD, версия).

enable-query=false
query.port=25565

Используется некоторыми мониторингами и плагинами. Безопасен (только чтение).

MOTD и иконка

motd

motd=A Minecraft Server

Сообщение, которое игроки видят в списке серверов. Поддерживает цветовые коды § (например, §6 - золотой). Многие плагины (например, MOTDPro) расширяют эту функциональность.

enable-status

enable-status=true

Отвечать ли на ping-запросы клиентов. При false сервер для всех будет в статусе “не отвечает” - но и подключиться нельзя через “Add Server”, только direct connect.

hide-online-players

hide-online-players=false

При true список игроков в ping-ответе будет пустым. Защита приватности.

Прочие параметры

resource-pack / resource-pack-sha1

resource-pack=
resource-pack-sha1=

URL к ресурспаку, который сервер форсирует клиенту, и SHA1 для проверки. При наличии - клиент при подключении предложит загрузить пак.

require-resource-pack

require-resource-pack=false

При true отказ от ресурспака = кик. Используется на ролевых и тематических серверах.

text-filtering-config

text-filtering-config=

URL фильтра чата (для серверов с детской аудиторией). Редко используется.

op-permission-level

op-permission-level=4

Дефолтный уровень для команды /op. 4 - полный доступ. Можно понизить до 1-3, если хотите разделять права.

Пример оптимизированного server.properties

Для сервера на 30 онлайн, Paper, версия 1.20.4:

server-port=25565
online-mode=true
enforce-secure-profile=true
network-compression-threshold=256
use-native-transport=true
sync-chunk-writes=true

view-distance=8
simulation-distance=6
max-tick-time=60000
entity-broadcast-range-percentage=80
max-players=30
player-idle-timeout=20

gamemode=survival
difficulty=normal
hardcore=false
pvp=true
spawn-protection=32
allow-flight=true

level-name=world
level-type=minecraft\:normal
generate-structures=true
max-world-size=15000

motd=§6Мой сервер §fwww.example.com

enable-rcon=false
enable-query=false
white-list=false

После применения такого конфига рекомендуется сделать pre-generate мира до max-world-size через Chunky или WorldBorder. Это снимет огромную нагрузку с CPU в дальнейшем. Не забывайте про общую оптимизацию сервера и настройку защиты от DDoS.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Влияние ключевых параметров на TPS

Помните: server.properties - это только базовый конфиг. На Paper/Purpur гораздо больше параметров доступно в paper-global.yml, paper-world-defaults.yml, bukkit.yml, spigot.yml. Тонкая настройка идёт уже там.

FAQ

Где находится server.properties? В корневой папке сервера, рядом с server.jar. На хостинге доступен через файловый менеджер или встроенный редактор панели.

Какой view-distance ставить? По умолчанию 10. Для 50+ онлайн - 7-8, для приватного на 5-10 человек - 10-12.

Чем simulation-distance отличается от view-distance? view-distance - рендеринг чанков на клиенте, simulation-distance - радиус тикования. Симуляция обычно меньше на 1-2 чанка.

Что делает online-mode=false? Отключает проверку лицензии Mojang. Заходить можно под любым ником - обязательно ставьте плагин авторизации.

Как настроить RCON? enable-rcon=true, задать rcon.port и сильный rcon.password, перезапустить. Никогда не открывать порт наружу без файервола.

Что такое spawn-protection? Радиус защищённой зоны вокруг спавна. По умолчанию 16. Для приватных - 0, для публичных - 32-64.