Car Thief Script [ESX/QBcore]

Dependencies

• QBcore - Supports all versions
• oxmysql - For database interaction.
• marko_leveling - For Gain Xp and LVL
• Rep-NPC (free) - Alternative scripts for NPC interaction are viable; a free, ready-made warrant option is provided.
• ps-dispatch - (Optional)

Features

• Level System for Car Thieves and Cops.
• Legal Side:
  Officers (or other factions set in config) can search for thieves and return cars to to impound, earning rewards and experience in the process. Police levels influence the % of earnings.
  • Example: Level 1 grants only 40% of the car’s value that would have been received by a player attempting to steal it, whereas Level 10 equals 110% (configurable in config).
  • Using ps-dispatch or a similar service notifies the police of a theft attempt.
• Criminal Side: Tasks involve generating a random car (customizable per level) and a search area for it. Players receive details like the number, colour, and brand of the car to find and steal, then deliver to a specified location.
  • Once stolen, police (or other factions mentioned in the config) can track the car. The map updates the blip (default is every 25 seconds), forcing the thief to frequently change directions to avoid police.
  • Car thefts occur by receiving a task from an NPC (Rep-NPC or other scripts suggested) or via a chat command. Given the open-source code portion, initiating the task function can be easily implemented anywhere (assistance provided).

Technical Aspects**

• Configurations: A wide range of detailed settings is provided, including:
  • Debug Mode for server-side and client-side alerts for in-depth debugging and customization.
  • Over 200 pre-configured locations for car thefts.
  • Settings for all markers, zones, blips, etc.
  • Faction settings to define who can start tasks, who can see blips of stolen cars (Dispatcher mode), and more.
• Detailed Settings for Each Skill Level:
  • Criminal Side:
    • Vehicles available for theft at certain levels.
    • Amount of experience gained for each specific car.
    • Amount of cash for each specific car.
  • Legal Side:
    • Set which factions have access to certain functions:
      • Seeing blips of stolen cars.
      • Intervals between blip location updates (default is 25 seconds).
      • Impounding vehicles.
      • Setting the % of earnings for returning a stolen car to the impound lot.
      • Saving information about a stolen car automatically to the police database [ps-mdt]
• Player Notification Methods Support:
  • Easily add your preferred notification method with our open-source code segment, which you can modify, or we can do it for you .
  • Default support (check updates in Discord) includes: chat, notify, um-chat, okok-chat, qs-smartphonePRO.
    • Example: Notifications about cars players need to steal can come through chat, notification, or SMS if using qs-smartphonePRO.
  • ps-Dispatch support, with alternative scripts notifying cops of a failed theft attempt. Otherwise, notifications might not be present, but as mentioned, officials can still activate “Dispatcher” mode to receive car locations every 25 seconds.
• Rep-NPC: Grateful for the Rep team’s integration of their NPC script, allowing players to receive car search tasks through dialogues.
• Open Source Code Segment: The part of the code responsible for this functionality is fully open, allowing easy modification of the prepared logic.
• Code Accessibility: Although a significant portion of our code is escrowed, access is provided to most functions and events for use wherever desired.

Language and Translation

• Easily translate the script into your desired language using Config.lua.
• In our Discord, you can find language packs for Ukrainian, Polish, Spanish and English (Base) - the list of languages may expand post-publication*.

Optimization

• The task assignment methods are based on a “queue” principle, where each player wishing to obtain a task enters a queue (set Debug Mode = true to track) before creating a car and interacting with the database. This ensures that all players begin tasks sequentially (configurable through settings).
• Location reservation, as mentioned, by default we offer 200+ car spawn locations. Each location is reserved through a specific database interaction combined with the queue system described above, preventing task duplication. Each player receives a unique task, and the reservation is lifted when the task is terminated.

Technical Support

• We offer technical support to all our clients.
• Continuous script support; we are constantly working on the script, so it may change from the time of publication.
• This is the first publication of our script for FiveM, so your feedback is crucial. Based on it, we can improve.

Links