Come aggiungere una mappatura sul tuo server FiveM: la guida completa

Personalizzare la mappa del tuo server FiveM è ciò che fa la differenza tra un server generico e un universo veramente immersivo. Le mappature ti permettono di aggiungere edifici, interni, decorazioni e intere aree che non esistono nel GTA V di base.

In questa guida, vedremo cos'è esattamente una mappatura, come è strutturata, come installarla correttamente sul tuo server e come evitare gli errori classici. Che tu stia aggiungendo una stazione di polizia personalizzata, un ospedale o un interno MLO completo, avrai tutte le chiavi in mano.

Cos'è esattamente una mappatura?

Una mappatura (o map) è una modifica dell'ambiente di GTA V che consente di aggiungere elementi al mondo di gioco. Concretamente, può essere:

Edifici e strutture esterne
Interni accessibili (MLO)
Mobili e oggetti decorativi
Modifiche del terreno
Aree completamente nuove

Le mappature funzionano come qualsiasi risorsa FiveM: le posizioni nella tua cartella resources, le dichiari nel server.cfg, e il server le carica all'avvio.

Struttura di una mappatura

Una mappatura ben organizzata segue sempre la stessa struttura di cartelle. Ecco come appare:

nome-della-mappatura/
├── fxmanifest.lua
├── stream/
│   ├── file1.ymap
│   ├── file2.ytyp
│   └── file3.ybn
└── data/ (opzionale)
    └── file.meta

I file principali

fxmanifest.lua — Il file di configurazione obbligatorio che indica a FiveM come caricare la risorsa.

Cartella stream/ — Contiene i file della mappatura vera e propria:

.ymap : posizioni e collocazioni degli oggetti
.ytyp : definizioni dei tipi di oggetti
.ybn : collisioni (per evitare che i giocatori passino attraverso)
.ytd : texture (se la mappatura utilizza texture personalizzate)

Cartella data/ (opzionale) — Contiene file .meta per configurazioni aggiuntive.

Creare un fxmanifest.lua se la mappatura non ne ha uno

Alcune mappature scaricate non hanno un file manifest. Senza di esso, FiveM non può caricare la risorsa. Ecco come crearne uno.

Manifest base (mappatura semplice)

Se la tua mappatura contiene solo una cartella stream/ con file .ymap, .ytyp e .ybn, utilizza questo manifest:

fx_version 'cerulean'
game 'gta5'

author 'IlTuoNome'
description 'Descrizione della mappatura'
version '1.0.0'

this_is_a_map 'yes'

La riga this_is_a_map 'yes' è essenziale: indica a FiveM che questa risorsa è una mappatura e che deve caricare automaticamente i file dalla cartella stream/.

Manifest con file data

Se la tua mappatura contiene anche una cartella data/ con file .meta o .ytyp, aggiungi le dichiarazioni corrispondenti:

fx_version 'cerulean'
game 'gta5'

author 'IlTuoNome'
description 'Descrizione della mappatura'
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 mappature interne più complesse. La loro struttura appare così:

mlo-interno/
├── fxmanifest.lua
└── stream/
    ├── interno.ymap
    ├── interno.ytyp
    ├── interno_shell.ybn
    └── textures.ytd

E il manifest corrispondente:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytyp'
}

data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'

Da notare: Alcuni MLO richiedono script aggiuntivi per definire i punti di ingresso e uscita. Controlla la documentazione della mappatura che stai installando.

Installare la mappatura sul tuo server

Una volta che la tua mappatura è pronta con il suo fxmanifest.lua, l'installazione è semplice.

Passo 1: Caricare la cartella

Accedi al gestore file del tuo server OuiHeberg / OuiPanel e naviga fino alla cartella resources. Crea una sottocartella per organizzare le tue mappature se ne hai più di una, ad esempio [mappings].

Carica l'intera cartella della tua mappatura in resources/[mappings]/.

[IMMAGINE: Screenshot del gestore file che mostra la struttura delle risorse con una cartella mappings contenente più mappe]

