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, the game will throw an exception if you use an ID below 200 otherwise.
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, defaults to 2.0
.
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
.