> 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/zones.md).

# Zones

> You need to register zones using the Admin Panel, please make sure to read and follow these instructions [Zones](/laptop-pack/music/admin/zones.md)

#### Hearing Zone Music

Players do not need to do anything to hear a zone. The server continuously checks player proximity. When a player gets close enough to a zone's center (within radius + a small buffer), the server subscribes them and sends the current track with its playback position. Audio starts immediately in sync with every other player already listening.

When a player moves far enough away, the server unsubscribes them and audio stops cleanly.

#### Audio Behavior by Position

Zones use two distinct audio modes depending on the player's exact position:

**Inside the polyzone** — Audio is played in stereo at full volume, as if the source is at the player's ears. This represents being physically inside the venue.

**Outside the polyzone but within radius** — Audio is spatial and distance-based. Volume fades smoothly as the player moves away from the zone boundary. Once they are far enough past the fade distance, volume reaches zero, but the audio session stays active so it can fade back in as the player returns.

**Indoor zones** — Zones marked as Indoor add a muffling effect when the player is outside the poly boundary. The audio is significantly reduced, simulating the sound of music heard through walls. As the player walks through the entrance, volume transitions smoothly to full over a short fade.

#### Headphone Mode

If a player activates headphone mode, all zone audio is reduced to 20% of its configured volume. This lets players use their personal audio without zone music overpowering it.

***

### Controlling a Zone (Device)

Players physically inside a zone's polyzone can see it as a connectable **device** in the music app. Connecting to the zone device gives full playback control over that zone's music — visible to everyone listening.

From the zone device a player can:

* Search and play tracks
* Build and manage the zone's queue
* Skip, seek, pause, resume, and change volume
* Jump to any track in the queue

If the zone has a **Required Job** configured, only players with that job can connect as a controller while inside the Polyzone. Anyone else simply hears the music but cannot control it.

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