Studios
Chop Shophouse-3.jpg

Configuration

SoonChop ShopQBCore · Qbox · ESX
PAGE 03 OF 07  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

The config files are open in the escrow. config/shared.lua is loaded on the client and the server. config/server.lua is only loaded on the server. All player-facing text is in locales/en.json.

Yards#

Each table in Config.Yards is one yard. Add a table to add a yard; ids must be unique.

Field What it does
id Unique key. It is also used in /chopadmin end <yard> and in the GlobalState key chop:<id>.
label Shown on the blip, the task list and the tablet map.
bossModel Ped model of the yard boss.
bossOutfit Optional fixed look: components = { { component, drawable, texture }, ... } and props = { { prop, drawable, texture }, ... }.
bossPose Optional looped pose instead of Config.BossScenario, for example sitting on a chair (dict, clip, optional chair, chairOffset, chairHeading, offsetZ).
boss Where the boss stands (vec4). He is placed and frozen at exactly this z, so use the z a coords tool shows while you stand on the spot.
bay Where the car is moved and frozen while it is stripped (vec4).
dropRadius How close the car must be to the bay for a drop-off. Default 25.0.
bucket Routing bucket the yard is in. Default 0.
blip { enabled, sprite, color, scale }. Off by default, since chop shops are word of mouth.

config/shared.lua#

Setting Default What it does
Config.Debug false Prints log lines to the server console.
Config.Bridge 'auto' 'auto' uses glitch-abstraction when it is installed and qbx_core, ox_inventory and ox_target otherwise. 'abstraction' or 'qbox' forces one.
Config.PauseMenuLegend true Sends yard names to glitch-pauseMenu's map legend when blips are on.
Config.BossSpawnDistance 80.0 The boss ped spawns when a player is this close.
Config.BossScenario 'WORLD_HUMAN_CLIPBOARD' Idle scenario for bosses without a bossPose.
Config.TargetDistance 2.0 Target reach for the boss.
Config.PartDistance 1.8 Target reach for car parts.
Config.Anims Table weld, crouch and engine animations used while removing parts.
Config.CarryProps Table Prop model, bone, pos and rot for each carried part kind (door, bonnet, wheel, engine, box).
Config.CarryAnim anim@heists@box_carry@ / idle Animation while carrying a part.
Config.Parts Table Every part. See below.
Config.SkillCheck Table Skill check keys (w, a, s, d) and the checks per level band.
Config.DispatchAlert Function Client-side police alert. ps-dispatch and cd_dispatch are filled in.
Config.Interactions Table The rc-interactions yard boss dialogue.

Parts#

Each entry in Config.Parts has:

Field What it does
label, progress, icon Target option text, progress text and icon.
bone Vehicle bone the target option sits on. A car without that bone gets no option.
door / wheel Door index (0 FL, 1 FR, 2 RL, 3 RR, 4 hood, 5 trunk) or wheel index (0 LF, 1 RF, 2 LR, 3 RR) broken off when the part is removed.
requires Another part that has to come off first.
anim Config.Anims key.
duration Base progress time in ms. Perks shorten it.
hard Adds one extra skill check.
carry Config.CarryProps key.
salvage Always given on hand-in: { item, min, max }.
bonus Chance (0 to 1) of one extra roll on the pool.
rolls Roll the pool this many times. Used instead of salvage on the trunk, engine bay and dashboard.
pool { item, tier 1-4, min, max } entries. A roll first picks a tier with the level-scaled odds, then an item of that tier.

Skill checks#

Config.SkillCheck.bands picks the checks by chopping level. The highest band the player reaches is used:

Level Checks
0 and up easy, medium, medium
6 and up easy, easy, medium
12 and up easy, easy

A part with hard = true adds one medium check. Each rank of the chop_skill perk removes one check, down to a minimum of one.

Yard boss dialogue#

