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

# Overview

Grab props, empty vehicles and NPCs, hold them in front of you, turn them and throw them with a charged shot. Synced for every player.

objectgrab lets players pick up loose things in the world and throw them. Look at a bin and press E, and it flies into your hands. Turn it with the mouse wheel, hold the left mouse button to charge, and let go: it flies to where the crosshair points, and every other player sees it.

{% embed url="<https://www.youtube.com/watch?v=jzNOhgy01Ns>" %}
The preview video
{% endembed %}

## What you get

* **Grab almost anything loose.** Map props like bins, cones, crates and chairs, objects spawned by other scripts, empty vehicles and NPCs. Players can never be grabbed.
* **Two ways to grab.** The E key, with an outline and a key hint on the object, or a **Grab** option in ox\_target.
* **Hold and turn.** The object floats in front of the player, or sits in a hand. The mouse wheel turns it, Ctrl and the mouse wheel tilt it.
* **A charged throw.** Hold to charge from 12 to 45 m/s in 1.2 seconds, with an animated charge bar that goes from cyan to red.
* **Synced map props.** A grabbed map prop is swapped for a networked copy, so everyone sees it move. The original comes back after 5 minutes.
* **No instant kills.** A player hit by a thrown object is knocked down, not killed by the impact. Damage per hit is up to you.
* **Settings per model.** Hand bone, position, rotation, animations, throw power, charge time and damage for any single model.
* **Permissions** by ACE, by group, or by job with a minimum grade and duty. ESX, QBCore and Qbox are detected by themselves.
* **Exports and events** for your own scripts: grab, drop and throw, block grabbing for a player, override permissions.

## What can be grabbed

| What                       | By default | Limits                                                            |
| -------------------------- | ---------- | ----------------------------------------------------------------- |
| Map props                  | yes        | 2.0 m on the longest edge                                         |
| Objects spawned by scripts | yes        | 2.0 m on the longest edge                                         |
| Pieces of broken props     | yes        | 2.0 m on the longest edge                                         |
| Empty vehicles             | yes        | 6.0 m on the longest edge, nobody inside, not spawned by a script |
| NPCs                       | yes        | Not in a vehicle, not spawned by a script                         |
| Players                    | never      |                                                                   |

Everything has to be within 4 metres. Each limit is a setting, see [Grabbing and throwing](/organized-chaos-docs/objectgrab/grabbing-and-throwing.md) and [Configuration](/organized-chaos-docs/objectgrab/configuration.md).

## Requirements

|             |                                                                     |
| ----------- | ------------------------------------------------------------------- |
| OneSync     | Required. It is on by default on txAdmin servers                    |
| A framework | Not needed. ESX, QBCore or Qbox for permissions by job or group     |
| ox\_target  | Optional, for the **Grab** option. Without it players use the E key |
| ox\_lib     | Optional, for notifications, the key hints and the player ped cache |

## Where to go next

* [Installation](/organized-chaos-docs/objectgrab/installation.md)
* [Grabbing and throwing](/organized-chaos-docs/objectgrab/grabbing-and-throwing.md)
* [Map props and syncing](/organized-chaos-docs/objectgrab/map-props-and-syncing.md)
* [Per-model settings](/organized-chaos-docs/objectgrab/per-model-settings.md)
* [Configuration](/organized-chaos-docs/objectgrab/configuration.md)
* [Commands and permissions](/organized-chaos-docs/objectgrab/commands-and-permissions.md)
* [Exports and events](/organized-chaos-docs/objectgrab/exports-and-events.md)
* [Troubleshooting](/organized-chaos-docs/objectgrab/troubleshooting.md)