Retro Car Rental

Development

Server Callbacks

All registered via lib.callback. Call with lib.callback.await from client or server.

Callback	Returns
rs_carrental:server:getRentals	Active rentals formatted for NUI
rs_carrental:server:hasVip	bool - checks both inventory item and DB entry
rs_carrental:server:rent	Deducts money, spawns vehicle, writes DB
rs_carrental:server:return	Calculates refund or overdue fee, deletes entity
rs_carrental:server:extend	Extends expiry, applies tiered discount
rs_carrental:server:getVehicleNetId	netId for a given rental ID
rs_carrental:server:purchaseVip	Deducts money, gives item, writes VIP DB entry

Events

• rs_carrental:server:getVehicleCoords - server event, returns vehicle position for GPS tracking.
• rs_carrental:client:setGps - client event, sets a waypoint to the vehicle.

NUI Messages (Lua → Web)

Action	Payload
open	{ config, locale, rentals, hasVip }
close	-
updateRentals	{ rentals }
updateVehicleStatus	{ rentalId, fuel, engine, brakes }
updateLocale	{ locale }

NUI Callbacks (Web → Lua)

Callback	Params
rentVehicle	model, categoryId, paymentMethod
returnVehicle	rentalId
extendRental	rentalId, hours
trackGps	rentalId
purchaseVip	optionId, paymentMethod
closeUI	-

Bridge Functions

Framework-agnostic server-side helpers:

Bridge.GetPlayer(src)
Bridge.RemoveMoney(src, amount, type)
Bridge.AddMoney(src, amount, type)
Bridge.GetMoney(src, type)
Bridge.GiveVehicleKeys(src, plate, vehicle)
Bridge.RegisterPlayerLoaded(cb)
Bridge.Notify(src, message, type)
Bridge.GiveItem(src, item, count)
Bridge.HasItem(src, item)

How Rentals Work

1. Player interacts with NPC → client opens rental UI with location data.
2. Player picks a vehicle → NUI sends rentVehicle.
3. Server validates max rentals, VIP status, balance → spawns vehicle at spawnPoint, generates plate, writes DB.
4. Background loop (60s interval) checks all active rentals for overdue status.
5. On return: if early, partial refund based on ReturnRefundPercent. If overdue, fee charged at OverdueRatePerHour × hours (rounded up).

VIP Validation

Both conditions must be true:

1. vip_rental_card exists in player inventory.
2. rs_carrental_vip row exists with expires_at > now.