> For the complete documentation index, see [llms.txt](https://ikcscripts.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://ikcscripts.gitbook.io/docs/boombox/using-the-boombox/placement-and-pickup.md).

# 📍Placement & Pickup

The iKCScripts Boombox is a physical inventory item that can be placed in the world and picked back up by its owner.

The placement system is designed to make positioning the Boombox simple while keeping item handling and ownership protected by the server.

***

### 📻 Placing a Boombox

Use the:

```
kc_boombox
```

item from your configured inventory.

Using the item starts **Boombox Placement Mode** and displays a preview of the Boombox in front of your character.

The placement preview lets you choose exactly where the Boombox should be positioned before confirming it.

***

### 🎮 Placement Controls

While Placement Mode is active, the on-screen instructions display the available controls.

You can:

* Move the Boombox into position
* Rotate the Boombox
* Confirm placement
* Cancel placement

The placement instructions remain visible until the Boombox is successfully placed or placement is canceled.

{% hint style="info" %}
The Boombox must remain within the server's configured placement distance.
{% endhint %}

***

### 👻 Placement Preview

The Boombox shown during placement is only a preview.

It allows you to position and rotate the Boombox before the real networked object is created.

The inventory item is **not removed** simply because Placement Mode has started.

***

### ✅ Confirming Placement

Once the Boombox is positioned where you want it, use the displayed confirmation control.

The server validates the placement before creating the real Boombox.

After successful placement:

* The real Boombox is created
* Ownership is assigned
* The placement is saved
* The Boombox becomes available for interaction
* The inventory item is removed

{% hint style="success" %}
The Boombox item is only removed after the server successfully creates the placed Boombox.
{% endhint %}

***

### ❌ Canceling Placement

You can cancel Placement Mode before confirming the Boombox.

When placement is canceled:

* The placement preview disappears
* No real Boombox is created
* The inventory item remains in your inventory

You can use the item again whenever you are ready.

***

### 🚫 Invalid Placement

The server may reject a placement that does not meet the required placement conditions.

This can include situations such as:

* Attempting to place too far away
* Invalid placement position
* Placement conditions not being satisfied
* The character being in a state where placement is not allowed

If placement is rejected, the Boombox item should not be consumed.

***

### 🎯 Interacting After Placement

Once successfully placed, the Boombox becomes available through the interaction system configured by the server.

Supported interaction systems include:

* **ox\_lib TextUI**
* **ox\_target**
* **qb-target**

With ox\_lib TextUI, the owner will see:

```
[E] Open Boombox • [G] Pick Up
```

Other nearby citizens will see:

```
[E] Open Boombox
```

Each interaction is associated with that specific placed Boombox.

***

### 📦 Picking Up Your Boombox

Only the **owner** can pick up a placed Boombox.

Use the displayed pickup interaction while standing close to your Boombox.

After a successful pickup:

* Active music from the Boombox is stopped
* The physical Boombox is removed
* Its placed persistence record is removed
* The `kc_boombox` inventory item is returned to the owner

{% hint style="success" %}
You do not need to open the Boombox interface before picking it up.
{% endhint %}

***

### 🔒 Ownership Protection

Ownership is established when the Boombox is successfully placed.

Other citizens cannot pick up your Boombox.

This remains true even when they have playback control through:

* **Trusted Friends**
* **Others Around**

Those permissions provide music control only and do not transfer ownership.

{% hint style="warning" %}
Only the owner can recover the physical Boombox and receive the inventory item back.
{% endhint %}

***

### 💾 Persistent Placement

Placed Boomboxes are stored by the server.

You can leave your Boombox placed instead of picking it up before leaving the area.

After a server or resource restart, saved Boomboxes can be restored when the required game and network conditions are available.

{% hint style="info" %}
Physical Boombox placement persists across restarts. Active music playback does not need to automatically resume after a complete server restart.
{% endhint %}

***

### 🔄 Moving a Boombox

If you want to move an already placed Boombox:

1. Pick up the Boombox.
2. The item is returned to your inventory.
3. Use the item again.
4. Position it in the new location.
5. Confirm the new placement.

This preserves the normal ownership and inventory validation process.

***

### 🎵 Next Step

Once your Boombox is placed, continue to:

→ **🎛️** [**Opening & Controls**](/docs/boombox/using-the-boombox/opening-and-controls.md)

To learn about sharing playback control:

→ **👥** [**Others Around**](/docs/boombox/using-the-boombox/others-around.md)

→ **👥** [**Trusted Friends**](/docs/boombox/features/trusted-friends.md)