> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/3d-tuning-tablet/commands.md).

# 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`.