Vehicle System

[Los Santos Roleplay]

Script name: Vehicle System

Script author: &

 

 

 

---

 

---

Introduction

The vehicle system is diverse. Its best known feature is a private vehicle system which allows each player to own vehicles and spawn them, these vehicles do not appear upon login. Only the owner is able to spawn them. There are also public and faction vehicles.

 

* Each owner can spawn up to three(3) vehicle's depending on donator status.
* Only owners and those who have keys to the vehicle can despawn the vehicle.
* Each player can own up to ten(10) vehicles.
* Each faction can have up to 130 for their faction. Maximum vehicles for factions can be modified by lead admins.

 

There are 4 vehicle types now on the server: Public, Private, Faction and Company

• Public vehicles are rentable vehicles (such as Greenwoods and Bobcats around the airport).
• Private vehicles are vehicles owned by a single player, therefore only they may spawn it, park it, upgrade it and perform other commands available for private vehicles.
• Faction vehicles are vehicles owned by a specific faction. For example the LSPD own all LSPD cruisers and vehicles (including unmarked patrol cars and undercover vehicles). On the other side of the law we have vehicles used by illegal factions (vans such as Burrito a common example).
• Company vehicles are vehicles owned by a specific scripted company. A company can request for vehicles to be added to their fleet. They'll be managed and used by the company members.

 

---

Commands

This sections covers all of the available commands that are for vehicle usage,this section does not include the Grand Theft Auto system which is used to steal vehicles. Each command is accompanied by a picture to depict it in use.

 

• (/v)ehicle

This is the vehicle command,it is used together with a parameter.
When doing this command without any parameter given it will display all available actions like so:

 

 

• (/v)ehicle list

By using the parameter "list", this will display all vehicles available on your account. If you do not own any vehicles, it will notify you with a simple chat message. You're able to cycle through the menu to see all your vehicles (if you have more then six vehicles). Any vehicle that is near you will be marked in GREEN, by clicking on a vehicle it will spawn at its parking spot. Here is an example of the clickable menu that will open if you have any vehicles:

 

 

• (/v)ehicle get

By using the parameter "get" you can retrieve an owned vehicle. You can also add another parameter - a vehicle ID from the list. Add the vehicle ID from your list (for example your Towtruck is one(1) so you will add one after the "get" parameter (/vehicle get 1) and it will spawn my towtruck)). This differs from /v list by allowing you to enter one command and have the vehicle spawn immediately.

 

• (/v)ehicle park

By using the parameter "park", this would 'park' your vehicle (despawn it). This means it will not be visible until you spawn it again. This is available only at the vehicle's parking space, where you've defined it.

 

• (/v)ehicle buypark

By using the parameter "buypark" you can define the parking space for your vehicle. If you set your parking space near a house that you own then you will not be charged the usual $2,500.

NOTE: Your vehicle's parking space is automatically changed to the impound lot if your vehicle is impounded by a public impounder.

 

• (/v)ehicle sell

By using the parameter "sell" you can offer your vehicle to a player. After you send the request, the player you're trying to sell to would receive a dialog asking if they want to buy your vehicle for a price that you've chosen. The second player is able to accept by pressing Y on his keyboard on N on his keyboard to decline. The seller receives the full amount offered and the buyer loses the full amount and receives the vehicle.

 

• (/v)ehicle register

By using the parameter "register" you can attempt to register your vehicle. This may only be done at a dealership in the presence of a mechanic.. If you're a silver or gold donator, you're able to choose a unique plate up to seven (7) symbols, numbers or letters but not including any special symbols. To create a unique plate, enter the unique plate of your choice as a parameter after the register parameter.

 

• (/v)ehicle unregister

By using the parameter "unregister" you can unregister your vehicle. This action is only available at the blackmarket. Doing this renders your vehicle without a license plate (which is illegal according to the San Andreas Penal Code).

 

• (/v)ehicle buy

By using the parameter "buy" you will be shown a vehicle listing at a dealership.

 

• (/v)ehicle upgrade

By using the parameter "upgrade" at a dealership you are shown the upgrade process. You may upgrade your insurance plan, lock, immobilizer, alarm, engine, battery or vehicle armor. You may or may not need a mechanic nearby, it differs.

 

• (/v)ehicle stats

By using the parameter "stats" your vehicle statistics and details are displayed. This command must be entered whilst inside your vehicle.

• Life Span

Engine/Battery life - decreases when the vehicle is damaged and health of the vehicle is under 694.0, it decreases while you drive by a very slow speed, it'll take around 70 days (in total hours of 1,680) to reach its final state.
Miles Driven - shows how many miles the vehicle has been driven.

 

• Security

