BetterWL 🌐
A superior whitelist/blacklist solution for Minecraft servers that extends the functionality of the vanilla whitelist system.
Features
- Enhanced Whitelist: Whitelist players by name, UUID, or IP address
- Blacklist System: Block players by name, UUID, or IP address
- Temporary Access: Add or remove players temporarily to/from whitelist or blacklist
- Sleek Commands: Clean and intuitive command system
- Customizable Messages: Edit kick messages and plugin messages in the config
- Permission System: Granular permissions for server administrators
Commands
| Command | Description | Permission |
|---|---|---|
/bwl add [player/ip/uuid] |
Add to whitelist | betterwl.add |
/bwl del [player/ip/uuid] |
Remove from whitelist | betterwl.del |
/bwl blacklist add [player/ip/uuid] |
Add to blacklist | betterwl.blacklist.add |
/bwl blacklist del [player/ip/uuid] |
Remove from blacklist | betterwl.blacklist.del |
/bwl whitelist [true/false] |
Enable/disable whitelist | betterwl.whitelist.toggle |
/bwl reload |
Reload config | betterwl.reload |
/bwl list |
List whitelisted entries | betterwl.list |
/bwl blacklist list |
List blacklisted entries | betterwl.blacklist.list |
/bwl tempadd [player/ip/uuid] [seconds] |
Temporarily whitelist | betterwl.tempadd |
/bwl tempdel [player/ip/uuid] |
Remove from temp whitelist | betterwl.tempdel |
/bwl blacklist tempadd [player/ip/uuid] [seconds] |
Temporarily blacklist | betterwl.blacklist.tempadd |
/bwl blacklist tempdel [player/ip/uuid] |
Remove from temp blacklist | betterwl.blacklist.tempdel |
Installation
- Download the latest release from Bukkit
- Place the JAR file in your server's
pluginsfolder - Restart your server or use a plugin manager to load the plugin
- Edit the config.yml file in the
plugins/BetterWLfolder to customize settings
Configuration
# BetterWL Configuration
whitelist:
enabled: false # If true, only whitelisted players can join
players: [] # List of whitelisted player names
ips: [] # List of whitelisted IP addresses
uuids: [] # List of whitelisted UUIDs
blacklist:
players: [] # List of blacklisted player names
ips: [] # List of blacklisted IP addresses
uuids: [] # List of blacklisted UUIDs
messages:
prefix: "&8[&bBetterWL&8] &r"
whitelist-kick: "&cYou are not whitelisted on this server!"
blacklist-kick: "&cYou are blacklisted from this server!"
Examples
Whitelist a player
/bwl add Notch
Whitelist an IP address
/bwl add 192.168.1.1
Temporarily whitelist a player for 1 hour
/bwl tempadd Notch 3600
Blacklist a UUID
/bwl blacklist add 069a79f4-44e9-4726-a5be-fca90e38aaf5
Remove a player from the blacklist
/bwl blacklist del Notch
Enable the whitelist
/bwl whitelist true
List all whitelist entries
/bwl list
License
This project is licensed under the MIT License.

