Configuration

lation chop shop has no Lua config file. Every option lives in the database (the lation_chopshop_config table, one row per section) and is changed in game under /chopadmin > Config, where a save reaches the server and every player at once. The panel itself is covered on the admin panel page.

On the first start, each section is seeded from lua/shared/defaults.lua, and the defaults on this page are what that file holds. After that, editing the file changes nothing on your server except what a reset puts back.

The sections below follow the Config page, and each lists its options in the order of its cards. The key is the option's path in an export, for example contracts.allowCancel, and the shape GetRuntimeConfig returns. Options marked restart apply after lation_chopshop restarts; everything else applies as it saves.

SetupCopy Anchor Link

Four cards: General, Integrations, Jobs and Chop menu.

A player whose job changes to or from a blacklisted one sees the blips go or come back at once.

The custom options do nothing until you add your code: interaction in lua/client/utils/interact.lua, everything else in lua/client/utils/ui.lua.

StartCopy Anchor Link

Five cards: Broker, Opening hours, Police, Vehicles and Map blip. The broker ped is where players take contracts and use the shops.

The ped spawns when a player comes within 100 meters during its hours. A change to the locations, their peds or the blip moves, adds or removes the peds and blips for everyone at once.

With Allow owned vehicles off, the plate is checked on the server when a chop starts, against owned_vehicles (ESX) or player_vehicles (QBCore and Qbox), as the game reads it and trimmed. A plate's answer is kept for a minute.

A car of a blacklisted model is never chopped or counted toward a contract. Start chopping still shows on one whose class matches, and picking it tells the player the shop won't take the model; a contract holder who takes the wheel of one hears it then. Blacklisting a model while one is being chopped lets that car go: nothing more comes off it, its stands can still be taken off, and the contract is free for another car.

ContractsCopy Anchor Link

Three cards: General, Bonus payout, and Tiers and classes.

TiersCopy Anchor Link

Each tier is one kind of contract. When a player asks for a contract, the script finds every tier with a minimum level at or below theirs that still has an allowed class, picks one at random with equal odds, then picks one of its classes at random.

Tiers are stored under contracts.tiers.<key>. Add asks for the key: lowercase letters, digits, underscores and dashes. The defaults:

Vehicle class idsCopy Anchor Link

These are GTA's vehicle classes, used in allowedClasses and vehicleClasses.

LocationsCopy Anchor Link

By default players can chop anywhere. Turn on the restriction to limit chopping to set areas. Two cards: Zones and Map blips.

Location blips only show while Restrict chop locations is on.

ItemsCopy Anchor Link

Three cards: Tools, Salvaged parts, and Jack stands and drill.

If you rename an item here, the new name works straight away and the old one stops doing anything, but the new one still has to exist in your inventory.

MinigamesCopy Anchor Link

Five cards: Wheels, Doors, Torque spin, Connector unclip and Rapid tap.

The torque and tap rates take steps of 0.5. The server refuses a part claimed less than 1.5 seconds after it was started. If the number of fasteners times the hold time would come in under about 1.7 seconds, the hold time is raised automatically so honest players are never refused.

ExperienceCopy Anchor Link

Level ladder lists the total XP needed to reach each level, up to 50 levels. XP per part is the range a player gets for each part, rolled between the least and the most for the level they are at when it comes off.

Keys are experience.levels.<level> and experience.rewards.<level>.xp.min / .max. Level 1 is the start and stays at 0. Add a level adds one on top and Remove the top level takes the highest away, so the highest level is the number of levels. Doors pay half the rolled XP, since a car has four of them.

A change to the ladder applies to every player: those online move to the level their XP reaches (a player it lifts is told), and the stored levels the leaderboard reads are updated.

ShopsCopy Anchor Link

The broker has two built-in shops, in two cards: Tool shop and Swap shop. A player must be within 15 meters of an active broker to buy or swap, and an entry with a level above 0 needs at least that level.

The section opens with a short pitch for lation shops, for anything more than these two. Dismissing it folds it into a Shops chip in the panel's header, which brings it back. Neither shows on a server that has lation_shops installed.

Tool shopCopy Anchor Link

Swap shopCopy Anchor Link

Players turn salvaged parts in for cash, an item, or both.

Set payout to 0 for an item-only trade. A swap with no payout and no reward item is refused, so players never lose parts for nothing.

LoggingCopy Anchor Link

Three cards: Service, Events and Discord. The keys start with logs.

The Discord options are greyed out unless the service is Discord. Turn on the events you want under logs.events:

The Logging section is never sent to players' game clients, so the webhook URL stays on the server. An export does hold it.

Files you can still editCopy Anchor Link

A few things are plain Lua files, read when the resource starts. Restart lation_chopshop after editing them.

LanguageCopy Anchor Link

Every string is in locales/en.json, the only language that ships. To translate, copy it to a new file such as locales/de.json and translate the values.

The admin panel and the in-game screens (contract, minigames, engine bay) read the lation:locale convar, which every lation script reads, unless lation_chopshop:locale gives this one its own. Notifications, menus and prompts go through ox_lib's locale, which follows its own ox:locale setting.

setr lation:locale de
setr ox:locale de

If a file for the chosen language is missing, English is used.