SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

BungeeSafeguard - UUID-based whitelist plugin

by INT_MAX · for Minecraft

whitelist, blacklist, UUID, Geyser, XBOX

3.7KDownloads
5 yr agoLast updated
Spigot · PaperLoaders
1.19Latest game version

About BungeeSafeguard - UUID-based whitelist plugin

From SpigotMC

whitelist, 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
    • 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:

Read the full description on SpigotMC →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Paper1.16 to 1.19 (4 versions)1.19
Spigot1.16 to 1.19 (4 versions)1.19

From 10 recorded builds of BungeeSafeguard - UUID-based whitelist plugin.

Recent builds

BuildReleasedGame versionsLoaders
3.12021-07-291.16 to 1.19 (4 versions)Spigot, Paper
2.6.12021-05-05n/aSpigot, Paper
2.62021-04-11n/aSpigot, Paper
2.52020-11-28n/aSpigot, Paper
2.42020-09-26n/aSpigot, Paper
2.32020-09-22n/aSpigot, 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 catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC 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

BungeeSafeguard - UUID-based whitelist plugin, answered

Generated from the mod’s own source data.

Do my players need to install BungeeSafeguard - UUID-based whitelist plugin?

SpigotMC lists BungeeSafeguard - UUID-based whitelist plugin 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. BungeeSafeguard - UUID-based whitelist plugin 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 BungeeSafeguard - UUID-based whitelist plugin on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add BungeeSafeguard - UUID-based whitelist plugin in one click.