05 - carvariations.meta

3 min read

🎨 carvariations.meta

INFO

Questo file definisce colori, ruote e modifiche di default per ogni variante del veicolo. Permette di creare combinazioni predefinite che appaiono nello spawn.

ObiettivoDettagli
Cosa imparerai• Configurare colori, ruote e modifiche di default
• Usare gli indici colore (0-159) e le palette GTA V
• Creare varianti di spawn multiple per il veicolo
Prerequisiti• vehicles.meta completato
• Conoscenza base XML

Struttura Base

<?xml version="1.0" encoding="UTF-8"?>
<CVehicleModelInfoVariationData>
    <InitDatas>
        <Item>
            <modelName>custom_sport</modelName>
            
            <colors>
                <Item>
                    <indices>
                        <PrimaryColorIndex>0</PrimaryColorIndex>
                        <SecondaryColorIndex>0</SecondaryColorIndex>
                        <PearlescentColorIndex>0</PearlescentColorIndex>
                        <WheelColorIndex>0</WheelColorIndex>
                    </indices>
                </Item>
                <Item>
                    <indices>
                        <PrimaryColorIndex>12</PrimaryColorIndex>
                        <SecondaryColorIndex>0</SecondaryColorIndex>
                        <PearlescentColorIndex>111</PearlescentColorIndex>
                        <WheelColorIndex>156</WheelColorIndex>
                    </indices>
                </Item>
            </colors>
            
            <kits>
                <Item>
                    <kitInfo>
                        <WheelType>0</WheelType>
                        <WheelTypeFront>0</WheelTypeFront>
                        <WheelTypeRear>0</WheelTypeRear>
                    </kitInfo>
                </Item>
            </kits>
        </Item>
    </InitDatas>
</CVehicleModelInfoVariationData>

Colori

Indici Colore (0-159)

Ogni colore ha un indice numerico che punta alla palette di GTA V:

IndiceColore
0Nero
1Grigio
2Grigio chiaro
3Bianco
4Rosso
5Blu scuro
6Blu
7Giallo
8Verde
9Verde scuro
10Arancione
11Marrone
12Rosso brillante
……
88Rosa
135Oro
156Argento

Struttura Colori

<colors>
    <!-- Variante 1: Rossa con cerchi neri -->
    <Item>
        <indices>
            <PrimaryColorIndex>12</PrimaryColorIndex>
            <SecondaryColorIndex>0</SecondaryColorIndex>
            <PearlescentColorIndex>111</PearlescentColorIndex>
            <WheelColorIndex>0</WheelColorIndex>
        </indices>
    </Item>
    
    <!-- Variante 2: Blu con cerchi argento -->
    <Item>
        <indices>
            <PrimaryColorIndex>6</PrimaryColorIndex>
            <SecondaryColorIndex>3</SecondaryColorIndex>
            <PearlescentColorIndex>156</PearlescentColorIndex>
            <WheelColorIndex>156</WheelColorIndex>
        </indices>
    </Item>
</colors>
Parametro ColoreDescrizione
PrimaryColorIndexColore principale carrozzeria
SecondaryColorIndexColore secondario (strisce, tetto, minigonne)
PearlescentColorIndexEffetto perlato/iridescente sopra il colore base
WheelColorIndexColore dei cerchi

INFO

Gli indici colore 0-159 corrispondono alla palette globale di GTA V. Puoi trovare la lista completa cercando “vehicle colors” su FiveM docs o nel file carcols.meta originale di Rockstar.

Ruote

<kits>
    <Item>
        <kitInfo>
            <WheelType>0</WheelType>        <!-- Categoria ruota -->
            <WheelTypeFront>0</WheelTypeFront>
            <WheelTypeRear>0</WheelTypeRear>
        </kitInfo>
    </Item>
</kits>

Wheel Types

TipoCategoria
0Sport
1Muscle
2Lowrider
3SUV
4Offroad
5Tuner
6Bike
7High End

WheelType (cerchi specifici)

IDRuota
0Default sport
5Cerchio a 5 razze
12Cerchio a stella
25Cerchio tuning
40Cerchio offroad
55Cerchio high-end

Default Mods e Upgrades

Per specificare modifiche applicate di default:

<defaultMods>
    <Item>0:0</Item>    <!-- Spoiler type 0 -->
    <Item>5:25</Item>   <!-- Cerchi type 25 -->
    <Item>6:2</Item>    <!-- Sospensioni - bassa -->
    <Item>12:3</Item>   <!-- Motore upgrade level 3 -->
    <Item>13:2</Item>   <!-- Freni sportivi -->
    <Item>14:2</Item>   <!-- Cambio sportivo -->
</defaultMods>

Formato: <ID_MOD>:<INDICE> dove ID_MOD corrisponde ai mod type del vehicles.meta.

WARNING

Gli ID_MOD nei defaultMods devono corrispondere esattamente ai modType dichiarati nel vehicles.meta. Se dichiari un defaultMod per un modType che non hai incluso nel vehicles.meta, il gioco ignorerà silenziosamente il valore.

Varianti di Spawn

Puoi definire fino a 10 varianti di spawn con diverse combinazioni di colore, ruote e modifiche:

<Item>
    <modelName>custom_sport</modelName>
    
    <!-- 6 varianti colore -->
    <colors>
        <Item><indices><PrimaryColorIndex>12</PrimaryColorIndex>...</indices></Item>
        <Item><indices><PrimaryColorIndex>6</PrimaryColorIndex>...</indices></Item>
        <Item><indices><PrimaryColorIndex>0</PrimaryColorIndex>...</indices></Item>
        <Item><indices><PrimaryColorIndex>3</PrimaryColorIndex>...</indices></Item>
        <Item><indices><PrimaryColorIndex>88</PrimaryColorIndex>...</indices></Item>
        <Item><indices><PrimaryColorIndex>135</PrimaryColorIndex>...</indices></Item>
    </colors>
    
    <!-- 2 tipi ruota -->
    <kits>
        <Item><kitInfo><WheelType>0</WheelType>...</kitInfo></Item>
        <Item><kitInfo><WheelType>7</WheelType>...</kitInfo></Item>
    </kits>
</Item>

Ogni veicolo spawnato in strada sceglierà casualmente una combinazione tra quelle definite.

TIP

Più varianti di spawn definisci, più varietà vedrai nel traffico cittadino. Crea almeno 4-6 combinazioni colore e 2-3 tipi di ruote per un risultato realistico.

TIP

Prossimo passo: 06 - handling.meta

Torna alla: Indice Generale