# Commands

All commands can be renamed in `cfg.lua` — the names documented below are the defaults.

***

### Client Commands

#### `/nitrobar`

Toggles the nitrous HUD bar on/off for the vehicle the player is currently driving.

**Config key:** `cfg.general.nitrous.commands.nitrobar` (default: `"nitrobar"`)

**Usage:** `/nitrobar`

**Preconditions**

| Check                                | Error message (locale key) |
| ------------------------------------ | -------------------------- |
| Player must be in a vehicle.         | `nitrobar_not_in_vehicle`  |
| Vehicle must have nitrous installed. | `nitrobar_no_nitro`        |

***

#### `/move_nitrobar`

Enters drag mode so the player can reposition the nitrous HUD bar on their screen.

**Config key:** `cfg.general.nitrous.commands.move_nitrobars` (default: `"move_nitrobar"`)

**Usage:** `/move_nitrobar`

**Preconditions**

| Check                                | Error message (locale key) |
| ------------------------------------ | -------------------------- |
| Player must be in a vehicle.         | `nitrobar_not_in_vehicle`  |
| Vehicle must have nitrous installed. | `nitrobar_no_nitro`        |

***

#### `/reset_nitrobar`

Resets the nitrous HUD bar to its default screen position.

**Config key:** `cfg.general.nitrous.commands.reset_nitrobars` (default: `"reset_nitrobar"`)

**Usage:** `/reset_nitrobar`

***

### Server Commands

#### `/givenitro`

Admin command. Adds nitrous tanks to the target player's current vehicle.

**Config key:** `cfg.givenitroCommand` (default: `"givenitro"`)

**Usage:** `/givenitro [playerid] [count]`

**Parameters**

| Name       | Type     | Required | Description                                         |
| ---------- | -------- | -------- | --------------------------------------------------- |
| `playerid` | `number` | Yes      | Target player's server ID.                          |
| `count`    | `number` | No       | Number of tanks to add. Defaults to `1` if omitted. |

**Authorization**

Allowed if **either** of the following is true:

* The caller has the `command` ACE permission, **or**
* One of the caller's identifiers is listed in `cfg.givenitroAlloweds` (`steam:`, `license:`, `license2:`, `fivem:`).

**Preconditions**

| Check                                   | Error message (locale key)        |
| --------------------------------------- | --------------------------------- |
| Target player must be online.           | `givenitro_player_not_online`     |
| Target player must be inside a vehicle. | `givenitro_player_not_in_vehicle` |

**Behavior**

Adds the requested amount of nitrous tanks to the target vehicle, clamped to the vehicle's per-model maximum (`cfg.general.nitrous.nitro_tanks`). The caller receives a success notification.

**Example**

```
/givenitro 12 2
```

Gives `2` nitrous tanks to the player with server ID `12`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rainmad.com/resources/3d-tuning-tablet/commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.