Как установить MLO на сервер FiveM: stream, fxmanifest, ensure

Вы загрузили пакет карты с файлами, такими как .ymap, .ytyp, .ybn и .ydr, и вы хотите его на своём сервере. Это руководство показывает макет папки, fxmanifest.lua, строку server.cfg и быстрый способ протестировать это в игре.

#Что находится внутри пакета карты

MLO (пользовательский интерьер) или карта — это обычный ресурс. Обычные файлы:

• .ymap: где находятся объекты и интерьер в мире.
• .ytyp: определение интерьера и его пользовательских реквизитов (их «архетипов»).
• .ybn: коллизии. Без них вы падаете сквозь пол или проходите сквозь стены.
• .ydr и .ydd: 3D модели реквизитов и частей.
• .ytd: текстуры.

Все они идут в папку, названную stream. FiveM отправляет всё в stream игрокам самостоятельно, поэтому вы не перечисляете эти файлы в манифесте.

#Структура папки

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

Многие пакеты идут с другим уровнем, таким как my_mlo-master/my_mlo/. Переместите папку, которая содержит fxmanifest.lua, в resources, или сервер не сможет найти ресурс.

#Fxmanifest.lua

Если пакет поставляется без манифеста, создайте один:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' говорит FiveM, что ресурс содержит данные карты. Если пакет имеет файл .ytyp, добавьте строку, которая его регистрирует:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Используйте одну строку data_file для каждого файла .ytyp. Путь — это реальный путь в папке, поэтому проверьте имя и регистр букв.

Совет: если пакет уже поставлялся с манифестом, сохраните его. Автор написал его для этих точных файлов, и он часто перечисляет несколько файлов .ytyp или дополнительные опции, которые вы не хотите угадывать.

#Добавьте его в server.cfg

ensure my_mlo

Имя после ensure должно быть именем папки. Чтобы запустить целую группу, поместите карты в папку в скобках и используйте ensure [maps]. Карты не зависят от вашего фреймворка, но запустите их после других основных ресурсов, чтобы ошибка карты не могла заблокировать важные. Подробнее об этом в server.cfg resource order.

Перезагрузите сервер или введите ensure my_mlo в прямую консоль txAdmin. Новый .ytyp более надёжен при полной перезагрузке.

#Требование game build

Некоторые карты используют реквизиты или модели из более новой DLC GTA V. На стандартной сборке игры эти реквизиты отсутствуют: вы видите пустые комнаты, белый ящик или вообще никакого интерьера. Страница пакета обычно указывает сборку, которую он требует. Установите её в server.cfg и перезагрузитесь:

set sv_enforceGameBuild 3095

Число выше — только пример: используйте то, что просит пакет. Полный список и побочные эффекты находятся в sv_enforceGameBuild и DLC.

#Протестируйте это в игре

1. Прочитайте консоль txAdmin при запуске. Ошибки, такие как отсутствующий файл в data_file, показываются там. Если ресурс не запускается, см. couldn't start resource.
2. Присоединитесь к серверу. Перейдите к координатам в файле readme пакета с помощью меню телепортации txAdmin или команды координат из вашего скрипта администратора.
3. Пройдите через дверь. Пользовательский интерьер часто загружается только когда вы близко, поэтому приближайтесь пешком и не издалека на высокой скорости.
4. Проверьте пол и стены. Если вы падаете или проходите сквозь, файлы .ybn отсутствуют или не загрузились. См. falling through the map.

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

• Интерьер не появляется. Ресурс не запущен, координаты неправильны или требуется более новая сборка игры. Также проверьте, что файлы находятся внутри stream, а не на один уровень глубже в подпапку, которую ресурс не использует.
• Реквизиты отсутствуют, но стены есть. .ytyp не зарегистрирован. Добавьте строку DLC_ITYP_REQUEST с правильным именем файла.
• Часть комнаты мерцает или стены исчезли. Другая карта охватывает одно и то же место. См. map conflicts.
• Текстуры выглядят неправильно или тяжело. Большие текстуры стоят памяти потока. См. oversized assets.
• Это работало, затем сломалось после обновления. Очистите кэш клиента и попробуйте ещё раз: clear the FiveM cache.

#Много карт на одном сервере

Каждая карта добавляет потоковые файлы, которые каждый игрок загружает и хранит в памяти. Установите только карты, которые вы используете, поместите каждую в свой ресурс и назовите его чётко. Когда что-то ломается, вы можете затем остановить один ресурс за раз и найти причину.

#Чеклист