# 🎨 Script Customization Guide



### 🇬🇧 English Version

You are free to customize this script as much as you'd like! There are **three main files** where you can modify its behavior and appearance:

***

#### 1️⃣ `/server/config.lua`

This file is the heart of your server-side configuration.

*   🌐 **Language**: Set the default language using:

    ```lua
    Config.Locale = 'en' -- or 'fr', or your custom one
    ```

    You can create your own translations by adding a new file in the `/local` folder.
* 🛠️ **Crafting Configurations**:
  * Define crafting materials and their costs.
  * Set up how long each part takes to craft.
  * Adjust which parts are needed for each weapon.
*   📍 **Crafting Table Locations**: Set crafting table positions like so:

    ```lua
    Config.Tables = {
        vec3(2430.804443, 3158.096680, 48.741455),
    }
    ```

***

#### 2️⃣ `/client/config_client.lua`

This file manages client-side customization, especially user experience settings.

*   ⚙️ **Framework Selection**:

    ```lua
    Framework = 'qb' -- Can also be 'esx' or 'ox'
    ```

    `ox` refers to [ox\_lib](https://overextended.dev/ox_lib), which is supported but not required by default.
* 📢 **Notification Settings**: Choose whether to show prompts and what style of notification to use.
* 🧭 **Interaction Distance**: Set how close players must be to interact with crafting tables.

***

#### 3️⃣ `/html/js/workbench.js`

This file controls the **UI logic** for the crafting system.

* 🎨 **Themes and Language Switching**: Built-in support to dynamically change themes and languages.
* 🧱 **UI Structure**:
  * Allows showing materials needed.
  * Toggles categories.
  * Handles part and weapon selections.
* 🧰 No game-side logic or security is handled here — this file is purely for visual interactivity.

***

### 🇫🇷 Version Française

Vous pouvez **personnaliser votre script autant que vous le souhaitez** ! Trois fichiers principaux vous permettent de le configurer à votre guise :

***

#### 1️⃣ `/server/config.lua`

C’est le fichier principal côté serveur.

*   🌐 **Langue** :

    ```lua
    Config.Locale = 'fr' -- ou 'en', ou votre propre langue
    ```

    Vous pouvez créer une langue personnalisée dans le dossier `/local`.
* 🛠️ **Configuration des Fabrications** :
  * Définir les matériaux requis et leur coût.
  * Choisir le temps de fabrication de chaque pièce.
  * Déterminer quelles pièces sont nécessaires pour chaque arme.
*   📍 **Position des Tables de Craft** :

    ```lua
    Config.Tables = {
        vec3(2430.804443, 3158.096680, 48.741455),
    }
    ```

***

#### 2️⃣ `/client/config_client.lua`

Ce fichier permet de personnaliser les interactions côté client.

*   ⚙️ **Choix du Framework** :

    ```lua
    Framework = 'qb' -- Peut être aussi 'esx' ou 'ox'
    ```

    `ox` fait référence à [ox\_lib](https://overextended.dev/ox_lib) — il est compatible mais **pas requis par défaut**.
* 📢 **Notifications** : Activez ou désactivez les messages d’interaction et configurez leur style.
* 🧭 **Distance d’Interaction** : Déterminez à quelle distance un joueur peut interagir avec une table.

***

#### 3️⃣ `/html/js/workbench.js`

Ce fichier gère l’interface utilisateur (UI) du système de fabrication.

* 🎨 **Thèmes et Langues** : La sélection de la langue et du thème se fait dynamiquement.
* 🧱 **Structure de l’interface** :
  * Affichage des matériaux nécessaires.
  * Catégories de pièces repliables.
  * Sélection intuitive d’armes et de pièces.
* 🧰 Ce fichier est uniquement dédié à l’apparence et l’interactivité, pas à la logique serveur.
