Installation Guide

Follow these steps to install and configure the script correctly.

1

1. Codesign Bridge

This script requires cd_bridge to be installed and running before it can function

cd_bridge is plug-and-play and requires no setup. It automatically handles:

• Framework integration

• Database setup

• Script compatibility

• Error Handling

Once started, it will detect and connect to all supported scripts automatically.

👉 See the [Full Bridge Setup Guide] →

2

2. Download Script

Download the Script from the FiveM Portal Website

1. 👉 Download cd_mechanic →

2. Unzip the downloaded file.

3. In your server’s resources folder, create a folder named [codesign] if it does not already exist.

4. Place cd_mechanic (and all other Codesign scripts) inside the [codesign] folder.

Example of a resources folder with a [codesign] directory.

3

3. Install Dependencies

Required & Optional Dependencies

• Dependencies are either included in [cd_mechanic/dependencies] or have a text file with a download link (GitHub/Cfx Portal).

• Place them in your server’s [codesign] folder

• ⚠️ Do not place them inside the cd_mechanic folder

• Required dependencies start automatically

Resource Name	Download	Required	Details
cd_bridge	Cfx Portal		Required for framework, database, and compatibility.
cd_mechanicprops	Cfx Portal		Provides mechanic props (e.g. car lift).
cd_torquemaster	Cfx Portal		Provides a minigame.

4

4. Database Setup (SQL)

No manual SQL setup required.

The script automatically inserts all required database tables.

Config.AutoInsertSQL = true

Make sure this is enabled in configs/config.lua.

5

5. Items

Items to add to your inventory or framework

Use the link below to find copy-paste item tables for your inventory or framework.

Item Setup

6

6. Configure Script

Review the config.lua Settings

• Start by configuring cd_mechanic/configs/config.lua first

• This file contains the core settings required for basic script functionality

• Most feature-specific settings are located in separate config files

Review the config_mod_prices.lua Settings

After configuring config.lua, the next step is cd_mechanic/configs/config_mod_prices.lua.

This file contains the main pricing and economy configuration used by both player-run mechanic businesses and public LS Customs locations.

• Parts Per Thousand Configure how many basic_vehicleparts are required based on repair and upgrade value.

• Standard Mod Prices Configure the base pricing for standard vehicle upgrades as a percentage of vehicle value.

Important Notes

• These settings directly affect pricing and vehicle balancing on your server

• It is recommended to review all values before using the script in production

• Default values may not match your server economy or gameplay style

Review the config_businesses.lua Settings

After configuring config.lua and config_mod_prices.lua, the next step is cd_mechanic/configs/config_business.lua.

This is where you can begin configuring the main systems and features used by player-run mechanic businesses.

• Business Upgrades Configure purchasable business upgrades, tools, and workshop equipment.

• Crafting Configure the built-in crafting system and additional crafting recipes.

• Mechanic Shop Configure items that mechanics can purchase through the mechanic shop.

• Items Configure mechanic-related items such as vehicle parts, repair kits, lighting controllers, OBD scanners, stancers, hydraulics, dyno slips, and NOS items.

• Other Settings Configure additional business-related behaviour such as work order handling, object syncing, and log expiry.

Important Notes

• These settings directly affect pricing, progression, and vehicle balancing on your server

• It is recommended to review all values before using the script in production

• Default values may not match your server economy or gameplay style

Review the config_advanced_upgrades.lua Settings

This file is used for player-run mechanic businesses only and controls the advanced upgrade system, allowing mechanics to install custom performance parts that apply handling and performance changes to vehicles.

• Advanced Upgrade Categories Configure advanced upgrade categories such as brakes, drivetrain conversions, engine swaps, transmissions, and tyres, including pricing, handling modifiers, required tools, crafting, and mechanic shop settings.

Review the config_parts_degradation.lua Settings

This file controls the parts degradation system, which is a major part of the script and is used by player-run mechanic businesses.

Parts can wear down from normal mileage, vehicle crashes, NOS usage, and aggressive tuning through the tuner tablet.

• Parts Degradation Configure serviceable vehicle parts, health loss, negative handling effects, repair costs and major failure behaviour.

• Service Vehicle Repair Configure engine and body repair costs for mechanic service orders.

• Vehicle Crash Degradation Configure how vehicle crashes damage serviceable parts and apply tuning penalties based on crash severity.

7

7. Business Setup & Usage

Create a Mechanic Business

You must have admin permissions to create a business.

• Go to the location where you want the business to be set.

• Use /mechanictablet, open the Admin App, and create a business.

Businesses are linked to a job. Once assigned, all players with that job will have access.

After the admin creates the business, the business owner can finish setting it up.

👉 See the [Admin Setup Guide] →

Business Owner Setup

After a business is created, the owner must complete setup using the tablet.

Required Setup

1. Open the Business App Use the tablet to access your business.

2. Purchase Upgrades Go to the Upgrades tab and buy the required upgrades.

3. Set Upgrade Locations Place each purchased upgrade in the Shop Layout tab.

Optional Setup

• Billing Presets Set prices for common services

• Commissions Set earnings per job grade

• Manage Staff Hire and manage employees

👉 See the [Business Setup Guide] →

Create LS Customs (Public)

You must have admin permissions.

• Go to the location where you want LS Customs to be set.

• Use /mechanictablet, open the Admin App, and create a public LS Customs.

👉 See the [LS Customs Setup Guide] →

Using Mechanic Shops & LS Customs

• Go to a mechanic business or LS Customs location

• Press the interaction key (default: E) to open the customs menu

Access methods can be changed in config.lua.

👉 See the [Usage Guide] →

8

8. Set Up Discord Logging

Configure Discord Logging Webhooks

The script can send important action logs to Discord using webhooks. These webhook settings can be edited in cd_mechanic/configs/server_webhooks.lua.

• Admin Business Actions Logs when an admin creates, edits, or deletes a mechanic business.

• Admin Customs Actions Logs when an admin creates, edits, or deletes a public LS Customs.

• Boss business Purchase Logs when a business boss purchases upgrades, including what was bought, the quantity, and the total cost.

• Mechanic Shop Purchase Logs when mechanic employees purchase items from the mechanic shop.