Введение: вечность на старте

Ошибка «Startup timeout» или «Server took too long to start» появляется, когда сервер Minecraft не успевает загрузиться за отведённое системой время. Это часто случается на слабых VDS, при использовании огромного количества модов или при первой загрузке после обновления Minecraft. Сервер запускается, начинает грузить мир, но через 2-3 минуты падает с таймаутом. В этом гайде — почему сервер долго стартует и как дать ему больше времени.

Причина 1: Большой мир с тысячами чанков

При запуске сервер загружает спавн-чанки и чанки вокруг них. Если мир имеет радиус 50 000 блоков — только индексация region-файлов может занять минуты. Плюс загрузка самих чанков в память.

Решение:

• Обрежьте мир, удалив редко посещаемые чанки (инструмент ChunkyBorder + Region Trimmer).
• Установите лимит мира: /worldborder set 10000.
• Уменьшите view-distance при запуске до 4, после старта увеличьте.

Причина 2: Много модов (Forge/Fabric)

Каждый мод регистрирует свои блоки, предметы, рецепты, биомы при старте. 100+ модов = десятки тысяч регистраций. Плюс проверка совместимости, загрузка конфигов.

Решение:

• Удалите неиспользуемые моды.
• Используйте моды-оптимизаторы загрузки: LazyDFU (Forge/Fabric) — откладывает инициализацию DFU (Data Fixer Upper) до реальной необходимости.
• Увеличьте таймаут запуска в скрипте (см. ниже).

Причина 3: Нехватка CPU при запуске

Запуск сервера — это однопоточная операция. Одно ядро процессора должно выполнить все задачи инициализации. Если ядро слабое (например, VDS с 2.0 ГГц) — запуск затягивается.

Решение:

• Выберите VDS с высокой частотой ядра (3.5+ ГГц).
• Не запускайте другие программы во время старта сервера.

Как увеличить таймаут запуска

Для systemd (Linux)

Если сервер запускается как systemd-сервис, отредактируйте файл сервиса:

[Service]
TimeoutStartSec=600  # 10 минут вместо 90 секунд по умолчанию

Затем выполните sudo systemctl daemon-reload и перезапустите сервис.

Для Docker

В docker-compose.yml добавьте:

healthcheck:
  test: ["CMD", "mc-health"]
  interval: 30s
  timeout: 600s
  retries: 1

💡 Совет профи

Используйте плагин Chunky для предзагрузки мира. Парадоксально, но предзагруженный мир запускается быстрее. Почему? Потому что сервер не пытается генерировать чанки при старте — они уже есть на диске. Генерация чанка во время старта — это двойная нагрузка (CPU + I/O). Предзагрузка убирает генерацию из уравнения, оставляя только чтение с диска.