FiveM Mechanic System [ESX/QB]

https://www.youtube.com/watch?v=yBlY2HB3wNA

In Game Shop Creator

Admins can create mechanic shop in-game in runtime with jobs & grades added. No need to restart your server!

• Default Job Grades - Configure the default created grades for a shop with name, label and salary for each grade.
• Shop Name - Enter a desired name for the shop
• Job Name & Label- You decide the created job name and label. If the name matches an existing it job, it will automatically use it's label and grades. This allows to create branches of a mechanic shop using same the job for multiple shops - like in different parts of the town.
• Blip - Enable or disable blip specifically on each created shop.

Admin Mechanic Menu

Can be accessed by command/keybind. They can either create mechanic shops or view created shops and manage these. When selecting a created mechanic shop, admins can:

• Set Boss - Assign a boss to the shop, who can operate it.
• Marker Management - Create marker for boss-menu, duty toggle, storage, garage, workbench and quick repairs. Customizable drawMarker. Possibility to delete marker and create elsewhere incase.
• Spawn Lifts - Admins can spawn custom lifts (created by K4MB1) for each shop. And add as many lifts to a shop as you want.
• Enable/Disable - Do you want to punish your shop and restrict all their access? No need to delete the shop, simply disable until you enable it again.
• Delete Shop - Completely delete the shop and the created job + roles.

Player Mechanic Menu

Can be accessed by command/keybind. This can only be performed by hired mechanics and the menu offers.

• #Billing - View or create bills.
• #NPC Jobs - Request jobs or cancel an ongoing job.
• #Vehicle Status - View status of the vehicle (can be disabled and used as target).
• #Check Service - Perform a service check (can be disabled and used as target).
• #Diagnose Parts - Get a report of parts condition (can be disabled and used as target).
• #Body Repair - Start the progress of a body repair on a vehicle (can be disabled and used as target).
• #Push Vehicle - Push closest vehicle (disable in config).
• #Flip Vehicle - Flip closest vehicle (disable in config).
• #Unlock Vehicle - Unlock closest vehicle (disable in config).
• #Impound Vehicle - Impound closest vehicle (disable in config).

Shop Markers

Each marker can be disabled/enabled in config. And for each shop, the admin decides which markers to create.

• Duty - Mechanics can go on/off duty. If they have another job, they will always be able to go on duty as mechanic, as long as they are hired in the specific mechanic shop.
• Boss Menu- The boss has access to a menu to manage account and employees.
  • Account: see balance, deposit or withdraw money.
  • Employees: recruit players, promote/demote or fire.
• Garage - Store or spawn personal owned vehicles.
• Workbench - Craft configurated items based on recipes. Set required materials and amounts for each item. Add categories. You can easily replace the function with another crafting system.
• Quick Repair - A marker to quick-fix vehicles; maybe if there are no mechanics online?
• Storage - Each shop comes with a storage marker, to store items. Supports different #inventories or can be used as menu based.

Custom Lift

The resources includes custom lift prop created by K4MB1 Maps. This allows mechanics to use a very realistic and smooth lifts to inspect and repair vehicles.

Car Jack

You can spawn car jack by using an item. Attach the car jack to one of the wheels of the vehicle and then interact to lift up the vehicle on one side.

Mileage System

All personal owned vehicles will have their mileage tracked and saved. You can configure between miles or kilometers. The mileage system is almost 1:1 on the in-game driven mileage seen on the GPS navigation.

Vehicle Status

Is an option to view details about the closest vehicle, which are engine and body health. Fuel and dirt level. Engine and oil temperatures and so on. For personal owned vehicles it also displays the driven mileage of the vehicle.

Vehicle Service/Maintenance

All personal owned vehicles must be maintained and serviced, otherwise vehicle will sooner or later malfunction.

• Service Check - Mechanics can check service on a vehicle and get a report of all service parts and their expected life span. It will display as SERVICE OK or SERVICE DUE.  The engine temperature must drop below x value (configurable) before you can diagnose.
• Parts - Oil filter, air filter, fuel filter, coolant, brake fluid, power steering fluid, transmission fluid, spark plugs, drive belt, flywheel and tires.
• Degradation - These parts degrade based on driven mileage in-game.
• Service Due - Means that this part is now malfunction and it will start degrade associated health parts.
• Repair - Mechanics can repair each service part by using the respective item on the vehicle. It will return some materials as scrap from the old replaced part.
• Configuration - You can customize lifespan mileage for each service part, you can add, edit or remove service parts. Customize returned materials and amounts. Degradation percentage and values. Enable or disable skill check, customize progress bar, animation and durations.

Health Parts

These are the core parts of the vehicle that ensure it drives properly.

