База знаний / Настройка bukkit.yml

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

Настройка bukkit.yml

bukkit.yml − базовый конфиг Bukkit/Spigot/Paper/Purpur в корне сервера. Здесь задаются лимиты спавна, частота попыток спавна, автосохранение и несколько сетевых/служебных опций.

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

settings

  • allow-end − загружать ли измерение Энда. false отключает Энд целиком.
  • warn-on-overload − писать ли в лог сообщение Can't keep up!. Не убирает лаги, только прячет предупреждение.
  • connection-throttle − пауза (мс) между попытками входа с одного IP. Полезно против простых flood-подключений; для серьёзной защиты смотрите ещё конфиги Paper и защиту сервера.
  • query-plugins − отдавать ли список плагинов по GS4 Query. На открытом сервере часто ставят false, чтобы не светить стек.
  • shutdown-message − текст при перезагрузке/выключении сервера (например, "Сервер остановлен").
  • permissions-file − файл прав Bukkit (permissions.yml). На практике права почти всегда ведёт плагин вроде LuckPerms.
  • world-container − каталог миров (если задан, миры нужно положить туда вручную).

spawn-limits

Сколько мобов соответствующей категории может существовать в загруженной области (логика ванильная/Bukkit, определяет потолок мобов на игрока). На Paper часть лимитов может переопределяться в world-конфиге.

  • monsters − враждебные (зомби, скелеты и т.д.).
  • animals − животные.
  • water-animals − водные существа (дельфины, кальмары и др.).
  • water-ambient − мелкая «атмосферная» рыба.
  • water-underground-creature − подземные водные (например, светящиеся кальмары).
  • axolotls − аксолотли.
  • ambient − ambient-мобы (летучие мыши и подобные).

Снижение лимитов − один из простых способов разгрузить CPU на серверах с фермами и большим онлайном. Слишком низкие значения делают мир «пустым».

ticks-per

Как часто сервер пытается заспавнить мобов (в тиках; 20 тиков ≈ 1 секунда). -1 − ванильный дефолт.

  • animal-spawns − животные (по умолчанию реже враждебных).
  • monster-spawns − враждебные.
  • water-spawns, water-ambient-spawns, water-underground-creature-spawns, axolotl-spawns, ambient-spawns − соответствующие категории.
  • autosave − интервал полного автосохранения мира в тиках (6000 ≈ 5 минут). -1 отключает автосейв Bukkit (не рекомендуется без другого механизма сейва).

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

chunk-gc

  • period-in-ticks − как часто подчищать чанки, загруженные плагинами. На Paper значение дополнительно ограничено сверху.

worlds

Секция для кастомных генераторов/biome provider по имени мира: generator и biome-provider в формате имя-плагина или имя-плагина:параметры. Нужна только если ставите мир с плагинным генератором.

Связанные конфиги

  • spigot.yml − активация сущностей, трекинг, despawn и другие рычаги TPS на Spigot/Paper;
  • специфичные конфиги Paper − анти-xray, лимиты пакетов, прокси, тонкая настройка миров.

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

Полная документация представлена на официальном сайте: bukkit.yml − PaperMC Docs.