# Liberty Auto Rental

**Drive Free.**

A complete vehicle rental economy for QBCore — built different, by one dev, for the streets.

Players walk up to a Liberty broker, pick a car, and sign a real lease for **1–7 days**. They pay the rental fee plus a refundable security deposit and drive off with a full tank. Bring it back clean and the deposit comes home. Bring it back wrecked and damage comes out of it. Miss the deadline and the car is **repossessed on the spot** — deposit gone.

**The part that sets it apart:** a rental is inserted into your server's real `player_vehicles` table, so it behaves like an owned car and works with **any QBCore garage** — no bridge, no adapter, no compatibility layer to babysit. The car parks and pulls from whatever garage you already run.

---

## Why It's Different

- **Native ownership, zero garage work.** Rentals live in `player_vehicles` — the same table your garage already reads. We didn't write an adapter for your garage; we used the table it already uses.

- **A real economy, not a toy.** Realistic 1:1 pricing, per-day rates, hefty deposits, and a Vans & Trucks row for working players. Scale the whole economy with one multiplier.

- **Engineered, not assembled.** Server-authoritative money with rollback on every failure. Anti-dupe spawning. Damage reads hardened against spoofing. Rate-limited endpoints. Built to survive a live server.

---

## Features

**Rental Loop**

- Real wall-clock leases, 1–7 days — the clock runs whether the renter is online or not

- Pay rental fee + refundable deposit up front, cash or bank

- Always spawns with a full tank, plate, and keys handed over automatically

- Drive to any Liberty return spot to return it

**Deposits & Damage**

- Server reads body and engine health on return and deducts a configurable fee

- Fee is always capped at the deposit — a player can never owe more than they put down

- Damage read takes the worst of server + client values, so nobody fakes a clean return

**Liberty Rewards**

- Four loyalty tiers driven by lifetime completed rentals

- The perk is a **deposit reduction** — never a rate discount, so your economy stays honest

- Luxury vehicles gated behind higher tiers

**Repossession & Recovery**

- Miss the deadline and the car is repossessed wherever it sits — deposit forfeited (configurable grace)

- Crashed or relogged and the car despawned? Recover it **free** at any broker — no lost deposits from a server hiccup

**In-Game Builder** (`/createrental`)

- Place brokers, spawn bays, and return spots with a live ghost preview — no manual coordinates

- Rename, recolor blips, and delete locations in-game

**Admin Suite** (`/rentalmanager`)

- Force-return (full refund), force-repo (forfeit), or comp a free rental to any online player

- Live dashboard of every active rental

**Operations**

- Discord webhook logging for rentals, returns, damage, repossessions, and admin actions

- Optional per-vehicle storefront thumbnails with a clean fallback

- Read-only exports so your other scripts can recognize rental vehicles

**Zero-Friction Compatibility**

- Auto-detects your fuel system (LegacyFuel, rcore_fuel, ox_fuel, Renewed-Fuel, lc_fuel, qs-fuelstations)

- Auto-detects your key system (qb-vehiclekeys, qbx, qs, wasabi, mk, jaksam, cd_garage, okokGarage, t1ger)

- Auto-detects ox_target or qb-target, with a clean prompt fallback if you run neither

---

## Requirements

- **QBCore** (Qbox compatible)

- **oxmysql**

- **ox_lib**

Optional, auto-detected — no config required: ox_target / qb-target and all major fuel & key systems above.

*Note: this is a QBCore / Qbox resource. It is not an ESX script.*

---

## Install in 4 Steps

1. Drop `inf-rental` into your resources

2. Import `schema.sql` once — your `player_vehicles` table is reused as-is, no schema changes

3. `ensure inf-rental` in your `server.cfg`

4. Set your garage, admin permissions, and (optional) Discord webhook, then build a location with `/createrental`

---

## Open / Locked

`config.lua`, `schema.sql`, `README.md`, and `CHANGELOG.md` are **fully open** to edit — pricing, categories, deposits, loyalty tiers, damage rates, webhook, everything you'd want to tune. The core logic is escrow-protected.

---

## Support

- **Discord:** discord.gg/bh77yjDegd

- **More scripts:** infamous.tebex.io

*Infamous Development — Scripts built different. By one dev. For the streets.*