Admin Mechanic Menu

The admin mechanic menu is a comprehensive tool for managing mechanic shops in-game, accessible via command or keybind. Admins can create, view, and manage shops, assign a shop boss, and configure various markers such as boss menu, duty toggles, storage, and garages. Custom vehicle lifts designed by K4MB1 can be spawned as needed. Shops can be temporarily disabled to restrict access or permanently deleted. This menu streamlines shop management and configuration without requiring server restarts.

Dynamic Shop Creation

The in-game dynamic shop creator, allows admins to set up mechanic shops in real-time without server restarts. Default job settings, including grades, names, labels, and salaries, are pre-configured in the system. When creating a shop, admins enter a job name; if it doesn’t exist, the default settings are applied. If the job already exists, the system automatically pulls the existing data, allowing for the creation of multiple branches using shared job attributes. Each shop can have its own blip, which can be enabled or disabled individually.

Shop Markers

Each shop has customizable markers that can be enabled or disabled in the config, with admins deciding which markers to create. Mechanics can toggle duty at any time, even if they have another job, as long as they’re hired at a specific shop. The boss menu allows shop bosses to manage accounts, recruit, promote or fire employees, and handle vehicle storage. The workbench provides item crafting based on configurable recipes, and shops have quick repair markers for immediate vehicle fixes. Each shop also includes a storage marker, supporting various inventory systems or menu-based storage options.

Player Mechanic Menu

The player mechanic "action" menu is accessible by command or keybind and available exclusively to hired mechanics. It offers a range of features including viewing or creating bills, requesting NPC jobs - or cancel an ongoing job, checking vehicle status, performing service checks, diagnosing health parts, and initiating body repairs. Mechanics can also push, flip, unlock, or impound the nearest vehicle, with each feature customizable and able to be disabled in the config.

Mileage System

The script tracks and saves the mileage of all personal vehicles, with options to track distances in either miles or kilometers. It offers nearly 1:1 accuracy with the actual in-game distance traveled, as seen on the GPS navigation. This feature adds realism to vehicle management by accurately reflecting the wear and usage of each vehicle.

Vehicle Status

Mechanics can view detailed information about the nearest vehicle, using 3rd-eye-target or menu, including engine and body health, fuel and dirt levels, and engine and oil temperatures. For personal vehicles, it also displays the driven mileage, providing a comprehensive overview of the vehicle’s condition.

Body Repair

A comprehensive body repair process consisting of three main steps: inspection, damage reporting, and part installation. Mechanics begin by inspecting the vehicle at four designated points to identify any damage. If no damage is found, such as broken or missing doors, hoods, trunks, windows, wheels, or burst tires, the repair process ends automatically with the vehicle restored to its original condition. If damage is detected, a detailed damage report is generated in the mechanic menu, listing all missing or broken parts. This report is updated live as repairs progress. Mechanics can then use specific body parts to replace or install missing components, accompanied by realistic animations and props.

The entire process, including props, animations, skill checks, progress bars, and durations, is fully customizable in the configuration, allowing for a tailored repair experience that enhances roleplay immersion.

Vehicle Service/Maintenance

All personal-owned vehicles require regular maintenance and servicing to prevent malfunctions over time. Mechanics can perform a detailed service check on each vehicle, receiving a report on the condition and expected lifespan of various service parts: oil filter, air filter, fuel filter, coolant, brake fluid, power steering fluid, transmission fluid, spark plugs, drive belt, flywheel, and tires.

These parts degrade based on the in-game mileage driven, and once they reach their lifespan limit, they are marked as SERVICE DUE, indicating that the part is malfunctioning and will begin to degrade associated health parts if not replaced. Mechanics can repair each service part using the appropriate item, and the old, replaced part will return some materials as scrap.

The system is highly configurable, allowing you to customize the lifespan and degradation rate for each service part, as well as add, edit, or remove parts. Additionally, you can configure the amount and type of returned materials, set degradation percentages and values, and enable or disable features like skill checks, progress bars, animations, and durations for a tailored maintenance experience.

Health Parts

This system covers essential vehicle components that ensure proper functionality, including the radiator, fuel pump, brakes, drive shaft, alternator, and clutch. Mechanics can diagnose the condition of these parts, receiving a detailed report that categorizes them as OK, WORN, DEFECT, or MECHANICAL FAILURE. Diagnostics require the engine temperature to drop below a configurable value. Health parts degrade due to direct collisions or when associated service parts, like the oil filter, are due for maintenance, which can accelerate the degradation process.

Each part affects the vehicle differently when malfunctioning:

• a damaged radiator causes engine overheating and smoke
• a failing fuel pump leads to stalling and rapid fuel loss
• faulty brakes result in poor braking performance
• a compromised drive shaft makes steering difficult
• an alternator issue causes starting problems
• a defective clutch results in rough gear shifts.

Mechanics can repair these health parts using specific items, returning some materials as scrap from the old parts.

