
Discord AutoWhitelist
Whitelist via Discord embed
About this Mod
Discord AutoWhitelist is a modern, easy-to-use Minecraft Forge mod that fully automates your server's whitelist system using Discord roles. Whether you're running a private SMP, a roleplay kingdom, or a premium community server, this mod ensures that only verified Discord members can join your Minecraft world — without manual intervention.
🚀 Key Features
✅ One-Click Whitelisting
Players can whitelist themselves directly from Discord by clicking a button and entering their Minecraft username — no admin needed.
✅ Role-Based Access Control
Only users with specific Discord roles (defined in the config) are allowed to whitelist themselves. You can leave it empty to allow everyone.
✅ Mojang API Validation
The mod verifies every submitted Minecraft username through the official Mojang API to ensure only real premium accounts are accepted (you can disable this option in the config).
✅ Persistent Whitelist File
User data is stored in a lightweight, editable whitelist.json file in your config folder for easy backup and syncing.
✅ Highly Customizable Config
Every part of the mod is tweakable through a simple JSON config file, including:
Discord bot token, channel, and role IDs
Embed colors, button text, descriptions
Custom messages for success, errors, and invalid attempts
Premium account requirement toggle
✅ Spam-Proof Messaging System
To prevent message flooding, the mod only sends the whitelist embed once, and tracks whether it's already been posted.
✅ Failsafe Logging & Feedback
All key actions (like Mojang checks, Discord responses, and whitelist commands) are logged and confirmed for easier debugging.
Available Versions
How to Install Discord AutoWhitelist on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.5).
Install Mod
Open the mod browser in the dashboard and search for "Discord AutoWhitelist". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.5, 1.20.4, 1.20.3 (+2 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Discord AutoWhitelist server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.5). You can switch loaders with one click in the panel.
Is Discord AutoWhitelist compatible with forge?
Discord AutoWhitelist officially supports forge for Minecraft 1.20.5, 1.20.4, 1.20.3. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Discord AutoWhitelist – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Discord AutoWhitelist consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Discord AutoWhitelist with just one click on your server.