> For the complete documentation index, see [llms.txt](https://docs.space101.store/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.space101.store/product-guides/smart-arges-script.md).

# Smart Arges Script

## Step 1 - Installation

To get started, you'll need to download your new resource previously purchased from our [`store`](https://space101.store/). For that, you must login with your account on [`keymaster`](https://keymaster.fivem.net/asset-grants/) and look for the Asset Grants section, there we will find our script.

<figure><img src="/files/CHo5zn1xXv4iEnywZQAF" alt=""><figcaption></figcaption></figure>

## Step 2 - Configuration

#### UI Command

* **`Config.UICommand`** defines the in-game command players use to open the Arges spotlight UI.
* Example: `argesUI` → players type `/argesUI` in chat to open it.
* You can change this to any command string you prefer.
* `Config.DefaultKeybind` The Default Keybind assigned to new players upon joining

#### Vehicles

```lua
Config.Sweep = {
    Speed = 7.0,             -- How fast the Arges sweeps
    MaxAngle = 120           -- How far the Arges sweeps at its widesst point
}
```

* The **`Config.Vehicles`** section stores spotlight setups for each vehicle.
* Each entry is keyed by the vehicle’s **spawn name** (e.g., `19tahoeslic`).
* Inside each vehicle, you can configure up to two spotlights:
  * **FirstLight** → usually the driver’s side.
  * **SecondLight** → usually the passenger’s side.

#### Light Components

Each light is built from three parts, which attach to one another in sequence:

1. **`arges_addon_base` (THIS SHOULD BE THE ONLY THING YOU NEED TO CHANGE)**    &#x20;
   * Attaches directly to the vehicle model.
   * Has a `use` option (`true` = enabled, `false` = disabled).
   * The `location` values (`x, y, z`) determine placement on the vehicle body.
2. **`arges_base`**
   * Attaches to the addon base.
   * Controls the positioning of the spotlight housing.
3. **`arges_head`**
   * Attaches to the base.
   * Represents the light head where the beam comes from.
   * Small adjustments fine-tune the beam’s direction.

{% hint style="info" %}
`SecondLight` is **OPTIONAL**, you can leave it out of the config if you do not want it
{% endhint %}

Compatible models:

* GM Tahoe
* Matt's 2018 Charger
* Kanes 2020 FPIU