vehicles.meta

The vehicles.meta file in GTA V is an XML-format file which, as with previous versions of the game, defines vehicles and some of their properties. This file is found in ..\common\data\levels\gta5 and can be edited with any text editor.

Parameters

modelName

Name of the model file without extension.

txdName

Name of the texture dictionary without extension.

handlingId

The name used in handling.meta.

gameName

Name corresponding to its GXT2 entry.

vehicleMakeName

The vehicle maker's name corresponding to its GXT2 entry.

animConvRoofDictName

The animation dictionary name used to animate the vehicle's convertible roof.

animConvRoofName

The model node used by the convertible roof animation (typically "roof").

animConvRoofWindowsAffected

The windows (if any) affected by the movement of the convertible roof, for example the side windows which retract during the animation.

audioNameHash

The model name of the vehicle whose sounds are inherited by the vehicle.

coverBoundOffsets

Defined in vehiclelayouts.meta

First Person IK Offsets

Inverse kinematics offsets when in first person view.

• FirstPersonDriveByIKOffset
• FirstPersonDriveByUnarmedIKOffset
• FirstPersonProjectileDriveByIKOffset
• FirstPersonProjectileDriveByPassengerIKOffset
• FirstPersonProjectileDriveByRearLeftIKOffset
• FirstPersonProjectileDriveByRearRightIKOffset
• FirstPersonDriveByLeftPassengerIKOffset
• FirstPersonDriveByRightPassengerIKOffset
• FirstPersonDriveByRightRearPassengerIKOffset
• FirstPersonDriveByLeftPassengerUnarmedIKOffset
• FirstPersonDriveByRightPassengerUnarmedIKOffset
• FirstPersonMobilePhoneOffset
• FirstPersonPassengerMobilePhoneOffset

PovCameraOffset

The X, Y, and Z offsets used to align the first-person camera to the driver of the vehicle.

PovCameraVerticalAdjustmentForRollCage

The extra offset to be used for PovCameraOffset when a rollcage is installed in the vehicle.

PovPassengerCameraOffset

The X, Y, and Z offsets used to align the first-person camera to the front passenger(s) of the vehicle.

PovRearPassengerCameraOffset

The X, Y, and Z offsets used to align the first-person camera to the rear passenger(s) of the vehicle.

AllowJoyriding

Disallows AI drivers of this vehicle to drive recklessly. Used for professional vehicles such as Ambulance, Bus, Boxville, etc.

wheelScale

Defines how big the vehicle's front wheels rim are to get correctly looking "blow up tires" effect.

wheelScaleRear

Defines how big the vehicle's rear wheels rim are to get correctly looking "blow up tires" effect.

dirtLevelMin

The minimum allowed dirtiness of the vehicle.

dirtLevelMax

The maximum allowed dirtiness of the vehicle.

diffuseTint

Changes the window tint color, no matter what color the window texture have. It does not appear on vehicle_glass_inner shader. Use https://www.webfx.com/web-design/color-picker/ To get your color in HEX. Ignore the first 4 digits. Paste the hex code from the site after 0x00...

HDTextureDist

The distance at which the vehicle's higher-resolution textures (contained in modelName+hi.ytd) should be loaded.

lodDistances

Distances LOD models will switch. 6 levels.

swankness

How cool the vehicle is, for AI response. 0 to 5.

flags

Available flags:

• ALLOW_OBJECT_LOW_LOD_COLLISION
• FLAG_ALLOW_HATS_NO_ROOF
• FLAG_ALLOWS_RAPPEL
• FLAG_ATTACH_TRAILER_IN_CITY
• FLAG_ATTACH_TRAILER_ON_HIGHWAY
• FLAG_AVERAGE_CAR
• FLAG_AVOID_TURNS
• FLAG_BIG
• FLAG_BIKE_CLAMP_PICKUP_LEAN_RATE
• FLAG_BLOCK_FROM_ATTRACTOR_SCENARIO
• FLAG_BOOT_IN_FRONT
• FLAG_CAN_BE_DRIVEN_ON
• FLAG_CAN_HAVE_NEONS
• FLAG_CAN_HONK_WHEN_FLEEING
• FLAG_CANNOT_BE_DRIVEN_BY_PLAYER
• FLAG_CANNOT_BE_MODDED
• FLAG_CANNOT_BE_PICKUP_BY_CARGOBOB
• FLAG_CANNOT_TAKE_COVER_WHEN_STOOD_ON
• FLAG_CONSIDERED_FOR_VEHICLE_ENTRY_WHEN_STOOD_ON
• FLAG_COUNT_AS_FACEBOOK_DRIVEN
• FLAG_DAMPEN_STICKBOMB_DAMAGE
• FLAG_DELIVERY
• FLAG_DISABLE_AUTO_VAULT_ON_VEHICLE
• FLAG_DISABLE_BUSTING
• FLAG_DISABLE_THROUGH_WINDSCREEN
• FLAG_DISABLE_WEAPON_WHEEL_IN_FIRST_PERSON
• FLAG_DONT_CLOSE_DOOR_UPON_EXIT
• FLAG_DONT_ROTATE_TAIL_ROTOR
• FLAG_DONT_SPAWN_AS_AMBIENT
• FLAG_DONT_SPAWN_IN_CARGEN
• FLAG_DONT_STOP_WHEN_GOING_TO_CLIMB_UP_POINT
• FLAG_DONT_TIMESLICE_WHEELS
• FLAG_DRIVER_NO_DRIVE_BY
• FLAG_DRIVER_SHOULD_BE_MALE
• FLAG_EMERGENCY_SERVICE
• FLAG_EXPLODE_ON_CONTACT
• FLAG_EXTRAS_ALL
• FLAG_EXTRAS_CONVERTIBLE
• FLAG_EXTRAS_GANG
• FLAG_EXTRAS_ONLY_BREAK_WHEN_DESTROYED
• FLAG_EXTRAS_RARE
• FLAG_EXTRAS_REQUIRE
• FLAG_EXTRAS_SCRIPT
• FLAG_EXTRAS_STRONG
• FLAG_EXTRAS_TAXI
• FLAG_FAKE_EXTRALIGHTS
• FLAG_FLEE_FROM_COMBAT
• FLAG_FORCE_ENABLE_CHASSIS_COLLISION
• FLAG_GEN_NAVMESH
• FLAG_GIVE_SCUBA_GEAR_ON_EXIT
• FLAG_HAS_BULLETPROOF_GLASS
• FLAG_HAS_DIRECTIONAL_SHUFFLES
• FLAG_HAS_INTERIOR_EXTRAS
• FLAG_HAS_LIVERY
• FLAG_HAS_NO_ROOF
• FLAG_HAS_REAR_MOUNTED_TURRET
• FLAG_HAS_TURRET_SEAT_ON_VEHICLE
• FLAG_HEADLIGHTS_ON_LANDINGGEAR
• FLAG_HEADLIGHTS_USE_ACTUAL_BONE_POS
• FLAG_HELI_USES_FIXUPS_ON_OPEN_DOOR
• FLAG_IGNORE_ON_SIDE_CHECK
• FLAG_IGNORE_RWINDOW_COLLISION
• FLAG_INCREASE_PED_COMMENTS
• FLAG_INTERIOR_BLOCKED_BY_BOOT
• FLAG_IS_BULKY
• FLAG_IS_BUS
• FLAG_IS_ELECTRIC
• FLAG_IS_JETSKI
• FLAG_IS_OFFROAD_VEHICLE
• FLAG_IS_TANK
• FLAG_IS_VAN
• FLAG_LAW_ENFORCEMENT
• FLAG_NO_BOOT
• FLAG_NO_BROKEN_DOWN_SCENARIO
• FLAG_NO_RESPRAY
• FLAG_PARKING_SENSORS
• FLAG_PEDS_CAN_STAND_ON_TOP
• FLAG_PEDS_INSIDE_CAN_BE_SET_ON_FIRE_MP
• FLAG_PLANE_WEAR_ALTERNATIVE_HELMET
• FLAG_POOR_CAR
• FLAG_PREFER_ENTER_TURRET_AFTER_DRIVER
• FLAG_RECESSED_HEADLIGHT_CORONAS
• FLAG_RECESSED_TAILLIGHT_CORONAS
• FLAG_REPORT_CRIME_IF_STANDING_ON
• FLAG_RICH_CAR
• FLAG_SMALL_WORKER
• FLAG_SPAWN_BOAT_ON_TRAILER
• FLAG_SPAWN_ON_TRAILER
• FLAG_SPORTS
• FLAG_SPRAY_PETROL_BEFORE_EXPLOSION
• FLAG_TALL_SHIP
• FLAG_TWO_DOORS_ONE_SEAT
• FLAG_USE_COVERBOUND_INFO_FOR_COVERGEN
• FLAG_USE_FAT_INTERIOR_LIGHT
• FLAG_USE_FIVE_ANIM_THROW_FP
• FLAG_USE_FULL_ANIMS_FOR_MP_WARP_ENTRY_POINTS
• FLAG_USE_HIGHER_DOOR_TORQUE
• FLAG_USE_LIGHTING_INTERIOR_OVERRIDE
• FLAG_USE_PILOT_HELMET
• FLAG_USE_RESTRICTED_DRIVEBY_HEIGHT
• FLAG_USE_SMALLER_OPEN_DOOR_RATIO_TOLERANCE
• FLAG_USE_STEERING_PARAM_FOR_LEAN
• FLAG_USE_STRICTER_EXIT_COLLISION_TESTS
• FLAG_USE_TURRET_RELATIVE_AIM_CALCULATION
• FLAG_USE_WEAPON_WHEEL_WITHOUT_HELMET