Lock - lock level, click me to view details.
Alarm - alarm level, click me to view details.
Immobiliser - click me to view details.
Insurance - click me to view details.

 

• Misc

Primary Color/Secondary Color - your vehicle colors, handy when you need to see the hex IDs for your vehicle's paint job.
License plate - displays the license plate the vehicle is/should be registered with.
Armor - Displays the armour present on the vehicle. Armor protects the vehicle from an additional 250 points of damage.

 

 

• (/v)ehicle tow

By using the parameter "tow" you can tow your vehicle back to its parking (spawn) point. This may only be done if the vehicle is spawned and occupied. The service costs $2,000 and dialog is displayed on the vehicle during the process.

 

 

• (/v)ehicle duplicatekey

By using the parameter "duplicatekey" you can give a set of keys to a player (specificed by entering an ID as the final parameter). This costs $750 and the player will keep the keys until they log out.

 

• (/v)ehicle locate

By using the parameter "locate" it will list all of your vehicles locations, see below for example:

 

 

• (/v)ehicle scrap

By using the parameter "scrap" you will scrap your vehicle permanently. You will only receive half of the dealership price of the vehicle, regardless of its modifications.

 

• (/v)ehicle faction

By using the parameter "faction" this will assign the vehicle to the faction you're a leader of. This command is only available to official faction leaders.

 

• (/v)ehicle company

By using the parameter "company" this will assign the vehicle to the company you're the owner of. This command is only available to scripted company owners.

 

• (/v)ehicle lights

By using the parameter "lights" you can switch your vehicle's lights on or off. Note that your lights will automatically switch on from 8PM onwards servertime and that the toggle from this command is reset if you leave it.

 

• (/v)ehicle lock or /lock

By using the parameter "lock" you can lock or unlock your vehicle. This can be done from inside the vehicle or near it.

 

• (/v)ehicle price

By using the paramter "price" you can check the price of each vehicle model available for sale.

 

• (/v)ehicle opendoor or /opendoor

By using the parameter"opendoor" you can physically open the doors of your vehicle (or any vehicle that is unlocked). It sends an emote above your head much like /ame.

 

• /vehiclename

This command allows you to have a real life model displayed for your vehicle related emotes (/engine, /opendoor, /lock, etc). The following sequence shall be followed when requesting a vehicle name: Year Make Model. E.g.: 1999 Toyota Supra, 2005 Dodge Challenger. No versions, types, engine sizes are allowed. Level 3 Game Admins (and above) are responsible for these requests. You should never use the /report system to get an update on your request, you get notified upon login or if you were in-game when they handled it you get a notification in your chatbox.

 

• /trunk

By using this command, you will be able to open or close your trunk when standing near the trunk or inside the vehicle. You're able to do this only when the vehicle's engine is on.

 

• /hood

By using this command, you'll be able to open or close your hood when standing near the hood or inside the vehicle. You're able to do this only when the vehicle's engine is on.

 

• /engine

By using this command, you'll be able to turn on or off your engine inside the vehicle. You're able to do this only when the vehicle is yours, if not you'll need to hotwire it.

 

• /vehiclefines

By using this command, you'll be able to see all of your fines that are in the vehicle you're currently in.

 

• /carmenu

By using this command, you'll be able to enter the Wang Cars modification center that is located in Rodeo to modify your vehicle with any miscellaneous such as bodykits, XMR, wheels and hydraulics. This also works at Loco Low .Co in Playa Del Seville/Willowfield.

 

---

Vehicle Save Details

This section covers anything that is able to be saved when you despawn or spawn your vehicle or when you quit while leaving it spawned.

 

• Lock level (0-5)
• Alarm level (0-4)
• Immobiliser level (0-4)
• Insurance level (0-3)
• Vehicle parking space
• Colors
• Tickets
• Fuel
• Plates
• Vehicle armour
• Modifications
• Drug packages
• Weapon packages
• Weapons
• Tires data
• Battey life
• Engine life

 

---

Vehicle Security

This section covers vehicle security, how it helps you and how it works. All information stated here is valid as of the current version of LS:RP vehicle system updated in April 2016. Information was taken directly from the author of the vehicle system

 

With the new breaching methods, there are two possible ways to gain access to a vehicle. One by prying the door off the vehicle with a toolkit or by smashing the door and cracking it open with melee attacks. To hinder would-be thieves, many options are available to upgrade the security of your vehicle.

 

Locks are there to protect the privacy of your vehicle, different type of locks have differing levels of protection towards your vehicle.

 

>> Lock(s) and effects

^ Stock Level Security

+ 250 second wait time protection against prying method.

^ Second Level Security