Setting Default What it does
useRcInteractions true Targeting the boss shows "Talk to the yard boss", and the conversation runs every action. Falls back to the plain target options when rc-interactions or the flow is missing.
projectId '' The flow's UUID. Leave it empty to find the flow by projectName.
projectName 'Chop Shop - Yard Boss' Name the server looks up in rc-interactions. Imported copies saved as <name> (Imported) also match.
keepTargetOptions false Keep the plain options next to "Talk".

config/server.lua#

Setting Default What it does
BayMinutes 10 How long a car may sit in the bay before the yard crushes it.
CooldownMinutes 30 Per-character cooldown, started at drop-off. Kept in resource KVP, so it survives relogs and restarts.
MinTimeFraction 0.6 A part finished faster than this share of its progress time is refused and logged as suspicious.
PartRange 6.0 Max distance between the player and the car for part checks.
BossRange 5.0 Max distance between the player and the boss.
ClearBayCooldown 30 Seconds between two "Clear the bay" requests per player.
NetGuard true Runs the glitch-poolcleaning net event guard when that resource is installed. Does nothing without it.
RejectOwned true Refuses cars whose plate is in the owned vehicles table.
OwnedVehicleTable 'auto' owned_vehicles on ESX, player_vehicles on QBCore and Qbox. Set a name if yours differs.
VehicleTypes { automobile = true } Server GetVehicleType values that are accepted.
ModelWhitelist {} Only these models (lowercase spawn names). Empty means any car.
ModelBlacklist stockade, rhino, insurgent, insurgent2, barracks, riot, riot2 Models that are always refused.
AllowPoliceCars true Allows emergency vehicles.
PoliceModels Table Spawn names counted as emergency vehicles, on top of every Qbox shared vehicle with category emergency. Names of models you do not have are ignored.
PoliceLootMult 2 Salvage and roll counts are multiplied by this for emergency vehicles.
PoliceMinOnDuty 2 Police on duty needed to chop an emergency vehicle. 0 turns the check off.
PoliceJobs police, sheriff, bcso, sasp, lspd Jobs counted as police. Qbox counts job type leo; QBCore counts type leo or these names (on duty only); ESX counts these names.
TierWeights maxLevel = 20, min = { 65, 20, 12, 3 }, max = { 35, 30, 25, 10 } Loot tier weights at level 1 and at maxLevel, with a straight line in between.
FinishBonus minLevel = 15, chance = 0.35 A bonus item for the owner when a car is finished at a high level, rolled from its own pool.
XP Table category ('chopping'), perTier XP per handed-in item by tier, finish XP per finished car ({ 25, 50 }), and the perk caps maxPriceBonus (0.15) and maxAlertCut (0.40).
Tablet jobId = 'chop', minParts = 4 glitch-criminaltablet reporting. A car counts as finished for the tablet, XP and the finish bonus when at least minParts parts were handed in.
Selling mode = 'auto', dirty = true, dirtyItem = 'black_money' Who buys the parts and how they pay, with a { min, max } price per item in prices.
Dispatch chance = 0.10, policeChance = 0.60, delay = { 20, 60 } Police alert chance on each drop-off, the chance for emergency vehicles, the delay in seconds, and the optional serverAlert function.

Selling modes#

mode Who buys
'auto' The tablet's Fence when glitch-criminaltablet is running, otherwise the yard boss.
'fence' Never at the yard. Needs the tablet or your own buyer.
'boss' The yard boss always buys, with or without the tablet.

If the Fence buys your parts, keep its sell list in step with ServerConfig.Selling.prices.

Default part prices#

Item Price per item
car_door, car_hood, muffler $47 to $78
car_wheel $59 to $99
car_mirror $23 to $43
car_headlight $31 to $55
steeringwheel $39 to $67
car_speakers $120 to $180
car_radio, car_brakes $140 to $220
car_battery $160 to $230
sport_rim $310 to $470
airbag $270 to $390
car_ecu $350 to $510
car_turbo $700 to $1000
catalytic_converter $620 to $940