> For the complete documentation index, see [llms.txt](https://kazescripts.gitbook.io/kazescripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kazescripts.gitbook.io/kazescripts/kaze_chopshop/configuration.md).

# Configuration

Where every setting lives, and the ones you are most likely to change.

All settings are in `kaze_ChopShop/shared/config/`. These files are not encrypted.

| File                      | What is in it                                                               |
| ------------------------- | --------------------------------------------------------------------------- |
| `main.lua`                | Debug, shop laptop, crew invites and keys, pager and hot offers             |
| `tiers.lua`               | XP settings and the 5 tiers                                                 |
| `contract.lua`            | Vehicle search, tracker, door hack and hotwire, guards and dogs             |
| `chop.lua`                | Chop yards, chopping, parts, scrap materials, minigames                     |
| `seller.lua`              | Parts buyer, payment and prices                                             |
| `warehouses.lua`          | Warehouse limits, broker, storage, upgrades, creator, photos                |
| `interiors.lua`           | Warehouse interiors, their looks and designer props                         |
| `chopshop_locations.lua`  | Written by the creator: laptops, yards, areas, meets, broker, blip switches |
| `warehouse_locations.lua` | Written by the creator: warehouses for sale                                 |

Framework, inventory, target, keys and dispatch are set in `kaze_lib/config.lua`.

{% hint style="info" %}
The two `_locations.lua` files are written by the in-game creator. You can edit them by hand, but the creator rewrites them on save.
{% endhint %}

## main.lua

| Option                 | Default          | What it does                                                      |
| ---------------------- | ---------------- | ----------------------------------------------------------------- |
| `Config.Debug`         | `false`          | Debug prints and tools (`/chopshop_place`, `/chopshop_carry`)     |
| `Laptop.Mode`          | `'dui'`          | `'dui'` shows the UI on the laptop screen, `'tablet'` full screen |
| `Laptop.ActiveCount`   | `1`              | Laptops picked from your laptop spots each restart. `0` = all     |
| `Laptop.SpawnDistance` | `40.0`           | Range where the laptop prop is created                            |
| `Group.InviteRadius`   | `15.0`           | Invited players must be this close                                |
| `GroupTier`            | `'captain'`      | Crew contract tier: `'captain'` or `'lowest'` in the crew         |
| `PromptKeys`           | Y / X            | Accept and decline keys                                           |
| `Pager.Required`       | `true`           | The captain needs a pager to start                                |
| `Pager.HotOffers`      | on, every 10 min | Random hot contracts with bonus XP                                |

## contract.lua

| Option                | Default  | What it does                                 |
| --------------------- | -------- | -------------------------------------------- |
| `Run.ZoneRadius`      | `250.0`  | Size of the search zone on the map           |
| `Run.TargetSpread`    | `150.0`  | How far from the area centre the car can be  |
| `Tracker.GiveOnStart` | `false`  | Give the captain a tracker if they have none |
| `Steal.Relay`         | 25 s     | Door hack time and hold time                 |
| `Steal.Wiring`        | 35 s     | Hotwire time and penalty                     |
| `Security`            | per tier | Guards and dogs, see Tiers and XP            |

## chop.lua

| Option                   | Default  | What it does                                                                           |
| ------------------------ | -------- | -------------------------------------------------------------------------------------- |
| `Yards.Blip`             | shown    | Yard blip: `show`, `sprite`, `color`, `scale`                                          |
| `Yards.Radius`           | `5.0`    | Stop this close to deliver                                                             |
| `Yards.Marker`           | `false`  | Red delivery circle on the ground                                                      |
| `Chop.TimeLimit`         | `25`     | Minutes to take the car apart                                                          |
| `Chop.Interaction`       | `'auto'` | `'auto'` follows kaze\_lib, `'textui'` or `'target'`                                   |
| `Chop.FailDamage`        | `25`     | A failed minigame damages the part by this %                                           |
| `Chop.Minigames`         |          | Settings of each chop minigame                                                         |
| `Types.<part>.materials` | per part | Scrap materials given per part, see [Chopping](/kazescripts/kaze_chopshop/chopping.md) |

## seller.lua

| Option           | Default        | What it does                                          |
| ---------------- | -------------- | ----------------------------------------------------- |
| `ResponseTime`   | 60 - 120 s     | Time before the buyer pages back                      |
| `Minutes`        | `15`           | How long the buyer waits                              |
| `Cooldown`       | `10`           | Minutes between requests                              |
| `Account`        | `'dirty'`      | `'cash'`, `'bank'` or `'dirty'`                       |
| `Item`           | `nil`          | Pay with an item instead, for example `'markedbills'` |
| `Prices`         |                | Base price per part                                   |
| `TierMultiplier` | D 1.0 to S 2.4 | Price multiplier per tier                             |

## warehouses.lua

| Option                      | Default            | What it does                                        |
| --------------------------- | ------------------ | --------------------------------------------------- |
| `MaxOwned`                  | `1`                | Warehouses one character can own                    |
| `MaxKeys`                   | `5`                | Key holders per warehouse                           |
| `SellRefund`                | `0.5`              | Part of the price paid back on sale                 |
| `Broker.blip` / `OwnedBlip` | shown              | Blip settings, `show = false` hides them            |
| `Storage`                   | 40 slots           | Base storage size                                   |
| `Upgrades`                  |                    | Power Tools, Parts Yield and Storage Racks levels   |
| `Creator.Ace`               | `'kazechop.admin'` | Permission for `/chopshop_creator`                  |
| `Photos`                    | webp, 1280x720     | Warehouse photo size and the screencapture resource |

{% hint style="info" %}
Warehouse photos are uploaded to Fivemanage. Put the key in `server.cfg`, never in a config file: `set kaze_chopshop_fivemanage_key "your-key"`
{% endhint %}