02 - Convertire Veicoli

Convertire Veicoli SP in FiveM

INFO

I veicoli sono le mod SP più comuni e anche le più facili da convertire. Segui questa procedura passo-passo.

Obiettivo	Dettagli
Cosa imparerai	Convertire veicoli da mod SP a risorsa FiveM funzionante
Prerequisiti	Conoscenza base di FiveM, OpenIV installato, una mod veicolo da convertire

---

Scenario Tipico

Scarichi una mod veicolo da GTA5-Mods.com, trovi questi file:

police_charger_2020/
├── police_charger_2020.yft
├── police_charger_2020.ytd
├── police_charger_2020.ybn
├── handling.meta
├── vehicles.meta
├── carvariations.meta
├── carcols.meta
└── mod.xml (o .oiv)

---

Passo 1: Estrarre i file

Da .oiv

1. Rinomina mod_name.oiv → mod_name.zip
2. Estrai il contenuto
3. Trova i file dentro la struttura update/x64/dlcpacks/nome_mod/

Da .rpf

1. Apri con OpenIV
2. Naviga dentro le cartelle
3. Estrai TUTTI i file in una cartella temporanea

---

Passo 2: Identificare i file necessari

Per un veicolo servono:

File	Da SP?	Azione
.yft	✅ Intatto	Metti in stream/
.ytd	✅ Intatto	Metti in stream/
.ybn	✅ Intatto	Metti in stream/
handling.meta	⚠️ Forse	Spesso usabile direttamente
vehicles.meta	❌ Da creare	Le mod SP di solito hanno un vehicles.meta che referenzia un DLC, va adattato
carvariations.meta	⚠️ Forse	Spesso usabile con piccole modifiche
carcols.meta	⚠️ Forse	Spesso usabile direttamente

---

Passo 3: Creare i Meta File

vehicles.meta

Le mod SP di solito hanno un vehicles.meta che usa <dlcName>. Per FiveM devi rimuovere dlcName e cambiarlo in una risorsa standalone.

WARNING

Il tag <dlcName> presente nelle mod SP va assolutamente rimosso per FiveM. Se lasciato, il veicolo risulterà invisibile.

Mod SP (originale):

<InitDatas>
    <Item>
        <modelName>charger20</modelName>
        <dlcName>dlc_police_charger</dlcName>  ← DA RIMUOVERE
        <gameName>CHARGER20</gameName>
        ...
    </Item>
</InitDatas>

Convertito per FiveM:

<InitDatas>
    <Item>
        <modelName>charger20</modelName>
        <!-- dlcName RIMOSSO — FiveM carica da stream/ -->
        <gameName>CHARGER20</gameName>
        ...
    </Item>
</InitDatas>

handling.meta

Spesso usabile così com’è. Basta copiarlo in stream/.

INFO

L’handling.meta delle mod SP è quasi sempre compatibile con FiveM senza modifiche. Se il veicolo non si muove, verifica di aver aggiunto data_file 'HANDLING_FILE' nel fxmanifest.

carvariations.meta

Controlla che modelName matchi esattamente con quello in vehicles.meta. A volte il nome è diverso — allineali.

TIP

Scegli un nome modello e usalo identico in vehicles.meta, carvariations.meta, handling.meta e carcols.meta. Anche un underscore di differenza causa il fallimento.

carcols.meta

Usabile direttamente. Assicurati solo che modelName sia corretto.

---

Passo 4: Creare fxmanifest.lua

-- fxmanifest.lua
fx_version 'cerulean'
game 'gta5'
 
author 'TuoNome'
description 'Police Charger 2020 - Convertito da SP'
version '1.0.0'
 
files {
    'stream/*.meta'
}
 
data_file 'VEHICLE_METADATA_FILE' 'stream/*.vehicles.meta'
data_file 'HANDLING_FILE' 'stream/*.handling.meta'
data_file 'CARCOLS_FILE' 'stream/*.carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'stream/*.carvariations.meta'
 
client_script 'client.lua'

---

Passo 5: Script Lua per spawn

-- client.lua
local vehicleHash = GetHashKey('charger20')
 
RegisterCommand('spawncharger', function()
    RequestModel(vehicleHash)
    local attempts = 0
    while not HasModelLoaded(vehicleHash) and attempts < 50 do
        Citizen.Wait(100)
        attempts = attempts + 1
    end
    
    if HasModelLoaded(vehicleHash) then
        local playerPed = PlayerPedId()
        local coords = GetEntityCoords(playerPed)
        local heading = GetEntityHeading(playerPed)
        
        local vehicle = CreateVehicle(vehicleHash, coords.x + 5, coords.y + 5, coords.z, heading, true, false)
        SetPedIntoVehicle(playerPed, vehicle, -1)
        SetModelAsNoLongerNeeded(vehicleHash)
        print('^2[VEHICLE] Veicolo spawnato!')
    else
        print('^1[VEHICLE] ERRORE: Modello non caricato')
    end
end, false)

---

Passo 6: Test

1. Metti la cartella in resources/
2. Aggiungi ensure nome_risorsa in server.cfg
3. Riavvia il server
4. In gioco: /spawncharger

---

Problemi Comuni

Problema	Causa	Soluzione
Veicolo invisibile	modelName errato o dlcName non rimosso	Controlla vehicles.meta, rimuovi <dlcName>
Texture rosa/checker	txdName non matcha il nome .ytd	Allinea txdName nel vehicles.meta
Veicolo non si muove	handling.meta non caricato	Aggiungi data_file 'HANDLING_FILE'
Crash su spawn	YFT danneggiato o ossa mancanti	Prova ad aprire il .yft in CodeWalker
Luci non funzionano	carcols.meta mancante o modelName errato	Controlla modelName in carcols.meta
Ruote staccate	Skeleton del veicolo non standard	Alcuni veicoli SP hanno skeleton custom
Colori sbagliati	carvariations.meta non caricato	Aggiungi data_file 'VEHICLE_VARIATION_FILE'

---

TIP

Prossimo passo: 03 - Convertire Armi

---

Torna alla: Indice Generale