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

# Deployables

Placeable world objects with zones, limits, persistence and custom interactions.

**Deployables** (`ace_deployables`) lets players place objects in the world from an inventory item: tents, campfires, chairs, coolers, gazebos and more. Each deployable has per-player and server-wide limits, optional ownership, pickup or destroy behavior, an optional lifetime, and an optional **custom interaction** written in plain Lua.

|                   |                                                                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Resource name** | `ace_deployables`                                                                                                                                      |
| **Version**       | 1.0.3                                                                                                                                                  |
| **Frameworks**    | Framework-independent (auto-detects your inventory)                                                                                                    |
| **Inventories**   | ox\_inventory, qs-inventory, codem-inventory, tgiann-inventory, qb-inventory, ps-inventory, lj-inventory, ESX. Standalone fallback when none is found. |
| **Dependencies**  | None required. `ox_lib` is only needed for ox notifications.                                                                                           |
| **Storage**       | `db/deployables.json` (no SQL database)                                                                                                                |

## Features

* **13 deployables included**, all using base-game props
* **Automatic inventory detection** and an **item definition generator** (`generated_items.txt`)
* **Limits:** `maxPerPlayer` and `globalLimit` per deployable
* **Ownership:** only the owner can pick up or destroy an object
* **Pickup modes:** `true` (pick up, item returned), `"destroy"`, or `false` (can't be picked up)
* **Lifetime:** objects can remove themselves automatically
* **Placement zones** with map blips, plus max placement distance and height checks
* **Persistence** across restarts
* **Custom interactables:** write your own Lua interaction per object (campfire and tent examples included)
* **Notifications:** GTA, ox\_lib or your own system
* Toggleable on-screen text

## Included deployables

|                                                                                                                                                                                                                                                                                  | Key               | Label            | Item                  | Per player | Server limit | Pickup    | Interaction | Lifetime | Owner-only |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------- | ---------------- | --------------------- | :--------: | :----------: | --------- | ----------- | -------- | :--------: |
|        <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-6e03c34fb32fb288ac868ef43848dcbc32daf18b%2Fdeployables-ace_campfire.png?alt=media" alt="Campfire" data-size="original">        | `campfire`        | Campfire         | `ace_campfire`        |      2     |      50      | `destroy` | `campfire`  | `1.0`    |      ✅     |
|            <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-e8f20bbad8049ec4f3d7a988c53b9724ced9a9a3%2Fdeployables-ace_tent.png?alt=media" alt="Tent" data-size="original">            | `tent`            | Tent             | `ace_tent`            |      3     |      100     | ✅         | `tent`      | —        |      ✅     |
|                                                                                                                                                                                                                                                                                  | `hobostove`       | Hobo Stove       | `ace_hobo_stove`      |      2     |       —      | ❌         | `campfire`  | `1.0`    |      ✅     |
|      <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-1123bb2c2c1b2ffe3ca4388773d96e176af24ca2%2Fdeployables-ace_skid_chair.png?alt=media" alt="Skid Chair" data-size="original">      | `skidChair`       | Skid Chair       | `ace_skid_chair`      |      5     |       —      | ✅         | —           | —        |      ✅     |
| <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-d93c6de58d2a5a5d68080a89ded1e380c2f610a2%2Fdeployables-ace_light_projector.png?alt=media" alt="Light Projector" data-size="original"> | `light_projector` | Light Projector  | `ace_light_projector` |      5     |       —      | ✅         | —           | —        |      ✅     |
|          <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-7b2b966c26562f4157f039ee36acabe24076ee17%2Fdeployables-ace_cooler.png?alt=media" alt="Cooler" data-size="original">          | `cooler`          | Cooler           | `ace_cooler`          |      2     |       —      | ✅         | —           | —        |      ❌     |
|     <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-4091f3ac9e69c61c85ddb9468c40ec298906ecde%2Fdeployables-ace_speaker.png?alt=media" alt="Portable Speaker" data-size="original">    | `radio_speaker`   | Portable Speaker | `ace_speaker`         |      1     |       —      | ✅         | —           | —        |      ❌     |
|   <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-bf14873b4dace85d00d4b83c28f9d97813a9399b%2Fdeployables-ace_folding_table.png?alt=media" alt="Folding Table" data-size="original">   | `folding_table`   | Folding Table    | `ace_folding_table`   |      2     |       —      | ✅         | —           | —        |      ✅     |
|     <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-751e9566bc6e80d2bc378660a91948eb636616ac%2Fdeployables-ace_umbrella.png?alt=media" alt="Beach Umbrella" data-size="original">     | `beach_umbrella`  | Beach Umbrella   | `ace_umbrella`        |      3     |       —      | ✅         | —           | —        |      ✅     |
|    <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-9b0f7ce7fe38329475496a31f41044e014f15e2f%2Fdeployables-ace_small_basket.png?alt=media" alt="Small Basket" data-size="original">    | `small_basket`    | Small Basket     | `ace_small_basket`    |      4     |       —      | ✅         | —           | —        |      ❌     |
|       <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-5c76ce2378ca9166c9b922e4978ef29bca2afb9b%2Fdeployables-ace_bbq_grill.png?alt=media" alt="BBQ Grill" data-size="original">       | `bbq_grill`       | BBQ Grill        | `ace_bbq_grill`       |      4     |       —      | ✅         | —           | —        |      ✅     |
|    <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-adedfb9e5a827bdcb448c30e7f4c242554e0ee3e%2Fdeployables-ace_lounge_chair.png?alt=media" alt="Lounge Chair" data-size="original">    | `lounge_chair`    | Lounge Chair     | `ace_lounge_chair`    |      4     |       —      | ✅         | —           | —        |      ✅     |
|          <img src="https://2698751888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeduQ6kxfGcEoMzSKJnCJ%2Fuploads%2Fgit-blob-a5719a975bb3be8f6866dd73dafc7b537f271fe2%2Fdeployables-ace_gazebo.png?alt=media" alt="Gazebo" data-size="original">          | `prop_gazebo_02`  | Gazebo           | `ace_gazebo`          |      2     |       —      | ✅         | —           | —        |      ✅     |

{% hint style="info" %}
No item image is included for the Hobo Stove (`ace_hobo_stove`).
{% endhint %}

{% content-ref url="/pages/rHOhgvWeKGu8MzWk5AAO" %}
[Installation](/docs/inventory-and-items/deployables/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/eQiiVH6MZ6rXcbEPYmvO" %}
[Custom Interactables](/docs/inventory-and-items/deployables/custom-interactables.md)
{% endcontent-ref %}
