← База знаний
Rustrustкарты3 мин. чтения

Установка кастомной карты

Как установить кастомную карту на сервер Rust через levelurl — хостинг .map файла, генерация в RustMaps и RustEdit, особенности вайпа

Установка кастомной карты

Кастомная карта заменяет процедурно сгенерированный мир Rust на созданный вручную или по своим параметрам. Это даёт уникальный ландшафт, авторские монументы и продуманный баланс. В этой статье разберём, как разместить файл карты в интернете, подключить его через levelurl и что учитывать при вайпе.

Установка кастомной карты Rust через levelurl

Где взять кастомную карту

Есть два основных источника:

  • RustMaps (rustmaps.com) — онлайн-генератор карт. Вы задаёте размер и seed или используете фильтры по монументам, а сервис выдаёт готовый .map файл со ссылкой. Часть карт бесплатна, часть — платная.
  • RustEdit — десктопный редактор карт. В нём создают полностью авторские миры: рисуют рельеф, ставят монументы, добавляют кастомные префабы и триггеры. Результат сохраняется в .map файл.

Для старта проще всего взять готовую карту с RustMaps: там есть прямая ссылка на файл, которую можно сразу подставить в levelurl.

Хостинг .map файла

Rust загружает карту по прямой ссылке (levelurl), поэтому файл должен быть доступен по HTTP(S) как обычный файл, а не как страница загрузки.

Требования к ссылке:

  • Ссылка должна вести напрямую на .map файл и заканчиваться на .map.
  • Сервер по ссылке должен отдавать файл без капчи, авторизации и промежуточных страниц.
  • Хостинг должен быть стабильным: карта скачивается и сервером, и каждым игроком при подключении.

Подходящие варианты хостинга:

  • RustMaps — при генерации даёт прямую ссылку вида https://content.rustmaps.com/.../map.map. Это самый надёжный способ.
  • Собственный веб-сервер или объектное хранилище (S3-совместимое) — загрузите файл и получите прямую ссылку.
  • Обычные файлообменники с страницей-прослойкой не подходят — Rust не сможет скачать файл.

Не используйте ссылки, которые меняются или истекают: если карта станет недоступна, сервер не запустится, а игроки не смогут зайти.

Подключение через levelurl

Откройте панель panel.teahost.ru, выберите сервер и перейдите в раздел Startup.

  • Найдите поле параметров запуска (Startup Command).
  • Добавьте параметр с прямой ссылкой на файл:

+server.levelurl "https://content.rustmaps.com/maps/ваша-карта.map"
```

3. Убедитесь, что параметры `+server.worldsize` и `+server.seed` **не конфликтуют** с картой. При использовании `levelurl` они игнорируются — размер и рельеф берутся из файла.
4. Сохраните настройки и перезапустите сервер.

При первом запуске сервер скачает карту по ссылке и закеширует её. В консоли панели вы увидите строку загрузки уровня. Если ссылка нерабочая, сервер напишет ошибку и не стартует — проверьте, что файл открывается в браузере напрямую.

## Что учесть при вайпе с кастомной картой

Кастомная карта и прогресс на ней — разные вещи. При вайпе очищается прогресс (постройки, предметы), а сама карта остаётся, пока в `levelurl` стоит та же ссылка.

Важные моменты:

- **Смена карты = смена ссылки.** Чтобы дать новый мир, замените URL в `levelurl` на другой `.map` файл. Просто вайп карту не меняет.
- **Seed и size не работают.** Пока задан `levelurl`, параметры `WORLD_SEED` и `WORLD_SIZE` не влияют ни на что. Чтобы вернуться к процедурной генерации, уберите `levelurl` полностью.
- **Форс-вайп.** После ежемесячного обновления Rust карта может стать несовместимой со старыми сейвами. В первый четверг месяца делайте полный вайп и, при необходимости, обновите карту у автора.
- **Версия карты.** Крупные обновления Rust иногда ломают старые кастомные карты. Если после обновления сервер падает при загрузке уровня, скачайте свежую версию карты с RustMaps.

Автобэкапы в панели сохраняют прогресс перед вайпом, поэтому при ошибке можно откатиться к предыдущему состоянию. О расписании вайпов и смене seed читайте в статье [настройка расписания вайпов](/wiki). DDoS-защита на серверах TeaHost включена по умолчанию.

Другие руководства по настройке — в [базе знаний Rust](/rust).