> For the complete documentation index, see [llms.txt](https://dynyx-scripts.gitbook.io/dynyx-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dynyx-scripts.gitbook.io/dynyx-scripts/chop-shop/installation-and-configuration.md).
# Installation & Configuration
{% stepper %}
{% step %}
### Add the Resource
**Drag the `dynyx_chopshop` folder into your `resources` directory.**\
Make sure it’s correctly placed, then add `ensure dynyx_chopshop` to your `server.cfg` to activate the script on server startup.
{% endstep %}
{% step %}
### Install **Dependencies**
**Ensure all required dependencies are installed and updated.**\
This includes your core framework (e.g., QBCore), your inventory system (e.g., ox\_inventory or qb-inventory), and any targeting systems (e.g., ox\_target or qb-target).
{% endstep %}
{% step %}
### Configure Inventory Compatibility
**Navigate to the `inventory` folder.**\
You’ll need to follow a specific setup guide based on your inventory system.\
Item images used in the chop shop system can be found inside the `images` folder for easy reference.
* [ox\_inventory](/dynyx-scripts/chop-shop/installation-and-configuration/ox_inventory.md)
* [qb-inventory](/dynyx-scripts/chop-shop/installation-and-configuration/qb-inventory-ps-inventory.md)
{% endstep %}
{% endstepper %}
## Configuration:
```lua
Config = {}
Config.Notifications = "ox" -- Notification system to use: "ox" for ox_lib notifications, "qb" for qb-core notifications
Config.Target = "ox_target" -- Target system: "ox_target" for Ox Target, "qb-target" for QB Target
Config.Inventory = "ox_inventory" -- Inventory system: "ox_inventory" for Ox Inventory, "qb-inventory" for QB Inventory
Config.ProgressBar = "ox_lib" -- Progress bar system: "ox_lib" for Ox Lib, "qb-core" for QB Core Progress Bar
Config.MinCops = 0 -- Minimum number of police officers required to start the job
Config.PoliceJob = 'police' -- Job name for police officers in the server
Config.Dispatch = 'none' -- Dispatch system: "orgien_police", "qs-dispatch", "core_dispatch", "ps-dispatch", or "none" if no dispatch is used
Config.Phone = "qb-phone" -- Phone system: "qb-phone", "roadphone", "qs-smartphone", "lb-phone"
Config.WaitListTimer = 0 -- Time (in seconds) before a player can get a job after speaking to the boss
Config.Cooldown = 30 -- Cooldown (in seconds) after completing the job before being able to start another one
Config.img = "ox_inventory/web/images" -- Directory where inventory item images are stored
Config.LockVehicle = false -- If set to true, the chop vehicle will be locked
Config.TrunkItem = "cartrunk" -- Item required to interact with or remove the trunk
Config.HoodItem = "carhood" -- Item required to interact with or remove the car hood
Config.DoorItem = "cardoor" -- Item required to interact with or remove the car door
Config.WheelItem = "carwheel" -- Item required to interact with or remove the car wheel
Config.Reward = { -- Reward when you chop a vehicle's part
ChopTrunk = {
"steel",
"money",
"phone",
"plastic",
},
ChopHood = {
"aluminum",
"money",
"iron",
"plastic",
},
ChopDoor = {
"aluminum",
"money",
"radio",
"iron",
},
ChopWheel = {
"rubber",
"steel",
"plastic",
},
ScrapVehicle = {
"metalscrap",
"rubber",
}
}
Config.RewardAmountMin = 2 -- Min amt of per reward item
Config.RewardAmountMax = 5 -- Max amt of per reward item
Config.RewardAmountChance = 80 -- Chance of Getting a reward
Config.SpecialReward = { -- Special Reward when you chop a vehicle's part
"crack_baggy",
"diamond_ring",
"meth",
"10kgoldchain",
"rolex",
}
Config.SpeicalRewardMin = 1 -- Min amt of per reward item
Config.SpecialRewardMax = 3 -- Max amt of per reward item
Config.SpecialRewardChance = 50 -- Chance of Getting a reward
Config.BreakDownPartsLocation = vector3(471.7, -1312.21, 29.22) -- Where you break down the vehicle parts into material
Config.BreakDownPartsReward = { -- Reward when you break down a vehicle part
ChopTrunk = {
"steel",
"money"
},
ChopHood = {
"aluminum",
"money"
},
ChopDoor = {
"aluminum",
"money"
},
ChopWheel = {
"rubber",
"money"
},
}
Config.BreakDownPartsMin = 10 -- Min amt of per part item
Config.BreakDownPartsMax = 25 -- Max amt of per part item
Config.BossCoords = { -- You can add multiple locations (Every Restart a new location is selected)
vector4(683.5137, -789.3112, 24.4957, 357.9453)
}
Config.ChopCarLocations = { -- Location where the Car you have to steal spawns at
vector4(59.6679, -849.2748, 30.8152, 343.5621),
vector4(-438.4437, -459.8052, 32.6085, 352.0847),
vector4(-921.9538, -169.2906, 41.8765, 206.7782),
vector4(906.7933, 3589.7756, 33.2219, 268.3691),
vector4(1557.4805, 3788.2549, 34.0967, 27.9620),
vector4(2466.0042, 4074.6331, 38.0647, 62.0357),
vector4(393.3818, -641.5439, 28.5004, 268.0425),
}
Config.DisassembleVehLocations = { -- Locaiton where you chop down the car into pieces
vector4(2349.9409, 3134.6299, 48.2087, 258.7731),
vector4(1541.5659, 6335.5615, 24.0756, 58.8045),
vector4(1431.5463, 6333.3398, 23.9940, 194.7919),
vector4(437.6965, 3523.0012, 33.6073, 273.1766),
vector4(1528.7623, 1703.4760, 109.8092, 263.3474),
}
Config.ChopCarVehicles = { -- Vehicle Spawn Name that the buyers will drive up in
'sultan',
'habanero',
'gresley',
'fq2',
'felon',
'zion',
'jackal',
'sentinel',
'asea',
'glendale',
'ingot',
'surge'
}
Config.Peds = { -- Boss Peds
"g_m_y_salvaboss_01",
"a_m_m_og_boss_01",
"a_m_m_paparazzi_01",
"a_m_m_socenlat_01",
"a_m_y_cyclist_01",
"a_m_y_vinewood_02",
"a_m_y_smartcaspat_01",
"g_m_m_casrn_01",
"g_m_m_chicold_01",
"g_m_m_armlieut_01",
"mp_m_bogdangoon",
"mp_f_execpa_02",
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://dynyx-scripts.gitbook.io/dynyx-scripts/chop-shop/installation-and-configuration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.