Chop Shop

addPlayerData

Adds an amount to a player’s specified data field. Adding to exp also handles leveling up, including the level-up notification and log.

exports.lation_chopshop:addPlayerData(source, type, amount)

number

required

The source (player ID) to add data to.

string

required

The data field to modify: "level", "exp", "vehicles" or "parts".

number

required

The amount to add to the specified data field.

issueContract

Issues a contract to a player exactly as the broker would: the same blacklist, cooldown, police-count, tier and inventory checks apply, and the player is notified of the result. Use it to hand out contracts from your own script, phone or job.

exports.lation_chopshop:issueContract(source)

number

required

The source (player ID) to issue the contract to.

getContract

Returns the player’s raw contract record, or nil when they have none.

local contract = exports.lation_chopshop:getContract(source)

number

required

The source (player ID) to look up.

{
  tierId        = "street",   -- key of the tier in /chopadmin -> Contracts
  vehicleClass  = 1,          -- GTA vehicle class id the contract asks for
  cashBonus     = 500,        -- on-time completion bonus
  issuedAt      = 1757650000, -- unix time
  expiresAt     = 1757653600, -- unix time
  bonusEligible = true,       -- false once the clock has run out
  activeNetId   = nil,        -- the vehicle net id once a chop is in progress
}

getContractDetails

Returns the same information the contract case file displays, with labels resolved and the remaining time computed. Always returns a table.

local details = exports.lation_chopshop:getContractDetails(source)

number

required

The source (player ID) to look up.

{
  status            = "active",    -- "none", "active", "in_progress" or "expired"
  tierId            = "street",
  tierLabel         = "Street",
  vehicleClass      = 1,
  vehicleClassLabel = "Sedans",
  issuedAt          = 1757650000,
  expiresAt         = 1757653600,
  remainingSeconds  = 3210,
  cashBonus         = 500,
  bonusEligible     = true,
  account           = "cash",      -- where the bonus is paid: cash, bank or an item name
  accountIsMoney    = true,
}

When the player has no contract the table is just { status = "none" }.

GetRuntimeConfig

Returns the live configuration as edited in /chopadmin. Pass a section name for that section only, or omit it for every section.

local contracts = exports.lation_chopshop:GetRuntimeConfig("contracts")
local everything = exports.lation_chopshop:GetRuntimeConfig()

string

One of setup, start, experience, contracts, locations, minigame, items, shops or logs.

getPlayerData and getLevelData are also available on the server. See the Shared page.

Hooks

Server hooks live in lua/server/utils/hooks.lua, which ships open under escrow. Edit the functions in place to add your own rules and reactions.

Function	Purpose
`Hooks.CanDoChopping(source, notify)`	Return `false` to block a player from every chop shop feature. Runs the blacklisted-jobs check by default.
`Hooks.CanRequestJob(source)`	Return `false` to stop a player being issued a contract.
`Hooks.CanParticipate(source, netId)`	Return `false` to stop a player helping on an active chop vehicle. Checks the blacklist and distance to the vehicle by default.
`Hooks.GetContract(source)`	Returns the player’s contract record.
`Hooks.IsInitiator(source, netId)`	Returns `true` when this player started the chop on that vehicle.
`Hooks.VehiclePartRemoved(source, entity, model, typeId, boneId)`	Called after every part reward. `typeId` is `wheel`, `door` or `mock` (engine bay); `boneId` is the part id. Empty by default; a good place for custom rewards.

Looking for an export we don’t have listed here? Contact us and we’ll do what we can!

Weed

Coke

Meth

Modern Shops

Money Laundering

Metal Detecting

Scuba Diving

Drug Sales

Banking

Interact

Modern UI

Chop Shop - Exports - Server

addPlayerData

issueContract

getContract

getContractDetails

GetRuntimeConfig

Hooks

​addPlayerData

​issueContract

​getContract

​getContractDetails

​GetRuntimeConfig

​Hooks

addPlayerData

issueContract

getContract

getContractDetails

GetRuntimeConfig

Hooks