AdvancedParking

If a player enters a vehicle, it will be registered in the database as a saved vehicle. The vehicle will always stay at the last location where it has been left by a player. If it despawns while players are too far away from it or after a server restart, the script will respawn the vehicle on server side as soon as a player gets close enough again. This also means no more "despawns" when looking away for a second.

All vehicle modifications and statuses are saved (check saved values below for more information) and will be reapplied upon respawning.

Vehicles that have been saved are completely dynamic. You can push a saved vehicle with a bulldozer and it will update accordingly.

The original Forum Post can be found here.

Requirements

• OneSync
• OxMySQL
• kimi_callbacks

📖 Documentation

• https://docs.kiminaze.de/scripts/advancedparking

❓ Support

• https://discord.kiminaze.de

📋 Patchnotes

• https://github.com/Kiminaze/version_history/blob/main/AdvancedParking.json

📋 Features

• All vehicles a player has entered will be saved.
  • Configurable vehicle class, model and plate blacklist.
• Vehicles will respawn automatically when players get close and the vehicle isn't there.
• Vehicles will respawn after a server restart.
• Vehicles that have been saved are completely dynamic. They can be moved and take damage.
• Vehicle spawning happens on server side.
• Attached trailers will be saved automatically.
• Option to save only player owned vehicles (requires ESX, QB, QBOX, OX).
• Cleanup functiontakes care of vehicles that haven't been updated.
  • Configurable time threshold.
  • Option to send cleaned up vehicles to the player garage (requires ESX, QB, QBOX, OX).
• Non-networked (or client side only) vehicles will be ignored.
• Can be restarted any time.
• Delete function that will delete any vehicle where a player is not close enough every X minutes (turned off by default). This is only meant for servers that have an over-abundance of (modded) vehicles where it could have a negative impact on performance (e.g. 200+ players + NPC vehicles).
• Admin command for deleting all vehicles from the database table.
• Exports for receiving the position of vehicles from server and client side.

💾 Saved values

While this script aims to save all variables of a vehicle, some of them can not yet be updated on server side and will only be updated when entering/leaving the vehicle (or when using the included "UpdateVehicle" export).

• Position and rotation
• Status:
  • Entity, body, engine and petrol tank health
  • Dirt Level
  • Fuel Level (includes compatibility with "LegacyFuel")
  • Door lock status
  • Burst/flat tires
  • Missing doors
  • Broken windows
• Tuning:
  • Number plate text
  • Modifications from 0-49 (except 17, 19 and 21 (possibly HSW mods that aren't in the game yet))
    • Visual and performance mods
  • Colors
    • Primary and secondary
    • Custom primary and secondary (RGB)
    • Pearlescent
    • Interior
    • Dashboard
    • Tiresmoke
    • Window tint
  • Lights
    • Xenon color
    • Neonlights color
    • Enabled neons
  • Extras
  • Wheels
    • Type
    • Custom
    • Bulletproof
    • Color
    • Drift Tires
  • Livery (from mods, extra livery and roof livery)
• Extra values:
  • engine on/off
  • landing gear state
  • vtol position
  • boat anchor state
  • convertible roof state
  • stub wings state
• Entity state bags

🔥 Performance

• Client Side:
  • idle: 0.00ms
  • inside vehicle: 0.01ms
• Server Side:
  • idle: 0.00ms
  • updating vehicles: 0.00-0.50ms (dependent on how many players and vehicles are present)

Lines: ~3200
Code accessibility: ~75%