Installation & Configuration & Integration
Step By Step Installation
Step By Step InstallationInstall
Login to your keymaster account, check Granted Assets section and download script you bought from us
Script Start Order
To correctly start the mechanic script in your server.cfg, ensure to start the scripts in the following order. Failure to do so may result in various error codes
ensure ox_lib
ensure PolyZone
ensure dusa_mechanic
ensure dusa_carkitAdd Items
Go to _installation folder, you can find item images there. For item codes, firstly choose your framework, after that insert required items in your items file or sql
If you using ox_inventory ONLY use items_ox
If you using qb_inventory or qs-inventory use items_qb
If you using chezza_inventory use items.sql
Configuration
ConfigurationCreate New Mechanics
Owner of the mechanic identifier or citizenid must be determined at the bossIdentifier section
id value cant be same with other mechanics
job value must be different from other mechanics, otherwise it will be glitched
👨🔧 How can I set myself as boss to a mechanic?
Assigning Yourself as the Boss of a Mechanic Shop
To accomplish this, you will need to locate your assigned identifier or citizenid. Here's how you can find this information:
Navigate to your FiveM server's database where your user information is stored.
Look for the table that contains user data, often labeled as
usersorplayers.Within this table, find your user entry. It should contain fields for your
identifierand possiblycitizenid, among other personal details.Note down the
identifierorcitizenidvalue associated with your entry; this is the information you will need to input into the mechanic shop's configuration.
Once you have your identifier or citizenid, follow these steps to set yourself as the boss:
Open the mechanic shop script configuration (config.lua)
Scroll down to the
Config.Mechanicssection of the configuration.Choose the mechanic shop entry (e.g.,
[1],[2], etc.) you wish to own.Replace the empty string
""next tobossIdentifierwith your notedidentifierorcitizenid.Save the configuration file and restart your server for the changes to take effect.
You are now set as the boss for the selected mechanic shop.
Tuning Tablet
Tuning Tablet Usage Options
You have various options for using the Tuning Tablet. By setting TuningAsItem to true, you can attach the tablet to an in-game item, or if it's set to false, it will be accessible via a command. If you decide to leave TuningAsItem as false, you can customize the command to open the tuning interface by editing TuningCommand to your preference.
Configuring the Tuning Tablet:
TuningAsItem: Set totrueif you want to use the tablet as an inventory item, orfalseto use it with a command.TuningCommand: IfTuningAsItemisfalse, customize this command to your liking for opening the tuning interface.- Additional Options
MinimumGrade Setting
To adjust who can use the Tuning Tablet, change the
Config.MinimumGradevalue. This number represents the minimum required employee rank to access the tablet.Speed Settings
The
IncreaseSpeedandMaxSpeedoptions help you control the maximum acceleration and top speed that can be set using the tablet for vehicle modifications.
Crafting
To activate and customize the production table, several modifications are required:
prop: Defines the object for the table, which can be accessed fromforge plebmaster.job: Determines which jobs can access the table.workarea:Withinworkarea, thelengthandwidevalues set the range of accessibility for the table.coords:Usecoordsto place the production table in the desired location.
In the CraftItems section, you can add or remove items:
prop:Specifies the object to be previewed.img:Changeimgto modify the menu image.
For the requirements section:
Define new items by setting
nameanditem.Do not alter the
ownedvalue.Adjust
countto specify the required quantity of items.
How to edit part prices?
How to edit part prices?Editing Part Prices
To set the prices for each part, you can perform the following steps in config.lua:
Use
Ctrl+Fto locate theConfig.Menussection within the file.There you will find various upgrades and customizations like
brakes,transmission, etc., along with their prices.basePricerepresents the base price of a part, andincreaseBydetermines the incremental value based on the part's quality.You can adjust these values accordingly to set your prices.
Remember, individual mechanic shops can establish their discount rates for all parts, so consider this factor when setting your economy. Adjust your prices with this in mind to maintain a balanced economy.
Integrations - Compatibilities
Integrations - CompatibilitiesTo ensure that our script operates harmoniously with other scripts, you will need to adjust the following settings.
Vehicle Keys
Key Integration for Custom Vehicle Key Plugins
If you're not using one of the pre-integrated vehicle key scripts like dusa, jaksam, qbcore, wasabi or quasar and need to integrate your own, follow these steps:
Open
bridge/framework/client.luafile.Use
Ctrl+Fto find the functiondusa.integrateKey.Insert the integration code provided for your key script into the located code block.
For example, if you're using a plugin called
xand they provide a function that looks like:You will need to replace
vehiclewith yourvehiclevariable andvehicleplatewith yourplatevariable as per your script.
If you encounter any difficulties while performing these steps, don't hesitate to open a support ticket for assistance.
API
The details for operations in this category have not been provided extensively, as anyone with basic knowledge can perform the necessary actions. Therefore, it is recommended to reserve this part more for your developers. Developers can refer to the provided snippets and integrate them into your scripts for extended functionality.
client
Triggering the Mechanic Menu from Anywhere Similar to Admin Menus
To invoke the mechanic menu from various locations, similar to how you would with admin menus, you can integrate the following code snippet into your scripts:
Triggering the Craft Menu
Integrate the following code snippet into your scripts:
Enabling the Tuning Tablet Menu
To enable the Tuning Tablet menu in other script, you'll need to use this event:
Snippet:
Clearing Existing Vehicle Lifts
To remove any vehicle lifts that have been previously placed on the server, follow the instructions below:
Navigate to
data>lifts.luaLOcate the vehicle lift you want to delete by finding its coordinates or by using the owner's job, citizen ID (or identifier) as a filter
Delete or comment out the entry of the specific vehicle lift
Save the
lifts.luafile after modificationRestart the script
Note: Ensure you have a backup of your configuration files before making any changes. If you encounter any issues, revert to the backup file and contact support.
Monitoring Vehicle Stancer Settings Changes
To track changes to a vehicle's stancer settings, follow these steps:
Retrieving Current Stancer Settings of Vehicles
To obtain the current stancer settings of a vehicle, use this callback:
Common Problems
For the error you are experiencing, you might not need to wait for us by opening a ticket. Here, you can find the most common errors encountered:
1. Applying Chameleon Colors
Issue: When I try to remove my car from the garage, the chameleon colors are not being applied.
Solution: This issue stems from your core script not supporting the chameleon color palette. However, you can solve this problem with two small pieces of code.
The functions that need modifications and the code sections to be added are specified below.
Follow this path -> qb-core/client/functions.lua
The codes to be added are:
If you don't know how to do it or are hesitant, replace your entire code block with the following. (If there have been prior modifications related to this function on your server, this method is not recommended.)
Last updated