Installing BungeeGuard on your BungeeCord server network

Installing BungeeGuard is essential for protecting against IP spoofing and ensuring secure player connections across your BungeeCord network. This guide will walk you through each step to properly install and configure it on Beacon Hosting servers.

Step 1: Download BungeeGuard Plugin

Download the latest version of BungeeGuard that matches your BungeeCord setup from the official LuckPerms GitHub repository or a trusted plugin site like SpigotMC.

Step 2: Upload to Your BungeeCord Server

Access your Beacon Hosting control panel and navigate to your BungeeCord server.
Upload the BungeeGuard.jar file to the /plugins directory.

Step 3: Configure BungeeGuard

Start the BungeeCord server once to generate the configuration files.
Then, open the plugins/BungeeGuard/config.yml file and copy the generated token.

You will need this token for each backend (Spigot/Paper) server that connects to your proxy.

Step 4: Install BungeeGuard on Backend Servers

Upload the same BungeeGuard plugin to the /plugins folder of each backend server (Spigot/Paper).
After running the backend servers once, open their spigot.yml or paper.yml and add your token under the bungeeguard section.

Example:

settings:
  bungeecord: true
bungeeguard:
  allowed-tokens:
    - "your-generated-token-here"

Step 5: Restart All Servers

After saving your configuration files, restart both the BungeeCord proxy and all backend servers to apply the changes.

[INFO] Make sure ip_forward: true is enabled in your BungeeCord config.yml and bungeecord: true is set in each backend server’s spigot.yml to ensure correct player data forwarding.

Additional Resources

If you need to select a server or manage your services, visit our Server Selection Page.

For more guides and support articles, visit the Beacon Hosting Knowledgebase.