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

Что такое FiveM MLO

MLO — так сообщество называет собственный интерьер, добавленный на карту GTA V и устроенный так же, как интерьеры самой Rockstar, в которые можно зайти. Игроки входят в него прямо с улицы, без телепорта и экрана загрузки.

MLO делают авторы карт: бесплатно на форуме Cfx.re или платно, обычно через Tebex. Для FiveM MLO — это просто ресурс, который стримит файлы карты, поэтому он устанавливается как любая другая карта.

Как выглядит ресурс MLO

Ресурс карты — это папка с манифестом и папкой stream, в которой лежат игровые файлы:

my_mlo/
├── fxmanifest.lua
└── stream/
    ├── my_mlo.ymap
    ├── my_mlo.ytyp
    ├── my_mlo.ybn
    ├── my_mlo.ydr
    └── my_mlo.ytd

Документация FiveM приводит такой манифест для карты:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'
this_is_a_map 'yes'

В большинстве скачанных MLO уже есть и то, и другое. Если в манифесте автора есть дополнительные строки, например записи data_file, оставьте их как есть.

Установка MLO

1. Распакуйте архив и найдите папку, в которой лежит fxmanifest.lua. Эта папка и есть ресурс; в некоторых архивах она вложена в ещё одну папку.
2. Загрузите её в папку resources сервера, дав папке простое имя без пробелов.
3. Добавьте её в server.cfg:

   ensure my_mlo

4. Загрузите ресурс. Перезапустите сервер или выполните в консоли сервера refresh, чтобы он увидел новую папку, а затем ensure my_mlo.
5. Зайдите на локацию в игре. Если нет стен или вы проваливаетесь сквозь пол, поищите в консоли ошибки этого ресурса.

Полный перезапуск сервера — самый надёжный способ загрузить новый ресурс карты.

MLO с escrow с Tebex

Многие платные MLO используют asset escrow от Cfx.re: файлы зашифрованы и работают только на серверах, чей лицензионный ключ принадлежит аккаунту, который их купил.

• Покупайте с нужного аккаунта. Аккаунт Cfx.re, привязанный при оплате, должен быть тем, которому принадлежит лицензионный ключ вашего сервера.
• Загрузите все файлы, включая скрытый файл .fxap. Некоторые FTP-клиенты пропускают скрытые файлы, а без него ресурс падает с ошибкой "Failed to verify protected resource".
• "You lack the required entitlement" в консоли означает, что лицензионный ключ и покупка находятся на разных аккаунтах. Проверьте ключ или перенесите покупку на нужный аккаунт на портале Cfx.re; перенести покупку можно один раз.
• Escrow-файлы зашифрованы, поэтому редактировать их нельзя; обычно авторы оставляют конфиги незашифрованными для тех настроек, которые предполагается менять.

MLO, которым нужен более новый игровой билд

Некоторые MLO используют пропы или интерьеры из более позднего обновления GTA Online. Для них сервер должен работать на этом игровом билде; на более старом части не будет или ресурс не запустится. Обычно билд указан на странице автора.

Задайте его в server.cfg, например:

sv_enforceGameBuild 3407

Настройка применяется только при запуске сервера, а каждый билд включает содержимое предыдущих, поэтому ставьте самый высокий билд, который нужен вашим MLO. FiveM переключает игроков на этот билд при подключении.

Конфликты и производительность

• Один MLO на локацию. Два MLO, заменяющих одно и то же здание, обычно конфликтуют: мерцающие стены, невидимые полы, двери не на своём месте. Оставьте один или попросите авторов о совместимых версиях.
• Следите в консоли за слишком тяжёлыми ассетами. FiveM предупреждает о стримящихся файлах, которые занимают больше 16 МБ памяти, а выше 48 МБ пишет, что они приведут к проблемам со стримингом, например к незагружающимся моделям. Выбирайте оптимизированные MLO.
• Не ставьте всё сразу. Добавьте несколько MLO, проверьте, потом добавьте ещё. Если что-то сломается, вы будете знать, какой из них виноват.

Используйте только MLO, на которые у вас есть права

Лицензия платформы FiveM запрещает использовать её так, чтобы нарушались чужие права, а форум Cfx.re не допускает релизы, нарушающие интеллектуальную собственность третьих лиц, например реальные бренды и 3D-модели из других игр. На практике:

• берите бесплатные MLO с их официальной страницы релиза, а платные покупайте у автора;
• никогда не используйте слитые или "крякнутые" копии платных MLO: это нарушает лицензию автора, а escrow-версии всё равно не запустятся;
• сохраняйте в ресурсе указание авторства и файл лицензии.

MLO на серверах FiveM от HytHost

На FiveM-хостинге HytHost сервером управляет txAdmin, а ваш server.cfg и папка resources находятся в папке данных txAdmin — txData. Загружайте туда MLO через файловый менеджер панели или по SFTP, а server.cfg редактируйте в CFG-редакторе txAdmin.

• Не трогайте server.cfg в корневой папке: панель перезаписывает его при каждом запуске, и txAdmin использует не его.
• Добавляйте sv_enforceGameBuild в server.cfg txAdmin самостоятельно, когда это нужно MLO.
• По умолчанию сервер при каждом запуске обновляется до последних артефактов FiveM.

Только начинаете с FiveM? Начните с гайда как создать сервер FiveM.