Setting up the plugin with multiple BungeeCord servers

Setting up the Plugin

This guide will show you how to setup the plugin if you are running more than 1 BungeeCord server.

If you're running multiple proxies, we expect that you're at least an intermediate systems administrator.
We'll try to keep things simple but this guide will assume you know what you're doing.

If you need more help, please join our support Discord and we'll do our best!

The latest version of ForceConnect only supports Java 17 so make sure to update.

Installation

Please download a release of this plugin via our releases page. You will need the ForceConnect-Bungee.jar and ForceConnect-Spigot.jar files for setup.

Extra context for this guide: ForceConnect runs on 2 encryption files called the key pair (two keys, paired to each other).
We call these public_key and private_key to make it obvious to you which is which. Never release your private_key, it is literally your server's password.

Follow these steps to install onto your server:

1. Install the ForceConnect-Bungee.jar onto every BungeeCord server in their plugin folders.

2. Start one of your BungeeCord server to generate a key pair. Save both key files, you will need them.
   Note: You will find these files in the folder plugins\ForceConnect on the BungeeCord server.

3. Start the remaining BungeeCord servers and allow them to generate key pairs (automated process).

4. Once this happens, stop these BungeeCord server and delete their key pairs. Do not delete the pair from the server in stage 2.

5. Copy the private_key file from the server in Stage 2 into the ForceConnect plugin folder on each of the stopped BungeeCord servers.
   Note: When these BungeeCord servers load, they'll all be loading the same private key which is what we want!

6. Install ForceConnect-Spigot.jar on every Spigot server that you wish to protect. We recommend all of them to be effective.

7. Start your Spigot server to generate the configuration files. These will generate in plugins\ForceConnect on each Spigot server.
   Note: At this stage, for security purposes, a failsafe will prevent players from connecting until you finish this setup.
   Please don't be alarmed, this is intentional and will be fixed in the next stage!

8. Take your public_key file from your BungeeCord server (see stage 2) and put them in the plugins\ForceConnect folder on your Spigot servers. Then, restart your Spigot server and you should be protected!

Handling Errors

For a guide on how to handle things going wrong in setup or any other issues, please consult our guide on Handling Errors.