New Installation wiki

First installation

Installation on a proxy server (BungeeCord/Waterfall/Velocity)

1. Download a JPremium-XXX.jar file from spigotmc.org or builtbybit.com.
2. Navigate to your plugins directory on your proxy server and then place the JPremium-XXX.jar file in that directory.
3. Fully start and stop your proxy server to allow default JPremium configurations to be generated. Your server will be probably shut down automatically.
4. Open the JPremium configuration file which is located at plugins/JPremium/configuration.yml.
5. Enter limbo and main server names in limboServerNames and mainServerNames options. All server names, you can find in the config.yml or config.toml file in the directory where you have your proxy server. They are stored in a list, so they have to be between parenthesis - [], not apostrophes! The limbo server is the server where players need to authorize. The main server is the server where players go after success authorization. Look at these photos: PHOTO1, PHOTO2.
6. If you are using BungeeCord:
   • Set the ip_forward setting to true in the config.yml file on your BungeeCord server.
   • Set the bungeecord setting to true in the spigot.yml file on each your Spigot server.
7. If you are using Velocity:
   • Follow instruction how to configure player information forwarding on your Velocity server: https://docs.papermc.io/velocity/player-information-forwarding
   • If you want to use the legacy mode, you need to set 'accessTokenDisabled' to true in your JPremium configuration files on your back-end servers. JPremium won't check any passing data to your back-end servers, so your servers will work in an insecure mode!
8. Start your server again.

Installation on a back-end server (Spigot/PaperSpigot) - Optional installation

1. Download a JPremium-XXX.jar file from spigotmc.org or builtbybit.com.
2. Navigate to your plugins directory on your back-end server and then place the JPremium-XXX.jar file in that directory.
3. Fully start and stop your back-end server to allow default JPremium configurations to be generated.
4. Open the JPremium configuration file which is located at plugins/JPremium/configuration.yml.
5. Copy the JPremium access token from your JPremium configuration on your proxy server and paste it into the accessToken option in your JPremium configuration in the back-end server.
6. Set the captchaMapSlot option to the slot number where JPremium should place the captcha map in a player inventory.
7. Start your server again.