Passo 2: Dichiarare in server.cfg

Apri il tuo file server.cfg e aggiungi una riga ensure per caricare la mappatura:

ensure nome-della-mappatura

Se hai più mappature, aggiungi una riga per ogni mappatura:

# Mappature
ensure mapping-commissariato
ensure mapping-ospedale
ensure mapping-garage

Importante: Per le mappature, utilizza sempre ensure invece di start. Il comando ensure è più affidabile per questo tipo di risorsa.

Passo 3: Rispettare l'ordine di caricamento

L'ordine delle risorse in server.cfg può essere importante. In generale, carica le tue mappature dopo il framework ma prima degli script di lavoro che le utilizzano:

# Framework
ensure es_extended
ensure esx_skin

# Mappature
ensure mapping-commissariato
ensure mapping-ospedale

# Script di lavoro
ensure esx_policejob
ensure esx_ambulancejob

Passo 4: Riavviare il server

Riavvia il tuo server affinché le mappature vengano caricate. Controlla i log all'avvio: se tutto va bene, non dovresti vedere errori relativi alle tue mappature.

Verificare che la mappatura funzioni

Una volta riavviato il server, connettiti in gioco e recati alle coordinate della mappatura. La maggior parte dei creatori indica le coordinate nella descrizione o in un file readme.

Se non conosci le coordinate, puoi cercarle nei file .ymap della mappatura o utilizzare un comando di teletrasporto se hai un menu admin.

Risoluzione dei problemi comuni

La mappatura non appare

Controlla che il fxmanifest.lua esista e contenga this_is_a_map 'yes'
Controlla che la riga ensure sia presente in server.cfg
Controlla i log del server per errori di caricamento
Assicurati di essere alle coordinate corrette in gioco

Le collisioni non funzionano (si passa attraverso)

Il file .ybn è probabilmente mancante o mal nominato
Controlla che il file di collisione corrisponda alla mappatura

Errore all'avvio del server

Leggi attentamente il messaggio di errore nei log
Controlla la sintassi del fxmanifest.lua
Assicurati che tutti i file referenziati esistano

La mappatura provoca lag

Alcune mappature molto dettagliate possono influenzare le prestazioni. Ecco alcuni suggerimenti:

Riduci la distanza di rendering nelle impostazioni della mappatura se è configurabile
Evita di sovrapporre troppe mappature nella stessa area
Preferisci mappature ottimizzate e testate dalla comunità

Buone pratiche

Organizzare le tue mappature

Crea una cartella [mappings] nelle tue risorse per raggruppare tutte le tue mappature. Questo facilita la gestione e la manutenzione:

resources/
├── [mappings]/
│   ├── mapping-commissariato/
│   ├── mapping-ospedale/
│   └── mapping-garage/
├── [esx]/
└── ...

Testare prima di distribuire

Testa sempre una nuova mappatura su un server di test prima di aggiungerla al tuo server principale. Questo evita brutte sorprese in produzione.

Salvare regolarmente

Prima di aggiungere o modificare mappature, esegui un backup del tuo server. Presso OuiHeberg, puoi creare backup direttamente dal pannello.

In sintesi

Aggiungere mappature sul tuo server FiveM è abbastanza semplice una volta compresa la logica: una cartella con i file della mappatura, un fxmanifest.lua ben configurato e una riga ensure nel server.cfg. Gli MLO (interni) richiedono a volte un po' più di configurazione, ma il principio rimane lo stesso.

Vuoi personalizzare il tuo server FiveM con mappature personalizzate? OuiHeberg offre piani di hosting FiveM con accesso semplice ai tuoi file per installare e gestire facilmente le tue risorse.

Hai bisogno di un server GTA/FiveM?

Scopri le nostre offerte di hosting GTA V / FiveM a partire da 9,98€/mese con deployment istantaneo.

Vedi le offerte

Come aggiungere una mappatura sul tuo server FiveM: la guida completa