Як встановити 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.