Zones

You need to register zones using the Admin Panel, please make sure to read and follow these instructions Zones

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.