Skip to content

Vehicle Data

Vehicles in Unturned consist of the 6 different engine types, Car, Plane, Helicopter, Blimp, Boat, and Train. Many properties of the different engine types are shared between them, however, some are specific to each engine type, and are categorized as such below.

Vehicle Agnostic properties


ID: The item ID is used to spawn the item into the game, and is represented as an unsigned 16 bit integer (a range of 0–65535). It is recommended not to use a value less than 2,000 as those are reserved for official content. It is also recommended to avoid any ID range being used by curated content, as those are often used by modded servers and custom Workshop maps. Vehicles ID ranges do not conflict with those of Items or Objects.

Bypass_ID_Limit: Allows you to use an ID that is within the space reserved for vanilla content.

Size2_Z: Controls orthogonal camera size for vehicle skin icons. Basically irrelevant since very few vehicles have skins. Defaults to 0.0

Shared_Skin_Name:

Shared_Skin_Lookup_ID ID of base vehicle that is being skinned. i.e. the vehicle's ID. Defaults to ID.

Engine: Car, Plane, Helicopter, Blimp, Boat, Train. Defaults to Car.

Rarity: Common, Uncommon, Rare, Epic, Legendary, Mythical. Defaults to Common.

Battery Properties

Cannot_Spawn_With_Battery: If present the vehicle will not spawn with a battery present.

Battery_Spawn_Charge_Multiplier: Defaults to 1 unless Battery_Spawn_Charge_Multiplier is present, in which case the default value is 0.

Battery_Burn_Rate: Defaults to 20 unless Battery_Burn_Rate is present, in which case the default value is 0.0.

Battery_Charge_Rate: Defaults to 20 unless Battery_Charge_Rate is present, in which case the default value is 0.0.

BatteryMode_Driving: Charge, Burn, None.

BatteryMode_Empty: Charge, Burn, None.

BatteryMode_Headlights: Charge, Burn, None.

BatteryMode_Sirens: Charge, Burn, None.

Driving Properties

Speed_Min: Maximum reverse speed in Meters per Second.

Speed_Max: Maximum forward speed in Meters per Second. If the Engine is not Train, the speed is multiplied by 1.25

Steer_Min: Steering angle at the lowest possible speed.

Steer_Max: Steering angle at the highest possible speed.

Brake: Determines the amount of braking force applied to the vehicle.

Override_Center_Of_Mass: Defaults to false.

Center_Of_Mass: This

Center_Of_Mass_x
Center_Of_Mass_y
Center_Of_Mass_z

Wheel_Collider_Mass_Override: Overrides the setting of your wheel colliders mass to provided value. Should default to 3.

Physics_Profile: Physics Profile GUID. Documentation can be found here

Traction: Changes the wheels physics on ice and off-road.

Sleds: Makes the wheels slide easier. For use on planes where this effect is desired.

Fuel

Fuel_Min: Minimum fuel that the vehicle can spawn with.

Fuel_Max: Maximum fuel that the vehicle can spawn with.

Fuel: Maximum amount of fuel the vehicle can hold.

Fuel_Burn_Rate: The rate fuel burns at. Set to 2.05 for Car, 4.2 for others by default.

Health

Health: Health of the vehicle. Vehicle spawns with this health by default.

Health_Min: Minimum health that the vehicle can spawn with.

Health_Max: Maximum health that the vehicle can spawn with.

Explosion

Explosion: ID of the explosion effect to use when destroyed.

Explosion_Min_Force_Y: Defaults to (00, 1024, 0.0). To set this property, include any of the below with a value.

Explosion_Min_Force_Y_x
Explosion_Min_Force_Y_y
Explosion_Min_Force_Y_z

Explosion_Max_Force_Y: Defaults to (00, 1024, 0.0). To set this property, include any of the below with a value. Any unspecified values are set to defaults

Explosion_Max_Force_Y_x
Explosion_Max_Force_Y_y
Explosion_Max_Force_Y_z

Turret Properties

Turrets: x Specifies the number of turrets on the vehicle.

