Running a server
Set up Block Band on a Minecraft server. What it adds, the server settings, commands, sharing songs and voice chat groups.
What the server needs
Put the Block Band jar in the server’s mods folder too. With it, players get:
- band mode and the server’s top scores,
- the instrument items and stage blocks,
- the server’s own songs (see Server songs),
- protection from damage while they’re playing (optional).
Players with Block Band can still join servers without it and play songs on their own.
Server settings
The server’s settings are in serverconfig/tgband-server.toml inside the world folder. (Put a copy in the server’s
defaultconfigs folder to use it for new worlds.)
| Setting | Default | What it does |
|---|---|---|
protectPlayersWhilePlaying |
true |
Players can’t be hurt while they’re in a song. |
voiceChatBandGroups |
true |
With Simple Voice Chat installed, each band gets its own voice chat group. |
maxSongSizeMB |
150 |
Server songs bigger than this aren’t sent to players. |
songUploadKBps |
2048 |
How fast songs are sent to each player, in kilobytes per second. |
Commands
| Command | Who | What it does |
|---|---|---|
/band ... |
Everyone | Everything on the Band screen (see Band mode) |
/bandsongs |
Everyone | Lists the songs the server shares |
/bandsongs reload |
Operators | Looks for new or changed songs in config/tgband/songs/ |
Voice chat
With Simple Voice Chat on the server, each band
gets its own open voice chat group when it forms: the band hears each other (and the singer) from anywhere, and
players nearby still hear them. Players who are already in a group stay in theirs. Turn this off with
voiceChatBandGroups = false.
Simple Voice Chat needs its own port open on the server (24454 UDP by default); see its own setup guide.
Copyright on servers
Songs you put in the server’s songs folder are sent to every player. Only share music you have the rights to, and mark songs that are safe to stream (see Streaming safely) so streamers on your server can use them.