Come aggiungere un MLO FiveM al tuo server

Pubblico: Proprietari di server e sviluppatori che gestiscono già un'istanza FiveM funzionale e desiderano estenderla con risorse di mappe interne/esterne (MLO) personalizzate.

1 · Prerequisiti

Requisito	Versione minima	Perché è importante
Artefatto del server FiveM	6016 (build 7116) o più recente	Gli artefatti più vecchi non possono caricare quelli moderni `cerulean` fx si manifesta.
Caricatore di mappe (già integrato)	Nativo per impostazione predefinita	Nessun plugin aggiuntivo necessario:FiveM trasmette automaticamente i file delle mappe.
Accesso al server	SFTP/SSH + permessi di scrittura	Devi caricare i file e modificarli server.cfg.
licenza legale	Prova d'acquisto / termini di utilizzo gratuito	Il GDPR dell'UE e la politica di Rockstar vietano la distribuzione di risorse senza licenza.

2 · Scarica e ispeziona il pacchetto MLO

Integrità della fonte – Preferire fornitori con zip firmati SHA-256 o tag Git pubblici.
Verifica la struttura – Una risorsa conforme assomiglia a:

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

Creare fxmanifest.lua se mancante – Modello minimo:

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'

ℹ️ I manifesti delle risorse standard seguono lo schema in Documentazione FiveM → “Manifesto delle risorse” (impegno 20b7b15, 2025-03-11)

3 · Carica la risorsa

Connettiti tramite SFTP alla radice del tuo server.
Vai a /resources/[maps]/—crea la cartella bracket-folder se non esiste.
Carica l'intero my-mlo elenco invariatoEvitare spazi e maiuscole nei nomi delle cartelle per prevenire problemi di percorso in Linux.

4 · Registrati in `server.cfg`

Aggiungi (o sostituisci start) Dopo risorse di base essenziali:

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

Salva il file e ricomincia il server o eseguire refresh ➜ ensure my-mlo nella console live.

5 · Cancella la cache e riavvia (se necessario)

FiveM memorizza nella cache i dati delle mappe. Per evitare ghost di versioni precedenti:

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

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

Come cancellare la cache dei server FiveM

6 · Lista di controllo per la verifica in gioco

Controllo	Comando/strumento	Criteri di superamento
Teletrasporto	vMenu → Varie → Teletrasporto → Inserisci coordinate	Il giocatore appare nel nuovo interno/esterno.
Integrità della trama	`profile_frame` poi cammina in giro	Nessun segnaposto rosa/bianco; perdita di FPS < 10%.
Collisione	Muri e rampe pedonali	Nessuna barriera invisibile o caduta attraverso il pavimento.
Illuminazione	Cambiamento del ciclo temporale con `/time 23 0`	L'interno si scurisce/illumina correttamente senza artefatti.

Se si verificano errori, rivedere l'elenco dei file mancanti .ytd O .ybn è il solito colpevole.

7 · Streaming di più MLO in modo sicuro

Una risorsa per MLOIn questo modo si evitano le collisioni di hash.
Aggiungere il prefisso ai nomi con il tag del fornitore, ad esempio bh-bank-lobby, per una disattivazione più semplice.
Utilizzare la stessa versione del manifesto per tutte le risorse della mappa per evitare avvisi di analisi.

8 · Risoluzione dei problemi Quick-Ref

Sintomo	Probabile causa	Risoluzione
Consolle: Impossibile analizzare il manifesto	Sintassi Lua errata	Correre `lua -p fxmanifest.lua` localmente; correggere virgolette/virgole.
MLO visibile, texture mancanti	`.ytd` file non referenziati	Aggiungili a `files{}` o posto in `stream/`.
I giocatori si bloccano all'ingresso	Hash prop duplicato su tutte le mappe	Rinomina duplicato `.ydr` oppure scaricare la risorsa in conflitto.
Tempo di download lungo	Grande `.ytd` texture	Comprimi le texture (DXT5 / BC3) o riduci la scala.

9 · Note sulla conformità e sulla protezione dei dati

Regolamento / Politica	Cosa devi fare
Politica di Rockstar Modding (2015-09-15)	Non vendere asset contenenti IP Rockstar.
GDPR UE artt. 44-49	Conservare le fatture dei fornitori; comunicare l'origine delle risorse su richiesta dell'utente.
FiveM ToS §3.2	Mantieni intatti i crediti; non ridistribuire pubblicamente le mod a pagamento.

Conclusione

Carica → ensure → riavvia; se il manifesto è valido, il tuo nuovo interno sarà attivo entro due minuti.

Hai bisogno di nuovi MLO?

Fonti

FiveM Docs – Manifesti delle risorse (consultato il 22 maggio 2025)
Rockstar Games – Politica di modding, 15 settembre 2015
Regolamento (UE) 2016/679 (GDPR), articoli 44-49