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

# ABackboards

Strap a patient onto a spinal backboard with a synced animation and prop.

![ABackboards](https://3178353394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2Hc1pmEtJtEBI0blIeE%2Fuploads%2FaF03nhPdniP31IAX20Eq%2FABackboards.jpg?alt=media)

Strap an injured player onto a spinal backboard. The board slides in beside the patient and attaches to them, and the patient plays a synced animation. Remove it again with a single command.

## Requirements

| Dependency                                                            | Required | Notes                                         |
| --------------------------------------------------------------------- | -------- | --------------------------------------------- |
| [ox\_lib](https://github.com/overextended/ox_lib)                     | Yes      | Notifications                                 |
| [Medical Prop Pack](https://www.gta5-mods.com/maps/medical-prop-pack) | Yes      | Provides the backboard prop (`combicarrier2`) |
| QBCore / QBox / TMC                                                   | Optional | Only needed to use the backboard as an item   |

## Installation

1. Install **ox\_lib** and the **Medical Prop Pack** on your server.
2. Drag the `ABackboards` folder into your `resources` folder.
3. Add it to your `server.cfg` after ox\_lib:

   ```cfg
   ensure ox_lib
   ensure ABackboards
   ```
4. Set your framework in `config.lua` (see below).
5. **Framework only:** add a `backboard` item to your inventory. See [Adding items to your inventory](/aero-labs-docs/getting-started/installing-a-script.md#adding-items-to-your-inventory).

## Configuration

```lua
Config.Framework = "QBCore" -- "Standalone", "QBCore", "QBox", "TMC"

Config.ItemName = "backboard" -- Ignored in Standalone
Config.Command = {
    enabled       = false,            -- Set to true for Standalone
    command       = "usebackboard",
    removeCommand = "removebackboard",
}
```

| Option                         | Description                                                         |
| ------------------------------ | ------------------------------------------------------------------- |
| `Config.Framework`             | Your framework. Use `Standalone` if you have none.                  |
| `Config.ItemName`              | The usable item that starts the backboard.                          |
| `Config.Command.enabled`       | Registers the `/usebackboard` command. Turn this on for Standalone. |
| `Config.Command.command`       | Name of the apply command.                                          |
| `Config.Command.removeCommand` | Name of the remove command. It is **always** available.             |

## Usage

### Putting a patient on a backboard

1. Use the **backboard** item, or type `/usebackboard` in Standalone.
2. Look at the patient. A **yellow marker** appears above their head.
3. Press **E** to select them. Press **Esc** to cancel.
4. The board slides in next to the patient and attaches to them.

### Taking a patient off

1. Type `/removebackboard`.
2. Look at the patient and press **E**.
3. The board is removed and the patient's animation stops.

{% hint style="info" %}
The target must be a living player. Dead peds and NPCs can't be selected.
{% endhint %}

## Developer events

Trigger these from a radial menu, ox\_target option or your own script:

| Event (client)                                    | Description                                   |
| ------------------------------------------------- | --------------------------------------------- |
| `MDXBackboard:Client:UseBackboard`                | Starts target selection to apply a backboard  |
| `MDXBackboard:Client:RemoveNearbyPlayerBackboard` | Starts target selection to remove a backboard |