
GateKeeper
A plugin adding a basic whitelist system to velocity, with Bedrock player and LuckPerms Group whitelisting support.
Commands and Permissions:
If you want to add a bedrock player to the whitelist by their username and not UUID, please prefix it with your configured bedrock player prefix (default:
.) first. Example:Tim203->.Tim203
/vwhitelist (aliases: /velocitywhitelist, /gatekeeper)
add <username or uuid>: Adds a new player to the whitelistremove <username or uuid>: Removes the specified player from the whiteliston: Enables the whitelistoff: Disables the whitelistlist: Lists all players currently on the whitelistaddgroup <group name>: Adds a LuckPerms group to the whitelistremovegroup <group name>: Removes a LuckPerms group from the whitelistlistgroups: Lists all currently whitelisted LuckPerms groupsclear: Clears the entire whitelist
Permissions are given based on the commands:
whitelist: base command node
whitelist.addfor the add-commandwhitelist.clearfor the clear-commandwhitelist.listfor the list-commandwhitelist.offfor the off-commandwhitelist.onfor the on-commandwhitelist.addgroupfor the addgroup-commandwhitelist.removegroupfor the removegroup-commandẁhitelist.listgroupsfor the listgroups-commandwhitelist.removefor the remove-command
config.yml
enabled: true # if the whitelist should be enabled or not. This will change with the use of `/whitelist on|off`.
prefix: "<dark_gray>[<light_purple>Whitelist<dark_gray>]<reset> " # The prefix for every message except the disconnect reason.
messages:
disconnect-reason: | # the message shown to the player when he is not on the whitelist
<red>You are not whitelisted on this server.</red>
<gray>Please contact an administrator if you believe this is a mistake.</gray>
errors:
player-not-found: "<red>Player '{0}' not found.</red>"
already-whitelisted: "<red>Player is already whitelisted.</red>"
group-already-whitelisted: "<red>Group is already whitelisted.</red>"
not-whitelisted: "<red>Player is not whitelisted.</red>"
group-not-whitelisted: "<red>Group is not whitelisted.</red>"
incorrect-confirmation: "<red>Incorrect confirmation number."
whitelist-already-on: "<red>Whitelist is already enabled.</red>"
whitelist-already-off: "<red>Whitelist is already disabled.</red>"
lp-integration-missing: "<red>LuckPerms is required on the proxy to use the group whitelisting feature."
usage:
add: "<red>Usage: /vwhitelist add <player></red>"
addgroup: "<red>Usage: /vwhitelist add <group></red>"
remove: "<red>Usage: /vwhitelist remove <player></red>"
removegroup: "<red>Usage: /vwhitelist remove <group></red>"
whitelist: "<red>Usage: /vwhitelist <on|off|add|remove|addgroup|removegroup|list|listgroups></red>"
info:
added-to-whitelist: "Added <red>{0}</red> to the whitelist."
removed-from-whitelist: "Removed <red>{0}</red> from the whitelist."
added-group-to-whitelist: "Added group <red>{0}</red> to the whitelist."
removed-group-from-whitelist: "Removed group <red>{0}</red> from the whitelist."
whitelist-on: "Whitelist has been <green>enabled</green>."
whitelist-off: "Whitelist has been <red>disabled</red>."
list: "Whitelisted players: <yellow>{0}</yellow>"
listgroups: "Whitelisted groups: <yellow>{0}</yellow>"
list-empty: "<gray>The whitelist is currently empty."
whitelist-clear: "Please type in <red>/whitelist clear {0}</red> in the next 15 seconds to confirm. <gray>Note that this action cannot be undone."
whitelist-clear-confirmed: "Whitelist cleared successfully."
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7.10, 1.8, 1.8.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as gatekeeper-2.0.0.jar — drop this file into the mods folder
- Download size: 306 KB
- Download link checked 11 Sept 2026 — working
These come from our own check of the pack file, not from the source page.