Come installare un MLO su un server FiveM: stream, fxmanifest, ensure

Hai scaricato un pack di mappe con file come .ymap, .ytyp, .ybn e .ydr, e vuoi che sia sul tuo server. Questa guida mostra il layout della cartella, fxmanifest.lua, la riga server.cfg e un modo veloce per testarlo nel gioco.

#Cosa c'è dentro un pack di mappe

Un MLO (un interno personalizzato) o una mappa è una risorsa normale. I file soliti sono:

• .ymap: dove gli oggetti e l'interno si trovano nel mondo.
• .ytyp: la definizione dell'interno e dei suoi prop personalizzati (i loro "archetypes").
• .ybn: le collisioni. Senza di loro cadi attraverso il pavimento o cammini attraverso i muri.
• .ydr e .ydd: i modelli 3D di prop e parti.
• .ytd: le texture.

Tutto questo va in una cartella denominata stream. FiveM invia tutto in stream ai giocatori da solo, quindi non elenchi quei file nel manifest.

#La struttura della cartella

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

Molti pack vengono con un altro livello, come my_mlo-master/my_mlo/. Sposta la cartella che contiene fxmanifest.lua in resources, o il server non può trovare la risorsa.

#L'fxmanifest.lua

Se il pack viene fornito senza manifest, creane uno:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' dice a FiveM che la risorsa contiene dati mappa. Se il pack ha un file .ytyp, aggiungi la riga che lo registra:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Usa una riga data_file per ogni file .ytyp. Il percorso è il percorso reale nella cartella, quindi controlla il nome e il caso delle lettere.

Consiglio: se il pack è venuto con un manifest, mantienilo. L'autore l'ha scritto per questi file esatti, e spesso elenca diversi file .ytyp o opzioni extra che non vuoi indovinare.

#Aggiungilo a server.cfg

ensure my_mlo

Il nome dopo ensure deve essere il nome della cartella. Per iniziare un intero gruppo, metti le mappe in una cartella tra parentesi e usa ensure [maps]. Le mappe non dipendono dal tuo framework, ma avviale dopo le tue altre risorse di base in modo che un errore mappa non possa bloccare quelle importanti. Ulteriori informazioni su server.cfg resource order.

Riavvia il server, oppure digita ensure my_mlo nella console live di txAdmin. Un nuovo .ytyp è più affidabile con un riavvio completo.

#Requisito di build di gioco

Alcune mappe usano prop o modelli da un DLC GTA V più recente. Sul build di gioco predefinito, quei prop sono mancanti: vedi stanze vuote, una scatola bianca o nessun interno affatto. La pagina del pack di solito dice il build di cui ha bisogno. Impostalo in server.cfg e riavvia:

set sv_enforceGameBuild 3095

Il numero sopra è solo un esempio: usa quello che il pack chiede. L'elenco completo e gli effetti collaterali sono in sv_enforceGameBuild and DLC.

#Testalo nel gioco

1. Leggi la console txAdmin all'avvio. Errori come un file mancante in data_file si mostrano lì. Se la risorsa non si avvia, vedi couldn't start resource.
2. Unisciti al server. Vai alle coordinate nel readme del pack, con il menu di teleportazione di txAdmin o un comando di coordinate dal tuo script admin.
3. Cammina attraverso la porta. Un interno personalizzato spesso si carica solo quando sei vicino, quindi arriva a piedi e non da lontano ad alta velocità.
4. Controlla il pavimento e i muri. Se cadi o passi attraverso, i file .ybn sono mancanti o non si sono caricati. Vedi falling through the map.

#Problemi comuni

• L'interno non appare. La risorsa non è stata avviata, le coordinate sono sbagliate, o è necessario un build di gioco più recente. Controlla anche che i file siano dentro stream e non un livello più profondo in una sottocartella che la risorsa non usa.
• I prop sono mancanti, ma i muri sono lì. L'.ytyp non è registrato. Aggiungi la riga DLC_ITYP_REQUEST, con il nome file corretto.
• Parte della stanza sfarfalla o i muri sono spariti. Un'altra mappa copre la stessa area. Vedi map conflicts.
• Le texture hanno un aspetto strano o pesante. Le texture grandi costano memoria in streaming. Vedi oversized assets.
• Ha funzionato, poi si è rotto dopo un aggiornamento. Cancella la cache del client e riprova: clear the FiveM cache.

#Molte mappe su un server

Ogni mappa aggiunge file in streaming che ogni giocatore scarica e mantiene in memoria. Installa solo le mappe che usi, metti ognuna nella sua risorsa e denominala chiaramente. Quando qualcosa si rompe, puoi quindi fermare una risorsa alla volta e trovare la causa.

#Elenco di controllo