Skip to content

Renting a Vehicle

Renting a Vehicle

This page walks through the full player experience end to end, from the rental agent to drop-off.

1. Find the rental agent

A rental NPC (Config.Ped) stands near Simeon's dealership by default, marked with a map blip (Config.Blip). Approach and interact using whichever method you configured in Config.Interaction:

  • ox_target / qb-target — look at the NPC and select the rental option.
  • textui / marker — stand in the marker and press E (Config.Interact.key).

2. Browse the fleet

The React interface opens with the full catalogue. Each card shows the vehicle's class, description, top speed, seats, trunk, acceleration, drivetrain and live stock, plus its image (resolved automatically for stock GTA5 cars). Filter with the category tabs — All, Super, Sport, SUV, Sedan, Muscle, Off-road — exactly as defined in Config.Categories.

3. Pick a duration and pay

Prices are driven by a per-day base and a chosen unit:

  • Select a unit — minute, hour, day or week.
  • Pick a quantity, using the quick presets or the stepper.
  • Toggle insurance (optional) — a flat add-on.
  • Review the live breakdown: rental total + service fee + insurance + refundable deposit.
ℹ

The total you see is confirmed on the server. Client-sent prices and durations are ignored — the server recomputes everything from Config.RentalUnits before charging.

Confirm the booking. The configured account (Config.PaymentType — cash or bank) is charged. If you don't have enough money, the rental is refused and nothing spawns.

4. Walk to your car

This is the signature part of BUPA Rental: you are not teleported into the seat.

  • The car spawns at the first free parking bay (Config.SpawnPoints).
  • A GPS route + blip is drawn straight to it (Config.RouteToSpawnedCar).
  • Walk over — the route clears automatically once you reach the vehicle.
  • Keys are issued to you via your configured keys system, the tank is filled to the vehicle's fuel level, and (if enabled) a rental_contract item lands in your inventory.
✓

Because bays are briefly reserved after each spawn, cars never stack on top of each other. If every bay is momentarily occupied, you're told to try again shortly — and you are not charged.

5. The rental contract item

If Config.UseRentalDocument is on, using the rental_contract item opens a live receipt showing the vehicle, plate, price and remaining time. With Config.ReissueKeysOnDocumentUse, using it also re-issues your keys while the rental is still active — handy if you lost them.

6. Returning the vehicle & deposit

Open My rentals in the UI to return a car early. On return:

  • The vehicle despawns and its keys are removed.
  • Your deposit is refunded (Config.RefundDepositOnReturn).
  • A confirmation notification is shown.

Return points and their radius are defined by Config.ReturnPoints and Config.ReturnDistance.

7. Expiry

When a rental's time runs out, the server settles it automatically (checked every 30 seconds): the car despawns if Config.DeleteVehicleOnExpire is set, keys are removed, and you receive an expiry notice. Expired records are either deleted or moved to the history table, depending on Config.RemoveDatabaseRecordOnExpire.

PreviousInstallationNext Spawn Points & Bays