+ 500 second wait time protection against prying method.
+ Improved armor, providing more protection from physical breaching.(Fist & melee)

^ Third Level Security

+ 750 second wait time protection against prying method.
+ Special armor, x2 defense against melee breaching.

^ Fourth Level Security:

+ 1,000 second wait time protection against prying method.
+ Special armor, x3 against melee breaching.
+ Special armor better defense against physical attack breaching. (Fist)

^ Fifth Level Security:

+ 1,250 second wait time protection against prying method.
+ Special armor, blocks all types of physical Breaching.

 

The immobiliser serves to make a potential thief's task tricker by layering complication in their attempts at hotwiring a vehicle.

>> Immobiliser(s) and effects

›>› Stock Level Immobiliser

125 second limit while hotwiring.

 

›>› Second Level Immobiliser

100 second limit while hotwiring.

 

›>› Third Level Immobiliser

75 second limit while hotwiring.

 

›>› Fourth Level Immobiliser

50 second limit while hotwiring.

 

›>› Fifth Level Immobiliser

25 second limit while hotwiring.

 

 

Any alarm abov the default (level 0) will produce a sound.

 

>> Alarm(s) and effects

^ Stock Level Security

+ Loud vehicle alarm

 

^ Second Level Security

+ Loud vehicle alarm
+ Vehicle alerts its owner of a possible breach.

^ Third Level Security

+ Loud vehicle alarm
+ Vehicle alerts its owner of a possible breach.
+ Vehicle alerts the local police department of a possible breach.

 

^ Fourth Level Security

+ Loud Vehicle Alarm.
+ Vehicle alerts its owner of a possible breach.
+ Vehicle alerts the local police department of a possible breach.

+ Vehicle blip will appear on the radar.

 

---

The Dealership

Buying a vehicle

This section covers the process purchasing a vehicle.

 

The information is presented in text on-screen instead of the game chat.
Each dealership has a configured point. There are four in total; two for land vehicles, one for air vehicles and one for marine vehicles.

 

Grotti & Commerce Dealership

Regular dealerships sell vehicles listed under the following categories

 

• Bikes  
• Convertibles  
• Industrial  
• Lowriders  
• Offroad  
• Saloons  
• Sports Vehicles  
• Public Service  
• Public Service Law  
• Station Wagons  
• Unique  

 

Certain vehicles require certain permissions (such as emergency vehicles and donator exclusive vehicles such as the BMX and ZR-350) and usually serve as private vehicles to their respective faction leaders.

 

Santa Maria Beach Lighthouse Dealership

Sells boats. The Predator is exclusive to law enforcement agencies and the fire department only.

 

Los Santos International Airport Dealership

Sells you aircraft (requires a unique flying licence available near the airport spawn).
 

Once you've chosen the right dealership and the right category, you will have a list of vehicles that fit the current category.
Each category displays the vehicle pictures (stock models) and prices.

 

When you click on the vehicle model you want, the process will continue to the physical preview. The physical preview allows you to see the vehicle and it will create a dialog for you to understand how the vehicle works, which fuel it runs on and its capacity and its overall price.

 

The price is the total cost of the vehicle, modifications and whether you include a lock, alarm, immobilizer, colors and XMR.

 

For example we choose vehicle X which costs $100,000 and we want to add: Alarm level 4, Immobiliser level 4, custom color and XMR.

 

 

 

 

 

When you're ready to buy the vehicle, you will be shown the following:

 

 

If you hit ESC to purchase your vehicle, you will be given the option to confirm or deny the purchase at its final stage. Hitting ESC again cancels the purchase. Proceeding through the dialog will eventually finish the process and turn the vehicle over to you.

 

 

Vehicle Upgrade

This section covers the process of upgrading features on a personal vehicle.

 

• Lock
• Alarm
• Immobiliser
• Armour
• Insurance
• Battery
• Engine

 

The main change is that all of the additional items for the vehicle are now inside the upgrade category inside the command list.

 

(/v)ehicle upgrade will bring up:

 

And you're able to choose the upgrade you would like.

 

A vehicle begins with a stock lock (level 1).

 

 

When you write the end with the yes, it will start to upgrade your lock:

 

 

When the operation finishes, it will notify you:

 

 

