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

spigot.yml − конфиг Spigot (есть и на Paper/Purpur) в корне сервера. Здесь самые ощутимые для TPS настройки: AI сущностей, дальность видимости мобов, хопперы и дроп. На Fabric/Forge файла нет.

Многие опции живут под world-settings.default. Чтобы переопределить мир, добавьте секцию с именем папки мира (как level-name в server.properties) и перезапустите сервер. Перед экспериментами рекомендуется сделать бэкап.

settings (глобальные)

• bungeecord − режим за BungeeCord/Waterfall (форвардинг IP/UUID). Для Velocity на Paper обычно настраивают proxies в paper-global.yml.
• timeout-time − через сколько секунд без тиков watchdog считает сервер зависшим.
• messages − сообщения:
  • whitelist − «Вас нет в белом списке сервера»
  • server-full − «Сервер заполнен»
  • outdated-client − «Ваш клиент устарел, используйте версию {0}»
  • outdated-server − «Сервер использует устаревшую версию {0}»
  • restart − «Сервер ещё перезапускается»

world-settings: entity-activation-range

Дистанция в блоках от игрока, на которой поведение сущностей вычисляется полноценно. Это основной рычаг против лагов от мобов. См. также Can't keep up!.

• animals, monsters, villagers, raiders, flying-monsters, water, misc − радиусы по категориям. Меньше = легче серверу; слишком мало − медленные фермы и странное поведение мобов вдалеке. У misc (в т.ч. предметы) сильное занижение может глючить предметы в потоках воды.
• tick-inactive-villagers − тикать ли жителей вне радиуса. false разгружает торговые залы, но жители вне зоны «замирают».
• wake-up-inactive − периодически пробуждать неактивных мобов, чтобы мир совсем не замирал.

world-settings: entity-tracking-range

Насколько далеких сущностей сервер отправляет клиенту. Меньше радиус − меньше трафика, мобы появляются ближе.

• players, animals, monsters, misc, display, other.

world-settings: merge-radius, despawn, spawn

• merge-radius.item / merge-radius.exp − радиус слипания дропа и сферы опыта (меньше сущностей на земле).
• item-despawn-rate − через сколько тиков пропадает обычный дроп (6000 ≈ 5 минут).
• arrow-despawn-rate / trident-despawn-rate − аналогично для стрел и трезубцев.
• mob-spawn-range − в каких чанках от игрока разрешён спавн мобов.
• nerf-spawner-mobs − упростить поведение мобов из спавнеров (фермы легче для процессора).

world-settings: ticks-per (хопперы)

• hopper-check − как часто хоппер ищет предметы.
• hopper-transfer − интервал передачи предметов.
• hopper-amount − сколько предметов за раз.
• hopper-can-load-chunks − могут ли хопперы подгружать чанки.

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

world-settings: рост и порталы

• growth.*-modifier − скорость роста культур/растений в процентах от ванили (100 = норма).
• enable-zombie-pigmen-portal-spawns − спавн зомбифицированных пиглинов в адских порталах.

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

• bukkit.yml − капы спавна и автосейв;
• конфиги Paper − анти-xray, пакеты, прокси;
• server.properties − view-distance и базовая ваниль.

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

Актуальные ключи и дефолты: spigot.yml − PaperMC Docs.