Карта сервера

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

Генерация процедурной карты

Как сгенерировать случайную карту

Сид и размер пишут в server/server1/cfg/server.cfg без плюса:

server.seed 1337
server.worldsize 3500

В start.bat те же поля идут с плюсом: +server.seed 1337 +server.worldsize 3500.

server.seed — число, из которого собирается рельеф. server.worldsize — сторона карты в метрах, от 1000 до 6000. Для небольшого онлайна удобны 3000–4500. Чем больше людей, тем шире мир.

WARNING

После смены сида или размера остановите сервер, удалите старые proceduralmap.* в server/server1 и запустите снова. Иначе поднимется прежняя карта.

Скобки из примеров в файл не переносят. Это только место для вашего числа.

Как настроить генерацию карты

world.configstring и world.configfile

Доли биомов, дороги и чёрный список монументов лежат в JSON. Удобнее отдельный файл в папке идентичности, например server/server1/mapgen.txt, и параметр запуска:

+world.configfile "mapgen.txt"

world.configstring — тот же JSON одной строкой прямо в параметрах. Файл проще править.

{
  "PercentageTier0": 0.3,
  "PercentageTier1": 0.3,
  "PercentageTier2": 0.4,
  "PercentageBiomeArid": 0.4,
  "PercentageBiomeTemperate": 0.15,
  "PercentageBiomeTundra": 0.15,
  "PercentageBiomeArctic": 0.3,
  "PercentageBiomeJungle": 0.5,
  "MainRoads": true,
  "SideRoads": true,
  "Trails": true,
  "Rivers": true,
  "Powerlines": true,
  "AboveGroundRails": true,
  "BelowGroundRails": true,
  "UnderwaterLabs": true,
  "PrefabBlacklist": [],
  "PrefabWhitelist": []
}

Доли уровней 0, 1 и 2 в сумме должны давать 1. Четыре обычных биома (пустыня, умеренный, тундра, арктика) тоже уложите в 1. Джунгли в эту четвёрку не входят: они занимают часть нулевого уровня, а не отдельный кусок карты.

Короткий файл, если нужны только тропы и столбы:

{
  "Trails": false,
  "PrefabBlacklist": [
    "electrical_box_",
    "powerline_poles"
  ]
}

На что смотреть

• Файл меняет первую генерацию. Готовый .map он не переписывает: удалите карту и дайте серверу собрать мир заново.
• Если нулевого уровня почти нет, точек появления не будет. Игрока выкинет с причиной вроде «внутри ландшафта».
• Часть монументов привязана к уровню или биому. Сильно урежете долю — памятника на карте не окажется.
• Powerlines не убирает будки у дороги. Их имя добавляют в чёрный список отдельно.
• Наземные рельсы AboveGroundRails появляются на размере 4250. На меньшей карте ключ ничего не рисует, даже если он true.
• Белый список оставляет только то, что в него попало, и прячет остальное. Чёрный и белый одновременно не включают. Совпадение идёт по куску имени, полный путь префаба не нужен.
• PercentageBiomeJungle замещает долю биома на нулевом уровне (ориентир — около половины). Число по умолчанию Facepunch уже снижал и может сменить снова. Сверка — конвар и класс WorldConfig вашей сборки.

Карта без лишнего

Отдельный пресет Barren убрали в обновлении декабря 2023. Похожий пустой мир собирается так:

{
  "MainRoads": false,
  "Trails": false,
  "Rivers": false,
  "Powerlines": false,
  "AboveGroundRails": false,
  "PrefabBlacklist": [
    "monument/cave/cave_",
    "iceberg/iceberg_",
    "ice_lakes/ice_lake_",
    "swamp/swamp_",
    "cliff",
    "rock_formation_",
    "bush_"
  ]
}

Кусты и другие динамические объекты в чёрный список встают, но консоль начинает сыпать ошибками на каждом спавне. Для монументов это нормальный инструмент, для кустов — шум в логе.

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

1. Положите .map туда, где по ссылке сразу скачивается файл, без страницы предпросмотра.
2. В server/server1/cfg/server.cfg добавьте прямую ссылку:

server.levelurl "https://example.com/maps/island.map"

3. Перезапустите сервер.

Если в панели хостинга есть поле карты, вставьте ту же ссылку туда. Путь server/server1/cfg — для сервера, который ставили по нашему курсу. На панели имя идентичности смотрите в настройках.

Где брать кастомные карты

• Нарисовать самому в RustEdit.
• Заказать у автора карт под свой онлайн и монументы.
• Купить уже собранный .map на площадке модификаций.

Плагины под такую карту ищите на TopPlugin. Зарубежные витрины с картами и модами — Codefling и Lone Design.

Где взять ссылку на карту

Игре нужна прямая ссылка, которая заканчивается на .map:

https://example.com/maps/island.map

Страница «скачать» в браузере, облако с кнопкой и ссылка с редиректом на авторизацию серверу не подходят. Файл должен открываться как сам .map.