The system is highly customizable, allowing you to configure degradation rates, collision impact, malfunction effects, and associated service parts. You can also add, edit, or remove health parts, adjust skill checks, and customize progress bars, animations, and durations to fit your needs.

Car Jack

Allows mechanics to spawn a jack using an item, attach it to a vehicle’s wheel, and lift the vehicle on one side for repairs or inspections. This interactive tool enhances realism by enabling detailed work on specific vehicle areas.

Custom Lifts

The resource includes custom lift props by K4MB1 Maps, providing a realistic and immersive experience for mechanics. These smooth-operating lifts enable detailed vehicle inspections and repairs, enhancing the overall mechanic roleplay with lifelike animations and precise functionality.

Patch Kits

Patch Kits provide a quick solution to restore both health and service part values for all components that are either due for service or in mechanical failure condition. They instantly repair parts to a configurable amount, effectively delaying further degradation and temporarily preventing malfunctions. This allows mechanics to provide immediate, albeit temporary, fixes to vehicles in critical condition, ensuring they can continue to operate until a full repair is possible. The configuration options allow you to customize the amount restored, making Patch Kits adaptable to different gameplay scenarios and repair needs.

Repair Kits

There are two types of Repair Kits available — normal and advanced. Advanced kits can be restricted to mechanics only, adding a layer of exclusivity and skill-based gameplay. Each kit type can restore engine health to a specified level, which is configurable in the settings. You can also enable or disable skill checks and customize animations, progress bars, and durations for each repair kit type, providing flexibility to suit various gameplay styles and scenarios.

Prop Emotes

Mechanics can use various items to perform immersive emotes with props such as tool trolleys, toolboxes, engine hoists, and road cones. All props are configurable, allowing you to add or remove them as needed to enhance roleplay and mechanic interactions

NPC Jobs & Activities

This system offers three dynamic job types to keep mechanics engaged when there are no customer requests. With over 40 job locations and the option to add more, each job features a configurable distance check to ensure mechanics have a minimum travel distance, preventing tasks from being too close and adding more variety to their work.

• Break Down Jobs - Mechanics can respond to breakdown calls, where they must bring a tow truck to assist an NPC with a disabled vehicle. The job requires towing the vehicle and the NPC to a specified drop-off location, with payment received upon completion.
• Roadside Repairs - Mechanics attend to NPCs facing random issues such as dead batteries, empty fuel tanks, or burst tires. They must carry the necessary repair kits and complete the job on-site, receiving payment directly from the NPC after resolving the issue.
• Scrapping - Mechanics can take on scrapping runs by collecting a vehicle from an NPC and delivering it to the scrapyard. The NPC at the scrapyard reviews the vehicle and rewards the mechanic with materials, which can be used for crafting various items.

These activities ensure mechanics have engaging, varied tasks that require travel and proper preparation, adding depth and realism to their role.

Tow Trucking

This resource includes an integrated tow trucking system activated by the /tow command. Mechanics can use it to attach and tow vehicles seamlessly within the game. The system is flexible, allowing you to customize or disable it entirely if you prefer to use a different towing script. It provides a straightforward solution for vehicle recovery and transportation, enhancing the mechanic roleplay experience with easy-to-use controls and smooth towing mechanics.

Billing System

This resource features a comprehensive billing system designed for mechanics to create detailed, itemized bills for their customers. Mechanics can add specific notes for each service or repair performed, providing transparency and clarity for customers. Before the payment is processed, customers must review, confirm, and sign the bill, ensuring they agree with the charges. Mechanics can access a list of all issued bills, which is particularly useful for shop owners to monitor transactions, track completed work, and manage overall shop expenses effectively. This system not only enhances the customer experience with clear communication but also helps shop owners maintain accurate financial records and accountability.

Vehicle Interaction

Mechanics have access to a variety of immersive interaction options with vehicles. They can push vehicles to move them out of the way, flip overturned vehicles back onto their wheels, unlock locked vehicles, and send vehicles to impound, effectively deleting them from the game. Each feature is fully configurable in the settings, allowing you to enable or disable them as needed. The impound feature is also open for customization, providing the flexibility to integrate your own events or exports for a more tailored experience. These interactions enhance the mechanic roleplay by offering realistic and practical vehicle management options.

Customization

The scripts has config file(s) with an extensive amount of configurable options, allowing extreme customization to make the system work with your roleplay server. A separate language file, containing all strings, makes it very easy for you to translate the system into your preferred language of choice. There's an icon folder with inventory icons for all included items.

Performance

The script has been rigorously tested to ensure maximum optimization and smooth performance, even on large servers with high player counts. Its low resource usage minimizes server strain, providing a stable and seamless gameplay experience for all users. The focus on efficiency and reliability ensures that the script can handle peak activity without compromising functionality or player immersion, making it a robust choice for any server environment.

Sync

The script is fully synchronized across all players, utilizing OneSync Infinity and statebags for seamless and reliable synchronization.