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

# Installation

Step by step guide to install Complete Speedometer on your server.

### **How to download the script**

To download the asset, you need to have completed the purchase using your own Keymaster account.

Once your purchase is confirmed on our official website, the asset will appear in your Keymaster account. From there, you can download and install it by following the steps outlined in the documentation.

The download contains one folder, copy it into your server `resources` folder:

* `complete_speedometer`

{% hint style="info" %} <mark style="color:blue;">**If the asset was bought through a different account, you can transfer it via the Keymaster transfer system**</mark>
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**NOTE: Please do not edit the name of the downloaded folder, otherwise the script won't work properly**</mark>
{% endhint %}

### **Dependencies**

Complete Speedometer is standalone: it needs no framework, no database and no other resource. It works on ESX, QBCore, Qbox or any other framework.

{% hint style="warning" %} <mark style="color:orange;">**Using Complete HUD v3? It already includes a speedometer: don't start both resources together**</mark>
{% endhint %}

### **Start the script**

Add this line to your `server.cfg`:

```
ensure complete_speedometer
```

Restart the server and get in any vehicle: the speedometer appears automatically and hides when you get out.

### **Configuration**

Everything is in `complete_speedometer/config.lua`, the only file not encrypted:

* Screen position: `Config.UIPosition`
* km/h or mph: `Config.Km`
* Seatbelt indicator, key and sound: `Config.Seatbelt`, `Config.SeatbeltKey`, `Config.SeatbeltSound`
* High beams and open doors indicators: `Config.Headlight`, `Config.Door`
* Fuel script: `Config.GetFuel`

All the options are explained on the [Config](/complete-scripts/scripts/complete-speedometer/config.md) page.

{% hint style="info" %} <mark style="color:blue;">**If you already have a seatbelt script, call the**</mark> [<mark style="color:blue;">**setSeatbelt export**</mark>](/complete-scripts/scripts/complete-speedometer/exports.md) <mark style="color:blue;">**from it to light up the indicator**</mark>
{% endhint %}
