SimplyMusic

Summary
This plugin will allow you to listen to any music you want, from peaceful, video game music or hard rock, at least, in noteblocks. You can listen by your own or if you feel like playing with a friend, you can even listen along with them! A simple yet well-crafted GUI will give you the ability to customize your experience to the maximum.

Features

• The song list is displayed throughout the infinitely expandable GUI with a responsive and simple design.
• Fully customizable texts from simple command feedback to inventory items and even the commands themselves!
• You can listen casually to your songs in specific, play them one after the other and even shuffle them.
• You can also listen along with other users with the Tune Menu where you can simply click on the head of a user to listen along with him.
• A practical command is available to import songs from a direct link to a .nbs file.
• This plugin is NOT dependent on NoteBlockAPI altough it does use it.
• The volume of the songs is adjustable in a simple, user-friendly gui.
• Every option is related to a permission and can be configured.
• You have the option to reload the song library while in-game without reloading the server and songs are editable/deletable while in use.
• The plugin is also very lightweight and still in active development.
• SimplyMusic WILL check every song while loading/reloading to make sure that no song is put on twice or corrupted. It will also keep it's ram usage as low as possible with occasional garbage cleaning.
• A filter option to filter out the songs you don't want in favor of the songs you want to hear.
• Tab completion for the /music command
• Ability to loop a music over and over again
• A simple intuitive playlist system to play only your favorite music!
• Utilizes reflection & should be compatible with most Minecraft versions!
• Fully open source! Here

Upcoming Features

• A playlist system allowing multiple playlists per users with a customizable amount of songs per.
• An audio visualizer in the form of a gui, blocks and even particles if you feel like it.
• A server radio to play server-wide songs.
• A command to convert from .midi to .nbs (Halfway there)
• Loop feature
• A search tool to find the music that you so desire!

Commands

• Every command is under the parent command /music:
• /music help
• /music reload > Reloads the music folder
• /music list > Lists all available songs
• /music play > Plays songs in a consecutive order
• /music play <id> > Plays the specific song
• /music loop <id> > Loops a specific song
• /music tune <player> > Listens along with a player
• /music stop > Stops playback
• /music shuffle > Shuffles all of the songs to play the songs you hold in love.
• /music skip > If playing a song by its id, it will play the next one. If playing in consecutive mode, it will skip to the next one and if in shuffle mode, it will pick the next one in the list.
• /music gui > For the users that prefer a gui-ish experience
• /music import <Name> <Url .nbs> > Imports a song under the name from the url, validates it, makes sure it isn't over 1mb, and also makes sure that it doesn't already exist!
• /music volume <level> > Changes the volume of the music from 0 - 100

Permissions

• Every permission follows this syntax: simplymusic.GROUP.command
• /music reload - simplymusic.admin.reload
• /music list - simplymusic.user.list
• /music play - simplymusic.user.play
• /music loop - simplymusic.user.loop
• /music tune - simplymusic.user.tune
• /music stop - simplymusic.user.stop
• /music shuffle - simplymusic.user.shuffle
• /music skip - simplymusic.user.skip
• /music gui - simplymusic.user.gui
• /music import - simplymusic.user.import
• /music volume - simplymusic.user.volume
• Playlist GUI - simplymusic.user.playlist

Installation

1. Simply move the plugin SimplyMusic.jar into the folder inside of your server files called "plugins". You must then reload the server.
2. In order to add songs, simply download them and drag and drop them into the songs folder inside of "SimplyMusic" (Folder) OR use the command /music import <name> <url> for a quick struggle-less installation.

Songs

1. Note Block Studio Repository (Scroll down)
   
2. RedstoneTek's Github Repository
3. Find them online!

Adding Songs

• Find a .nbs version of the song you want online.
• User:
• Copy the link to the direct download (should end with .nbs)
• Perform /music import <name of song> URL
• Server Owner:
• Download the song
• Open the plugins folder, then the Simply music folder and put the song in it.
• Use /music reload

Screenshots
Main music GUI
Ingame overlay
Tune Menu
Volume Menu
Playlist Selector Menu
Playlist Menu

Languages and configuration
In order to configurate the language for your plugin, you will need access to the config.yml file, located in the SimplyMusic plugin folder, aswell as one language file from the list below.

1. Place the language file inside of the SimplyMusic folder, note it's name.
2. Go into your config.yml, and edit the custom_lang value to be set to true.
3. Simply set the lang value to your language file name without the extension (.yml).
4. /music reload
5. You're all set!

Premade languages downloads
TEMPLATE: Download here
Made by: RedstoneTek
French: Download here
Translated by: RedstoneTek
Italian: Download Here
Translated by: zBoringDropHD

ATTENTION: If you want to give me a hand are can translate from french/english to another language, please contact me via email at [email protected]

Reviewing
If you enjoyed the plugin, or not, feedback, whether it is good or bad, is always enjoyable so I can do my best to improve upon the plugin! Thank you to anyone who takes the time to leave some feedback to the plugin.

Listen Away! - RedstoneTek