База знаний / Как установить карту на сервер?

🚀 Продвинутое администрирование

Как установить карту на сервер?

Карта (мир) — готовая папка с ландшафтом, постройками и приключением. Чтобы заменить мир на сервере, папку с картой нужно положить на место текущей world.

❗️ Почему только SFTP: в файловом менеджере панели нельзя нормально перемещать и переименовывать папки. Для установки карты удобнее и надёжнее работать через SFTP (FileZilla / WinSCP): распаковать карту на компьютере и загрузить её целиком.

Как подключиться по SFTP — в статье Как подключиться по SFTP/FTP?

Подготовка карты на компьютере

  1. Скачайте карту (обычно архив .zip / .rar).
  2. Распакуйте архив на компьютере.
  3. Найдите папку мира (содержит в себе файл level.dat и папку region).
    4. Примерно ожидаемая структура папки с картой
    Примерно ожидаемая структура папки с картой
  4. Переименуйте эту папку в world.

Важно: версия карты должна совпадать с версией сервера (или быть близкой). Карта под 1.12 часто не откроется нормально на 1.20+. Сделайте бэкап текущего мира, если он нужен.

Установка через SFTP

  1. Остановите сервер в панели и дождитесь статуса «Offline» / «Выключен».
  2. Подключитесь к серверу по SFTP.
  3. В корне сервера найдите текущую папку world (иногда ещё world_nether, world_the_end).
    4. FileZilla: папки с миром на сервере
    FileZilla: папки с миром на сервере
  4. При необходимости сделайте бэкап: скачайте старую world на компьютер или переименуйте её, например, в world_old.
  5. Удалите старую папку world с сервера.
  6. Перетащите подготовленную локальную папку world в корень сервера.
  7. Дождитесь окончания загрузки — у больших карт это может занять несколько минут.

Nether и End: если карта идёт только с обычным миром, старые world_nether / world_the_end можно оставить или удалить — сервер создаст новые. Если в архиве есть свои измерения, загрузите их как отдельные папки с именами, которые ожидает ядро / инструкция автора карты.

Проверка имени мира

Откройте server.properties и убедитесь, что указано: 

level-name=world

Важно: это применимо только если папка с картой называется world. В противном случае нужно указать имя папки с картой, либо переименовать папку с картой в world, как было описано выше.

Запуск

  1. Запустите сервер в панели.
  2. В логах дождитесь сообщения вроде Done! / Server started.
  3. Зайдите в игру и проверьте, что загрузилась нужная карта.

Частые проблемы

  • Пустой или не тот мир — папка названа не так, как в level-name, или внутри ещё одна вложенная папка. Папка world должна содержать в себе level.dat и папку region. Если путь до файлов, например, world/MyMap/level.dat, то это неверно.
  • Панель не даёт переименовать/переместить — как раз поэтому всё делается в SFTP-клиенте на компьютере и загрузкой готовой папки.
  • Сервер не стартует — несовместимая версия карты, смотрите logs/latest.log.
  • Большая карта грузится очень долго — нормально для миров на гигабайты, не прерывайте загрузку.