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

# Configuration

Which files you can edit, and where each setting lives.

The core of the script is protected, but everything you might want to change is in **open files**:

```
Chapo_Crafting/
├── config/                   ← everything you configure
│   ├── config.lua            ← general: language, framework, permissions, rules, stash, placement, UI, logs
│   ├── benches.lua           ← bench types + static map benches
│   ├── recipes/
│   │   ├── _README.lua       ← the recipe manual (every field explained)
│   │   ├── tools.lua         ← one file = one category = one tab on the bench
│   │   ├── medical.lua
│   │   ├── weapons.lua
│   │   └── attachments.lua
│   ├── progression.lua       ← bench XP → level curve
│   ├── mastery.lua           ← the player perk tree
│   ├── condition.lua         ← wear + maintenance kits
│   ├── blueprints.lua        ← optional blueprint gates
│   ├── npcs.lua              ← hidden NPC vendors (server only)
│   ├── npc_display.lua       ← NPC visuals
│   ├── models.lua            ← bench props + screen / camera placement (advanced)
│   └── locales/              ← en.lua, ar.lua
├── bridge/                   ← framework, inventory, housing and client integrations
└── install/                  ← items to paste + optional SQL
```

{% hint style="info" %}
After editing a config file, **restart the resource** (`restart Chapo_Crafting`). Benches, levels, the craft queue, stashes and perks are stored in MySQL and are kept. Removing a recipe refunds any crafts still queued for it.
{% endhint %}

## Settings by topic

| Page                                                                                     | What's inside                                                                                 |
| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| [General](/visionstore-docs/scripts/crafting/configuration/general.md)                   | Language, framework, admin command, permissions, crafting rules, distances, keys, UI, logging |
| [Recipes and categories](/visionstore-docs/scripts/crafting/configuration/recipes.md)    | Add, edit or remove recipes, new tabs, every recipe option, blueprints                        |
| [Bench types](/visionstore-docs/scripts/crafting/configuration/benches.md)               | Which tabs a bench shows, who may use it, bench items, static map benches                     |
| [Bench levels](/visionstore-docs/scripts/crafting/configuration/progression.md)          | The XP → level curve, per-category levels                                                     |
| [Crafting Mastery](/visionstore-docs/scripts/crafting/configuration/mastery.md)          | The player perk tree, slots, XP and anti-farm rules                                           |
| [Wear and maintenance](/visionstore-docs/scripts/crafting/configuration/condition.md)    | How benches wear, condition stages and the three maintenance kits                             |
| [Bench stash](/visionstore-docs/scripts/crafting/configuration/stash.md)                 | The per-bench ox\_inventory stash and its upgrade levels                                      |
| [Placement](/visionstore-docs/scripts/crafting/configuration/placement.md)               | Ghost / gizmo placement, validation rules, no-build zones                                     |
| [Hidden NPC vendors](/visionstore-docs/scripts/crafting/configuration/npc-vendors.md)    | NPCs that sell benches through a material challenge, police custody                           |
| [Bench props and the screen](/visionstore-docs/scripts/crafting/configuration/models.md) | Add a new bench prop and line up the 3D screen with `/craftingcalibrate`                      |

## Languages

Set `Config.Locale` to `'en'` or `'ar'`. To add a language:

1. Copy `config/locales/en.lua` to `config/locales/<code>.lua` (for example `config/locales/fr.lua`).
2. Change `Locales['en']` to `Locales['fr']` and translate the values (keep the keys and the `%s`).
3. Set `Config.Locale = 'fr'`.

Missing keys automatically fall back to English.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://visionstore.gitbook.io/visionstore-docs/scripts/crafting/configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
