NullSect
Systems nominal

Scripts / systems · v0.1.0

Rent a Car

Rental agencies with deposits, late fees and return-anywhere, set up in game.

  • Qbox
  • QBCore
  • ESX

Features

  1. 01

    Agencies and catalog

    Counter NPC, blip and target per agency; categories, pictures and rent per length.

  2. 02

    Deposits and late fees

    The deposit comes back on return, minus damage and late fees. Return at any agency.

  3. 03

    In-game editor

    Create agencies and place the NPC, parking spaces and return lot with a ghost preview, no restart.

  4. 04

    Crash-safe

    After a disconnect the car waits for the same character; a restart refunds deposits on next login.

Requirements

Frameworks
Qbox, QBCore, ESX
Requires
oxmysql
Works with
ox_lib, ox_target, qb-target, qbx / qb vehiclekeys, ox_fuel, LegacyFuel, cdn-fuel, ps-fuel
Version
0.1.0

Recent changes

Read the docs →

0.1.0

  • Rental agencies: counter NPC, blip and target option per agency; three example agencies (Legion, LSIA, Sandy Shores).
  • Catalog NUI: categories, vehicle pictures with a silhouette fallback, rental length, bank / cash payment, price breakdown.
  • Server-spawned rental car with a RENTxxxx plate, vehicle keys bridge (qbx_vehiclekeys / qb-vehiclekeys / custom) and fuel bridge (ox_fuel / LegacyFuel / cdn-fuel / ps-fuel / native / custom).
  • Deposit settled on return: damage charge (with tolerance) and late fee (after a grace period), return at any agency.
  • Contract screen with plate, live countdown, estimated refund and return lot status; receipt after the return.
  • Watchdog: reminder before the end, notice when overdue, repossession far past the end, lost car ends the rental.
  • Reconnect window: after a disconnect or character unload the car waits for the same character.
  • Restart / crash: cut rentals refund their full deposit on the next login or counter visit.
  • Admin: /rentalend <id> (full refund).
  • In-game agency editor /rentaledit (tabs: locations, vehicles, settings):
    • move the counter ped, add / move / remove parking spaces and move the return lot with a live ghost preview (E saves, Backspace / X cancels), teleport to a point;
    • pick the vehicles an agency offers (cards with pictures, per category), rename it, switch it on / off;
    • create new agencies where you stand and delete them; reset a config agency to config.lua. Saved in ns_rentacar_points / ns_rentacar_agencies, pushed to every player at once (GlobalState).
  • Config agencies take enabled = false; the catalog is ordered by category, price and name.
  • English and Turkish locales.

Related

Cart

Your cart is empty.