type

Vehicle type.

• VEHICLE_TYPE_BICYCLE
• VEHICLE_TYPE_BIKE
• VEHICLE_TYPE_BLIMP
• VEHICLE_TYPE_BOAT
• VEHICLE_TYPE_CAR
• VEHICLE_TYPE_HELI
• VEHICLE_TYPE_PLANE
• VEHICLE_TYPE_SUBMARINE
• VEHICLE_TYPE_TRAILER
• VEHICLE_TYPE_TRAIN
• VEHICLE_TYPE_QUADBIKE

plateType

If/where a vehicle has license plates.

• VPT_BACK_PLATES
• VPT_FRONT_PLATES
• VPT_FRONT_AND_BACK_PLATES
• VPT_NONE

dashboardType

The layout of the vehicle's dashboard gauges/lights.

Land Vehicles

• VDT_BANSHEE
• VDT_BOBCAT
• VDT_CAVALCADE
• VDT_DUKES
• VDT_FELTZER
• VDT_FEROCI
• VDT_FUTO
• VDT_GENTAXI
• VDT_PEYOTE
• VDT_RACE
• VDT_SPEEDO
• VDT_SPORTBK
• VDT_SULTAN
• VDT_SUPERGT
• VDT_TAILGATER
• VDT_TRUCK
• VDT_TRUCKDIGI
• VDT_ZTYPE

Air Vehicles

• VDT_LAZER
• VDT_MAVERICK

vehicleClass

The class of the vehicle. Used for display text and race categories.

Land Vehicles

• VC_COMMERCIAL
• VC_COMPACT
• VC_COUPE
• VC_CYCLE
• VC_EMERGENCY
• VC_INDUSTRIAL
• VC_MILITARY
• VC_MOTORCYCLE
• VC_MUSCLE
• VC_OFF_ROAD
• VC_RAIL
• VC_SEDAN
• VC_SERVICE
• VC_SPORT
• VC_SPORT_CLASSIC
• VC_SUPER
• VC_SUV
• VC_UTILITY
• VC_VAN

Air Vehicles

• VC_HELICOPTER
• VC_PLANE

Water Vehicles

• VC_BOAT

wheelType

The class of wheel it uses by default.

• VWT_BIKE
• VWT_HIEND
• VWT_LOWRIDER
• VWT_MUSCLE
• VWT_OFFROAD
• VWT_SPORT
• VWT_SUV
• VWT_TUNER

trailers

What trailers it can spawn towing. Use the trailer's model name.

drivers

Specific peds that will spawn driving the vehicle. Use the ped's model name.

doorsWithCollisionWhenClosed

Which parts of the vehicle must remain collidable when closed. Typically used on large parts or parts which stick out such the tailgate on a pickup truck of the large hood of a semi truck. If left undefined the part itself will not be collidable when closed, and will instead fall back onto the collision of the main vehicle body.

requiredExtras

Determines which extras on the vehicle must always spawn. Used with the flag FLAG_EXTRAS_REQUIRE.

rewards

Reward you get for entering the vehicle, as defined by pickups.meta.

cinematicPartCamera

Used for cinematic camera views that are attached to the vehicle, such as the wheel camera on a car or the wing-tip camera on a plane.

pOverrideRagdollThreshold

Bulldozer and Rhino set this to "CVehicleModelInfo__CVehicleOverrideRagdollThreshold".