Turret_x_Seat_Index_y: Specifies which Seat_y the turret will use. x stands for the index of the turret (goes from 0,1,2...)

Turret_x_Item_ID: Specifies the ID of the turret weapon (IT IS ADVISED that the turret gun has Turret in it's .dat)

Turret_x_Yaw_Min: Yaw determines turret rotation. _Min decides for the left side (Keep number lower than -180 if you want a forever spinny boi)

Turret_x_Yaw_Max: Determines turret rotation to the right side. (Keep number higher than 180 if you want a forever spinny boi) -360 and 360 make forever spinny boi

Turret_x_Pitch_Min: Specifies how high the Pitch of the turret can go. ↑ (This is called elevation)

Turret_x_Pitch_Max: Specifies how low the Pitch of the turret can go. ↓ (This is called depression)

Turret_x_Ignore_Aim_Camera: Use this if you want the turret control view to be from the seated player's perspective.

Turret_x_Aim_Offset: Offsets the Aim on the Y axis.

Damage Properties

Invulnerable: Makes vehicle immune to all weapons (but not explosives) without the Invulnerable property.

Explosions_Invulnerable: Makes the vehicle immune to explosions.

Environment_Invulnerable: Makes the vehicle immune to zombies, animals, and thrown mega zombie boulders.

Bumper_Invulnerable: Makes vehicle invulnerable to collisions to damages caused by collisions with other objects.

Tires_Invulnerable: Makes tires Invulnerable.

Child_Explosion_Armor_Multiplier: Multiplies explosion damage dealt to people in the vehicle by provided number.

Bicycle Properties

Bicycle_Anim_Speed: The speed at which the bicycle pedals spin.

Stamina_Boost: If present the vehicle will receive a boost when shift is pressed.

Stamina_Powered: If present the vehicle will use stamina for power.

Misc.

Pitch_Idle: Changes the pitch of the engine audio at idle. If your audio clip is named Engine_Large or Engine_Medium this is preset to .75 and .625

Pitch_Drive: Changes the pitch of the engine audio while driving. If your audio clip is named Engine_Large or Engine_Medium this is preset to .075 and .025

Exit: Exit distance from vehicle.

Cam_Follow_Distance: Camera distance from player while in vehicle. Defaults to 5.5 unless Cam_Follow_Distance is present, in which case the default value is 0.0.

Cam_Driver_Offset: Offsets the position of the drivers first person camera by set amount.

Cam_Passenger_Offset: Offsets the position of the passengers first person camera by set amount.

Bumper_Multiplier: Multiplies bumper damage

Passenger_Explosion_Armor: Defaults to 0.0

Can_Be_Locked: If present it will not be possible to lock the vehicle.

Trunk_Storage_X: Width of trunk storage.

Trunk_Storage_Y: Height of trunk storage.

Drops_Table_ID: Defaults to 518.

Drops_Min: Defaults to 3.

Drops_Max: Defaults to 7.

Tire_ID: ID of the item used to attach a tire. Defaults to 1451.

Num_Steering_Tires: Steers tires 1 through n; with n being the number of tire models. If crawler is present the value defaults to 0. If Engine is car, this defaults to 2, otherwise, the default is 1.

Zip: Handlebar related property.

Bicycle: Tells unturned to use bicycle animations.

Reclined: Uses the slightly different drivers reclined animation.

Crawler: Locks wheel turning.

LockMouse: Locks the mouse to the forward position so the driver cannot move their view.

Bypass_Hash_Verification: Bypasses hash-based file verification.

Bypass_Buildable_Mobility: Allows you to place sentry guns and beds on a vehicle.

Supports_Mobile_Buildables:

Can_Repair_While_Seated: false, true Allows passengers of the vehicle to repair it. Defaults to false.

Plane


Air_Turn_Responsiveness: Defaults to 2.

Air_Steer_Min:

Air_Steer_Max:

Lift: Upwards force applied to the vehicle

Boat


Train


Train_Track_Offset: Defaults to 0.0.

Train_Wheel_Offset: Defaults to 0.0.

Train_Car_Length: Defaults to 0.0.


Last update: August 11, 2020