Convertire Mappe e MLO SP in FiveM

INFO

Le mod mappa SP sono le più semplici da convertire: contengono già tutti i file necessari (YDR, YBN, YTD). Serve solo creare YTYP e YMAP.

ObiettivoDettagli
Cosa impareraiConvertire mappe e MLO da SP a FiveM, creare YTYP/YMAP, gestire portali
PrerequisitiConoscenza base di FiveM, CodeWalker, una mod mappa da convertire

Scenario Tipico

Scarichi una mod mappa da GTA5-Mods.com:

downtown_building/
├── prop_building.ydr
├── prop_building.ybn
├── prop_building.ytd
├── prop_building_glass.ydr
├── prop_building_glass.ybn
└── prop_building_glass.ytd

Alcune mod includono già .ytyp e .ymap, altre no.


Passo 1: Identificare il tipo

La mod include…Azione
Solo .ydr + .ybn + .ytdDevi creare .ytyp + .ymap
.ytyp + .ymap già presentiSpesso usabili direttamente
File .rpf con struttura GTA VEstrai e verifica se ci sono ytyp/ymap
File .xml + texturePotrebbe essere per Map Editor, va ricostruito

Passo 2: Se la mod NON ha YTYP/YMAP

WARNING

Senza YTYP e YMAP i modelli 3D non appariranno in gioco. CodeWalker è essenziale per crearli da zero.

Dovrai crearli con CodeWalker:

Creare YTYP

  1. Apri CodeWalker → Tools > YMAP Editor > New .ytyp
  2. Aggiungi un archetype per ogni oggetto:
Archetype:
├── Name: prop_building_01
├── Type: CBaseArchetypeDef
├── Lod Distance: 300
├── Texture Dictionary: prop_building
└── Drawable Dictionary: prop_building
  1. Salva come stream/prop_building.ytyp

Creare YMAP

  1. CodeWalker → Tools > YMAP Editor > New .ymap
  2. Aggiungi entities con le coordinate dove vuoi posizionare l’edificio:
Entities:
├── Archetype: prop_building_01
│   ├── Pos: X: -450.0, Y: 1100.0, Z: 30.0
│   └── Rot: 0, 0, 0
  1. Salva come stream/building_map.ymap

TIP

Per posizionare con precisione, usa CodeWalker per navigare alla zona desiderata e leggere le coordinate nell’angolo superiore. Puoi anche usare il comando /coords su FiveM.

Trovare le coordinate

  • Apri la mappa in CodeWalker e naviga alla zona desiderata
  • Leggi le coordinate nell’angolo in alto
  • Usa quelle coordinate nello YMAP

Passo 3: Se la mod HA già YTYP/YMAP

Spesso funzionano direttamente! Basta:

  1. Copia TUTTI i file in stream/
  2. Crea fxmanifest con DLC_ITYP_REQUEST
-- fxmanifest.lua
fx_version 'cerulean'
game 'gta5'
 
author 'TuoNome'
description 'Downtown Building - Convertita da SP'
version '1.0.0'
 
data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'
 
-- Opzionale: script per teletrasporto se è un MLO
client_script 'client.lua'

Passo 4: Convertire MLO (Interni)

QUESTION

L’MLO ha i file portal? Senza portal.ymap le stanze non saranno separate e l’interno sarà un unico spazio senza porte funzionanti.

Gli MLO (interni) sono più complessi. Oltre a ytyp/ymap hanno:

  • Portal file — definiscono stanze e porte
  • Entity sets — gruppi di oggetti per stato (porte aperte/chiuso)

Verifica se l’MLO è completo

Un MLO SP completo ha:

mlo_interior/
├── interior.ydr (.ybn, .ytd)    ← Geometria
├── interior.ytyp                 ← Archetype
├── interior.ymap                 ← Posizionamento
├── portal.ymap                   ← Portali (stanze) — critico!
└── entities.ymap                 ← Entity sets (opzionale)

Se mancano i portal

Senza portal.ymap, l’MLO sarà un unico grande spazio senza stanze separate. Dovrai creare i portal in CodeWalker:

  1. Tools > YMAP Editor > New .ymap (portal type)
  2. Definisci le stanze come regioni 3D
  3. Collega le stanze con porte

Nota: Creare portal da zero è complesso. Cerca mod MLO che siano già complete.


Passo 5: Mod Mappa con Map Editor

Alcune mod SP vengono distribuite come file .xml per Map Editor:

map_editor_export.xml

Convertire in risorsa FiveM

  1. Apri il file XML in un editor di testo
  2. Identifica i modelli referenziati (nomi degli oggetti)
  3. Estrai i file .ydr/.ybn/.ytd corrispondenti dal gioco (con OpenIV) o dalla mod
  4. Crea YTYP e YMAP per ogni oggetto

Alternativa: Usa Map Editor direttamente su FiveM per ricreare la mappa.


Problemi Comuni

ProblemaCausaSoluzione
Mappa non appareDLC_ITYP_REQUEST mancanteAggiungi data_file nel fxmanifest
Oggetti invisibiliYTYP con nome erratoControlla Texture/Drawable Dictionary
Collisione assenteYBN mancanteGenera .ybn dall’YDR con CodeWalker
Luci non funzionano di notteTime flagsUsa CTimeArchetypeDef invece di CBase
MLO senza stanzePortal mancanteCrea portal.ymap in CodeWalker
Texture mancantiYTD non in stream/Copia .ytd nella cartella
Doppioni con altri oggettiCoordinate errateApri CodeWalker e controlla la posizione

TIP


Torna alla: Indice Generale