Hoe installeer ik MLO's en custom maps op mijn FiveM-server?

Wil je jouw FiveM-server een eigen gezicht geven met custom interieurs en mapaanpassingen? Dan kom je al snel uit bij MLO's en ymap-bestanden. In deze gids installeer je stap voor stap een MLO of custom map op je server bij MC-Node: je zet de juiste mapstructuur met een stream-map op, maakt een correcte fxmanifest.lua, uploadt de resource via SFTP en activeert alles met ensure in je server.cfg. Ook lees je hoe je de bekendste problemen oplost, zoals interieurs die niet laden of spelers die door de vloer vallen.

Wat is het verschil tussen een MLO en een ymap?

Beide passen de spelwereld aan, maar op een verschillende manier:

• Ymap — een plaatsingsbestand dat bestaande objecten (props) in de wereld neerzet of verplaatst: hekken, decoratie, wegblokkades of een extra gebouw aan de buitenkant. Licht en simpel; vaak volstaat één .ymap-bestand.
• MLO (Multi-Level Object) — een volwaardig, betreedbaar interieur met eigen kamers, portalen, collision en verlichting. Een MLO bestaat meestal uit meerdere bestanden: .ydr (modellen), .ybn (collision), .ytd (textures), een .ytyp (interieurdefinitie) en een .ymap (plaatsing).

Kort gezegd: een ymap zet iets neer, een MLO bouwt iets waar je in kunt. De installatie verloopt vrijwel identiek, maar een MLO is gevoeliger voor fouten omdat de .ytyp correct geladen moet worden.

Stap 1: Zet de juiste mapstructuur op

1. Pak de gedownloade MLO of custom map uit op je computer en bekijk welke bestanden erin zitten.
2. Maak één resourcemap met een korte naam zonder spaties of hoofdletters, bijvoorbeeld vanilla_hotel.
3. Zet alle streambestanden (.ydr, .ybn, .ytd, .ytyp en .ymap) in een submap met de naam stream.
4. Zet in de hoofdmap van de resource een bestand fxmanifest.lua.

De structuur ziet er dan zo uit:

vanilla_hotel/
├── fxmanifest.lua
└── stream/
    ├── hotel_interior.ydr
    ├── hotel_interior.ybn
    ├── hotel_textures.ytd
    ├── hotel.ytyp
    └── hotel.ymap

Een minimale, correcte fxmanifest.lua voor een map-resource:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

De regel this_is_a_map 'yes' vertelt FiveM dat deze resource wereld-data bevat, zodat de map bij het herstarten van de resource netjes opnieuw wordt geladen. Levert de maker extra regels mee, zoals data_file 'DLC_ITYP_REQUEST' 'stream/hotel.ytyp', laat die dan gewoon staan.

Stap 2: Upload de resource via SFTP

1. Verbind met je server via SFTP. Hoe je dat instelt lees je in SFTP met WinSCP of FileZilla.
2. Navigeer naar de map resources van je FiveM-server.
3. Upload de complete resourcemap, inclusief de stream-submap. Je mag de resource ook in een categoriemap zoals [maps] plaatsen.
4. Gebruik je FileZilla? Zet dan vóór het uploaden Transfer → Transfer type → Binary. In ASCII- of Auto-modus kan FileZilla binaire bestanden zoals .ydr en .ybn beschadigen, waardoor je interieur nooit laadt.

Kleine resources kun je ook via het tabblad Files in het paneel uploaden, maar voor MLO's met grote streambestanden is SFTP betrouwbaarder. De algemene werkwijze staat in Hoe upload ik een script?

Stap 3: Ensure de resource in server.cfg

1. Open server.cfg via het tabblad Files in het paneel (of via SFTP).
2. Voeg de regel ensure vanilla_hotel toe, met exact dezelfde naam als je resourcemap.
3. Let op de volgorde: zet map-resources boven scripts die het interieur nodig hebben, zoals housing-, garage- of teleportscripts. Een verkeerde ensure-volgorde zorgt ervoor dat zo'n script start terwijl het interieur nog niet bestaat.
4. Sla het bestand op en herstart je server via het tabblad Console.
5. Controleer in de console of je Started resource vanilla_hotel ziet en loop in-game naar de locatie.

Veelvoorkomende problemen

• Interieur is onzichtbaar of laadt niet — Controleer eerst in de console of de resource echt gestart is. Start hij wel, dan is het bestand vaak corrupt geüpload of wordt de .ytyp niet geladen: upload de hele stream-map opnieuw in binary-modus en controleer of this_is_a_map 'yes' in de fxmanifest.lua staat.
• Je valt door de vloer — Het collision-bestand (.ybn) ontbreekt of is beschadigd. Vergelijk de bestandsgroottes op de server met die op je pc; wijken ze af, dan ging het uploaden mis.
• Twee MLO's op dezelfde locatie — Flikkerende muren, dubbele deuren of een zwart interieur wijzen meestal op twee resources die hetzelfde gebouw aanpassen. Verwijder de ensure-regel van één van de twee en herstart de server.
• Foutmelding over te grote assets — Een console-melding dat een asset de size limit overschrijdt, komt bijna altijd door te zware .ytd-texturebestanden. Gebruik een geoptimaliseerde versie of verklein de textures (bijvoorbeeld van 4K naar 2K); te zware maps zorgen bovendien voor lange laadtijden en client-crashes.
• Script-errors na het toevoegen van de map — Controleer de volgorde in server.cfg: de map-resource moet eerder geladen worden dan de scripts die ernaar verwijzen.

Klaar!

Je server streamt nu je eigen MLO's en custom maps. Kom je er toch niet uit? Open een ticket via onze supportpagina en vermeld de naam van de resource en de exacte foutmelding uit de console.