Source-checkedOther

BungeeGuard

by Luck · for Minecraft

A simple plugin which adds a security token to the BungeeCord handshaking protocol.

87KDownloads
17 mo agoLast updated
Spigot · PaperLoaders
1.19Latest game version

About BungeeGuard

From SpigotMC

A simple plugin which adds a security token to the BungeeCord handshaking protocol.

BungeeGuard​

BungeeGuard is a plugin-based security/firewall solution for BungeeCord (and Velocity) proxies.

The problem
BungeeCord installations are insecure by default, and require additional firewall rules to be configured (using iptables or otherwise) to prevent malicious users from bypassing the proxy and connecting using any uuid/username they choose.

This is a well-known issue, and over the years many (even large) servers have been successfully targeted using this attack.

The conventional solution
The conventional solution recommended by the BungeeCord author is to configure a firewall rule using iptables or ufw to prevent outside connections to the backend servers.

However, there are two main problems with this:
  1. Configuring these firewall rules is complicated, especially for inexperienced users.
    1. Even experienced users sometimes make mistakes or overlook things. Unless the setup is absolutely perfect, rules are prone to being broken during later changes, or reset on system reboot.
  2. Users on "shared hosting" do not have access to the underlying system and most likely cannot setup their own firewall rules.
The BungeeGuard solution
Server admins install BungeeGuard (just an ordinary plugin!) on their proxies and backend servers.
  • On the proxy, BungeeGuard adds a secret "authentication token" to the login handshake.
  • On the backend (Spigot etc. server), BungeeGuard checks login handshakes to ensure they contain an allowed authentication token.
It's really that simple.

Installation
Installation is very straightforward.

If you have access to the underlying system and are able to setup firewall rules using iptables (or otherwise), I strongly recommend you do so. Then, install BungeeGuard as well.

See here for a detailed install guide.

License
BungeeGuard is licensed and made available under the permissive MIT license. Please see here for more information.

Highlights

From source data

Game versions

Supports 12 Minecraft versions, the newest being 1.19.

Loaders

Runs on Spigot and Paper.

Footprint

Rated a light load on a server.

BungeeGuard on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
Server side
Required on the server
Server type needed
Spigot, Paper
Server load
light
Smallest plan we suggest
Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.4.0, released 2025-06-02

Game versions by loader

LoaderGame versionsNewest
Paper1.8 to 1.19 (12 versions)1.19
Spigot1.8 to 1.19 (12 versions)1.19

From 9 recorded builds of BungeeGuard.

Recent builds

BuildReleasedGame versionsLoaders
1.4.02025-06-021.8 to 1.19 (12 versions)Spigot, Paper
1.3.32022-10-02n/aSpigot, Paper
1.3.22022-07-14n/aSpigot, Paper
1.3.12022-06-12n/aSpigot, Paper
1.3.02022-06-08n/aSpigot, Paper
1.2.22021-04-19n/aSpigot, Paper

Run BungeeGuard on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on SpigotMC as “Plugins”

Plugins

Its source category doesn’t say more about what it does, so NxLabs lists it under Other.

Runs on your server

From source side support

SpigotMC lists BungeeGuard as required on the server. Check its SpigotMC page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
SpigotPaper
Runs on
Serverrequired on the server
Game versions
1.19 and 11 earlier
Requires
One-click install needs a Paper server.

Verified at the source

  • ✓SpigotMCOfficial listing, checked 2026-10-01Open ↗
  • ✓AuthorLuck, as published on SpigotMC
  • ✓LicenseNot published by the sourceFree

BungeeGuard, answered

Generated from the mod’s own source data.

Do my players need to install BungeeGuard?

SpigotMC lists BungeeGuard as required on the server. Check its SpigotMC page to see whether players need it too.

Which loaders does it support?

Spigot and Paper.

Is it free?

Yes. BungeeGuard is free to download from SpigotMC.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run BungeeGuard on a Minecraft server.

Deploy in about a minute from $4.99 a month, then add BungeeGuard in one click.