Hoe voeg je een FiveM MLO toe aan je server?

Publiek: Server eigenaren en ontwikkelaars die al een functionele FiveM instantie beheren en deze willen uitbreiden met aangepaste interieur/exterieur kaartassets (MLOs).

1 · Vereisten

Vereiste	Minimale versie	Waarom het belangrijk is
FiveM server artifact	6016 (build 7116) of nieuwer	Oudere artifacts kunnen moderne niet laden `cerulean` fx manifests.
Kaartlader (reeds ingebouwd)	Standaard native	Geen extra plugin nodig—FiveM streamt kaartbestanden automatisch.
Toegang tot server	SFTP/SSH + schrijfrechten	Je moet bestanden uploaden en bewerken server.cfg.
Wettelijke licentie	Bewijs van aankoop / gratis gebruiksvoorwaarden	EU GDPR en Rockstar-beleid verbiedt het verspreiden van niet-gelicenseerde assets.

2 · Download en inspecteer het MLO pakket

Bronintegriteit – Geef de voorkeur aan leveranciers met SHA‑256‑ondertekende zips of publieke Git-tags.
Controleer structuur – Een conforme resource ziet er als volgt uit:

my-mlo/
 ├─ stream/
 │ ├─ *.ydr ↰ (models)
 │ ├─ *.ytyp ↰ (item definitions)
 │ ├─ *.ybn ↰ (collisions‑―if supplied)
 │ └─ *.ytd ↰ (textures)
 ├─ fxmanifest.lua
 └─ README.md (optional)

Creëren fxmanifest.lua indien ontbrekend – Minimale sjabloon:

fx_version 'cerulean'
games { 'gta5' }

author 'YourName'
description 'My Custom MLO'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream/**/*.ydr',
 'stream/**/*.ytyp',
 'stream/**/*.ytd',
 'stream/**/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'

ℹ️ Standaarden Resource-manifesten volgen het schema in FiveM docs → “Resource-manifest” (commit 20b7b15, 2025‑03‑11)

3 · Upload de Resource

Maak via SFTP verbinding met je server-root.
Navigeer naar /resources/[maps]/—maak de map met accolades aan als deze nog niet bestaat.
Upload de volledige my-mlo directory ongewijzigd. Vermijd spaties en hoofdletters in mapnamen om Linux-padproblemen te voorkomen.

4 · Registreer in `server.cfg`

Voeg toe (of vervang start) na essentiële basisresources:

ensure my-mlo # loads on boot; restarts automatically on txAdmin soft‑restarts

Sla het bestand op en restart de server of voer uit refresh ➜ ensure my-mlo in de live console.

5 · Cache wissen & Herstarten (indien nodig)

FiveM cached kaartgegevens. Om spoken van oudere versies te voorkomen:

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

Hoe de cache van FiveM-servers te wissen

6 · In‑Game verificatie checklist

Controleren	Commando\/tool	Slaagcriteria
Teleport	vMenu → Diversen → Teleport → Coördinaten invoeren	Speler spawnt in de nieuwe interior\/exterior.
Textuurintegriteit	`profile_frame` loop dan rond	Geen roze\/witte placeholders; FPS-verlies < 10%.
Botsing	Loop muren & hellingen	Geen onzichtbare barrières of door de vloer vallen.
Verlichting	Tijdcyclus wijzigen met `/time 23 0`	Interieur wordt correct donkerder\/helderder zonder artefacten.

Als er fouten optreden, controleer de bestandslijst—ontbrekend .ytd of .ybn is de gebruikelijke boosdoener.

7 · Veilig meerdere MLOs streamen

Eén resource per MLO. Dit voorkomt hashcollisies.
Prefix namen met vendor-tag, bijv. bh-bank-lobby, voor eenvoudiger uitschakelen.
Gebruik dezelfde manifestversie voor alle mapresources om parseerwaarschuwingen te voorkomen.

8 · Snelreferentie voor probleemoplossing

Symptoom	Waarschijnlijke oorzaak	Resolutie
Console: Kon manifest niet parseren	Ongeldige Lua-syntaxis	Voer `lua -p fxmanifest.lua` lokaal; corrigeer aanhalingstekens/komma's.
MLO zichtbaar, texturen ontbreken	`.ytd` bestanden niet gerefereerd	Voeg ze toe aan `files{}` of plaats in `stream/`.
Spelers crashen bij verbinden	Dubbele prop-hash over kaarten	Hernoem dubbele `.ydr` of laad conflicterende resource.
Lange downloadtijd	Grote `.ytd` texturen	Comprimeer texturen (DXT5 / BC3) of schaal ze omlaag.

9 · Nalevings- en gegevensbeschermingsnotities

Regelgeving / Beleid	Wat u moet doen
Rockstar Modding-beleid (2015-09-15)	Verkoop geen assets met Rockstar IP.
EU AVG Art. 44‑49	Bewaar leveranciersfacturen; geef de herkomst van activa op verzoek van de gebruiker vrij.
FiveM ToS §3.2	Houd credits intact; verspreid betaalde mods niet openbaar.

Conclusie

Upload → ensure → herstart; als het manifest geldig is, is je nieuwe interieur binnen twee minuten live.

Nieuwe MLOs nodig?

Bronnen

FiveM Docs – Resource Manifests (geraadpleegd op 22 mei 2025)
Rockstar Games – Modding Policy, 15 sep 2015
Verordening (EU) 2016/679 (AVG), artikelen 44‑49