BungeeSafeguard Plugin

Links

Links

Introduction

This plugin is installed on the UniversalCraft Waterfall servers for handling whole-server whitelisting requirements.

A very well-rounded and carefully designed plugin, from version 2.3 onwards BungeeSafeguard became compatible with Minecraft Java Edition™ servers that have the Geyser plugin installed so that Minecraft Bedrock Edition™ players can join. Once the whitelist functionality is switched on, simply use the /whitelist add command to allow a specific Minecraft Java Edition™ player to access the server, and use the /whitelist x-add command to a grant the same access to a Minecraft Bedrock Edition™ player. For the specific details of these commands, see below.

BungeeSafeguard also provides additional functionality that may be of use to other server owners. It provides player-banning options by way of blacklisting players. At UniversalCraft we have chosen to use the AdvancedBan plugin to achieve the same thing instead.

In addition, BungeeSafeguard has also implemented the concept of “lazy lists”. These are additional whitelists and blacklists where player names are added but no authentication with Mojang servers takes place and UUID values of player names are not looked up. Players are only added to the regular whitelist or blacklist once they try to log into your server for the first time. This is useful for offline private servers or for mass adding of player names in bulk.

On the UniversalCraft servers membership of the “owner” security group is required to issue all BungeeSafeguard commands.

Commands

/blacklist add <JavaPlayerName or JavaUUID>

Add a Minecraft Java Edition™ player to the Bungeecord/Waterfall server blacklist. Multiple player names or UUIDs may listed in one command by separating them with spaces. See the corresponding /blacklist x-add command for adding Minecraft Bedrock Edition™ players to the server blacklist.

/blacklist list

Show list of players currently on the blacklist.

/blacklist off

Turns off the blacklist functionality allowing players on the blacklist to still be able to connect to the Waterfall proxy server.

/blacklist on

Turns on the blacklist functionality preventing players who are listed on the blacklist from connecting to the Waterfall proxy server.

/blacklist remove <JavaPlayerName or JavaPlayerUUID>

Remove a player from the blacklist. Multiple player names or UUIDs may listed in one command by separating them with spaces. See the corresponding /blacklist x-remove command for removing Minecraft Bedrock Edition™ players to the server blacklist.

/blacklist x-add <BedrockPlayerName>

Add a Minecraft Bedrock Edition™ player to the Bungeecord/Waterfall server blacklist. Multiple player names may added in one command by separating them with spaces.

/blacklist x-remove <BedrockPlayerName>

Remove a Minecraft Bedrock Edition™ player from the blacklist. Multiple player names may listed in one command by separating them with spaces.

/whitelist add <JavaPlayerName or JavaPlayerUUID>

Add a Minecraft Bedrock Edition™ player to the Bungeecord/Waterfall server whitelist. Multiple player names or UUIDs may added in one command by separating them with spaces. See the corresponding /whitelist x-add command for adding Minecraft Bedrock Edition™ players to the server whitelist.

/whitelist list

Show list of players currently on the whitelist.

/whitelist off

Turns off the whitelist functionality allowing any players not on the blacklist to connect to the Bungeecord/Waterfall proxy server.

/whitelist on

Turns on the whitelist functionality allowing only players who are listed on the whitelist to connect to the Bungeecord/Waterfall proxy server.

/whitelist remove <JavaPlayerName or JavaPlayerUUID>

Remove a Minecraft Java Edition™ player from the whitelist. Multiple player names or UUIDs may listed in one command by separating them with spaces.

/whitelist x-add <BedrockPlayerName>

Add a Minecraft Bedrock Edition™ player to the Bungeecord/Waterfall server whitelist. Multiple player names may added in one command by separating them with spaces.

/whitelist x-remove <BedrockPlayerName>

Remove a Minecraft Bedrock Edition™ player from the whitelist. Multiple player names may listed in one command by separating them with spaces.

Configuration

The following configuration changes have been made for the UniversalCraft gaming servers:

config.yml

Set the message to be displayed to non-whitelisted players:

whitelist-message: This server is whitelisted.