07 - carcols.meta

3 min read

💡 carcols.meta

INFO

Il carcols.meta (e carcols_gen9.meta per next-gen) definisce luci, fanali, sirene e colori delle luci del veicolo.

ObiettivoDettagli
Cosa imparerai• Configurare luci anteriori, posteriori e di emergenza
• Impostare colori RGB per fari, freni e indicatori
• Gestire sirene e compatibilità next-gen (gen9)
Prerequisiti• vehicles.meta completato
• Conoscenza base XML

Struttura Base

<?xml version="1.0" encoding="UTF-8"?>
<CVehicleModelInfoVarGlobal>
    <LightSettings>
        <Item>
            <modelName>custom_sport</modelName>
            <graphics>
                <emissiveColor>
                    <value>0.00 0.00 0.00 1.00</value>  <!-- Luci spente -->
                    <value>0.95 0.78 0.15 1.00</value>  <!-- Luci accese (fendinebbia) -->
                    <value>1.00 1.00 1.00 1.00</value>  <!-- Luci full beam -->
                    <value>1.00 0.86 0.57 1.00</value>  <!-- Luci normali -->
                    <value>1.00 0.10 0.10 1.00</value>  <!-- Luci di emergenza (se polizia) -->
                    <value>0.38 0.61 1.00 1.00</value>  <!-- Luci lavoro -->
                    <value>0.00 0.00 0.00 1.00</value>  <!-- Riserva -->
                    <value>0.85 0.85 0.85 1.00</value>  <!-- Luci città -->
                    <value>0.35 0.35 0.35 1.00</value>  <!-- Luci notturne -->
                    <value>0.60 0.60 0.60 1.00</value>  <!-- Luci abbaglianti -->
                    <value>0.00 0.00 0.00 0.00</value>  <!-- Non usato -->
                </emissiveColor>
                <lightIntensity>1.0</lightIntensity>
                <lightVolumetricIntensity>1.0</lightVolumetricIntensity>
                <lightConeAngle>20.0</lightConeAngle>
                <lightConeAngleFullbeam>30.0</lightConeAngleFullbeam>
                <lightRange>40.0</lightRange>
                <lightRangeFullbeam>70.0</lightRangeFullbeam>
            </graphics>
        </Item>
    </LightSettings>
</CVehicleModelInfoVarGlobal>

Luci Anteriori

Colori Luci Anteriori

Colori in formato R G B A (0.0 — 1.0):

Tipo LuceColore (RGB)Esempio
Fendinebbia0.95 0.78 0.15Giallo
Anabbaglianti1.0 0.86 0.57Bianco caldo
Abbaglianti1.0 1.0 1.0Bianco puro
LED bianco0.85 0.90 1.0Bianco freddo
Xenon blu0.60 0.75 1.0Blu chiaro

Impostazioni Luci

ParametroDescrizioneValori Tipici
lightIntensityIntensità luminosa0.5 — 3.0
lightVolumetricIntensityIntensità volumetrica (fari visibili)0.5 — 3.0
lightConeAngleAngolo cono luci normali15.0 — 25.0
lightConeAngleFullbeamAngolo cono abbaglianti25.0 — 40.0
lightRangeDistanza illuminazione normale30.0 — 60.0
lightRangeFullbeamDistanza illuminazione abbaglianti60.0 — 100.0

TIP

I valori colore RGB nel carcols.meta usano un range 0.0-1.0, non 0-255. Per convertire, dividi il valore 0-255 per 255. Esempio: rosso 255 → 1.00, bianco caldo 220 → 0.86.

Luci Posteriori

<brakeLights>
    <emissiveColor>
        <value>0.00 0.00 0.00 1.00</value>  <!-- Spento -->
        <value>1.00 0.00 0.00 1.00</value>  <!-- Acceso (freno) -->
        <value>0.50 0.00 0.00 1.00</value>  <!-- Luci normali -->
    </emissiveColor>
</brakeLights>
 
<reverseLights>
    <emissiveColor>
        <value>0.00 0.00 0.00 0.00</value>  <!-- Spento -->
        <value>0.80 0.80 0.80 1.00</value>  <!-- Retromarcia -->
    </emissiveColor>
</reverseLights>
 
<indicatorLights>
    <emissiveColor>
        <value>0.00 0.00 0.00 0.00</value>  <!-- Spento -->
        <value>1.00 0.64 0.00 1.00</value>  <!-- Freccia arancione -->
    </emissiveColor>
</indicatorLights>

Luci di Emergenza (Polizia / Ambulanza / Vigili)

<emergencyLights>
    <!-- Luci principali sul tetto -->
    <emissiveColor>
        <value>0.00 0.00 0.00 0.00</value>  <!-- Spento -->
        <value>1.00 0.00 0.00 1.00</value>  <!-- Rosso -->
        <value>0.00 0.00 1.00 1.00</value>  <!-- Blu -->
        <value>1.00 1.00 1.00 1.00</value>  <!-- Bianco -->
    </emissiveColor>
</emergencyLights>

Colori Tipici per Servizio

ServizioColore PrimarioColore Secondario
PoliziaRosso (1,0,0)Blu (0,0,1)
AmbulanzaBianco (1,1,1)Rosso (1,0,0)
Vigili del fuocoRosso (1,0,0)Bianco (1,1,1)

WARNING

Per veicoli con lampeggianti avanzati (pattern ELS), il carcols.meta nativo non basta — serve una resource ELS separata. Il carcols.meta gestisce solo le luci di emergenza di base del motore originale Rockstar.

Sirene (Tipi 1-8)

<audio>
    <sirenType>3</sirenType>  <!-- Tipo sirena 1-8 -->
</audio>

Tipi di Sirena

TipoDescrizioneEsempio Utilizzo
1Sirena classica poliziaPolizia standard
2Sirena alternativa 1Polizia sportiva
3Sirena finto-allarmeFBI, agenti
4Sirena ambulanzaAmbulanza
5Sirena vigili del fuocoPompieri
6Sirena militareMilitari
7Sirena veicolo civicoServizi
8Clacson direzionaleTrain Horn

carcols_gen9.meta (Next-Gen)

Su FiveM con grafica enhanced (gen9), si usa carcols_gen9.meta per luci migliorate:

<?xml version="1.0" encoding="UTF-8"?>
<CVehicleModelInfoVarGlobal>
    <LightSettings>
        <Item>
            <modelName>custom_sport</modelName>
            <graphics>
                <emissiveColor>
                    <value>0.00 0.00 0.00 1.00</value>
                    <value>0.95 0.78 0.15 1.00</value>
                    <value>1.00 1.00 1.00 1.00</value>
                </emissiveColor>
                <lightIntensity>1.5</lightIntensity>
                <lightVolumetricIntensity>1.0</lightVolumetricIntensity>
                <!-- Gen9 supporta HDR e colori più vividi -->
                <lightHDR>true</lightHDR>
                <lightUseAudible>true</lightUseAudible>
            </graphics>
        </Item>
    </LightSettings>
</CVehicleModelInfoVarGlobal>

Se il server supporta la grafica next-gen, includi entrambi i file:

stream/custom_sport.carcols.meta        ← Standard
stream/custom_sport.carcols_gen9.meta   ← Next-gen enhanced

INFO

Il file carcols_gen9.meta è richiesto solo se il server FiveM utilizza la grafica enhanced (gen9). Se incluso, deve essere dichiarato anche nel fxmanifest.lua con data_file 'CARCOLS_GEN9_FILE'.

TIP

Prossimo passo: 08 - fxmanifest per Veicoli

Torna alla: Indice Generale