JukeHostConnect

JukeHost Connect
JukeHostConnect is the Spigot plugin for JukeHost. Often used intwine with MCJukebox

TL;DR
JukeHostConnect provides an easy bridge between your uploaded audio on JukeHost and using it ingame via a easy to use and interactive menu system.

JukeHostConnect works on 1.12.*, 1.13.*, 1.14.* and 1.15.*

How It Works
By using your JukeHost General and Minecraft API tokens JukeHostConnect will make a request to our service and obtain all of your audio. With this you can then view all you audio in their individual categories and play them or grab their link

Setup
Setting up JukeHostConnect is fairly simple.

1. Copy JukeHostConnect to your plugins folder. Make sure you also have MCJukebox installed
2. Run /jukehostconnect as an operator or with permission jukehostconnect.admin
3. Click the link pasted into chat.
4. You will see our site and be asked to login.
5. Copy the command given to you.
6. Paste the command into your Client chat and run it.
7. Now running /jukehostconnect or /jhc will open up a menu for you to use

Usage
JukeHostConnect's menus consist of a few layers.

1. Category layer, which shows you all the available categories (With no permission you see a Barrier block)
2. Tracks layer, which shows you all the tracks/audio in the category
3. Options layer, which shows you all the options that you can perform with the audio track you selected

The items on each layer are clickable. Clicking a category will open it. Clicking a track will provide you with options that you have been assigned.

Categories are permission based. Thus, if you aren't op or don't have either jukehostconnect.* or jukehostconnect.category.* permissions you won't see any categories. This is useful as normal players can open the menu but do nothing.

Categories can be assigned by giving the following permission: jukehostconnect.category.<category name>

The same is also applied with audio options with the following options being controlled by permissions: Play to self, Play to all, Full Link & Short Link
Controlled by the following permissions:

• jukehostconnect.play.all
• jukehostconnect.link

Commands & Permissions

• /jukehostconnect (/jhc)
• /jukehostconnect <lsetup> - jukehostconnect.admin
• Category e.g: Uploads - jukehostconnect.category.<category> jukehostconnect.category.Uploads

• 
  
• Audio - Play All - jukehostconnect.play.all
• Audio - Link - jukehostconnect.link
• jukehostconnect.admin - Grants all permissions except all categories
• jukehostconnect.* grants all permissions

EULA Compliant Features
With JukeHost you can limit users to specific categories and also only allow them to play it to themselves. This can be used as a paid feature if you would like users to be able to listen to audio from a selected list you provide.

Important
JukeHostConnect requires MCJukebox to be installed and requires an active internet connect in order to function. JukeHostConnect doesn't collect any data about your server. Its requests only sends and receives data about your audio from JukeHost's servers.