> 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/exports.md).

# Exports

All exports are accessible via `exports.rm_3dtuning:<name>(...)`.

***

### Client Exports

#### `getNitroData(plate)`

Returns current client-side nitrous state for the given vehicle plate.

**Parameters**

| Name    | Type     | Description                              |
| ------- | -------- | ---------------------------------------- |
| `plate` | `string` | Vehicle plate (auto-trimmed internally). |

**Returns**

| Type           | Description                                               |
| -------------- | --------------------------------------------------------- |
| `table \| nil` | Nitrous state object, or `nil` if vehicle has no nitrous. |

**Return shape**

| Field         | Type                 | Description                                          |
| ------------- | -------------------- | ---------------------------------------------------- |
| `hasnitro`    | `boolean`            | `true` when at least one tank is installed.          |
| `tanks`       | `integer`            | Total number of installed tanks.                     |
| `tankLevels`  | `table<int, number>` | 1-indexed map, each entry `0–100` (percent drained). |
| `currentTank` | `integer`            | Index of the tank currently being consumed.          |

**Example**

```lua
local data = exports.rm_3dtuning:getNitroData('ABC1234')
if data and data.hasnitro then
    print(('tanks=%d currentTank=%d'):format(data.tanks, data.currentTank))
end
```

***

#### `isNitroActive()`

Returns whether the local player is actively holding the nitrous activation key right now.

**Parameters** — none.

**Returns**

| Type      | Description                             |
| --------- | --------------------------------------- |
| `boolean` | `true` while nitrous is being consumed. |

***

#### `getVehicleFeatures(plate)`

Returns the tablet menu toggle states for the given vehicle.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type    | Description             |
| ------- | ----------------------- |
| `table` | Feature-to-boolean map. |

**Return shape** (all fields are `boolean`)

| Field              | Description                   |
| ------------------ | ----------------------------- |
| `nitrous`          | Nitrous enabled.              |
| `purge`            | Purge enabled.                |
| `popcorn`          | Popcorn backfire enabled.     |
| `glow`             | Glowing brake discs enabled.  |
| `drift`            | Drift+ mode enabled.          |
| `drift_hd`         | Drift HD mode enabled.        |
| `smoke`            | Drift smoke enabled.          |
| `sport_mode`       | Sport mode enabled.           |
| `throttle_control` | Throttle control enabled.     |
| `rollback`         | Rollback & handbrake enabled. |
| `neon`             | Neon lights enabled.          |
| `interior_lights`  | Interior lights enabled.      |
| `shunt`            | Shunt boost enabled.          |

***

#### `getCurrentVehicleFeatures()`

Returns the tablet feature toggles of the vehicle the local player is currently inside.

**Parameters** — none.

**Returns**

| Type    | Description                                                                                                                 |
| ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `table` | Same shape as [`getVehicleFeatures`](https://docs.rainmad.com/resources/3d-tuning-tablet/exports#getvehiclefeatures-plate). |

***

#### `getCurrentExhaust()`

Returns custom exhaust data for the vehicle the local player is currently inside.

**Parameters** — none.

**Returns**

| Type           | Description                                                                      |
| -------------- | -------------------------------------------------------------------------------- |
| `table \| nil` | Exhaust data, or `nil` if not inside a vehicle or vehicle has no custom exhaust. |

**Return shape**

| Field   | Type      | Description                            |
| ------- | --------- | -------------------------------------- |
| `color` | `integer` | Selected flame color index (`0–12`).   |
| `sound` | `boolean` | Whether the backfire sound is enabled. |

***

### Server Exports

#### `getNitroData(plate)`

Returns the server-side cached nitrous record for the given plate.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type           | Description                                         |
| -------------- | --------------------------------------------------- |
| `table \| nil` | Cached record, or `nil` if no nitrous is installed. |

**Return shape**

| Field        | Type      | Description                                                          |
| ------------ | --------- | -------------------------------------------------------------------- |
| `hasnitro`   | `boolean` | Always `true` when a record is returned.                             |
| `nos_level`  | `number`  | Current tank drain level (`0–100`, percent drained of current tank). |
| `nos_bottle` | `integer` | Total installed tanks.                                               |
| `color`      | `integer` | Selected particle flame color index (`0–12`).                        |

***

#### `hasTablet(plate)`

Checks whether the given vehicle has a tablet installed.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type      | Description                       |
| --------- | --------------------------------- |
| `boolean` | `true` if a tablet record exists. |

***

#### `getTabletData(plate)`

Returns the tablet offset/rotation record for the given vehicle.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type           | Description                                         |
| -------------- | --------------------------------------------------- |
| `table \| nil` | Tablet placement record, or `nil` if not installed. |

**Return shape**

| Field      | Type      | Description                           |
| ---------- | --------- | ------------------------------------- |
| `offset`   | `vector3` | Local offset from the vehicle origin. |
| `rotation` | `vector3` | Local rotation (pitch, roll, yaw).    |

***

#### `hasExhaust(plate)`

Checks whether the given vehicle has a custom exhaust installed.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type      | Description                               |
| --------- | ----------------------------------------- |
| `boolean` | `true` if a custom exhaust record exists. |

***

#### `getExhaustData(plate)`

Returns the server-side cached custom exhaust record for the given vehicle.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type           | Description                                |
| -------------- | ------------------------------------------ |
| `table \| nil` | Exhaust record, or `nil` if not installed. |

**Return shape**

| Field   | Type      | Description                            |
| ------- | --------- | -------------------------------------- |
| `color` | `integer` | Selected flame color index (`0–12`).   |
| `sound` | `boolean` | Whether the backfire sound is enabled. |

***

#### `getVehicleFeatures(plate)`

Returns the persisted tablet menu toggle states for the given vehicle.

**Parameters**

| Name    | Type     | Description    |
| ------- | -------- | -------------- |
| `plate` | `string` | Vehicle plate. |

**Returns**

| Type           | Description                                                                                                                                                                                    |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `table \| nil` | Same shape as the client [`getVehicleFeatures`](https://docs.rainmad.com/resources/3d-tuning-tablet/exports#getvehiclefeatures-plate), or `nil` if the vehicle has no saved feature state yet. |