About BungeeSafeguard - UUID-based whitelist plugin
From SpigotMCwhitelist, blacklist, UUID, Geyser, XBOX
BungeeSafeguard
A blacklist and whitelist BungeeCord plugin with support of UUID look up.
This plugin was formerly named BungeeGuard. In order not to conflict with the existing plugin BungeeGuard, this plugin is renamed to BungeeSafeguard from v2.0.
Tested with bsgtest on Waterfall, version: git:Waterfall-Bootstrap:1.19-R0.1-SNAPSHOT:8a03f3d:515.
BungeeCord/Waterfall 1.18-R0.1 should be working because I see 82.5% of the BungeeSafeguard users are using that version. I personally haven't conducted a full test against 1.18 but as you know BungeeCord's APIs are much more stable than APIs of MC servers (because it's just a proxy), which means BungeeCord plugins can migrate to higher versions of BungeeCord without compatibility issues most of the time. That said, it's highly recommended to do a local test after the upgrade and before going back to the normal operation mode to make sure 1) your configuration is taking effect using /bsg status and /bsg dump, 2) BungeeSafeguard is blocking you if you remove yourself from the whitelist or add yourself to the blacklist when the corresponding list is enabled. If the test fails, roll back to an old but working version and report the issue to me.
- BungeeSafeguard
- Features
- Usage
- New Features of v3.0 and How To Migrate
- Migrate to v2.0
- XBOX Live Player Support (Bedrock Edition Support)
- Replaceable Storage Backend for Lists
- Optional Extension Plugins
- Configuration
- Commands
- Whitelist
- whitelist add
- whitelist x-add
- whitelist lazy-add
- whitelist remove
- whitelist x-remove
- whitelist lazy-remove
- whitelist import
- whitelist on
- whitelist off
- whitelist confirm
- whitelist list
- Blacklist
- blacklist add
- blacklist x-add
- blacklist lazy-add
- blacklist remove
- blacklist x-remove
- blacklist lazy-remove
- blacklist import
- blacklist on
- blacklist off
- blacklist confirm
- blacklist list
- Main Command
- bungeesafeguard load
- bungeesafeguard reload
- bungeesafeguard status
- bungeesafeguard dump
- bungeesafeguard import
- bungeesafeguard merge
- bungeesafeguard export
- Whitelist
- Permission Nodes
- Lazy Lists
- Operation Confirmation
- Important Notes
Features
- First UUID-based blacklist and whitelist plugin for BungeeCord
- Add and remove players by their username or UUID (username-change-proof)
- Add and remove XBOX Live players by their Gamer Tag or UUID (Gamertag-change-proof) (from v2.3, see XBOX Live Player Support for more details)
- Lazy translation from username to UUID (from v1.2, offline server friendly, see lazy lists for details)
- Switch between multiple configuration files (e.g., a config for maintenance mode which whitelists administrators only; from v2.4)
- Optional confirmation before adding or removing list entries (from v2.4, see Operation Confirmation for more details)
- Import from old whitelist.json or banned-players.json (from v2.5, resolves issue #7; see whitelist import and blacklist import for more details)
- API support backed by (possibly) well-structured and documented code base (from v3.0; see Developing Extension Plugin for BungeeSafeguard for more details)
- Manage the lists via a GUI Web interface (TODO)
- SQL database storage support (TODO)
- Redis storage support (Redis-BSG)
Usage
Download pre-compiled jar file from this page or the release page. Put downloaded jar file under <path/to/BungeeCord/plugins>.
New Features of v3.0 and How To Migrate
If you are a developer who has been using the unannounced API, breaking changes in v3.0:
- Internal package name (from vip.untitled.bungeeguard to cyou.untitled.bungeesafeguard)
- Other massive internal refactoring
Otherwise, v3.0 is a major remastered version with backward compatibility. You don't need to do anything to upgrade from older versions.
However, you may want to know some new features brought by v3.0.
For normal users, we have the followings:
- Replaceable Storage Backend for Lists
- Optional Extension Plugins
For developers who want to interact with BungeeSafeguard gracefully, please refer to Developing Extension Plugin for BungeeSafeguard.
Migrate to v2.0
Breaking changes in v2.0:
Highlights
From source dataGame versions
Supports 4 Minecraft versions, the newest being 1.19.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
BungeeSafeguard - UUID-based whitelist plugin 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 — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 3.1, released 2021-07-29
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.16 to 1.19 (4 versions) | 1.19 |
| Spigot | 1.16 to 1.19 (4 versions) | 1.19 |
From 10 recorded builds of BungeeSafeguard - UUID-based whitelist plugin.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 3.1 | 2021-07-29 | 1.16 to 1.19 (4 versions) | Spigot, Paper |
| 2.6.1 | 2021-05-05 | n/a | Spigot, Paper |
| 2.6 | 2021-04-11 | n/a | Spigot, Paper |
| 2.5 | 2020-11-28 | n/a | Spigot, Paper |
| 2.4 | 2020-09-26 | n/a | Spigot, Paper |
| 2.3 | 2020-09-22 | n/a | Spigot, Paper |
Run BungeeSafeguard - UUID-based whitelist plugin 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 catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists BungeeSafeguard - UUID-based whitelist plugin 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 3 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
- ✓AuthorINT_MAX, as published on SpigotMC
- ✓LicenseNot published by the sourceFree