An alarm is a common feature in vehicles in LS:RP due to its usefulness in protecting your vehicle. Each upgrade adds new features (while retaining the previous level's features).

 

 

When you write the end with the yes, it will start to upgrade your alarm:

 

 

When the operation ends, it will notify you with the alarm upgrade:
 

 

An immobilizer effects the amount of time it takes to attempt to hot wire a vehicle.
 

 

 

When you write the command with the yes at the end, it will start to upgrade your immobilizer:
 

 

When the operation finishes, it will notify you with the immobilizer upgrade

 

Vehicle health varies from model to model (bikes tend to have less for example).

Armor is available up to a maximum of an additional 250.0 hit points on a vehicle. Also visible damage will not show until the amount of armor added is depleted. Engine life deterioration still only affects the vehicle's base health.

 

 

 

When you add "yes" to the end:

 

 

Once this has finished, you will be notified:

 

 

Insurance comes in 3 levels. Each level offers differing coverage and is permanent (upgrades to insurance are also permanent).

 

• First Level Insurance Coverage

Vehicle will always respawn with its max health.

• Second Level Insurance Coverage

Vehicle will always respawn with its max health.
Protection against cosmetic vehicle damage. Vehicle will re-spawn good as new.

• Third Level Insurance Coverage

Vehicle will always respawn with its max health.
Protection against cosmetic damage. Vehicle will re-spawn good as new.
Vehicle modification coverage. We got your fancy layout and XM tunes covered!

If your vehicle is destroyed, the insurance is charged and must be paid at a dealership in a prompt time frame.

 

 

Upon payment, you'll receive a notification that you've paid your insurance price.
 

 

 

---

Battery & Engine

This section covers the battery and engine of a vehicle and how they affect them in LS:RP.

 

Battery and Engine serve as a life span of a vehicle. Both decrease at 0.01 for every couple of minutes the engine is running.. The total estimated life span of an engine is 69 days (real time). The battery decreases upon explosion or other types of serious damage.

 

• Vehicle health is more then 650

Battery Life - No loss.

• Vehicle health from 550 to 649

Engine Life - (vehicle_health_loss/125.0) = deduction from engine life.
Battery Life - (vehicle_health_loss/150.0) = deduction from battery life.

• Vehicle health from 390 to 549(Grey Smoke)

Engine Life - (vehicle_health_loss/100.0) = deduction from engine life.
Battery Life - (vehicle_health_loss/125.0) = deduction from battery life.

• Vehicle health from 250.1 to 389 (Black smoke)

*Vehicle engine turns off around the 325-389 mark*
Engine Life - (vehicle_health_loss/75.0) = deduction from engine life.
Battery Life - (vehicle_health_loss/100.0) = deduction from battery life.

• On Vehicle Death

Engine Life - (-10)+random( 5 ) deducted.
Battery Life - (-10) deducted.

 

* vehicle_health_loss = 1000.0 - Vehicle Health. ((Example: 1000.0 - 400.0 = 600.0))

 

 

Under 650 you are likely to encounter problems with the engine.

 

 

If replaced, both engine and battery will replenish to 100.0.
 

---

Vehicle List with images

This section displays all vehicle prices. All models have been organized for an easy read and tips throughout can guide you.

 

Vehicle List ( With Images )

 

Click Here

 

Prices are updated with the system
This list will be updated as and when vehicles are added through updates.

 

---

Frequently Asked Question

• What happens if I do not pay my insurance?

If you fail to pay your vehicle insurance after a while, it will eventually be scrapped without notice.

• What is the price of X car?

If you're on IRC, you can simply type !price [carname] or click HERE for a large table of data! (Credits DamianC)

• What does vehicle armour do?

When you crash your car or bump it, it will remove it from vehicle armour so your car doesn't remain ugly and smashed. Once the armour has been used up, it will no longer visually repair though!

• What insurance level saves my precious XMR?

Level 3.

• How do I break into a car?

/lock breaking or /lock pry next to a locked car. Information is displayed on what to do next there.

• Can bikes have locks?

Yes, but they will break after 1 hit, no matter what level, as you cannot physically lock/block someone from getting on a bike. So, invest in a good alarm and immobilizer!

• Dealership says out of stock?!

/v buy, not /enter!

• Vehicle commands?

/v will list all parameters.

• What happens to my car when I logout?

It remains spawned, so park it! Note that your car lifespan will not reduce when exploded if you're not online to avoid abuse.

• How do I mod my car?

Head over to the mod shop west of Rodeo Bank and /carmenu at the i icon!

• What happens when I /v scrap?

Typing /v scrap is fine, it will ask you for confirmation and state how much you will be given. Selling it to another player normally yields more money!

• Where can I sell my car?

You can sell it on the forums or in-game with /ad!

• How does one turn on the XMR radio they bought?

/setstation will show a nice dialog to select your radio station.

• Where can I buy vehicles like the Turismo and Infernus?

Vehicles such as those are only ever auctioned on the forums. Head HERE to check the status!

Edited May 24, 2024 by asapdev

[forgotten]

moved

 

Edited January 15 by forgotten
moved