Mapping FiveM: come aggiungere una mappa MLO al tuo server
Un mapping FiveM aggiunge alla mappa di GTA V edifici, interni, decorazioni o zone intere. Questa guida spiega cos'è un mapping, com'è strutturato e come installarlo sul tuo server FiveM con OuiPanel, il pannello di gioco di OuiHeberg. Tratta anche gli interni MLO e gli errori più comuni.
Cos'è esattamente un mapping?
Un mapping (o mappa) modifica l'ambiente di GTA V per aggiungere elementi al mondo di gioco. Può trattarsi di cose diverse.
Edifici e strutture esterne.
Interni accessibili, chiamati MLO.
Mobili e oggetti decorativi.
Modifiche del terreno.
Zone completamente nuove.
Un mapping funziona come qualsiasi altra risorsa FiveM. Lo metti nella cartella resources, lo dichiari nel server.cfg e il server lo carica all'avvio.
Struttura di un mapping
Un mapping ben organizzato segue sempre la stessa struttura di cartelle.
nome-del-mapping/
├── fxmanifest.lua
├── stream/
│ ├── file1.ymap
│ ├── file2.ytyp
│ └── file3.ybn
└── data/ (facoltativa)
└── file.meta
I file principali
Il file fxmanifest.lua è obbligatorio. Dice a FiveM come caricare la risorsa.
La cartella stream/ contiene i file veri e propri del mapping.
.ymapdefinisce posizione e collocazione degli oggetti..ytypdefinisce i tipi di oggetti..ybngestisce le collisioni, così i giocatori non attraversano gli oggetti..ytdcontiene le texture, se il mapping ne usa di personalizzate.
La cartella data/, facoltativa, contiene file .meta per impostazioni aggiuntive.
Creare un fxmanifest.lua se il mapping non ne ha uno
Alcuni mapping scaricati non hanno il manifest. Senza, FiveM non può caricare la risorsa. Ecco come crearne uno.
Manifest semplice
Se il mapping contiene solo una cartella stream/ con file .ymap, .ytyp e .ybn, usa questo manifest.
fx_version 'cerulean'
game 'gta5'
author 'IlTuoNome'
description 'Descrizione del mapping'
version '1.0.0'
this_is_a_map 'yes'
La riga this_is_a_map 'yes' è indispensabile. Dice a FiveM che la risorsa è un mapping e che deve caricare da sola i file della cartella stream/.
Manifest con file data
Se il mapping contiene anche una cartella data/ con file .meta o .ytyp, aggiungi le dichiarazioni corrispondenti.
fx_version 'cerulean'
game 'gta5'
author 'IlTuoNome'
description 'Descrizione del mapping'
version '1.0.0'
this_is_a_map 'yes'
files {
'data/*.meta'
}
data_file 'DLC_ITYP_REQUEST' 'data/*.ytyp'
Manifest per un MLO (interno)
Gli MLO sono mapping di interni più complessi. La loro struttura è questa.
mlo-interno/
├── fxmanifest.lua
└── stream/
├── interno.ymap
├── interno.ytyp
├── interno_shell.ybn
└── textures.ytd
Ed ecco il manifest corrispondente.
fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
files {
'stream/*.ytyp'
}
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
Alcuni MLO richiedono script aggiuntivi per definire i punti di entrata e di uscita. Leggi la documentazione del mapping che installi.
Installare il mapping sul tuo server
Caricare la cartella del mapping
In OuiPanel, apri il tuo server FiveM e clicca su Gestione file nel menu laterale.
Apri la cartella
resources.Se hai più mapping, clicca su Crea una cartella e chiamala
[mappings]. Aprila.Sul tuo computer, comprimi la cartella del mapping in
.zip. Trascina il file sulla pagina. Quando compare «Trascina i tuoi file qui», rilascialo.Clicca sui tre puntini della riga del file, poi su Decomprimi. Infine elimina lo
.zip.
Verifica che la cartella estratta contenga direttamente fxmanifest.lua e stream/, senza cartelle intermedie. Il caricamento è limitato a 100 MB per file. Oltre, usa l'SFTP come spiega la guida Come connettersi in SFTP con FileZilla.

Dichiarare il mapping nel server.cfg
Apri il server.cfg nella cartella principale, aggiungi una riga ensure per il mapping e clicca su Salva.
ensure nome-del-mapping
Con più mapping, aggiungi una riga per ciascuno.
# Mappings
ensure mapping-commissariato
ensure mapping-ospedale
ensure mapping-garage

Per i mapping, usa sempre
ensureinvece distart. È il comando più affidabile per questo tipo di risorsa.
Rispettare l'ordine di caricamento
L'ordine delle risorse nel server.cfg può contare. Di norma, carica i mapping dopo il framework e prima degli script di lavoro che li usano.
# Framework
ensure es_extended
ensure esx_skin
# Mappings
ensure mapping-commissariato
ensure mapping-ospedale
# Script di lavoro
ensure esx_policejob
ensure esx_ambulancejob
Riavviare il server
Nella Console, clicca su Riavvia per caricare i mapping. Poi leggi le righe di avvio. Se va tutto bene, nessun errore riguarda i tuoi mapping.
Verificare che il mapping funzioni
Entra in gioco e vai alle coordinate del mapping. La maggior parte dei creatori le indica nella descrizione o in un file readme.
Se non hai le coordinate, cercale nei file .ymap del mapping, oppure usa un comando di teletrasporto se hai un menu admin.
Risolvere i problemi comuni
Il mapping non si vede
Verifica che
fxmanifest.luaesista e contengathis_is_a_map 'yes'.Verifica che la riga
ensuresia nelserver.cfg.Cerca errori di caricamento nella Console.
Assicurati di essere alle coordinate giuste in gioco.
Le collisioni non funzionano
Se i giocatori attraversano gli oggetti, probabilmente manca il file .ybn o ha un nome sbagliato. Verifica che corrisponda al mapping.
Errore all'avvio del server
Leggi il messaggio di errore nella Console.
Controlla la sintassi di
fxmanifest.lua.Assicurati che tutti i file citati esistano.
Un mapping aggiornato resta alla vecchia versione
Il server tiene in cache i file che invia ai giocatori. In Configurazione FiveM, clicca su Elimina cache, conferma e riavvia il server.
Il mapping causa lag
I mapping molto dettagliati possono pesare sulle prestazioni. Qualche idea.
Riduci la distanza di visualizzazione nelle impostazioni del mapping, se c'è.
Non accumulare troppi mapping nella stessa zona.
Preferisci mapping ottimizzati e provati dalla community.
Buone pratiche
Organizzare i tuoi mapping
Raggruppa i tuoi mapping in una cartella [mappings] dentro resources. Gestione e manutenzione diventano più facili.
resources/
├── [mappings]/
│ ├── mapping-commissariato/
│ ├── mapping-ospedale/
│ └── mapping-garage/
├── [esx]/
└── ...
Provare prima di pubblicare
Prova ogni nuovo mapping su un server di test prima di aggiungerlo al server principale. Eviti così brutte sorprese davanti ai tuoi giocatori.
Fare un backup prima di ogni modifica
Prima di aggiungere o modificare un mapping, crea un backup. Nel menu laterale, clicca su Backup, poi su Crea un backup.

Hai bisogno di aiuto?
Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.
Scopri le nostre offerte di hosting GTA V / FiveM a partire da 2,99 €/mese, con il server pronto in 60 secondi.
Vedi le offerte →