Een MLO installeren op een FiveM-server

Wat een FiveM MLO is

MLO is de naam die de community gebruikt voor een eigen interieur dat aan de GTA V-map wordt toegevoegd, gebouwd op dezelfde manier als de toegankelijke interieurs van Rockstar zelf. Spelers lopen er naadloos vanaf de straat in, zonder teleport of laadscherm.

MLO's komen van mapmakers, gratis op het Cfx.re-forum of betaald, meestal verkocht via Tebex. Voor FiveM is een MLO gewoon een resource die mapbestanden streamt, dus je installeert hem net als elke andere map.

Hoe een MLO-resource eruitziet

Een mapresource is een map met een manifest en een stream-map met de gamebestanden:

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

De documentatie van FiveM geeft dit manifest voor een map:

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

De meeste MLO's die je downloadt bevatten beide al. Heeft het manifest van de maker extra regels, zoals data_file-regels, laat die dan zoals ze zijn.

De MLO installeren

1. Pak de download uit en zoek de map met fxmanifest.lua. Die map is de resource; sommige downloads stoppen hem in een extra map.
2. Upload hem naar de resources-map van je server en houd de mapnaam eenvoudig: geen spaties.
3. Voeg hem toe aan server.cfg:

   ensure my_mlo

4. Laad hem. Herstart de server, of voer in de serverconsole refresh uit zodat de nieuwe map wordt gevonden, en daarna ensure my_mlo.
5. Ga naar de locatie in de game en loop naar binnen. Ontbreken er muren of val je door de vloer, kijk dan in de console naar fouten over die resource.

Een volledige herstart van de server is de veiligste manier om een nieuwe mapresource te laden.

MLO's met escrow van Tebex

Veel betaalde MLO's gebruiken Cfx.re asset escrow: de bestanden zijn versleuteld en werken alleen op servers waarvan de license key hoort bij het account dat ze heeft gekocht.

• Koop met het juiste account. Het Cfx.re-account dat je bij het afrekenen koppelt, moet het account zijn dat de license key van je server bezit.
• Upload alle bestanden, ook het verborgen .fxap-bestand. Sommige FTP-programma's slaan verborgen bestanden over, en zonder dat bestand faalt de resource met de fout "Failed to verify protected resource".
• "You lack the required entitlement" in de console betekent dat de license key en de aankoop op verschillende accounts staan. Controleer de key, of zet de aankoop over naar het juiste account via het Cfx.re-portaal; een aankoop kan één keer worden overgezet.
• Bestanden met escrow zijn versleuteld, dus je kunt ze niet bewerken; makers laten configbestanden meestal onversleuteld voor de instellingen die je mag aanpassen.

MLO's die een nieuwere game build nodig hebben

Sommige MLO's gebruiken props of interieurs uit een latere GTA Online-update. Daarvoor moet de server die game build draaien; op een oudere ontbreken onderdelen of weigert de resource te starten. De pagina van de maker noemt de build meestal.

Stel hem in via server.cfg, bijvoorbeeld:

sv_enforceGameBuild 3407

Dit werkt pas wanneer de server start, en elke build bevat de inhoud van de builds ervoor, dus gebruik de hoogste build die je MLO's nodig hebben. FiveM zet spelers bij het joinen over op die build.

Conflicten en prestaties

• Eén MLO per locatie. Twee MLO's die hetzelfde gebouw vervangen, botsen meestal: flikkerende muren, onzichtbare vloeren, deuren op de verkeerde plek. Houd er maar één, of vraag de makers om compatibele versies.
• Let in de console op te grote assets. FiveM waarschuwt voor gestreamde bestanden die meer dan 16 MB geheugen gebruiken, en meldt boven 48 MB dat ze tot streamingproblemen leiden, zoals modellen die niet laden. Kies liever geoptimaliseerde MLO's.
• Installeer niet alles tegelijk. Voeg een paar MLO's toe, test, en voeg er dan meer toe. Als er iets stukgaat, weet je welke het was.

Gebruik alleen MLO's waarvoor je de rechten hebt

De platformlicentie van FiveM verbiedt gebruik dat de rechten van anderen schendt, en het Cfx.re-forum staat geen releases toe die inbreuk maken op intellectueel eigendom van derden, zoals echte merken en 3D-modellen uit andere games. In de praktijk:

• gebruik gratis MLO's van hun officiële releasepagina en betaalde MLO's die je bij de maker hebt gekocht;
• gebruik nooit gelekte of "gekraakte" kopieën van betaalde MLO's: ze schenden de licentie van de maker, en die met escrow werken toch niet;
• laat de credits en het licentiebestand van de maker in de resource staan.

MLO's op FiveM-servers van HytHost

Bij FiveM-hosting van HytHost draait txAdmin je server, en je server.cfg en resources-map staan in de datamap van txAdmin, txData. Upload MLO's daarheen met de bestandsbeheerder van het panel of via SFTP, en bewerk server.cfg in de CFG-editor van txAdmin.

• Laat de server.cfg in de hoofdmap met rust: het panel overschrijft hem bij elke start, en het is niet degene die txAdmin gebruikt.
• Voeg sv_enforceGameBuild zelf toe aan je txAdmin-server.cfg wanneer een MLO dat nodig heeft.
• Standaard werkt de server bij elke start bij naar de nieuwste FiveM-artifacts.

Nieuw met FiveM? Begin met een FiveM-server maken.