• Diagnose Part Condition - Mechanics can diagnose health part condition and get a report of their current condition (OK, WORN, DEFECT and MECHANICAL FAILURE). The engine temperature must drop below x value (configurable) before you can diagnose.
• Parts - Radiator, fuel pump, brakes, drive shaft, alternator and clutch.
• Degradation - These part degrade on direct collisions. They can also degrade if the associated service parts are due for service, for example if oil filter is due for service, it starts degrading the radiator.
• Malfunction Effects - Each health part has different effects on the vehicle in certain conditions. Some also manipulates on the handling while the effects take place.
  • Radiator: engine temperature rise and engine smokes.
  • Fuel pump: vehicle stalls and fuel level drains faster.
  • Brakes: vehicle brakes are poor and player will have a hard time braking.
  • Drive shaft: vehicle becomes difficult to steer/turn.
  • Alternator: vehicle will have difficulties starting up.
  • Clutch: gear shifts are very poor.
• Repair - Mechanics can repair each health part by using the respective item on the vehicle. It will return some materials as scrap from the old replaced part.
• Configuration - Set delay in seconds in between malfunction effects to occur on malfunctioned parts. Set min/max degradation percentages on collisions. Set amount of parts to degrade on collisions. Enable or disable collisions. Enable or disable malfunction effects. Configure the margin of conditions for failure, defect and worn. Set associated service parts for each health part. Add, edit or remove health parts as you like. Enable or disable skill check, customize progress bar, animation and durations.

Body Repair

Comes in three steps, the first is the inspection and depending on the outcome, body damage report and body part installation. You can customize props, animations, skill checks, progress bars, durations an so on in config.

• Inspection - Mechanics must first inspect the vehicle on 4 points and determine the actual damage. If the vehicle has no broken/missing doors, hoods, trunks, windows, wheels/bursted tires, then the vehicle is automatically fixed and the body repair ends here.
• Damage Report - If the vehicle has any missing/broken parts, a report will be generated that can be accessed from the mechanic menu. This report will be updated live as the installation progresses.
• Install Parts - Mechanics can use specific body parts on missing parts of the vehicle to install with nice animations and sounds.

Patch Kits

Can be used to immediately fix and set health + service part values to + configurable amount on all parts that are due for service or in mechanical failure condition.

Repair Kits

There are two types, normal and advanced. You could restrict the advanced repair kit to mechanics only? In config you can set desired engine health to set for each repair kit type. Configurable options to enable/disable skillcheck and customize animation, progbar and durations.

Prop Emotes

Mechanics can use items to perform emotes using props with tools trolley, toolbox, engine hoist, road cone etc. You can add/remove props in config.

Billing System

This resource comes with a custom built-in billing system, where mechanics can create advanced bills with notes for their customers. The customer must confirm/sign the bill before the money is paid. Mechanics can also view issues bills, which could be useful for the shop owner to view and manage expenses in the shop.

Tow Trucking

The resource comes with a built-in tow trucking mechanism with /tow command to start the process. You can easily disable and use another to trucking script if you like to.

NPC Jobs/Activities

The resource offers 3 jobs to keep the mechanics active when no customers in their shops. There are 40+ job locations in total and you can easily add more. There is a distance check on each job, so the player will only receive jobs with minimum travel distance of x configurable units.

• Break Down Jobs: Mechanic can request break down jobs, where player must head out to an NPC with a vehicle that has a break down. This means the mechanic must bring a tow truck, to tow the vehicle and the ped to the drop off location and collect the payment.
• Road Side Repairs: The mechanic must head out to an NPC who has a random scenarios of these 3 (dead car battery, ran out of fuel or bursted tire). It is important that the mechanic brings the required kits to fix the problems that the NPC has. After the repair is done, player collects his payment from the driver's seat.
• Scrapping: Mechanics can do some scrapping runs to get materials to craft different items. They simply get a vehicle to collect from the NPC, bring it to the scrapyard and the NPC will review and offer some materials.

Push Vehicle

Mechanics can push vehicles very immersivity. You can disable this feature in config.

Flip Vehicle

Mechanics can flip upside down vehicles. You can disable this feature in config.

Unlock Vehicle

Mechanics can unlock a locked vehicle. You can disable this feature in config.

Impound Vehicle

Mechanics can send vehicles to impound (delete the vehicle). You can disable this feature in config. The function for this is open, so you can easily add your own event/export to impound vehicles.

Frameworks

• ESX Legacy (or v1.1, v1.2, v1.final)
• Official QBCore
• Qbox

Dependencies

• T1GER Library [required]
• OX Library [required]
• Target System (ox_target, qb-target or meta-target)
• Inventory System (ox_inventory, qb-inventory, qs-inventory, mf-inventory or default esx menu inventory)