Jak nainstalovat MLO na FiveM server

Co je FiveM MLO

MLO je komunitní název pro vlastní interiér přidaný do mapy GTA V, postavený stejně jako vstupní interiéry od samotného Rockstaru. Hráči do něj vejdou plynule z ulice, bez teleportu či načítací obrazovky.

MLO vytvářejí autoři map, buď zdarma na fóru Cfx.re, nebo placeně, obvykle s prodejem přes Tebex. Pro FiveM je MLO prostě resource, který streamuje mapové soubory, takže se instaluje jako kterákoli jiná mapa.

Jak vypadá MLO resource

Mapový resource je složka s manifestem a složkou stream, ve které jsou herní soubory:

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

Dokumentace FiveM uvádí pro mapu tento manifest:

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

Většina stažených MLO už obojí obsahuje. Pokud má manifest od autora řádky navíc, například položky data_file, ponechte je beze změny.

Instalace MLO

1. Rozbalte stažený archiv a najděte složku, která obsahuje fxmanifest.lua. Tato složka je resource; některé archivy ji balí do další složky navíc.
2. Nahrajte ji do složky resources na serveru a název složky nechte jednoduchý: bez mezer.
3. Přidejte ji do server.cfg:

   ensure my_mlo

4. Načtěte ji. Restartujte server, nebo v konzoli serveru spusťte refresh, aby se nová složka načetla, a pak ensure my_mlo.
5. Navštivte místo ve hře a vejděte dovnitř. Pokud chybí zdi nebo propadáte podlahou, hledejte v konzoli chyby týkající se tohoto resource.

Úplný restart serveru je nejbezpečnější způsob, jak načíst nový mapový resource.

Šifrovaná MLO z Tebexu

Mnoho placených MLO používá Cfx.re asset escrow: soubory jsou šifrované a běží jen na serverech, jejichž licenční klíč patří účtu, který je koupil.

• Kupujte ze správného účtu. Účet Cfx.re propojený při nákupu musí být ten, kterému patří licenční klíč vašeho serveru.
• Nahrajte všechny soubory, včetně skrytého souboru .fxap. Některé FTP programy skryté soubory přeskakují a bez něj resource selže s chybou „Failed to verify protected resource“.
• „You lack the required entitlement“ v konzoli znamená, že licenční klíč a nákup jsou na různých účtech. Zkontrolujte klíč, nebo nákup převeďte na správný účet na portálu Cfx.re; nákup lze převést jednou.
• Šifrované soubory jsou zašifrované, takže je nemůžete upravovat; autoři obvykle nechávají konfigurační soubory nešifrované pro nastavení, která máte měnit.

MLO, která potřebují novější herní build

Některá MLO používají objekty nebo interiéry z pozdější aktualizace GTA Online. Potřebují, aby server běžel na daném herním buildu; na starším části chybí nebo se resource odmítne spustit. Stránka autora build obvykle uvádí.

Nastavte ho v server.cfg, například:

sv_enforceGameBuild 3407

Projeví se jen při startu serveru a každý build obsahuje obsah předchozích buildů, takže použijte nejvyšší build, který vaše MLO potřebují. FiveM hráče na tento build přepne při připojení.

Konflikty a výkon

• Jedno MLO na jedno místo. Dvě MLO, která nahrazují stejnou budovu, se obvykle navzájem ruší: blikající zdi, neviditelné podlahy, dveře na špatném místě. Ponechte jen jedno, nebo požádejte autory o kompatibilní verze.
• Sledujte v konzoli příliš velké assety. FiveM varuje před streamovanými soubory, které zabírají více než 16 MB paměti, a nad 48 MB uvádí, že povedou k problémům se streamováním, například k nenačítání modelů. Dávejte přednost optimalizovaným MLO.
• Neinstalujte všechno najednou. Přidejte pár MLO, otestujte a pak přidejte další. Když se něco rozbije, víte, které to způsobilo.

Používejte jen MLO, ke kterým máte práva

Licence platformy FiveM zakazuje její používání způsobem, který porušuje práva kohokoli jiného, a fórum Cfx.re nepovoluje vydání porušující duševní vlastnictví třetích stran, například skutečné značky a 3D modely převzaté z jiných her. V praxi:

• bezplatná MLO stahujte z jejich oficiální stránky vydání a placená kupujte od autora;
• nikdy nepoužívejte uniklé nebo „cracknuté“ kopie placených MLO: porušují licenci autora a šifrované stejně nepoběží;
• ponechte v resource uvedení autora a soubor s licencí.

MLO na FiveM serverech HytHost

Na FiveM hostingu HytHost váš server spouští txAdmin a vaše server.cfg i složka resources jsou v datové složce txAdminu, txData. MLO tam nahrajte pomocí správce souborů v panelu nebo přes SFTP a server.cfg upravujte v CFG editoru txAdminu.

• server.cfg v hlavní složce nechte být: panel ho přepisuje při každém startu a txAdmin ho nepoužívá.
• sv_enforceGameBuild přidejte do server.cfg v txAdminu sami, když ho některé MLO potřebuje.
• Server se ve výchozím nastavení při každém startu aktualizuje na nejnovější FiveM artefakty.

Začínáte s FiveM? Začněte návodem jak vytvořit FiveM server.