> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack/music/app/devices.md).

# Devices

Devices are the audio output sources available to a player inside the music app. The active device determines where sound comes out, who controls playback, and what queue is shown. Players switch between devices from the **Devices** section within the app.

<figure><img src="/files/Y8zox4avkKUhhfQ0Xuno" alt=""><figcaption></figcaption></figure>

***

### Available Devices

#### Laptop

Always available. The laptop plays audio spatially — anchored to the player's position in the world. Nearby players automatically hear it as a 3D sound source that gets louder as they approach and fades as they move away. The hearing range is controlled by `Config.LaptopRadius` (default: 3 meters).

#### Headphones

Available when the player has the headphones item in their inventory (configurable via `Config.HeadphonesItem`). Connecting to headphones switches the player to a personal listening mode — audio plays locally, a 3D headphone prop is attached to the character with a put-on animation, and the Mini Player appears on screen so the player can control playback without keeping the app open.

Zone music that is currently playing in the environment is reduced to 20% volume while headphones are active, so it does not compete with whatever the player is listening to.

<figure><img src="/files/A6hg41fIMSh6Th7kOK12" alt=""><figcaption></figcaption></figure>

#### Vehicle

Available when the player is sitting in the **front seat** (driver or passenger) of a vehicle. The device label shows the vehicle's license plate. Connecting turns the player into the vehicle channel controller — they control the music that all passengers in that vehicle hear through the shared channel.

Vehicles in blacklisted classes (motorcycles, bicycles by default) do not appear as a device. The blacklist is configurable via `Config.VehicleClassBlacklist` in `config/_config.lua`.

<figure><img src="/files/dbCgPb4ooein0HyaoVEd" alt=""><figcaption></figcaption></figure>

#### Zone (dynamic)

Appears when the player walks into the polyzone boundary of an admin-created music zone. The device label is the zone's name (e.g. "Club Maze"). Connecting to a zone device gives the player full control of that zone's shared music queue — every nearby player hears the result in real time.

If the zone has a **Required Job** configured, the zone device only appears for players with that job. All other players inside the zone hear the music but cannot connect as a controller.

<figure><img src="/files/TbkM73VY4nPcZT9BIl7S" alt=""><figcaption></figcaption></figure>
