🚗 BD_PersistentVeh — Persistent Vehicle System for FiveM

✨ Concept

Your vehicles never disappear again. On every disconnect or server restart, vehicles are automatically stored and a marker appears at their position. The owner presses E to instantly respawn it, with all properties intact.

🔄 Auto-Store System

• Disconnect — Player vehicles are automatically stored when they leave the server
• Server Restart — All world vehicles switch back to stored state on reboot
• /storeveh Command — Manual storage by the owner (inside or near the vehicle)
• Clean Deletion — Vehicle is removed from the world, no ghost entities

📍 Marker System

• Visual Markers — A marker appears at the exact position of the stored vehicle
• Fully Configurable — Type, dimensions, RGBA color, Z offset
• Optimized Draw Distance — Markers only render within the configured radius
• Zero Entity Creation — Pure client-side rendering via DrawMarker, zero server impact

🗺️ GPS Blips

• Owner Only — Only the vehicle owner can see their stored vehicles on the map
• Vehicle Name Display — Shows model name + license plate on the blip
• Dedicated Icon — Personal vehicle sprite, blue color
• Short Range — Blips only visible when zoomed in to keep the map clean

⚡ Instant Retrieval

• Press E — The owner retrieves their vehicle with a single key press
• Native Visual Feedback — Key prompt with GTA native icon (~INPUT_CONTEXT~)
• ox_lib Compatible — Automatic TextUI if ox_lib is detected
• Properties Preserved — Color, tuning, plate, damage — everything restored via ESX

🔒 Server-Authoritative Security

• 6 Server Validations — ESX player, ownership, distance, anti-dupe, plate, entity
• Anti-Duplication — Checks that no vehicle with the same plate already exists in the world
• Ownership Verified — Cross-referenced with owned_vehicles table + ESX identifier
• Distance Check — Cannot retrieve a vehicle from far away
• Anti-Spam Cooldown — Protection against multiple key presses

⚙️ Full Configuration

• Marker — Type, size, RGBA color, Z offset
• Distances — Interaction (E), marker render range
• Limits — Max stored vehicles per player
• Conditions — Engine off required, vehicle must be stopped
• Auto-Store — Toggle on/off for disconnect auto-storage
• Locale — Translation system (fr / en)
• Debug — Toggleable debug mode with detailed logs

🌍 Compatibility

• ESX Framework — Full es_extended integration
• oxmysql — Native support
• mysql-async — Switchable via a single variable in utils.lua
• ox_lib — Automatic detection for enhanced TextUI
• OneSync — Server-side vehicle spawn, fully OneSync compatible