Installation Guide
This guide will help you install and set up JoinMusic on your server.
Prerequisites
Before installing JoinMusic, make sure you have:
- A Bukkit/Spigot server (version 1.8 - 1.21.x)
- NoteBlockAPI (Version 1.6.1.1 or newer)
- PlaceholderAPI (optional)
Basic Installation
Step 1: Download Required Files
- Download the latest version of JoinMusic from:
- Spigot
- Bukkit
- Hangar
-
Download NoteBlockAPI
Step 2: Install the Plugins
- Stop your server
- Place both JAR files in your server's
plugins
folder: JoinMusic.jar
NoteBlockAPI.jar
- Start your server
Step 3: Initial Configuration
- The plugin will generate its configuration file on first run
- Place your music files (
.nbs
format) in theplugins/JoinMusic/music
folder - Configure the plugin using the commands or by editing
plugins/JoinMusic/config.yml
BungeeCord Setup
If you're using a BungeeCord network, follow these additional steps:
Step 1: Install on Spigot Servers
- Install JoinMusic and NoteBlockAPI on all Spigot servers in your network
- Enable BungeeCord mode in the configuration of each Spigot server
Step 2: Install on BungeeCord
- Download the BungeeCord version of JoinMusic
- Place the BungeeCord plugin JAR in your BungeeCord's
plugins
folder - Restart your BungeeCord server
Verification
To verify your installation:
- Check the server console for any error messages
- Use the command
/joinmusic
or/jm
to see if the plugin responds - Join the server to test if music plays automatically
Troubleshooting
If you encounter issues:
- Check if NoteBlockAPI is properly installed
- Verify your music files are in the correct format (
.nbs
) - Ensure you have the correct permissions
- Check the server logs for error messages
Next Steps
After installation: - Configure the plugin - Set up permissions - Learn about available commands