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/

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.