База знаний / Настройка server.properties

🛠️ Настройка сервера

Настройка server.properties

server.properties − главный ванильный конфиг Minecraft-сервера в корне. Здесь сеть, режим игры, дистанции прорисовки, whitelist, RCON, ресурс-пак и многое другое. Файл есть и на Paper/Spigot/Purpur, и на ванили; на модовых ядрах тоже обычно читается.

Меняйте при остановленном сервере или сразу перезапускайте после сохранения. Перед экспериментами рекомендуется сделать бэкап.

Сеть и список серверов

  • server-ip − адрес привязки. Обычно пусто (слушать все интерфейсы). На хостинге чаще не трогают.
  • server-port − порт Minecraft (часто 25565; на хостинге смотрите выданный порт в панели).
  • max-players − максимальное количество игроков на сервере.
  • motd − описание в списке серверов. Подробнее: как сделать MOTD.
  • enable-status − отвечать ли на запросы списка серверов. false − в списке «оффлайн», но зайти всё ещё можно. Рекомендуется оставить true.
  • hide-online-players − не отдавать список ников в статусе. Рекомендуется оставить false для мониторингов.
  • rate-limit − лимит пакетов до кика (базовая защита от DoS и эксплоитов). 0 − выкл.
    В большинстве случаев рекомендуется оставить стандартное значение 0. В качестве стартовой точки можно взять 15000-20000. На Paper дополнительно смотрите packet-limiter.

Аккаунты, whitelist, безопасность

  • online-mode − проверка лицензии Mojang/Microsoft. Подробнее: не удалось проверить имя пользователя и защита сервера.
  • white-list − включить whitelist. Гайд: как включить Whitelist.
  • enforce-whitelist − сразу кикать тех, кого убрали из whitelist (без этого они могут остаться онлайн до выхода).
  • op-permission-level − какой уровень OP ставит команда /op (по умолчанию обычно 4). Уровни ванили:
    • 1 − обход защиты спавна, к дополнительным командам доступа нет;
    • 2 − читы мира: /give, /gamemode, /tp, командные блоки и т.п.;
    • 3 − модерация: /kick, /ban, /op//deop, whitelist;
    • 4 − всё, включая /stop и сохранение сервера.
    Список операторов и поле level в файле − ванильные файлы (ops.json). На плагинном сервере тонкие права обычно делают через LuckPerms, а не через уровни OP.

Мир и геймплей

  • level-name − имя папки мира (по умолчанию world).
  • level-seed − сид; пусто = случайный.
  • level-type − тип генерации (minecraft:normal, flat и др.).
  • generator-settings − JSON-настройки генератора (для flat/custom).
  • generate-structures − генерировать ли структуры.
  • max-world-size − максимальный радиус мира.
  • difficulty − peaceful/easy/normal/hard. Дополнительно про установку уровня сложности.
  • gamemode − режим по умолчанию (survival/creative/adventure/spectator).
  • force-gamemode − каждый вход сбрасывать в gamemode из файла.
  • hardcore − после смерти − spectator.
  • spawn-protection − защита спавна (формула стороны 2x+1; 0 = выкл.). Работает, только если есть хотя бы один OP.
  • allow-flight − не кикать за полёт в выживании (нужно для некоторых модов и элитр).
  • player-idle-timeout − кик за простой в минутах; 0 = выкл.
  • pause-when-empty-seconds − пауза сервера без игроков. Для работы чанклоадеров и ферм рекомендуется выключить (-1).
  • enable-command-block − включить командные блоки.

Производительность: дистанции и сущности

  • view-distance − сколько чанков сервер шлёт клиенту (радиус, 3–32). Сильно влияет на CPU/RAM. При лагах часто снижают до 6–8 − см. Can't keep up!.
  • simulation-distance − в каком радиусе тикаются сущности и редстоун (3–32). Можно поставить ниже view-distance: мир видно дальше, чем он «живёт».
  • max-tick-time − сколько мс может длиться тик, прежде чем watchdog убьёт процесс (стандартное значение 60000); -1 отключает watchdog. Не рекомендуется отключать, так как при длительном зависании сервер не сможет выйти из этого состояния.

Тонкая настройка мобов и их поведения − ещё в bukkit.yml, spigot.yml и конфигах Paper.

Ресурс-пак (если необходим для сервера)

Пошагово: как установить ресурспак на сервер.

  • resource-pack − URL пака.
  • resource-pack-sha1 − хеш для проверки (желательно указывать).
  • resource-pack-id − UUID пака.
  • resource-pack-prompt − текст предложения скачать.
  • require-resource-pack − кикать, если пак не принят.

RCON

  • enable-rcon / rcon.port / rcon.password − удалённая консоль. Включайте только при необходимости и со сложным паролем; не светите порт наружу без нужды.
  • broadcast-rcon-to-ops / broadcast-console-to-ops − дублировать вывод RCON/консоли онлайн-операторам.

Связанные статьи

Полная документация

Подробнее про каждое поле и дефолтные значения: