BlockyWhitelist

🔒 BWL – Discord Whitelist Plugin for Minecraft

BWL is a modern and secure Discord-based whitelist system for Minecraft servers. Seamlessly connect your Discord community with your server access using a sleek and easy-to-use solution. Designed with performance, flexibility, and simplicity in mind, BWL helps server owners maintain a trusted player base without the hassle.

✅ Features:

• Discord Integration – Link Minecraft accounts with Discord users
• Secure Whitelisting – Only verified Discord members can join
• Customizable Setup – Supports roles, language editation
• Modern Design – Clean and optimized for all Paper/Purpur servers
• Logging & Feedback – Get detailed logs and user-friendly messages

Perfect for private communities, SMPs, and networks that want a smarter way to manage access.

⚙️ Setup Guide

Getting started with BWL is quick and simple. Just follow these steps to link your Discord server with your Minecraft world:

1️⃣ Create Your Discord Bot

• Head over to the Discord Developer Portal.
• Click “New Application”, give it a name, and create it.
• Under the “Bot” tab, click “Add Bot”, then Enable the following Privileged Gateway Intents:
  • Presence Intent
  • Server Members Intent
  • Message Content Intent
• Copy your Bot Token — you’ll need it shortly.

2️⃣ Add the Bot to Your Server

• In the Installation > Install Link, select:
  • Discord provided link
  • Permissions: Read Messages, Manage Roles, Send Messages, etc. (as needed)
• Copy the generated URL, paste it in your browser, and invite the bot to your Discord server.

3️⃣ Install BWL on Your Server

• Download and place the BWL plugin .jar file into your server’s /plugins folder.
• Restart your server to generate the necessary files.

4️⃣ Connect the Bot In-Game

• Join your server and run the command:

  /bwl
  

• This opens the BWL setup menu. Here you can:
  • Paste your Bot Token
  • Enter your Guild ID (your Discord server’s ID)

5️⃣ You're All Set!

From here, customize roles and other options to suit your server. BWL will handle the whitelist based on your setup.

If you want to edit the kick messages or anything else, open up plugins/BlockyWhitelist/languages.json and edit them however you want!