Описание
# PartyBox
**PartyBox** is a client-side Fabric mod that enables live, server-controlled music and audio streaming in Minecraft.
It connects your Minecraft client to an external PartyBox backend, allowing players to tune into up to **five independent live audio channels**. Each channel can play different audio simultaneously, giving players full control over what they hear.
---
## Private Access Notice
PartyBox is currently intended for **private events**.
Adding songs and controlling playback is restricted to approved users.
Access requests: **DM @AllanStrat on Discord**
---
## Features
* Compatible with **Lunar Client**
* Compatible with **DiosesMC modpack**
* English and Spanish language support
* Live streamed audio from an external backend
* Five independent audio channels
* Client-side channel selector
* Optional "hear all channels" mode
* In-game volume control
* RGB "Now Playing" display
* Optional actionbar overlay
* `/partybox` commands for authorized users
* Token-based backend permissions
* Per-token channel restrictions
* Web dashboard for song management and playback monitoring
* Protected upload system for approved users
---
## How It Works
PartyBox uses an external backend service to stream decoded PCM audio to Minecraft clients over WebSocket.
The backend plays `.ogg` files on one of five logical channels. Example:
```
partybox play judas.ogg 3
```
This plays `judas.ogg` on Channel 3 for players listening to that channel.
---
## Player Controls
Players can:
* Select Channel 1–5
* Adjust volume
* Switch channels in real time
* Enable or disable the actionbar player
* Optionally hear all active channels simultaneously
---
## Admin and Token Access
Playback and uploads are protected by backend tokens.
Tokens can be restricted by permissions and channel access. For example, a token may only allow playback on Channel 5, while an admin token can control all channels.
---
## Supported Actions
* Play audio on a channel
* Stop channel playback
* Adjust channel volume
* Upload `.ogg` files via the web dashboard (if permitted)
---
## Web Dashboard
PartyBox includes a lightweight web dashboard:
[https://allanstrat.com/](https://allanstrat.com/)
The dashboard provides:
* List of uploaded songs
* Current "Now Playing" status across channels
* Upload interface for authorized users
Song uploads require a valid authorized token.
---
## Example Use Cases
* Server-wide music events
* Roleplay radio systems
* Theme park rides and attractions
* Staff announcement channels
* Minigame music and alerts
* Party hubs and social spaces
* Ambient zones or DJ-style live events
* Private event broadcasting
---
## Compatibility
* **Minecraft:** Fabric
* **Environment:** Client-side mod
* **Backend:** External PartyBox server
* **Audio Format:** `.ogg`
* **Channels:** 5 independent channels
---
## Notes
* PartyBox is not a voice chat replacement
* An external backend server is required
* Players only hear selected channels
* Admin controls and uploads are restricted by tokens
* Public access depends on server configuration
---
## Summary
PartyBox brings live multi-channel audio streaming to Minecraft through a lightweight Fabric client and a dedicated backend server.
Whether running a roleplay station, live event, theme park ride, music room, minigame, or private party, PartyBox provides a simple and flexible way for players to tune in and experience synchronized audio.